dsh-plugin-roundtable 圆桌会议

把一个 DeepSeek Harness 会话，变成一场可视化、可辩论、可拍板的圆桌会议。

一句话

你只负责抛出议题。DeepSeek 成为主持人，在拓扑图上拉起一圈专家节点，用带箭头的连线组织协作，经过汇聚网关汇总，遇到分歧时把决策权交还给你。

特性

会议组织

协作与辩论

针锋相对评审

成本与状态

会议设置确认与 Skill 接入（v0.2.31）

角色预设、整场导出与摘要缓存（v0.2.35）

界面操作

安装（一分钟）

[!NOTE] 需要已安装 DeepSeek Harness（0.1.5-rc.1+；v0.2.31 起按 0.1.5-rc.1 宿主复核（对应 @deepseek-ai/* 0.1.5-rc.2 包），v0.2.1 起即适配 Cordis 4.0.2 / dsh 客户端架构，不再兼容 0.1.1-rc.2）。

最快（npm，需要已 npm login）：

dsh plugin --profile web add @huanlin/dsh-plugin-roundtable

或从源码构建（修改源码后重新 pnpm build，本地安装继续链接当前目录）：

git clone https://github.com/9931666/dsh-plugin-roundtable
cd dsh-plugin-roundtable
pnpm install
pnpm build
dsh plugin --profile web add .

装完重启 DSH（关窗口 → 重新启动）→ 刷新 Web UI → 设置 → 圆桌会议能读出默认值即可。

从 0.1.1-rc.2 / 旧版升级：宿主必须先升到 0.1.5-rc.1+；直接装 v0.2.31 覆盖旧插件，重启 DSH。历史会议记录（.roundtable/）跨大版本兼容性不保证，重要会议先导出。

npm 安装方式（等价，供脚本化）

dsh plugin --profile web add @huanlin/dsh-plugin-roundtable

安装后重启 DSH、刷新 Web UI。然后在对话里直接用自然语言开会：

开个圆桌会议，评审 v0.5 的架构方案，从性能、安全、成本三个角度各安排一位专家，最后给我一份汇总报告。

或指定平等辩论模式：

用多模型平等模式开一场辩论会，议题是「单体 vs 微服务」，每位专家可以互相反驳，最多 3 轮，最后让我拍板。

或发起红队评审：

方案已定稿，开个针锋相对评审，拉两位红队专家专门挑毛病。

使用界面

• 聊天：自然语言直接触发即可（例：「开个圆桌会议讨论 X」「让几个专家辩论 Y」「用 RoundTable 决定 Z」）。本插件不提供 /roundtable 斜杠命令——V1 规格书里列过这个入口，但从未实现，本版明确不做，也不再承诺。
• 「圆桌会议」Tab：会话视图顶部切换，实时拓扑图 + 预算进度 + 网关摘要；拖拽连线、右键改通道方向。
• 设置页：设置 → 圆桌会议，配置默认协作模式、预算默认值、专家回答限制、skill 传递方式、右栏面板显示与自建角色预设。

协作模式

选择「多模型平等」时，界面会弹出安全限制设置（最大轮数、最大 Token 量），超限即闭麦暂停。选择「针锋相对」时，charter 自动附加红队评审协议（只挑毛病、不给替代方案）。

配置

默认配置开箱即用。Profile 可覆盖：

- id: roundtable
  config:
    stateDir: .roundtable        # 会议状态目录（工作区下）
    memberProvider: spawn        # 专家节点子代理后端（spawn / fork）
    maxNodes: 8                  # 单场会议专家上限
    defaultMode: orchestrated    # 默认协作模式
    memberMaxDepth: 1            # 专家再委派深度上限
    promptSectionOrder: 116      # 使用策略提示段顺序

运行时偏好（默认模式与预算默认值、专家回答限制）在「设置 → 圆桌会议」中修改，持久化到 settings.yaml：

工具一览（模型可见协议）

使用边界与注意事项

• 一个主持人同一时间只能带一场活动会议：新开会前先 roundtable_close。
• 专家是回合制子代理：消息唤醒 → 干一整轮 → 空闲；「辩论」是消息驱动的异步轮流对话，不是实时并发。
• 子代理的最终回复不可被程序直接读取：专家必须通过 roundtable_speak 把产出写入会议记录，汇聚网关与主持人从记录读取。这是协议约束，不是 bug。
• 设置卡片没有富表单：原生 userQuestions 只有「选项列表 + 一个自由文本框」，所以"可改全部"是靠自由文本 + 回流重建实现的（写明改动 → 主持人重出草案再确认），而不是点选式表单；点选式编辑面板属后续版本。
• skill 由 DSH 原生发现：插件不做导入动作，只读 ctx.skills 清单与正文；导入 = 把 skill 文件放进官方目录。若宿主未挂载 skill 服务，卡片上的清单为空、direct 模式自动降级为"不要调用 skill 工具"，插件本身照常工作。
• 会议已选 skill 在创建时固化：会议中途无法改会议的 skill 清单；需要新资料时走 relay 路径由主持人转交。
• 人类决策依赖 userQuestions 服务（标准 Web profile 自带）；其他 profile 若无此服务，决策功能不可用，设置卡片会返回 decision="unavailable" 让主持人改用文字确认。
• 状态为文件级持久化：单 DSH 进程内串行操作；多进程同时改同一会议不保证一致，请勿在多个 DSH 实例中开同一场会。
• 删会议 = 删整个 .roundtable/<id>/ 目录：不可恢复，删除前确认。
• 第三方模型要显式指定：拉取 zai / GLM 等厂商专家时，在 UI 下拉或消息中说明 provider/model（如 zai/glm-5.2），否则可能路由失败或模型不符。

已知限制（迭代中）

v0.2.35 已修复（原「已知限制」条目）：user-actions 的清空原先是非原子的直接截断——崩溃或与 UI 追加交错时可能留下半行 JSON，而读取侧静默跳过，那条用户操作就永久消失且无人知道。现在追加与清空共用一把串行锁、都走「同目录 tmp + rename」的原子写；清空时若确实读到坏行，会通过返回值 malformed 暴露出来，主持人必须如实告知用户。

评审与反馈设计（v0.2.2）

• 闭环复审：maxReviewPass=3（首轮 + 最多 2 次复审）。每轮用户表态后主持人修订方案并 roundtable_finish_review（附修订说明）；复审只核对上一轮已认定缺陷是否修复。想突破 3 轮上限，必须用户显式同意（工具参数 user_approved_extra_pass=true），否则拒绝——防无限循环。
• 驳回必填理由：前端驳回会先要求填理由；留空会失败。理由随 user-action 回传给主持人，修订方案时可逐条回应"为何驳回"。
• 反馈隐私边界：feedback.jsonl 仅含协作模式、专家 provider/模型、轮数/Token、时间戳与用户主动填写的说明，不含任何对话/发言内容；建议把该文件加入工作区 .gitignore；设置页可随时一键清空或关闭询问。

开发

pnpm install
pnpm typecheck    # 双端 tsc：host（tsconfig.json）+ client（tsconfig.client.json）
pnpm test         # 零依赖 node --test：Node 24 原生剥离类型，直接 import src/*.ts
pnpm build        # typecheck + tsdown（lib/index.js + lib/client.js）+ 双端 .d.ts
pnpm test:inline  # 同上，但测试在同一进程内跑（不 spawn 子进程 / 不占用管道）
node scripts/generate-logos.mjs   # 替换 src/client/assets/logos/ 下图片后重跑，再 pnpm build

pnpm test 用的是 Node 标准测试运行器（每个测试文件一个子进程）。在禁止子进程管道的环境里（例如 DSH 自带沙箱）它会以 spawn EPERM 失败——那是环境限制，不是测试失败；改用 pnpm test:inline 即可（需要 Node ≥ 22.8）。

许可证

MIT