在 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,这个插件提供了标准化的解决方案。