本文適用於deepseek-harness-sdk==0.1.0rc6與deepseek-harness-runtime-bin==0.1.0rc6。升級客戶端後,請重新完成下方的只讀文件測試。
支持範圍
模型目錄會變化。運行前先用 Coding Plan 專屬密鑰查詢實時目錄:
deepseek-v4-pro。不要把 deepseek-v4-flash 當作本文工具模式的等價替代;本次固定版本驗證中,它的多輪推理歷史與工具回放未通過。
1. 準備專屬密鑰
打開 Coding Plan 應用,進入已購買的 Coding Application,創建或複製該應用的專屬 API Key。Coding Plan 不使用通用餘額,其他應用的密鑰不能代表套餐權限。 只把密鑰放進當前 shell:2. 創建隔離工作區
Harness 的 bundled runtime 包含本地 Bash 工具。第一次驗證不要指向真實項目或主目錄;創建一個沒有秘密的一次性目錄:deepseek-harness-runtime-bin。不要使用 danger-full-access 擴大文件訪問範圍;本文示例只把一次性目錄傳給 cwd。
3. 運行官方 Python SDK
把下面內容保存為/tmp/deepseek-harness-demo/run.py:
/v1/chat/completions、SSE、推理內容、工具調用與工具結果回傳。完成後可刪除 /tmp/deepseek-harness-demo;若 Session 目錄包含項目上下文,也應按代碼倉庫同等敏感級別保管。
常見問題
- 401:檢查
ACEDATACLOUD_API_KEY是否導出到運行 Python 的同一個 shell。 - 403 或額度提示:確認密鑰屬於當前 Coding Application,套餐仍在有效期且有剩餘額度。
- 模型不可用:重新查詢
/v1/models,不要根據舊截圖猜模型名。 reasoning_content/ 工具回放錯誤:確認 SDK/runtime 都是本文固定版本,並使用deepseek-v4-pro。- 工具執行次數異常:停止運行可能產生副作用的任務,先用本文只讀 fixture 驗證當前服務版本。
- 安裝失敗:確認 Python 3.10+、操作系統架構受當前 wheel 支持,並檢查 SDK/runtime 版本一致。
能力邊界
本文只驗證本地 Python SDK 到 Chat Completions 的文本與工具循環。圖片、Files API、/v1/responses、/v1/messages、遠程工作區和托管 sandbox 不在本教程承諾範圍內;工作區權限與本地命令風險由運行 Harness 的機器和配置負責。

