前言¶
在 DeepSeek Harness(DSH)裏做複雜任務時,工具調用往返多、中間結果堆進對話,Lead 往往又要自己拆活又要自己收束驗收。官方已提供 PTC 模式:模型只直接調用 run_code,其餘工具在一段程序裏通過生成 SDK 調用,能減少輪次、壓低對話噪音。若你還希望會話默認按「先拆工作流、建共享任務、派有界隊友、Lead 做集成與驗證」來執行,單靠內置 PTC 預設通常不夠——需要在同一套 PTC 組合上疊加一套固定的委派準則。
下面介紹社區維護的配置包 zouyuanqing/dsh-super-ptc-mode(npm 包名 @local/dsh-super-ptc-mode):純配置 DSH Profile Bundle,安裝後新增 Agent 預設「超級 PTC 模式」(id super-ptc),在保留 PTC 工具呈現的同時,在預設作用域內追加 SUPER PTC 的 Agent Teams 委派教義。
這是什麼¶
@local/dsh-super-ptc-mode 由 zouyuanqing 維護,版本 1.0.0,許可證 MIT。包內沒有 index.js、沒有構建步驟、沒有運行時依賴;唯一行爲是通過 cordis.patch.yml(在 package.json 中聲明爲 dsh.bundle.patch)向 Profile 插入一行 @deepseek-ai/dsh-agent-preset,對應 row id preset-super-ptc。
與官方隨附的「PTC 模式」相比,差異主要在 persona 後綴:教義寫在預設組合內,只對選用 super-ptc 的新會話生效,並在 PTC SDK 說明之後渲染,從而約束執行策略。Agent Teams 相關工具不由本包聲明,而是依賴宿主 Profile 已啓用的實驗包 @deepseek-ai/dsh-experimental-agent-team-profile。
生態上,插件目錄站點 SkillHub 是社區索引,與 DeepSeek / 幻方無官方從屬關係;安裝與行爲以 GitHub 倉庫 文檔爲準。
核心功能¶
PTC 工具呈現¶
預設掛載 @deepseek-ai/dsh-agent-tool-presentation,mode: ptc。加入該預設的 Agent 在請求頭裏只直接暴露 run_code 傳輸;其它工具須在 run_code 程序內通過 await tools.<name>(args) 訪問。獨立調用可合併進同一段程序,減少往返,並把中間輸出留在程序側而非對話裏。
與官方 ptc 組合對齊的能力面¶
預設複述隨附 ptc 的組合行,使 PTC、委派與教義在同一預設內一致,主要包括:
- 身份與上下文:
persona(前綴 + 教義後綴)、agent-instructions、time-context - Shell:Windows 用
pwsh,其它平臺用bash - 文件系統:讀寫編輯、路徑與內容搜索
- 運行時:後臺任務與定時提醒
- 知識與控制:skills、goals、plan mode、compaction(
/compact與工具結果裁剪) - 委派:仍掛載舊版
subagent/subagent_fork/list_agents;教義要求默認採用 Agent Teams 策略 - 交互:
ask_user_question、todo_write、聯網搜索/抓取、present
在本預設的會話內,plugin_manager 與 plugin-market 相關工具被禁用,避免委派子會話擅自改 Profile。
委派教義(persona 後綴)¶
相對隨附 ptc 預設,增量即 persona 後綴,且不得包含 {{…}} 類 prompt 變量語法。教義要求 Lead 在非瑣碎任務上先分解再動手;在生成隊友前建立帶驗收標準、寫域互不重疊的共享任務;隊友數量有界(文檔寫明通常 1–4),任務簡報自洽;Lead 保留集成與最終驗證;不得把「完成消息」等同於已驗證成功。
依賴宿主提供的 Agent Teams 工具¶
本 Bundle 不聲明團隊工具。啓用 @deepseek-ai/dsh-experimental-agent-team-profile 後,宿主提供例如 spawn_teammate、send_message、list_agents、wait_agent、interrupt_agent,以及共享任務板 team_task_create / list / get / update。未啓用實驗包時預設仍可掛載,但團隊工具缺失,教義無法落地。
環境與依賴¶
| 要求 | 說明 |
|---|---|
| DSH 桌面或 Web 0.2.1-rc.5 或更新 | README 寫明在 0.2.1-rc.5 上驗證;組合面與隨附 ptc 預設相同 |
@deepseek-ai/dsh-experimental-agent-team-profile 已啓用 |
提供 Agent Teams 與任務板工具 |
@deepseek-ai/dsh-ptc-runtime-node(桌面應用內已包含) |
無 PTC 運行時則掛載拒絕,並指出失敗行 |
兼容性:README 記載在 Windows 上於 DSH 桌面 0.2.1-rc.5 端到端測試;組合在平臺維度與隨附 ptc 一致。
安裝與啓用¶
安裝方式爲本地目錄鏈式安裝,不要手改 Profile 依賴列表或 patch。官方步驟如下。
1、克隆倉庫並保持檢出目錄常駐(本地目錄安裝會鏈接整個目錄,files 不會過濾已鏈接目錄):
git clone https://github.com/zouyuanqing/dsh-super-ptc-mode.git
2、在 DSH 內用 plugin_manager 從克隆目錄安裝 Bundle(target 填倉庫的絕對路徑):
plugin_manager action: install_bundle target: <absolute path to the cloned dsh-super-ptc-mode directory>
3、若安裝結果提示 restart-required,先重啓 DSH 再使用預設。
4、新建會話時選擇 Super PTC Mode(顯示名:超級 PTC 模式,id super-ptc)。已有會話仍使用各自原有預設。
5、在新會話中核對:名冊與 Bundle 詳情出現標題與圖標;持久化系統提示含教義原文;請求頭僅 run_code 可直接調用;生成 SDK 暴露團隊工具綁定。倉庫內 docs/VERIFICATION.md 列出驗收項與復現提綱。
Bundle patch 在 Profile 自有 cordis.patch.yml 之前應用;若操作員編輯 Profile 覆蓋了 row id preset-super-ptc,以 Profile 級覆蓋爲準。
卸載:在 DSH 插件管理中對本 Bundle 執行 plugin_manager 的 set_bundle / remove_bundle;預設行隨 Bundle 移除,不影響 Agent Teams 實驗包。
典型用法¶
本包不附帶獨立業務場景腳本;用法即「選用預設 + 按教義組織多 Agent 工作流」。
1、確認實驗 Agent Teams Profile 與 PTC 運行時已滿足上節要求。
2、新建會話,預設選 super-ptc。
3、由 Lead 將任務拆成互不依賴的工作流;用 team_task_create 等建立共享任務與驗收條件;再通過 spawn_teammate 派發有界隊友,寫域分離。
4、複雜工具操作放在單次或少量 run_code 中,通過 SDK 批量調用 tools.*(含團隊工具),減少對話輪次。
5、Lead 使用 wait_agent、檢查任務板與產物,完成集成驗證後再對用戶收尾;避免僅依賴隊友的完成宣告。
倉庫 README 記載在 0.2.1-rc.5 上完成真實隊友與共享任務流驗證;細節見 VERIFICATION 文檔。
適用場景與注意¶
適合:已在 DSH 上使用 PTC、並願意啓用 Agent Teams 實驗能力的開發者;需要默認「Lead 編排 + PTC 批處理 + 共享任務驗收」的長鏈路工作流。
不適合或未就緒:未啓用 @deepseek-ai/dsh-experimental-agent-team-profile 的環境(教義無工具支撐);DSH 版本低於 0.2.1-rc.5 且組合面不兼容的情況需自行驗證。
安全與信任:插件以當前 DSH 進程權限運行;安裝前請閱讀倉庫源碼、cordis.patch.yml 與 MIT 許可證,確認 patch 僅插入預期預設行。@local/ 作用域與 private: true 表示設計爲從檢出目錄本地安裝,而非 npm 公開發布包。
結尾¶
dsh-super-ptc-mode 把官方 PTC 組合與一套固定的 Agent Teams 委派教義收成單一預設 super-ptc,適合在 DSH 裏用 run_code 壓低工具往返、又用共享任務與有界隊友分擔複雜工作的場景。