前言¶
DeepSeek Harness(DSH)的 Agent Teams 適合臨時項目協作,但每次切換會話就是一支新團隊:成員散失、崗位要重新交代、任務靠口頭傳達、員工之間互不瞭解。要把它變成一個持續運行、可管理、可驗收的團隊,需要一套持久化的名冊、任務賬本和羣聊機制。DSH Staff 就是爲了解決這個問題。
它是什麼¶
DSH Staff 是一個工作流類插件,維護者 Coolwyd。它把 DSH 的 Agent Teams 從「臨時項目組」變成「有編制的員工」:員工有名字、崗位、職責邊界、固定工位、任務賬本,能拉羣對話、互相質詢,輸入框上方還有一條常駐狀態帶。
安裝與啓用¶
通過官方安裝命令添加:
dsh plugin add github:Coolwyd/dsh-staff
安裝後插件會自動注入到 DSH 的對話輸入框上方,顯示員工狀態帶,並掛載「員工」入口按鈕與全屏員工中心。
核心功能¶
員工管理¶
staff_hire:招人/調崗。同名再調即更新,保留歷史任務;member綁定工位;template可選崗位模板。staff_rebuild:生成員工交接單:還原成spawn_teammate參數,用於新會話重建。staff_list:花名冊,含各狀態任務計數。staff_show:單人檔案 + 全部任務明細。staff_fire:離職(軟刪除,檔案與歷史保留)。
任務派發¶
staff_assign:派一條任務,支持priority(high/normal/low)與due。staff_task_update:狀態流轉:todo / doing / done / blocked。staff_dispatch:批量把待辦投給員工並喚醒,支持dryRun預覽。staff_autopilot:自動駕駛開關:每分鐘檢查待辦並喚醒一名員工,默認關閉,帶每日上限。staff_dashboard:全景看板:員工、待辦分佈、逾期與高優、羣、阻塞項。
羣聊¶
group_create:建羣,2–8 名在冊員工。group_update:羣改名、增刪成員(數量仍限 2–8)。group_send:羣發言,點名或全員;投遞時附帶最近 6 條羣歷史。group_read:讀羣消息流。group_list:羣列表。group_delete:解散羣(confirm必須顯式傳 true,防誤刪)。
維護¶
staff_export:導出 JSON 備份(可回灌)或 Markdown 報告。staff_doctor:數據自檢(三級輸出):problems必須修(存儲損壞、孤兒任務、序號重複倒序)、warnings可繼續使用(備份恢復、離職成員、序號斷檔)、infos現場信息。
崗位模板¶
提供 6 種崗位模板:secretary(首席執行祕書)、researcher(研究助理)、engineer(工程師)、tester(測試負責人)、product(產品經理)、ops(運維/SRE)。傳 template 可省略 post 與 duty;顯式傳入時優先於模板。
DSH 內界面¶
三處掛載,全部是 DSH 界面的一部分,不引入獨立站點:
- 側欄底部:「員工」入口按鈕,任何時候都能打開。
- 輸入框上方:狀態帶
員工 N · 待辦 M · 羣 K ▸,點擊打開。 - 全屏面板:員工中心:左側通訊錄按「羣聊 → 在線員工 → 待重建工位 → 未綁定工位」分組,右側員工詳情與羣列表;ESC 關閉。
樣式全部使用 DSH 主題 token(--dsw-alias-*),明暗主題自適應。數據 15 秒輪詢一次。
工位有三態,界面用狀態點顏色區分:
| 狀態 | 判定 | 界面 | 處置 |
|---|---|---|---|
online |
teammate 在任一在線會話裏 | 綠點·在線待命 | 直接投遞 |
missing |
名冊綁了名,但所有會話都找不到它(會話結束 teammate 就消失) | 橙點·工位缺失 | 發消息 / 點 ↑ 自動重建,或檔案頁「重建工位並上線」 |
unbound |
沒有綁定 teammate | 灰點·未綁定工位 | 先 staff_hire(member=...) 綁定 |
數據位置¶
~/.dsh/staff/roster.json:員工檔案與任務賬本。~/.dsh/staff/groups.json:羣與消息流。~/.dsh/staff/exports/:staff_export導出的備份與報告。
寫操作進程內串行化,併發調用不會互相覆蓋。
典型用法¶
建一個員工並派發任務:
1. staff_hire member=alice template=researcher
2. staff_assign task=調研 Q1 市場趨勢 priority=high due=2026-11-01
3. staff_dispatch dryRun=true
4. staff_dispatch
員工在會話中完成並彙報:
5. staff_task_update status=done
6. send_message "調研完成,結果見附件"
查看全景:
7. staff_dashboard
建羣討論:
1. group_create members=alice,bob charlie
2. group_send "今天下午三點開會討論 Q1"
3. group_send "請 alice 先做 PPT"
4. group_read
架構邊界¶
- 真·常駐員工(跨會話在職):插件層做不到。員工工位是某 Lead 會話的子會話,換會話即失效。做成 root 級員工需改會話模型。
- 後臺無人值守自動幹活:做了但默認關閉,
staff_autopilot每分鐘最多喚醒 1 人,有每日上限,內存態重啓即停。自動喚醒 = 自動計費,必須人顯式開啓。 - 側欄完整 UI 面板:只做輕量狀態帶。完整面板需 Typert Remote + client 模塊,且認證態下無法在本地驗證渲染。
已知限制¶
- 員工身份綁會話:teammate 只在當前會話的 Team 裏活着;名冊持久,工位不持久,用
staff_rebuild過渡。 - 羣歷史是快照:投遞時附帶最近 6 條,不是實時訂閱。
- 羣發即計費:每次羣發真實喚醒每個成員,2 人 = 2 次模型運行。
- UI 渲染未驗證:組件已掛載到
conversation.input.dock,但本環境無瀏覽器認證態,需人工刷新確認。 - 自動駕駛需人開:默認關閉,內存態,重啓失效。
適用場景與注意¶
適合需要把 Agent Teams 變成持續運行、可管理、可驗收的團隊,並希望用命令行與界面結合來管理員工、任務與羣聊的場景。
注意:插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。數據保存在 ~/.dsh/staff/,導出備份與報告後可回灌。
短結尾¶
DSH Staff 通過持久化名冊、任務賬本、羣聊與內嵌界面,把 Agent Teams 變成可管理、可對話、可驗收的員工團隊。更多細節與更新見:GitHub。