前言¶

DeepSeek Harness（DSH）支持把重任務委派給子智能體，父會話只收一條結論，避免 token 隨上下文線性膨脹。官方子智能體後端有 Codex（@deepseek-ai/dsh-subagent-codex）和 Claude Code（@deepseek-ai/dsh-subagent-claude-code），沒有 Cursor。

若你已有 Cursor 訂閱，Cursor CLI（cursor-agent）走的是真實 agent 循環：讀寫文件、跑命令、調 MCP，鑑權也獨立於 DSH。社區插件 dsh-subagent-cursor（維護者 xuanyuanli）把 cursor-agent 掛進 Profile，模型可通過工具 subagent_cursor 在會話工作區 spawn 一次性子進程，跑完只返回單條權威答案。

這是什麼¶

dsh-subagent-cursor 是面向 DSH 的 Cursor CLI 一次性 subagent 提供方（package 版本 0.1.1，MIT 許可證）。每次委派在父會話工作區啓動全新的 cursor-agent 進程，任務結束後把 Cursor 的最終答案（或失敗診斷）通知回父 agent；中間 assistant 消息、thinking、工具事件、stderr、token 用量不會進入父會話。

插件自行註冊 provider 與 Host 級工具，不依賴官方 @deepseek-ai/dsh-tool-subagent，以避免 provider 與工具同層加載時的時序問題導致工具靜默缺席。

核心功能¶

子智能體提供方與工具¶

• Provider 註冊名默認 cursor（可用 providerName 修改）。
• 工具名默認 subagent_cursor（可用 toolName 修改）；接受任務後返回 child id，完成後以通知送回答案。
• 一次性委派：後端不接受追問；要繼續對話需在新委派裏把上下文寫進 prompt。

能力與限制¶

提供方能力標誌均爲 false：不支持 agentOptions、agentPreset、outputSchema、depthLimit。深度嵌套只能靠 prompt 或 CLI 側約束。

權限檔¶

permissionMode 五選一，與獨立開關 approveMcps（默認 true，對應 --approve-mcps）正交：

默認 trust 而非 safe，是因爲 README 實測：Windows 上 safe 會導致 CLI exit 1、無 result 事件。

主要配置項¶

字段以倉庫 src/index.js 的 Config 爲準，常用項包括：model、cliPath、env、extraArgs、disposeGraceMs（默認 3000）等。extraArgs 不經校驗，勿改 --output-format，否則解析失敗。

安裝與啓用¶

前提：Node.js ≥ 22（宿主用於加載插件；實際執行用 CLI 自帶 node.exe），DSH ^0.2.1-rc.3，且 Cursor CLI 已登錄（插件不復用 DSH 憑據，也不讀 CURSOR_API_KEY）。

1、安裝 Cursor CLI 並登錄：

cursor-agent login
cursor-agent status

2、編輯 Profile 的 package.json（Web/Desktop 默認路徑 ~/.dsh/profiles/desktop/package.json），在 dependencies 中加入本包。本地開發可用 link:；發佈依賴示例：

{
  "dependencies": {
    "dsh-subagent-cursor": "0.1.1"
  }
}

3、在 dsh.profile.bundles 數組末尾追加 bundle 名（加載順序：base / web 在前，本包在後）：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-subagent-cursor"
      ]
    }
  }
}

4、安裝依賴並重啓 DSH：

cd ~/.dsh/profiles/desktop
pnpm install

安裝器提示需重啓時必須重啓。

典型用法與驗證¶

讓模型調用最小任務，期望得到文本答案且 stopReason 爲 completed：

用一個 subagent_cursor 任務，只回答 OK，不要調用任何工具。

可先繞開 DSH，用 CLI 自檢（參數等價於默認 trust + approveMcps: true；Windows 下 <版本> 取 %LOCALAPPDATA%\cursor-agent\versions\ 下最新目錄，README 寫作時參考版本爲 2026.10.22-27dcf5f）：

node "$LOCALAPPDATA/cursor-agent/versions/<版本>/node.exe" \
     "$LOCALAPPDATA/cursor-agent/versions/<版本>/index.js" \
     -p --output-format stream-json --trust --approve-mcps "Reply with exactly: PONG"

寫 subagent_cursor 的 task 時，第一句應爲祈使指令（如「讀取 X 並總結」）；工作目錄、日期等上下文放在指令之後，否則 agent 可能只確認環境而不調用工具。

適用場景與注意¶

適合：已有 Cursor 訂閱、希望在 DSH 裏多一個能真正改文件、跑命令的委派後端，且接受「單條結論、無追問」模型的人。

注意：

• 子進程在父會話工作區運行，權限與當前 DSH 進程及所配 permissionMode 相關；安裝前請閱讀源碼與 MIT 許可證，自行評估安全邊界。
• 同機掛兩套 Cursor 實例時，須區分 providerName 與 toolName。
• CLI 的 stream-json 輸出無版本化契約承諾；換 CLI 版本後建議重跑驗證步驟。
• 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件星標以目錄頁爲準（當前線索爲 0）。

結尾¶

dsh-subagent-cursor 補上了 DSH 官方未提供的 Cursor 子智能體後端：用訂閱額度驅動 cursor-agent，父會話只收一條權威答案，控制上下文膨脹。詳情與排障見倉庫 README。

• 目錄頁：https://www.skillhub.cn/plugins/xuanyuanli/dsh-subagent-cursor
• GitHub：https://github.com/xuanyuanli/dsh-subagent-cursor