DeepSeek Harness

ใช้คู่มือนี้เพื่อรัน DeepSeek Harness โอเพนซอร์สด้วยโมเดลที่ให้บริการโดย Felo API Platform เส้นทางที่แนะนำคือใช้ adapter deepseek-official ที่มีอยู่แล้วใน harness คุณยังเพิ่ม Felo เป็นผู้ให้บริการแบบกำหนดเองที่เข้ากันได้กับ OpenAI แยกต่างหากใน Web UI ได้ด้วย

DeepSeek Harness ปัจจุบันอยู่ในสถานะ developer preview และอาจมีการเปลี่ยนแปลงที่ไม่เข้ากัน ตรวจสอบบันทึกการออกรุ่นต้นทางเมื่อตัวเลือกหรือหน้าจอแตกต่างจากคู่มือนี้

ก่อนเริ่มต้น

คุณต้องมี Node.js และคีย์ของ Felo API Platform หนึ่งคีย์ ให้เก็บคีย์ให้พ้นจากระบบควบคุมเวอร์ชัน

export FELO_API_KEY="YOUR_API_KEY"

ตัวอย่างใช้ deepseek-v4-flash ตรวจสอบโมเดลและราคาก่อนเลือก ID โมเดลอื่น

การตั้งค่าที่แนะนำ: adapter DeepSeek ที่มีอยู่แล้ว

DeepSeek Harness อ่านข้อมูลรับรองของ adapter ที่มีอยู่แล้วจาก 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. เพิ่มหรือเลือกเวิร์กสเปซโปรเจกต์ของคุณ
2. เปิด Settings → Models
3. เลือกผู้ให้บริการ deepseek-official และโมเดล deepseek-v4-flash
4. เริ่มเซสชันใหม่และส่งงานในที่เก็บโค้ดขนาดเล็ก

ห้ามต่อท้าย base URL ด้วย /chat/completions adapter ที่มีอยู่แล้วจะส่งคำขอไปยัง {DEEPSEEK_BASE_URL}/chat/completions เอง

เก็บค่าตัวแปรสภาพแวดล้อมไว้ถาวร

DeepSeek Harness สามารถอ่านไฟล์ .env จากไดเรกทอรีที่คุณเริ่มต้นได้ เพิ่มค่าต่อไปนี้ในไฟล์ .env ที่ไม่ได้ถูกติดตามใน Git หากคุณไม่ต้องการ export ทุกเซสชัน:

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. กรอกค่าต่อไปนี้และบันทึกผู้ให้บริการ

หากการค้นพบโมเดลล้มเหลว ให้เพิ่ม ID โมเดลด้วยตนเอง การกระทำ Get available models ของผู้ให้บริการขึ้นอยู่กับเส้นทาง GET /models ที่เข้ากันได้กับ OpenAI และไม่จำเป็นสำหรับการกำหนดค่าด้วยตนเอง

ตรวจสอบการตั้งค่า

เริ่มเซสชันใหม่แล้วถามว่า:

Summarize this repository and identify its main packages.

การตั้งค่าพร้อมใช้งานเมื่อเซสชันเสร็จสมบูรณ์โดยเลือก deepseek-v4-flash และไม่มีข้อผิดพลาดด้านการรับรองความถูกต้องหรือไม่รู้จักโมเดล

สำหรับการทดสอบแบบไม่โต้ตอบอย่างรวดเร็วด้วย adapter ที่แนะนำ ให้รันจากเวิร์กสเปซเป้าหมาย:

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 Agent