前言¶
在 DeepSeek Harness（DSH）裏用多個 Agent 協作時，常見問題集中在三塊：誰對結果負責不清楚、執行者與驗收者混在同一條對話裏、重啓或壓縮上下文後「團隊狀態」難以續接。若只靠主會話裏輪流 @ 不同角色，任務邊界和驗收規則往往要靠人記，也很難用統一視圖看到待處理、進行中和待驗收。
@suifei/dsh-ai-team（社區目錄名 suifei/dsh-ai-team，界面稱「文淵閣」）是 maintainer suifei 發佈的工作流類 DSH 插件：裝進專用 ai-team profile 後，DSH 側欄出現三欄工作臺，用 Project、帶 owner 的 Task、Thread 與 append-only 賬本組織協作；模型下拉讀取 DSH 原生 llm 目錄，不必手填模型 id。分類爲工作流；npm 包當前版本爲 0.3.56，許可證 MIT。
下面按定位、核心能力、安裝與典型用法說明，事實均出自倉庫 README 與 package.json。
這是什麼¶
一句話：文淵閣 把「一支有分工的 AI 團隊」做成 DSH 裏可啓用的插件模式——Human 在環上定方向、守信任、處理不可撤回的決定；Agent 自行認領 Task、交接，並由「做的人以外」的成員驗收。
設計要點在 README 中歸納爲多件事同時成立：
- 成員持久：每個 Agent 有名字、角色、personality、notes、skills 和 session，DSH 重啓或上下文換代後仍是同一成員。
- 每個結果有 owner：Project 有具名 owner；Task 有唯一 accountable owner，由它推到驗收。
- 做的人不驗收：只能驗收已進入待驗收、且自己從未認領過的 Task；QA Task 僅 QA 成員能驗收。
- 房間爲 Agent 設計：成員從 inbox 拉消息；對着已變化 Thread 的回覆會因
baseSeq基線過期被退回並附變化摘要。 - 一切有記錄：Main stream、Thread、Task、收件箱均爲同一本 append-only 賬本的視圖。
- 無定時器：Agent 僅由團隊事件（消息、@、交接、驗收請求）喚醒。
新 Project 默認成員可改：墨淵（主理人）、青嵐（執行）、白硯（驗收）、玄策（編程）。
核心功能¶
三欄工作臺¶
┌ 文淵閣 ───────────────────────────────────────────────────────────┐
│ Projects │ Main stream / Board / Situation │ Thread │
│ # 我的項目 │ 主對話：一句話開工 │ 回覆 │
│ # UI 項目 │ 看板：待處理 / 進行中 / 待驗收 / 完成│ 驗收 / 退回 │
│ │ 態勢：需要你 / 團隊在做 / 等待受阻 / 最近完成 │ 任務動作 │
│ Agents │ │ │
│ 墨淵 (Lead) │ │ │
│ 白硯 (QA) │ │ │
└─────────────────┴────────────────────────────────────┴─────────────┘
- 主對話：Human 一句話進入 Main stream，Project owner 拆 Task；「團隊動態」展示推進中的 Task 與運行中成員。
- 看板：四列狀態
pending / in_progress / pending_acceptance / done（另有cancelled）；進行中卡片顯示 accountable owner 與執行者。 - 態勢：四象限——需要你、團隊在做、等待受阻、最近完成。
- 收件箱：跨 Project 聚合；頂部「待你處理 · N」；
askHuman結構化問題可直接展開提交；Agent 進度彙報留在 Thread，不佔用需 Human 決策的收件箱。 - PMO 自動：Project header 默認開啓；每 60s 按最高價值建議自動處理 Human 決策；無 active Task 時可自動喚醒 owner 續派任務；關閉後決策回到收件箱（僅插件算法執行，不接受外部腳本指揮）。
- 直接對話：點成員名打開該 Agent 的 DSH 原生 Session。
Project 與 Task¶
| 能力 | 說明 |
|---|---|
| Project | 具名 owner；獨立工作目錄；併發 runtime；每 Project 獨立賬本、Waker、SSE |
| Task | 唯一 accountable owner；狀態含 pending / in_progress / pending_acceptance / done / cancelled |
| Thread | append-only；回覆帶 baseSeq |
| 驗收 | maker 不能驗收；QA 硬門禁；qaChecklist 逐項通過 |
| 成員 | 持久 session；運行配方 standard / ptc / minimal / cordis |
| 模型 | Provider / Model 下拉讀取 DSH llm 目錄 |
| 技能 | DSH skill 工具加載；內置 Microsoft SkillOpt 7 個 skillopt_* 工具 |
| 重啓恢復 | team/startup 恢復未完成 Task |
每個 Project 需要獨立工作目錄：首次進入默認 Project 會提示「這個項目還沒有工作目錄」，點「選擇目錄」或填路徑；成員只在該目錄內執行 Task。
架構與 API（概覽）¶
- Host：路由、命令、SSE、Waker、成員 runtime、權限守衛。
- ProjectRuntime：一 Project 一 ledger + TeamService。
- Ledger：JSONL + SHA-256 hash chain + checkpoint。
- MemberRuntime：真實 DSH Agent session（
agents.create/followup），非模擬執行。 - Waker：僅從賬本 append 或 HTTP 命令結果計劃喚醒，無 heartbeat。
常用 HTTP 端點：
GET /ai-team/api/health
GET /ai-team/api/bootstrap?project=<id>
GET /ai-team/api/projects/<id>/board
GET /ai-team/api/projects/<id>/quadrants
GET /ai-team/api/projects/<id>/events # SSE
POST /ai-team/api/projects/<id>/commands
命令覆蓋 task.create/claim/submit/accept/request_changes/...、member.*、project.create/activate、inbox.ack 等。
安裝與啓用¶
插件按需裝在專用 profile，不建議與普通 desktop/web profile 混用未評估的權限策略。README 寫明：成員以 danger-full-access 運行，profile patch 會把 sandbox / approval / permission 固定爲 danger-full-access / never；只應裝在可信機器與可信 Workspace。安裝前宜自行查看源碼與 MIT 許可證。
1. 建專用 profile¶
dsh --profile ai-team --from-default-profile web --dump-config
2. 從 npm 安裝¶
dsh plugin --profile ai-team add @suifei/dsh-ai-team
本地 checkout 路徑安裝（示例來自 README）：
dsh plugin --profile ai-team add E:/works/dsh-ai-team
3. 啓動並進入文淵閣¶
dsh --profile ai-team --no-open --port 33271
打開終端輸出的 URL，在側欄點 文淵閣，再爲 Project 設置工作目錄。
典型用法¶
- 啓動
ai-teamprofile 並打開文淵閣側欄。 - 爲當前 Project 選擇或填寫工作目錄（新建項目時同樣要求）。
- 在主對話用一句話描述目標；Project owner（默認墨淵）拆 Task 並派工。
- 在看板或態勢中跟蹤
進行中/待驗收；在 Thread 中回覆、驗收或退回；需你拍板的項出現在收件箱。 - 需要改分工或模型時，在成員「⋯」資料中調整職責、personality、provider/model、skills、運行配方等。
技能文件搜索路徑包括 <DSH_HOME>/skills、<cwd>/.dsh/skills、<cwd>/.agents/skills；無需單獨安裝 dsh-skillopt 即可使用內置 SkillOpt 集成。
適用場景與注意¶
適合：希望在 DSH 內用結構化 Task / 看板 / 獨立驗收跑多 Agent 工作流，且接受 Human 只在方向、信任與不可撤回決定上介入的單機、單 Human 場景。
當前邊界（README 明示）：
- 單機、單 Human；不支持多 Human 共享 Team。
- desktop profile 被插件 patch 固定爲高權限；務必在可信環境使用。
- 倉庫
node --test報告 82 項通過；文檔 QA 與多輪 E2E 證據在維護者本機.ptc/rounds/，不隨 npm 發佈。
DSH 生態奉行「一切皆插件」；社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
文淵閣把多 Agent 協作收攏到「有 owner 的 Task + 做的人不驗收 + append-only 賬本 + 與 DSH llm 目錄聯動的成員配置」，適合需要可恢復、可審計團隊狀態的工作流實驗與日常項目推進。目錄頁與源碼見下方鏈接。
- 社區目錄：https://www.skillhub.cn/plugins/suifei/dsh-ai-team
- GitHub：https://github.com/suifei/dsh-ai-team
- npm：
@suifei/dsh-ai-team
