在 DeepSeek Harness(DSH)中,手動維護 Agent 的提示詞和權限白名單是構建複雜工作流的常見負擔。meow-dsh-workflow 作爲一個雙面(node + browser)DSH 插件,內置了一套可編輯的 Agent 角色庫,能將角色定義實時編譯爲系統提示詞,並通過 meow_agent_call 爲子 Agent 注入硬權限過濾。
定位與基礎信息¶
這是一個 DSH 插件,核心價值在於將「選角色 → 定協議 → 派發子 agent 協作」這一過程標準化。
- 開發者:meimiaoji-creator
- 許可證:MIT
- 核心功能:
- 內置可編輯的角色庫(如:研發負責人、頭腦風暴主持人)。
- 角色定義編譯成系統提示詞與工具白名單。
- 通過
meow_agent_call創建帶權限的子 agent。 - 角色記憶(跨會話)與公司臺賬簿(decisions/actions/need-boss 等)。
- Web 面板管理。
安裝與啓用¶
安裝時需要指定 web profile,因爲插件依賴 webServer 槽位。
dsh 插件 --profile web add github:meimiaoji-creator/meow-dsh-workflow
安裝完成後,重啓 DSH。在會話輸入框右側會出現「角色」按鈕,命令目錄也會出現 /meow-workflow-* 系列命令。
核心工作流¶
1. 角色發起與定義¶
插件安裝後會在 $DSH_HOME/meow-dsh-workflow/ 下生成 agents.json 文件,裏面預置了 10 個角色。
你可以通過以下兩種方式發起會話:
* 按鈕:點擊輸入框右側的「角色」按鈕,選擇角色並填寫目標。
* 斜槓命令:直接輸入 /meow-workflow-<角色id>,例如 /meow-workflow-lead(研發負責人)或 /meow-workflow-brainstorm(頭腦風暴主持人)。
發起時,Node 層會半組裝角色的系統提示詞,並注入一個「權限聲明」section(order 120)。
2. 子 agent 身份注入¶
主 agent 通過 meow_agent_call 工具創建子 agent。這裏有兩個關鍵點:
* 硬過濾:子 agent 的工具白名單(toolFilter.allow)是硬限制,子 agent 無法訪問未授權的工具。
* 軟約束:主 agent 的權限聲明是軟約束,主要依靠模型遵循。
示例 JSON:
{ "agentDefId": "engineer", "task": "實現 xxx,編譯測試通過後彙報" }
返回的 agentRunId 可用於續聊,確保同一個任務由同一個實例迭代,而不是另開新實例。
3. 協作配套工具¶
插件提供了以下工具用於維護協作狀態:
| 工具 | 功能 |
|---|---|
meow_memory_write / meow_memory_read |
角色記憶:綁定「項目(工作目錄)×角色」,跨會話留存。 |
meow_ledger_write / meow_ledger_read |
公司臺賬簿:記錄 decisions / actions / need-boss / status / product / market,按項目隔離。 |
meow_agent_save / meow_agent_list |
保存、新增、更新與查詢角色定義。 |
meow_child_agent_list |
查詢當前角色派發過的子 agent 能力目錄。 |
4. Web 面板與技能過濾¶
插件內置了一個自包含的單頁 Web 面板,無需外部服務:
* /meow-workflow/agents:Agent 管理頁。
* /meow-workflow/memory:角色記憶瀏覽。
* /meow-workflow/ledger:臺賬簿總覽。
此外,技能目錄(本地 + 遠程)會根據當前角色的 allowedSkills / allowedMcps 進行過濾,未授權的技能入口對子 agent 不可見。
與 meow-dsh-task 的聯動¶
在研發鏈路中,推薦將「事」與「人」的職責分開:meow-dsh-task 管「事」(任務清單、狀態追蹤、評審閉環),meow-dsh-workflow 管「人」(角色身份、工具權限、子 agent 派發)。
典型流程:
- 使用
/meow-workflow-lead發起研發負責人會話,調用meow_dsh_task_init建立任務清單。 - 逐任務調用
meow_dsh_task_claim認領,隨後使用meow_agent_call派發研發工程師實現。 - 評審專家只讀評審,若發現問題,通過
meow_dsh_task_issue_report登記並回流給原工程師(利用agentRunId續聊修復)。 - 問題解決後,使用
meow_dsh_task_issue_resolve關閉任務。 - 關鍵決策或文件通過
meow_dsh_task_checkpoint_append留痕,數據分別存儲在 Task 的臺賬和 Workflow 的記憶中。
技術約束與邊界¶
- 運行環境:僅支持
webprofile(強依賴webServer)。僅支持 Node 18+,ESM only。 - 權限隔離:插件僅寫入
$DSH_HOME/meow-dsh-workflow/下的配置與數據文件,不修改 DSH 源碼(零侵入)。 - 數據隱私:不讀取聊天記錄、會話歷史或其他插件的配置與數據;不調用 DSH 之外的第三方 API,無遙測數據外發。
- 授權模型:
- 主 agent:軟約束(靠提示詞引導)。
- 子 agent:硬過濾(靠
toolFilter.allow強制)。
結語¶
meow-dsh-workflow 是一個零侵入的協作層插件。它不改變 DSH 的核心架構,而是通過角色庫和子 agent 注入機制,讓構建複雜的多智能體對話變得結構化。如果你需要在一個會話中維護多個具有不同權限和記憶的子 Agent,這個插件提供了標準化的解決方案。