前言¶
DeepSeek Harness(DSH)裏成員 id 通常不可改、不可刪,名冊信息又往往散落在對話與本地文件之間。若要在多 Agent 協作裏做「誰接單、誰彙報、成本算在誰頭上」,單靠對話記憶很難穩定復現。社區插件 dsh-member-manager(維護者 SMPcosy,分類:工作流)在 DSH 名冊約束之上加一層可持久化的覆蓋層,並在此基礎上提供部門編號、員工工號、M/P 雙通道等級、工單閉環與任務圖(DAG)並行派發,以及審計與 token 成本歸因;運行時零額外 npm 依賴。目錄頁見 SkillHub,源碼與說明見 GitHub。
這是什麼¶
一句話:給 DSH 加「可運行的公司化組織」——名冊負責顯示名、崗位、職責、技能與模型覆蓋;公司化運行時負責部門、派工、驗收與並行任務圖。
- 數據落在
~/.dsh/storages/member-manager/(名冊與公司化格式文檔說明可跨版本升級)。 - 界面入口:DSH 設置 →「成員管理」面板。
- 對話側:
member_*共 16 個工具管名冊;company_*共 14 個工具管組織與工單。
與已停止維護的舊包 dsh-plugin-member-manager 同源升級:名冊工具名與 registry.json 格式保持一致,並新增 company/ 下部門、員工、工單、審計與成本數據。新舊兩包不要同時啓用,否則會重複註冊工具與路由。
核心功能¶
下面按 README 已列能力歸納,只寫資料中明確出現的行爲。
名冊覆蓋層¶
在 DSH 成員不可刪改的前提下,維護本地 registry.json:顯示名、崗位、職責、技能、模型覆蓋等。公司員工與名冊可雙向關聯;缺省情況下員工 id 即名冊 target,需要別名時可寫顯式 rosterTarget。登記策略爲「只補空字段、不覆蓋已有內容」;refresh 纔回填。
組織與員工¶
- 部門:編號如
D01…(模板可自定義)、編制、接單範圍、借調策略、職責描述;僅空部門可刪。 - 員工:工號如
E0001…、M/P 雙通道等級可並存、崗位/職責/技能/模型覆蓋、停用與調崗;v0.4 起還支持推理強度、spawn/fork 派生、子代理深度、工具黑白名單、會話策略等字段。 - M/P 雙通道:M 管理(默認
manager→ M2)、P 技術(默認staff→ P3、window→ P1);同一員工可同時擁有兩通道等級,至少保留一個。
派工閉環與工作網¶
典型鏈路:company_order(或 company_plan 提交任務圖)→ 路由與 company_assign 生成派工憑證 → 員工側 company_accept / company_report → company_review 驗收。
路由有五級回退:顯式部門、規則表、部門接單範圍、技能、兜底。attemptId 用於防串單;重派會先吊銷舊 attempt;同一員工忙碌時會返回 E_EMPLOYEE_BUSY。面板「工作網」僅在手動打開時出現,上半部爲五泳道看板(待派 / 已路由 / 執行中 / 已完成 / 異常),下半部爲管理層 → 部門 → 員工拓撲。
並行派發(DAG)¶
company_plan 一次最多提交 50 個任務,任務間用 key 聲明依賴;無依賴的同層可並行,下游在上游 done 後自動放行。內置空計劃、過大、非法任務、重複 key、錯誤引用、環等校驗錯誤碼。company_status({ group }) 可按批次彙總 done / running / pending / failed。
成本與審計¶
token 與請求可按員工、部門、工單歸因(只讀接口 GET /company/costs);audit.jsonl 爲 append-only,加載時可重放對賬。
隔離與降級¶
員工會話繼承宿主標準工具;company_* 走同步 guard。越權、缺宿主 Agent 服務、或關閉公司化開關時,會返回文檔中的錯誤碼,且不影響名冊功能。
安裝與啓用¶
當前版本 v0.5.3,許可證 MIT,要求 Node ≥ 22.19,DSH 引擎約束爲 >=0.2.1-rc.1 <0.3.0(見 package.json)。插件不支持熱重載,安裝或升級後需重啓 DSH。
官方 npm 安裝命令如下:
dsh plugin --profile desktop add dsh-member-manager@0.5.3
本地開發可用 link(將路徑換成本倉庫絕對路徑):
dsh plugin --profile desktop add link:"<本倉庫絕對路徑>"
從舊包 dsh-plugin-member-manager 升級時,倉庫提供 scripts/migrate-old-plugin.mjs(先 dry-run,再 --apply 備份並改寫 profile 登記),完成後重啓 DSH 消費遷移標記。卸載可用 dsh plugin --profile desktop remove dsh-member-manager;數據仍保留在 ~/.dsh/storages/member-manager/,可手動刪除。
安全說明:插件以當前 DSH 進程權限讀寫本地存儲與調用 Agent 能力。安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可證,確認符合你的環境策略。
典型用法¶
README 建議新手先讀倉庫內 docs/28-新手使用教程.md。面板側快速路徑如下:
- 重啓 DSH 後,打開 設置 →「成員管理」→「總架構」。
- 「新建部門」→ 用一句話描述(如「新建市場部,編制 5 人」)→「創建預覽」→「創建」。
- 在對話中派活:
company_order或company_plan→company_assign→ 對應員工company_accept/company_report→company_review。
對話裏也可直接用 member_list / member_add 管名冊,或用 company_hire / company_admin 建組織。需要把 DSH 核心成員同步進名冊時,可在面板點「同步核心成員」,或調用 member_sync(HTTP 路由拿不到 Agent 憑證,需通過工具觸發)。
常用配置默認值(節選,完整表見 README「配置項」):
| 字段 | 默認 | 說明 |
|---|---|---|
enabled / company.enabled |
true |
插件與公司化總開關 |
dataDir |
~/.dsh/storages/member-manager |
數據目錄 |
company.autoBoot |
true |
非阻塞自動 boot |
company.defaultOrderMode |
"async" |
下單模式 |
company.requireManagerReview |
true |
是否需要經理驗收 |
適用場景與注意¶
適合誰:已經在用 DSH 多成員 / 子 Agent,希望把「編制、等級、派單、驗收、並行任務依賴、成本歸因」落到本地可審計數據裏,而不是每次在對話裏口頭約定。
需要注意:
- 截圖中的
demo/*.html爲獨立 mock 演示;真實能力以 DSH 設置面板與對話工具爲準。 - 公司化關閉時,工作網會回退爲任務視圖,名冊能力仍可用。
- SkillHub 爲社區插件目錄,與 DeepSeek / 幻方無官方從屬關係;星標與版本以倉庫與 npm 發佈爲準。
結尾¶
dsh-member-manager 把 DSH 成員名冊與公司化運行時疊在同一數據目錄:名冊管「叫什麼、用什麼模型」,公司化管「編在哪個部門、接哪張單、DAG 怎麼並行、錢算在誰頭上」。若你要在工作流分類裏找可落地的組織派工插件,可從目錄頁與 README 的快速開始走通第一單。
- 目錄頁:https://www.skillhub.cn/plugins/SMPcosy/dsh-member-manager
- GitHub:https://github.com/SMPcosy/dsh-member-manager