DeepSeek Harness

از این راهنما برای اجرای DeepSeek Harness متن‌باز با مدل‌های سروشده توسط Felo API Platform استفاده کنید. مسیر پیشنهادی از آداپتور داخلی deepseek-official خود harness دوباره استفاده می‌کند. همچنین می‌توانید در Web UI Felo را به‌عنوان یک ارائه‌دهنده سفارشی سازگار با OpenAI جداگانه اضافه کنید.

DeepSeek Harness در حال حاضر یک پیش‌نمایش توسعه‌دهنده است و ممکن است تغییرات ناسازگارکننده ایجاد کند. وقتی گزینه یا صفحه‌ای با این راهنما تفاوت داشت، یادداشت‌های انتشار بالادستی آن را بررسی کنید.

پیش از شروع

به Node.js و یک کلید Felo API Platform نیاز دارید. کلید را بیرون از کنترل نسخه نگه دارید.

export FELO_API_KEY="YOUR_API_KEY"

نمونه‌ها از deepseek-v4-flash استفاده می‌کنند. پیش از انتخاب شناسه مدل دیگر، مدل‌ها و قیمت‌گذاری را بررسی کنید.

راه‌اندازی پیشنهادی: آداپتور داخلی DeepSeek

DeepSeek Harness اعتبارنامه آداپتور داخلی را از DEEPSEEK_API_KEY و endpoint آن را از DEEPSEEK_BASE_URL می‌خواند.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

http://127.0.0.1:3080 را باز کنید، سپس:

1. workspace پروژه خود را اضافه یا انتخاب کنید.
2. Settings → Models را باز کنید.
3. ارائه‌دهنده deepseek-official و مدل deepseek-v4-flash را انتخاب کنید.
4. نشست تازه‌ای شروع کنید و یک وظیفه کوچک مخزن بفرستید.

/chat/completions را به base URL نیفزایید. آداپتور داخلی خودش درخواست‌ها را به {DEEPSEEK_BASE_URL}/chat/completions می‌فرستد.

ماندگار کردن مقدارهای محیطی

DeepSeek Harness می‌تواند فایل .env را از پوشه‌ای که آن را در آن شروع می‌کنید بخواند. اگر نمی‌خواهید آن‌ها را در هر نشست صادر کنید، مقدارهای زیر را به یک فایل .env ردیابی‌نشده اضافه کنید:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

این فایل را ثبت نکنید. همچنین وقتی به پیکربندی سطح کاربر نیاز دارید می‌توانید از فایل‌های اعتبارنامه و تنظیمات harness زیر $DSH_HOME استفاده کنید.

راه‌اندازی جایگزین: ارائه‌دهنده سفارشی سازگار با OpenAI

وقتی می‌خواهید Felo به‌عنوان یک ارائه‌دهنده جداگانه ظاهر شود، نه جایگزین اتصال داخلی DeepSeek، از این مسیر استفاده کنید.

1. Web UI را با npx @deepseek-ai/dsh web شروع کنید.
2. Settings → Models را باز کنید.
3. Add custom provider را انتخاب کنید.
4. مقدارهای زیر را وارد و ارائه‌دهنده را ذخیره کنید.

اگر کشف مدل شکست خورد، شناسه مدل را دستی اضافه کنید. اقدام Get available models یک ارائه‌دهنده به مسیر سازگار با OpenAI یعنی GET /models وابسته است و برای پیکربندی دستی لازم نیست.

بررسی راه‌اندازی

نشست تازه‌ای شروع کنید و بپرسید:

Summarize this repository and identify its main packages.

راه‌اندازی آماده است وقتی نشست با مدل انتخاب‌شده deepseek-v4-flash کامل شود و خطای احراز هویت یا مدل ناشناخته ظاهر نشود.

برای یک آزمون دودی غیرتعاملی با آداپتور پیشنهادی، از workspace هدف اجرا کنید:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

نکته جستجوی وب

این راه‌اندازی درخواست‌های مدل را از Felo عبور می‌دهد. ارائه‌دهنده داخلی web_search در DeepSeek Harness الزامات endpoint جداگانه دارد، هرچند متغیر اعتبارنامه پیش‌فرض آن هم DEEPSEEK_API_KEY است. DEEPSEEK_SEARCH_BASE_URL را به Felo اشاره ندهید، مگر آنکه از یک endpoint جستجوی صریحاً سازگار استفاده می‌کنید. وقتی گردش‌کار شما به جستجوی Felo نیاز دارد، Chat API یا دیگر Felo Skillها را جداگانه به کار ببرید.

عیب‌یابی

گام‌های بعدی

• مخزن DeepSeek Harness
• مرجع LLM API
• مرجع Chat API
• مهارت‌های Felo برای عامل‌های هوش مصنوعی