ghost616/module_agent_deepseek

DeepSeek Harness 模块智能体插件

多模块协同开发插件，内置岐伯、隶首、风后、夔、力牧、皋陶、离朱七级智能体，覆盖从项目初始化、代码归类、计划编排、批量执行、代码审查到测试验证的完整开发闭环。

本插件为 opencode 版「风后力牧」多智能体协同框架的 DeepSeek Harness（dsh）移植，基于 @deepseek-ai/cordis 插件体系实现。

安装与加载

将本插件源码放入 dsh 的 profile 目录，并在 profile 的 cordis.patch.yml 中声明加载。

1. 将本项目的 src/、package.json 与仓库根目录的 client.js 一并复制到 profile 目录下的 module-agent/ 子目录，例如 ~/.dsh/profiles/web/module-agent/。client.js 为本插件的 dsh web 界面构建产物（随源码一并提供），用于在 dsh web 对话输入框上提供「回退并重发」按钮；未复制时仅缺少该界面按钮，插件其余能力不受影响。
2. 在 profile 目录的 cordis.patch.yml（~/.dsh/profiles/web/cordis.patch.yml）中新增：

- insert:
- id: module-agent
name: './module-agent/src/index.ts'
config:
项目根目录兜底（agent 会话无 cwd 时作为 .module_agent 数据目录的解析根）
dataDir: .
启动力牧/皋陶/离朱/夔子智能体使用的 subagent provider，默认 'spawn'
subagentProvider: spawn

3. 启动 dsh web，插件自动加载。

快速开始

在 dsh 会话中直接输入以下任一指令：

启动岐伯    （项目初始化）
启动隶首    （代码归类）
启动风后力牧 （开发编排）

七级智能体

| 智能体 | 角色 | 职责 |
|--------|------|------|
| 岐伯 | 项目设置向导 | 引导生成需求设计、代码规范、模块设计 |
| 隶首 | 代码归类专家 | 扫描已有代码，自动分类文件、绑定模块、提取代码规范 |
| 风后 | 编排总指挥 | 评估变更、生成计划、调度力牧/夔/皋陶/离朱、汇总报告、Git 提交 |
| 夔 | 批量编排器 | 接受风后委托，自动逐模块启动力牧执行 + 皋陶审查，完成后汇总 |
| 力牧 | 计划执行者 | 按开发计划编写代码，自动备份文件、写入执行记录 |
| 皋陶 | 代码审查员 | 对力牧提交的代码进行质量审查，输出问题列表和审查结论 |
| 离朱 | 测试执行者 | 根据测试说明执行编译检查、单元测试、端到端测试 |

架构总览

岐伯（项目设置）与风后力牧（开发编排）互斥，同一会话只能激活其一。

┌─────────────────────────────────────────┐
│              岐伯 (qibo)                  │
│        项目设置向导                        │
│  需求设计 → 代码规范 → 模块设计            │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────────┐
│              隶首 (lishou)                    │
│        代码自归类与模块补全                     │
│  扫描项目 → 文件分类 → 绑定模块 → 更新模块设计  │
└─────────────────────────────────────────────┘

┌──────────────────────────────────────────┐
│              夔 (kui)                      │
│            批量编排                         │
│  风后委托 → 逐模块确认 → 启动力牧/皋陶       │
│  → 等待完成 → 汇总报告                      │
└──────────────────────────────────────────┘

┌──────────────────────────────────────────┐
│              风后 (fengzhou)                │
│            计划编排中枢                      │
│  初始化工件 → 检查规范 → 评估变更            │
│  → 生成计划 → 调度执行 → 汇总 → Git 提交     │
│                                            │
│            禁止直接写/改代码                  │
└──┬──────────┬────────┬─────────┐
│          │        │         │
▼          ▼        ▼         ▼
┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
│ 力牧  │ │ 夔    │ │ 皋陶  │ │ 离朱  │
│ limu │ │ kui  │ │gaotao│ │lizhu │
│      │ │      │ │      │ │      │
│计划  │ │批量  │ │代码  │ │测试  │
│执行  │ │编排  │ │审查  │ │执行  │
│      │ │      │ │      │ │      │
│可绑定│ │子代理│ │      │ │      │
│→离朱 │ │启动  │ │      │ │      │
│      │ │力牧& │ │      │ │      │
│      │ │皋陶  │ │      │ │      │
└──┬───┘ └──┬───┘ └──────┘ └──────┘
│        │
▼        ├──────────┐
┌──────┐    ▼          ▼
│ 离朱  │ ┌──────┐ ┌──────┐
│(绑定) │ │力牧* │ │皋陶* │
└──────┘ │(夔启)│ │(夔启)│
└──────┘ └──────┘

新手模式

新手模式是一个可选的需求引导机制，帮助将模糊需求逐维度明确后再进入开发。

开启 / 关闭

1. 风后绑定工作空间后自动检测开发模式
2. 若未设置，风后引导选择「新手模式」或「老手模式」
3. 用户随时可告诉风后切换模式

5 维需求评估

| 维度 | 核心问题 |
|------|---------|
| 角色与场景（Who/Where） | 操作者的身份与权限？入口页面？ |
| 动作原子性（What） | 核心操作可拆为哪些具体步骤？ |
| 数据与范围（Which） | 数据来源、字段列表、排序与分页规则？ |
| 边界与异常（What if） | 空状态、加载态、网络超时、并发冲突、极限输入？ |
| 可量化验收（Measure） | 性能指标、可观测结果、状态变化？ |

任一维度不通过则判定为需求模糊，进入引导流程。

引导流程

1. 前置探索：搜索工程已有角色/权限定义和页面/路由入口
2. 逐轮引导（每次 1-2 维度）：提问 → 用户确认 → 对照现有代码进行可行性校验
3. 可行性校验：每轮确认后查看相关模块文件，判断现有代码能否支撑该需求，不可行则立即告知冲突点
4. 汇总确认：五轮完成后汇总所有需求要点 + 可行性校验结果，用户最终确认后进入正常开发流程

工作流程

代码归类（隶首）

1. 输入"启动隶首"启动代码归类
2. 隶首递归扫描项目目录，找到未归入模块的文件
3. 提取导出符号和依赖关系，从物理边界、依赖关系、功能语义三维度归类
4. 绑定模块并写入模块定义，更新模块设计，提取代码规范

项目初始化（岐伯）

1. 输入"启动岐伯"启动项目设置向导
2. 按 Phase 1→2→3 依次引导完成需求设计、代码规范、模块设计
3. 完成后在新会话中输入"启动风后力牧"进入开发模式

开发编排（风后力牧 / 夔）

1. 工作空间初始化：创建或绑定工作空间，配置各智能体的默认模型
2. 规范检查：检查代码规范和模块设计是否存在，不存在则引导先用岐伯生成
3. 模块树建立：读取或创建模块结构，默认生成 framework 框架模块
4. 评估变更：读取模块信息 + 直接分析代码，生成开发计划
5. 执行模式选择：
- 逐模块确认：风后逐个展示计划，用户确认后启动执行
- 批量编排：多模块并行时委托夔自动管理
6. 计划确认与执行（支持并行）：
- 展示计划 → 用户确认 → 启动力牧编写代码
- 力牧自动备份原文件，写入执行记录
- 支持会话重用：同模块计划复用已有力牧会话
7. 离朱测试：
- 力牧路径：力牧完成代码后自动启动离朱测试
- 风后路径：风后独立编写测试说明，启动离朱测试
8. 皋陶审查：检查皋陶状态 → 启动代码审查 → 获取审查结果
9. 汇总报告：收集所有执行结果、测试结果和审查结论
10. Git 提交：确认后执行 git add / git commit / git push
11. 收尾清理：关闭各智能体会话，清理已完成计划

纠正与反馈

风后在生成计划前自动读取历史纠正记录，避免重复犯错。用户指正后风后先核实再记录：

1. 计划前自动读取历史纠正
2. 用户指正 → 风后核实 → 记录纠正
3. 支持按索引删除指定纠正记录

批量编排（夔）

多模块并行开发时，风后委托夔自动管理全流程：

1. 风后将多模块计划委托给夔
2. 夔逐模块确认计划 → 启动力牧执行 → 等待完成
3. 计划完成后自动启动皋陶审查
4. 全部完成后通知风后，风后获取汇总报告

知识库

风后可配置工作空间的知识库目录，作为子代理（夔/力牧/皋陶/离朱）执行时的外部参考资料。

- 风后通过 knowledge_base 工具设置知识库目录及说明
- 工作空间初始化时自动读取知识库列表
- 子代理启动后自动获得知识库信息，并可直接读取知识库目录（无需审批）

回退并重发

「回退并重发」是 dsh web 对话输入框工具栏上的一个图标按钮，帮助你在多轮对话中撤销最近一轮。

- 入口：dsh web 对话输入框工具栏上的「回退并重发」图标按钮。
- 作用：撤销最近一轮——把最后一条用户消息及其后的模型回复作废，回到此前的内容继续交流。
- 表现：
- 会新建一个干净的分支会话继续，原会话保留、可随时回看；
- 自动切换到新分支会话；
- 把最后那条用户消息回填到输入框，便于修改后重新发送；
- 当没有可回退的已完成回合等场景时，会给出提示。
- 注意：该按钮仅出现在启用了本插件的 dsh 会话（如风后工作流会话）输入框上；由分支产生的新会话沿用同一会话上下文，可继续使用。

与 opencode 版实现方案差异

下表为 opencode 版（@opencode-ai/plugin）与本 dsh 版关键机制的映射，参照 src/index.ts、src/config.ts 的实际实现：

| 机制 | opencode 版 | dsh 版（本插件） |
|------|-------------|------------------|
| 插件入口 | Plugin(ctx) => tool，函数返回工具对象 | Cordis 插件 apply(ctx, config) + inject(['tools','systemPrompt','agents','subagents','llm','sessions'])（src/index.ts） |
| 工具定义 | tool({...}) 声明工具 | defineTool + ctx.tools.register()（src/tools/index.ts 的 registerModuleAgentTools） |
| 子智能体调度 | client.session.create / promptAsync | ctx.subagents.startContinuable() / followup() |
| 身份标记 | setAgentMode 持久化到 session_modes.json | subagent persona/descriptor：module-agent:role= marker 或 module-agent: provider 命名（src/lib/session_state.ts） |
| 权限拦截 | permission.ask / tool.execute.before | tools/pre-execute 事件 + ctx.tools.guard()（src/index.ts registerGuards） |
| 系统提示词注入 | chat.system.transform | ctx.systemPrompt.section()（src/index.ts registerPromptInjection） |
| 完成通知 | session.idle 事件 | agent/pre-step 拦截 dsh 的 subagent-settled 消息并替换为框架完成通知（src/index.ts registerCompletionNotification） |
| 模型能力 | opencode sdk client | ctx.llm（ModelCatalog 抽象：listProviders / listModels，src/index.ts） |
| 数据存储 | .module_agent/.json 文件存储 | 两版一致，沿用 .module_agent/.json 文件存储 |