DeepSeek Harness

השתמשו במדריך הזה כדי להריץ את DeepSeek Harness בקוד פתוח עם מודלים המוגשים על ידי Felo API Platform. המסלול המומלץ עושה שימוש חוזר במתאם המובנה deepseek-official של ה-harness. אפשר גם להוסיף את Felo כספק מותאם תואם OpenAI נפרד ב-Web UI.

DeepSeek Harness הוא כרגע תצוגה מקדימה למפתחים ועשוי להציג שינויים שוברי תאימות. בדקו את הערות הגרסה שלו במעלה הזרם כשאפשרות או מסך שונים מהמדריך הזה.

לפני שמתחילים

אתם צריכים Node.js ומפתח אחד של Felo API Platform. הרחיקו את המפתח מבקרת גרסאות.

export FELO_API_KEY="YOUR_API_KEY"

הדוגמאות משתמשות ב-deepseek-v4-flash. בדקו את מודלים ותמחור לפני בחירת מזהה מודל אחר.

הגדרה מומלצת: מתאם DeepSeek המובנה

DeepSeek Harness קורא את אישורי המתאם המובנה מתוך DEEPSEEK_API_KEY ואת נקודת הקצה שלו מתוך 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. הוסיפו או בחרו את סביבת העבודה של הפרויקט.
2. פתחו את Settings → Models.
3. בחרו בספק deepseek-official ובמודל deepseek-v4-flash.
4. התחילו הפעלה חדשה ושלחו משימת מאגר קטנה.

אל תוסיפו /chat/completions לכתובת הבסיס. המתאם המובנה שולח בקשות ל-{DEEPSEEK_BASE_URL}/chat/completions בעצמו.

שמירת ערכי הסביבה

DeepSeek Harness יכול לקרוא קובץ .env מהתיקייה שממנה אתם מפעילים אותו. הוסיפו את הערכים הבאים לקובץ .env שאינו במעקב אם אינכם רוצים לייצא אותם בכל הפעלה:

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

אל תעלו את הקובץ הזה ל-Git. אפשר גם להשתמש בקבצי האישורים וההגדרות של ה-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 של ספק תלויה בנתיב GET /models תואם OpenAI ואינה נדרשת לתצורה ידנית.

אימות ההגדרה

התחילו הפעלה חדשה ושאלו:

Summarize this repository and identify its main packages.

ההגדרה מוכנה כשההפעלה מסתיימת עם deepseek-v4-flash נבחר ולא מופיעה שגיאת אימות או מודל לא מוכר.

לבדיקת עשן לא אינטראקטיבית עם המתאם המומלץ, הריצו מתוך סביבת העבודה המיועדת:

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 חיפוש תואם במפורש. השתמשו ב-Chat API של Felo או ב-Felo Skills אחרים בנפרד כשתהליך העבודה שלכם זקוק לחיפוש של Felo.

פתרון בעיות

הצעדים הבאים

• מאגר DeepSeek Harness
• מסמכי LLM API
• מסמכי Chat API
• Felo Skills לסוכני AI