dsh-member-manager:在 DSH 上跑通部門、工號與工單派工

前言

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。面板側快速路徑如下:

  1. 重啓 DSH 後,打開 設置 →「成員管理」→「總架構」。
  2. 「新建部門」→ 用一句話描述(如「新建市場部,編制 5 人」)→「創建預覽」→「創建」。
  3. 在對話中派活: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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜