前言¶
在 DeepSeek Harness(DSH)裏用 Agent Teams 做並行開發時,單個 Teammate 在一輪對話裏可能連續發起大量工具調用,既難預估成本,也不利於在失控前收束任務。只靠人工盯日誌或事後復盤,往往來不及。下面介紹的 dsh-team-dev 把「每智能體、每輪的工具調用預算」做成可配置的守衛,並在同一插件行裏附帶 team-dev、team-boot 兩套技能,適合把工作流類能力一次裝齊。
這是什麼¶
dsh-team-dev 是 JieCore 維護的 DSH 插件包(npm 包名 dsh-team-dev,社區目錄條目爲 jiecore/dsh-team-dev)。它在一個 bundle 裏提供兩件事:步數預算守衛(per-agent、per-turn 的工具調用預算),以及從包內 skills/ 目錄安裝的 team-dev(開發團隊編排)與 team-boot(通用任務團隊)技能。運行時無額外依賴;項目級(rank 100)與用戶級(rank 400)同名技能仍可覆蓋隨包技能(rank 600)。
步數預算守衛¶
守衛按智能體、按輪次統計被跟蹤的工具調用次數。
- 軟閾值(默認 20):超過後對非隊友會話發出警告。
- 硬閾值(默認 25):在調用執行前拒絕所有被跟蹤且不在白名單內的工具,並引導智能體寫交接、更新任務、向 Lead 彙報。
- 白名單(默認
write、edit、team_task_update、send_message):這些工具在硬閾值之後仍可用,便於收尾。 onlyTeamMembers: true(默認):僅對 Agent Teams 的 Teammate 計預算;Lead 不受上限。
配置錯誤會在加載時明確失敗(例如 soft 低於 2,或 hard 不大於 soft)。
行級配置示例(默認值如下):
softThreshold: 20
hardThreshold: 25
allow: [write, edit, team_task_update, send_message]
include: []
exclude: []
onlyTeamMembers: true
隨包技能¶
安裝插件後,team-dev 與 team-boot 會隨包註冊。在會話裏輸入 / 打開技能菜單,應能看到這兩項(與 README 中的升級自檢一致)。卸載插件會移除隨包技能;若項目或用戶目錄裏已有同名技能,那些副本會保留。
安裝與啓用¶
資料中的安裝方式分兩類,均需在 profile 的 package.json 裏聲明依賴,再重裝 profile 並重啓 DSH。請勿憑插件名自行拼接 dsh plugin add github:owner/repo 一類命令。
作爲本地包 / bundle¶
- 在 profile 的
package.json中加入依賴,例如本地 tarball:
# "@jiecore/dsh-team-dev": "file:/absolute/path/to/dsh-team-dev-0.1.0.tgz"
# 或發佈後使用 git/npm 等 specifier
- 在
dsh.profile.bundles中列出 bundle 名:
"dsh.profile.bundles": [..., "dsh-team-dev"]
- 重裝並重啓:
cd "$DSH_HOME/profiles/web" && pnpm install
作爲 patch 插入(單會話 profile,無需 bundles 列表)¶
在 profile 的 cordis.patch.yml 末尾追加:
- insert:
- id: dsh-team-dev
name: dsh-team-dev
同時在 profile 的 package.json 中加入 dsh-team-dev 依賴,再執行 pnpm install 並重啓 DSH。
驗證是否生效¶
包完整性可本地 smoke check:
node scripts/verify.mjs
安裝並重啓後,在 harness 日誌中應看到掛載標記:
grep "dsh-team-dev" "$DSH_HOME/../Logs/DSH Desktop/harness.log" | tail -2
# 期望出現:[dsh-team-dev] budget guard + bundled skills installed
行爲探測:讓 Teammate 在一輪內發起超過 25 次工具調用時,第 26 次非白名單調用應被拒絕,並帶有 Step budget exhausted: ... 類提示。
典型用法與場景¶
- 多 Teammate 並行改代碼:用默認閾值限制單輪「探路式」工具風暴,同時保留
write/edit/team_task_update/send_message以便寫交接與同步 Lead。 - 團隊任務編排:配合隨包的
team-dev、team-boot技能,在同一插件安裝步驟裏補齊開發團隊與一般任務團隊的工作流能力。
市場側:公開 GitHub 倉庫若帶有 package.json 中的 dsh.bundle.patch 清單,可通過桌面市場的 discovery-github-compatibility-v1 被發現;npm 發佈(包名 dsh-team-dev)爲 README 推薦的另一通道。當前倉庫 package.json 版本爲 0.1.2,許可證 MIT。
適用場景與注意¶
適合已在 DSH 中使用 Agent Teams、希望用可配置預算約束 Teammate 工具調用、並需要 team-dev / team-boot 技能的用戶。插件以當前 DSH 進程權限運行,安裝前請自行查看 GitHub 源碼 與 LICENSE。卸載時移除 bundle 行或 patch 條目及依賴,重裝並重啓即可;守衛邏輯源碼位於倉庫 src/guard.ts,lib/index.js 爲構建產物。
DSH 升級後建議按 README「Upgrade self-check」複查日誌掛載、運行 verify.mjs、再做預算與技能菜單探測。
結尾¶
dsh-team-dev 把步數預算守衛與兩套團隊技能打在一個 bundle 裏,用軟/硬閾值和白名單在硬頂前攔住失控調用,又留給 Teammate 收尾通道。目錄頁:https://www.skillhub.cn/plugins/JieCore/dsh-team-dev;源碼與說明:https://github.com/JieCore/dsh-team-dev。