前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在插件生態中，dsh-waibao 插件解決了開發者在命令行中委派任務後難以追蹤過程的問題。它將原本隱藏在命令行的任務執行，搬到了可視化的 DSH 桌面工作區。
插件簡介¶
名稱：dsh-waibao
定位：DSH 外包。Codex 分配任務，DSH 桌面執行；同一會話繼續，完成後回來驗收。
維護者：ericlee041769-hash
分類：工作流
許可：MIT
核心功能¶
- 桌面可見會話：任務會話出現在原生工作區和側欄，正文、工具過程和用量由 DSH 展示。
- 上下文續接：後續任務重用保存的 session binding，接着原會話執行。
- 完成回調：任務結束後通知發起任務的 Codex 聊天，由 Codex 檢查產物。
- 歷史接入：把已有的 headless 會話加入桌面工作區，繼續工作。
- 保留模型：使用已選 provider/model；續接時檢查是否發生切換。
安裝與啓用¶
首版僅支持 Windows 和 Node.js 24+。完成回調功能需要 Codex 桌面客戶端及已啓用的 Codex App Tools。
- 從 v0.1.0 發佈頁 下載
dsh-waibao-0.1.0.tgz。 - 使用 DSH 桌面自帶 CLI 安裝：
$dsh = "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd"
& $dsh plugin --profile desktop add 'D:\Downloads\dsh-waibao-0.1.0.tgz'
- 正常退出並重開 DSH。
- 安裝 Codex 技能：
$plugin = "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-waibao"
node "$plugin\bin\install-skill.mjs"
- 在 Codex 新聊天中輸入：
用 dsh-waibao 把這個任務委派給 DSH，完成後幫我驗收。
典型用法¶
創建任務文件¶
在工作區創建提示詞文件和任務 JSON。以下爲示例路徑：
{
"workspace": "D:\\code\\demo",
"workspaceTitle": "外包演示",
"title": "檢查實現與測試",
"requestId": "demo-round-1",
"bindingPath": "D:/code/demo/work/dsh-session.json",
"promptFile": "D:/code/demo/work/round1.txt"
}
運行任務¶
使用 CLI 執行：
node "$plugin\bin\cli.mjs" run 'D:\code\demo\work\task.json'
續接與歷史接入¶
續接任務時，保留 bindingPath，使用新的 requestId 和提示詞文件。不要複製歷史正文或同時驅動同一會話。
若要接入已有 headless 會話，使用 adopt 命令：
node "$plugin\bin\cli.mjs" adopt '{"workspace": "D:\\code\\demo", "sessionId": "xxx", "workspaceTitle": "接入演示"}'
adopt 接受 workspace、sessionId 和可選的 workspaceTitle。執行前需確認舊 headless 進程已結束，並使用原始工作目錄。接入本身不調用模型。
完成回調處理¶
技能在 Codex 環境中調用 bin/job.mjs run <job.json>。任務結束後，通過本機 Codex App Tools 發出完成事件。
查看狀態：
node "$plugin\bin\job.mjs" status <id>
處理投遞：
node "$plugin\bin\job.mjs" deliver <id>
技術細節與注意事項¶
- 通信機制：插件通過帶隨機令牌的 Windows 本地命名管道通信，不使用 HTTP 端口。
- 數據存儲：連接記錄與回調狀態位於
~/.dsh/dsh-waibao/。可通過環境變量DSH_WAIBAO_DATA_DIR統一數據目錄。 - 權限與費用：提示詞交給 DSH 原生 Agent，使用當前賬號、模型和工具權限。模型費用由對應 provider 收取。
- 斷線處理：客戶端在收到
done前斷開會報錯，重試前應檢查桌面會話狀態。 - 安全建議：不要將令牌、完整日誌、個人項目和會話數據提交到公開倉庫。
結語¶
dsh-waibao 讓開發者能夠利用 DSH 的桌面能力處理複雜、長時間的任務，同時保持與 Codex 的協作流程。相關目錄與源碼可參考下方鏈接。
