前言¶
用 DSH 做多智能體開發，常見的做法是同時開幾個會話，各自派活，最後靠人工翻日誌對齊誰寫了什麼、誰驗證了什麼。能協作，但交付證據散在各處：驗收命令沒人復跑、實現者自己說完成即完成、任務之間的依賴關係只存在於提示詞裏。
agent-bot（npm 包名 @eternalnight/agent-bot，維護者 EternalNight996）就是針對這個缺口做的插件。它把一次 DSH 會話變成一支結構化交付團隊：掌教帶隊的任務 DAG、獨立審查、交付時就地運行產物並彙總證據。項目是 AgentTeams 的衍生，MIT 許可。下面按功能、安裝、用法、門禁幾個部分介紹。
這是什麼¶
一句話定位：DSH 的多智能體團隊協作與交付流水線插件，附帶一個桌面寵物組件。
項目信息（來源 GitHub README 與 package.json）：
- 維護者：EternalNight996
- 當前版本：v0.1.6（npm
latest標籤） - 許可：MIT
- 運行要求：Node.js
^22.19.0 || >=24 - 社區目錄裏的分類是「工作流」
- 插件本體不含雲依賴，團隊狀態寫在本地
.agent-teams目錄
它解決的具體問題是「交付證據」。常見智能體 UI 給人一牆日誌；agent-bot 把誰在幹活、什麼被卡住、交付了什麼，連同冒煙結果、獨立驗收、真實渲染證據放在同一處界面裏。
核心功能¶
團隊運行時¶
底層不是狀態機假動作，是一套可持久化的運行時：
- 掌教（captain）帶隊的任務 DAG，依賴滿足纔派發
- 持久成員會話、郵箱、attempt 所有權，支持修復輪次與冷恢復
- 每個角色有獨立寫域，前端 / 後端 / 合契（集成）互不重疊
- 任務帶質量契約：目標 / 範圍 / 驗收 / 驗證命令 / 審查結論
- 實現者不能批准自己的實現；宿主會復跑聲明的驗證命令
團隊狀態目錄結構：
.agent-teams/<teamId>/
team.json
inbox/
delivery-report.md
# 本地優先；不接雲賬號
界面與開宗嚮導¶
插件提供一座「洞府」式界面，內含六件可點設施：山門、道統、功德碑、封神榜、天機閣、宗門志。組建團隊的流程是固定的幾步：填目標與陣容、AI 按目標擬需求訪談（運行環境、視覺主題、動效強度等）勾選後拍板、計劃攤開審覈、批准後才創建任何東西、交付時在驅動網關裏直接跑起產物。README 中給出的真機採集記錄顯示，一次「做個貪喫蛇」的交付最後彙總爲 2/2 通過、0 阻斷、13m33s、165.2K token、¥1.66；這是單次運行記錄，不是對任何任務的保證。
角色陣容¶
陣容按「接下來要幹什麼」組隊，席位上限 5，空閒角色不消耗 token。內置 6 套任務陣容，例如功能直交（產品經理、高級開發者、證據收集者、代碼審查員）和缺陷修復（代碼庫入職引導工程師、高級開發者、證據收集者）。定義位置在 src/client/lineup-store.ts，角色顯示名取自 src/agency-role-seeds.ts。
桌面寵物¶
插件附帶一套獨立安裝的桌面寵物（形象「小肥魚」），Windows 端與 DSH 端共用同一套角色資源：
- 25 組逐幀動作：點擊回應、睡覺鏈路、6 種工作狀態、拖拽反饋、隨機待機
- 空閒時每 18–28 秒漫遊一段，停下隨機換動作
- 睡覺持續 10 分鐘；點一下才醒，不點就繼續睡
- 雙擊喚出 DSH 並展開側欄；DSH 未運行時會自動啓動
- 單擊只觸發撫摸，不喚起或改動 DSH 窗口；懸停顯示狀態卡（等級、成長、飽食、心情、精力）
寵物爲獨立安裝包，不依賴 Python 環境，按用戶安裝到 %LOCALAPPDATA%\Programs\DSH Pet 並創建桌面快捷方式。
安裝與啓用¶
在 DSH 裏安裝插件本體，官方命令：
dsh plugin --profile desktop add @eternalnight/agent-bot
# 重開 DSH → 組建團隊
桌面寵物單獨安裝，最近發佈的寵物包見 GitHub Releases：
DSH-Pet-Setup-<version>.exe
# 安裝到 %LOCALAPPDATA%\Programs\DSH Pet，創建桌面快捷方式
想從源碼裝，README 給的是從 GitHub 克隆後再添加本目錄。注意插件以當前 dsh 進程權限運行，安裝前應先檢查源碼與許可證（項目爲 MIT，來自第三方維護者，不是 DeepSeek / 幻方官方出品）。
安裝後最小閉環：點「組建團隊」→ 填目標與陣容 → 訪談勾選並拍板 → 先審計劃再批准 → 看成員跑、交付時在驅動網關裏直接看產物。
交付門禁配置¶
quality 字段控制門禁如何審計。下面這些字段和默認值都來自 README 原文：
| 選項 | 默認 | 作用 |
|---|---|---|
autoVerify |
true |
宿主在接收完成的質檢任務前，復跑每條聲明的 verify 命令 |
autoReview |
false |
所有門禁、目標驗收與宿主命令通過後，自動完成就緒的審查任務 |
requireAcceptance |
true |
自動審查要求被審任務的每條驗收都通過 |
autoDetect |
true |
檢測生成項目自帶的 package.json 測試 / 類型檢查腳本並一起跑 |
reviewMode |
"auto" |
auto：宿主收口；human：宿主審完停在「待人工複覈」 |
commands |
["git diff --check"] |
生成項目的兜底驗證命令，不繼承插件腳本 |
commandsByProject |
{} |
按項目根目錄配置驗證命令 |
verifyTimeoutMs |
120000 |
每條驗證命令的宿主超時 |
一個例子，宿主審完後停在待人工複覈，併爲某個項目指定冒煙腳本：
quality:
autoReview: true
reviewMode: "human" # 宿主審覈通過後停在「待人工複覈」
commandsByProject:
"projects/貪喫蛇": ["node projects/貪喫蛇/smoke.mjs"]
插件自身的發佈門禁用 pnpm verify（全量套件）和 pnpm verify:web-routes（瀏覽器側契約）做校驗。README 也提醒，這套工具的適用面是並行牆鍾與獨立驗證，不是「每個任務都更便宜」：小任務通常一個智能體更划算。
適用場景與注意¶
適合的場景：
- 任務可拆成有依賴的並行工作，交付物能被獨立命令驗證
- 希望「實現者不自批、宿主復跑驗收命令」的團隊化流程
- 需要在交付現場直接看到產物運行證據（冒煙、渲染、審查結論）
需要注意：
- 插件以當前 dsh 進程權限運行。安裝前應通讀源碼，確認沒有越權的文件系統或網絡行爲；許可證是 MIT，作者信息見 package.json（署名「夢遊」，公司「夢遊科技有限公司」）。
- 日常開發應直接運行其開發版驗證工具
python desktop-pet/pet.py --check --workspace .檢查寵物主流程。這個檢查來自 README 的實跑說明（退出碼 0 纔算通過），算是一個安裝後的快速自檢手段。 quality默認autoReview: false，即審查任務默認人工確認，適合先跑通再逐步放開。- 星標、版本以 GitHub/npm 實時數據爲準，README 裏的截圖數值是單次運行記錄。
結尾¶
agent-bot 的價值在於把「多智能體協作」落到可審計的交付門禁和可點視的界面上，而不是停留在角色卡片和日誌牆上。桌面寵物是附加項。項目地址見 SkillHub 目錄頁與 GitHub 倉庫：SkillHub 目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
- 目錄頁：https://www.skillhub.cn/plugins/EternalNight996/agent-bot
- GitHub：https://github.com/EternalNight996/agent-bot
- npm：https://www.npmjs.com/package/@eternalnight/agent-bot
