方案评审团 lucy971326/dsh-ai-solution-council

DSH AI 方案团

一个独立的 DeepSeek Harness 插件：让多个同职责、上下文隔离的 Agent 并行调查当前问题，再由主流程串行完成交叉评审、证据核验和最终裁判。

它适合用于架构设计、代码库调查、实现方案比较和高风险技术判断，目标是减少单个 Agent 被自身上下文和第一判断带偏的情况。

工作方式

主 Agent 调用 solution_council │ ▼ 4 个同职责 Agent 并行探索（各自继承当前 Agent 模式的工具能力，彼此不共享上下文） │ ▼ 串行交叉评审：比较共识、分歧和证据强弱 │ ▼ 串行证据核验：回到代码库检查关键结论 │ ▼ 主流程最终裁判：给出建议、理由和未解决风险

并行阶段不是让不同岗位各说一遍，而是让多个同职责 Agent 独立回答同一个问题。不同职责的评审者按阶段串行运行，避免评审者之间互相污染上下文。

每个调查 Agent 可以使用当前主 Agent 模式提供的工具探索代码库。方案团工具本身会从子 Agent 中屏蔽，防止递归启动方案团；不会硬编码一套与极简、常规、创造模式不匹配的工具白名单。

Web UI

安装 Web profile 后，模型调用 solution_council 会在对话区生成一个折叠的工具卡片：

- 卡片显示任务、当前阶段和整体进度；
- 点击卡片进入全屏工作台；
- 4 个并行 Agent 并排展示；
- 调查报告、交叉评审、证据核验和最终方案都支持 Markdown 展示与内容折叠；
- 可在工作台中取消运行，并返回对话区；
- 使用 DSH 公共 UI 主题 Token，跟随浅色/深色主题；
- UI 通过 Remote 读取 Host 状态，不新增聊天消息。

客户端只支持 Web。Headless 模式仍可使用模型工具和 Host 服务，但不提供页面。

安装

使用 npm 安装：

dsh plugin --profile web add dsh-ai-solution-council

开发

pnpm install
pnpm test
pnpm build

源码调试配置在 cordis.yml，其中的 file:///C:/... 路径需要替换成你本机的绝对路径：

dsh --profile web --patch .\cordis.yml --port 0

注意：--patch 主要用于 Host 调试；要验证 Web Client 扫描、Client Bundle 和 UI，必须通过 dsh plugin --profile web add 安装组合包。

配置

组合包默认使用 cordis.patch.yml：

- insert:
- id: solution-council
name: dsh-ai-solution-council
config:
explorerCount: 4
providerName: spawn

当前配置项：

| 配置项 | 默认值 | 说明 |
| explorerCount | 4 | 并行同职责探索 Agent 数量，当前有效范围为 2–4 |
| providerName | spawn | DSH profile 中注册的子 Agent provider 名称 |
| maxTaskBytes | 16384 | 单个任务允许的最大 UTF-8 字节数 |
| maxRunsPerSession | 32 | 每个会话保留的最大运行记录数 |

数据与生命周期

- 运行记录保存在独立的 solution_council Storage Domain 中，按当前 Session 隔离；
- 不修改原始 Session.events，也不把 UI 操作写成聊天消息；
- Host、模型工具和 Web UI 读取同一份运行状态；
- 服务重启后，无法恢复进程内的子 Agent，因此未完成的 queued/running Run 会被标记为 failed，并提示重新执行；
- 已完成运行会按 maxRunsPerSession 保留，超出部分淘汰最旧记录。

Remote 暴露的主要读取/控制面：

- list(session)：列出当前会话的方案团运行记录；
- get(session, callId)：读取某次工具调用对应的运行详情；
- cancel(session, callId)：取消仍在运行的方案团。

包结构

src/
├── index.ts # Host 入口 ├── solution-council.ts # 编排、工具、独立存储 ├── remote-service.ts # Host Remote Service ├── remote.ts # Host/Client Remote 描述 ├── types.ts # Host、Remote、Client 共用数据模型 └── client/ ├── index.ts # Web Client 入口 ├── CouncilToolRow.tsx # 对话区折叠工具卡片 ├── CouncilWorkbench.tsx # 全屏工作台 ├── MarkdownDisclosure.tsx ├── controller.ts ├── locales.ts └── solution-council.module.css

构建产物位于 lib/。独立包发布或从 GitHub 安装时必须包含构建产物，不能只提交 src/。
发布到 npm 时由作者侧的 prepare 构建；消费者从 npm 安装已构建的包，不执行插件构建脚本。

已知边界

- 并行 Agent 的质量仍取决于当前模型、Agent preset 和可用工具；方案团通过隔离和阶段审查降低偏差，不保证每份报告都正确；
- 并行调查阶段要求 Agent 不修改代码，但实际工具能力仍由当前 Agent 模式决定；
- 跨标签页、跨进程的实时冲突解决不在 v1 范围内；
- 方案团是当前 Session 的能力，不是全局知识库。
许可证

本项目使用 MIT 许可证，详见 LICENSE。