dsh-plugin-roundtable 圆桌会议
把一次 DeepSeek Harness 会话，变成一场可视化、可辩论、可拍板的圆桌会议。
本仓来源：RoundTable 最初由 @huanlin（9931666） 开源（MIT），
原作者已停止维护；本仓自 v0.2.35 基线接手继续开发，独立维护、不回合并上游。
详见 来源与致谢。
💡 痛点 · 答案
| 一个人的会话 | 圆桌的答案 |
|---|
| 一个模型既当选手又当裁判，自己审自己的方案 | 主持人 + 多席专家分工：DeepSeek 只做主持与汇总，方案由别的席位来挑 |
| 长上下文里堆十份报告，越读越糊 | 汇聚网关把发言确定性归并，主持人一键拉摘要，上下文不被淹没 |
| 专家结论无从复核，说得像真的 | 证据分级 + 独立验证席：结论必须给位置/命令/原文，给不出就标「未验证」 |
| 「讨论完了，到底同不同意」没有落点 | 人类决策卡片：分歧处会议暂停，你选 A/B 或自定义，决策权始终在你 |
| 想反驳自己的方案却不知从何下手 | 针锋相对评审：定稿后拉红队专挑毛病，逐条「支持/驳回」并留修订对照 |
✨ 功能一览
会议组织
- 🪑 左主持 + 右圆桌拓扑 — 会话视图新增「圆桌会议」Tab：主持人锚点、环形专家节点、中央汇聚网关，连线带方向箭头，全程可视化
- 💬 群聊视图（v0.2.47） — 同一 Tab 内一键切换「拓扑 / 群聊」：会议发言以 QQ 群聊形态展示（气泡、品牌头像、连续同人合并、轮次分隔），底部输入框可以主持人身份直接说话（落盘标
source: user，主持人下轮能分辨是谁说的）；拓扑视图与右栏面板完全不受影响
- ⌨️ 空状态就地开局（v0.2.48） — 「还没有圆桌会议」那一屏也有同一个输入框：说一句议题，主持人当场拉起专家队伍（等价于
/roundtable <议题>），不必再回聊天窗口绕一圈
- 🛡️ 审查修复（v0.2.49） — 群聊输入条补上 IME 组合态守卫（中文选词按 Enter 不再误发半截拼音）；群聊发言唤醒主持人并如实回报是否送达；
source: user 真正进入主持人可读面（status / 汇聚网关 / 导出）；截断提示改由 host 判定
- 👁️ 模式状态可见（v0.2.50） — 讨论模式徽章同时出现在空状态那一屏与有会议时的头部（此前只有后者）：「在这一屏打了个字」会置上一条切走 Tab 也不关的模式，而它此前完全不可见；徽章抽成单一共享组件，两处说法不会漂移，子标签改为描述后果（
切走 tab 仍开启）而非来源
- 🎯 圆桌讨论模式（e 功能） — 两个入口同一个状态：打开「圆桌会议」Tab 或敲
/roundtable，本会话之后发的每条消息都按圆桌会议处理；/roundtable off 或切走 Tab 关闭
- 🧩 持久子代理专家 — 每位专家都是独立可续聊的子代理，带《全局协作总纲》（目标 / 角色边界 / 协作协议 / 安全红线）入会
- 🔗 可视化连线 — 悬停拖拽「＋」拉线，右键切换单向/双向或删除，双向通道两端各有一个箭头
- 🏷️ 厂商 Logo 头像 — DeepSeek / GLM / z.ai / Gemini / Claude / Kimi / MiniMax / 千问；未收录厂商回退为「品牌色块 + 缩写」
- 💡 状态呼吸灯 — 纯 CSS 状态反馈，不消耗任何 Token
协作与辩论
- 🎛️ 三种协作模式 —
主持人统筹 一切经主持人转达；多模型平等 专家直达互辩、超预算自动闭麦；针锋相对 只对定稿方案挑毛病
- 🧮 调度面（v0.2.42） — 每轮提交
plan[{id, task, owner, depends_on}]：空依赖=同波并行，非空=1+max 波次；环/悬挂/未知席一律拒绝，先校验后推进（非法计划不烧轮）
- 🔍 计划 vs 实际对账 —
round_signals 报未派席、未派工作项与越界转派，计划定了没跟到底看得见
- 🧠 代理思考 — 黑盒干活模型（视频/图片生成等）也有透明思考链：导演模型先写
[DeepSeek 代理思考] 再翻译参数
- 🗳️ 人类决策卡片 — 会议暂停、你来拍板，选项来自专家实发输出而非模型臆造
针锋相对评审（红队）
- 🎯 评审全流程 — 定稿方案 → 记录「问题 + 方案」→ 拉红队（只挑毛病、不给替代方案）→ 收集观点 → Web 评审弹窗自动打开
- ☑️ 逐条三态表态 — 每观点独立卡片，可「支持 / 驳回 / 取消」；驳回必填理由，理由回流给主持人修订对照
- 🔬 观点证据分级 — 代码/bug 类附可复现步骤，设计类缺陷附论证链；观点卡按类型显示证据徽标
- 🔁 闭环复审（最多 3 轮） — 修订后再复审，只核对上一轮认定缺陷是否修复；超上限须用户显式批准，防无限循环
- 📄 Markdown 导出 — 全部轮次/观点/表态/驳回理由/修订对照导出为交付物，可留存或贴进 issue
成本与状态
- 🧯 预算熔断 — 轮数与 Token 双预算，超限自动「闭麦」，可补预算继续或汇总收场
- 📉 诚实的 Token 口径 — 显示的是发言文本量（中文约 0.6 token/字），不含 system prompt、persona、历史与工具开销，不等于账单
- 🔒 匿名反馈回路 — 结束后 1 键有用度 + 可选一句「最卡的点」，只记模式/模型/轮数/Token/时间戳，绝不记对话；可随时查看、清空或关闭
- 🗃️ 知识库摘要缓存 — 主持人读过的 KB 文件按
path + size + mtimeMs 记摘要，status 标 [HIT]/[STALE]，省掉「主持人读一遍 + 专家读一遍」的双倍消耗
- 💾 持久化 — 会议落在
<工作区>/.roundtable/<meetingId>/（meeting / transcript / review / user-actions / kb-digest），重启可恢复
设置与预设
- 🧑🤝🧑 自建角色预设 — 设置 → 圆桌会议 → 角色预设，自己建模板；插件不预置任何内置角色
- 🎚️ 模型 · 思考强度 — 点「编辑」表单就长在该条下方，一次改完名称/角色/厂商+模型/思考强度；档位名逐字取自宿主，不自造枚举
- ⚙️ 开会前先确认 — 每次开会（哪怕只有一位专家）先弹设置卡片：专家名单 + 模式 + 预算 + 知识库 + 选中 skill，确认后才创建
- 🧰 Skill 接入 — 清单来自 DSH 原生
ctx.skills（目录发现，非插件自造）；可选「主持人中转」（省 token）或「专家直接调用」
🚀 快速开始
需要：DeepSeek Harness 0.1.5-rc.1+（v0.2.1 起适配 Cordis 4.0.2 / dsh 客户端架构，不再兼容 0.1.1-rc.2）。
# 从源码装（推荐：本仓不发 npm）
git clone https://github.com/Fishsb/dsh-plugin-roundtable
cd dsh-plugin-roundtable
pnpm install && pnpm build
dsh plugin --profile web add .
装完重启 DSH → 刷新 Web UI → 设置 → 圆桌会议 能读出默认值即可。
然后在对话里直接用自然语言开会：
开个圆桌会议，评审 v0.5 的架构方案，从性能、安全、成本三个角度各安排一位专家，最后给我一份汇总报告。
用多模型平等模式开一场辩论会，议题是「单体 vs 微服务」，每位专家可以互相反驳，最多 3 轮，最后让我拍板。
方案已定稿，开个针锋相对评审，拉两位红队专家专门挑毛病。
或者直接切到讨论模式（两个入口等价）：
/roundtable # 开启讨论模式：本会话后续消息都按圆桌会议处理
/roundtable 评审 v0.5 的架构方案，重点看性能与安全 # 开启并立刻把议题交给主持人
/roundtable off # 关闭
# 另一个入口：直接在 Web UI 里点开「圆桌会议」Tab —— 打开即开启，切走即关闭
从 0.1.1-rc.2 / 旧版升级：宿主先升到 0.1.5-rc.1+，再装本插件覆盖旧版并重启。历史会议（.roundtable/）跨大版本兼容性不保证，重要会议先导出。
🧑🤝🧑 专家团：作者实际在用的 28 席
本仓附带作者长期使用后收敛的完整专家名单，见 EXPERTS.md（含每席完整角色定义与分组说明）与 experts.yaml（可直接粘进 settings.yaml）。
| 分组 | 席位数 | 这一组解决什么 |
|---|
| 澄清与立项 | 3 | 先把「要做什么、值不值得做」问清楚 |
| 方案成型 | 5 | 摆成可比矩阵、做减法、找现成的、再收敛 |
| 攻防与质疑 | 3 | 对定稿方案找真问题：结构性隐患、未言明前提、极端输入 |
| 工程专项 | 9 | 结构 / 落地 / 性能 / 安全 / 数据 / 依赖 / 维护 / 可观测 / 技术债 |
| 验证与取证 | 5 | 判据先立、缺陷能复现、事实有出处、与基线对照 |
| 视角与交付 | 3 | 换到使用者一侧看，排出时间线，组织成交付文档 |
用法：把 experts.yaml 的内容粘进 ~/.dsh/settings.yaml 的 roundtable.rolePresets 下，重启 DSH 即出现在设置页；开会时主持人用 roundtable_list_presets 读取并按需上席。也可以只挑几席——删掉不需要的条目即可。
EXPERTS.md 与 experts.yaml 由 scripts/export-experts.mjs 从磁盘真相直出，禁止手写；漂移检查 node scripts/export-experts.mjs --check。
🔄 工作原理
flowchart LR
U[你的议题] --> P["roundtable_plan_meeting<br/>设置卡片·等你确认"]
P --> C[roundtable_create<br/>你成为主持人]
C --> N["专家节点 ×N<br/>子代理 + 总纲 persona"]
N <-->|发言| T[("会议记录<br/>transcript.jsonl")]
N -->|"speak"| G[汇聚网关<br/>确定性归并]
G -->|summarize| C
C -->|分歧| D[人类决策卡片]
D --> U
C --> E["export_meeting<br/>export.md"]
C -.->|"定稿后"| R["针锋相对<br/>红队只挑毛病"]
R --> V[评审弹窗<br/>逐条支持/驳回]
V -.-> C
单一出口原则（v0.2.36 起）：专家的正文不能直接回传主会话——回传通道在插件层被物理封死，产出只能经 roundtable_speak 写入会议记录，主持人再从记录汇总。这不是限制，而是把「十份报告淹掉主会话」变成「账本 + 一次汇总」。
🎛️ 协作模式
| 主持人统筹 orchestrated | 多模型平等 egalitarian | 针锋相对 redteam |
|---|
| 主持人角色 | 决定谁发言、转达观点、语义仲裁 | 退居发牌 + 计时 + 裁判 | 记录议题与方案、收集红队观点 |
| 专家之间 | 都经由主持人 | 直达消息互相辩论 | 都经由主持人 |
| 连线含义 | 协作关系声明 | 允许互发消息的通道 | 协作关系声明 |
| 终止方式 | 主持人判断完成 | 轮数 / Token 预算超限自动闭麦 | 主持人判断完成 |
| 隔离性 | 信息隔离（互不知晓） | 公开名册（可广播） | 信息隔离 |
选择「多模型平等」时界面会要求填安全限制（最大轮数、最大 Token），超限即闭麦暂停。选择「针锋相对」时总纲自动附加红队评审协议（只挑毛病、不给替代方案）。
⚙️ 配置
Profile 可覆盖（默认开箱即用）：
- id: roundtable
name: 'dsh-plugin-roundtable'
config:
stateDir: .roundtable # 会议状态目录（工作区下）
memberProvider: spawn # 专家节点子代理后端（spawn / fork）
maxNodes: 8 # 单场会议专家上限
defaultMode: orchestrated # 默认协作模式
memberMaxDepth: 1 # 专家再委派深度上限
promptSectionOrder: 116 # 使用策略提示段顺序
运行时偏好在「设置 → 圆桌会议」中修改，持久化到 settings.yaml：
| 偏好 | 默认 | 说明 |
|---|
| 默认协作模式 | orchestrated | 主持人统筹 / 多模型平等 / 针锋相对 |
| 最大轮数 / 最大 Token | 10 / 200000 | 会议预算，超限闭麦 |
| 互通开关 | 开 | 只看当前对话会议 / 看全部 |
| 专家每轮输出上限（token） | 0（不限制） | 专家组模型 max_tokens |
| 专家每轮最多意见数 | 0（不限制） | 专家 prompt 约束 |
| 反馈开关 | 开 | 结束后是否询问 1 键有用度 |
| skill 传递方式 | 主持人中转 relay | 主持人读后转交 / 专家自行用 skill 工具 |
| 右栏面板显示 | 全开 | 专家 / 分工 / 知识库 / 已选 skill / 发言记录 / 分针记录 / 产出文件 |
🧰 工具一览（模型可见协议，23 个）
| 工具 | 作用 |
|---|
roundtable_plan_meeting | 开会第一步：出设置卡片（专家 + 全部参数 + skill），阻塞等确认；返回 approved / revise。不创建会议 |
roundtable_create | 建会，调用者成为主持人（支持 kb_path / skills / skill_delivery） |
roundtable_add_node / remove_node | 增删专家（可续聊子代理 + 总纲 persona）；add_node 可带 preset / reasoning_effort |
roundtable_list_presets | 读用户自建角色预设（id/name/role/路由/档位），支持子串过滤 |
roundtable_connect / disconnect | 建 / 删连线（单向 / 双向） |
roundtable_next_round | 推进轮次 + 提交本轮调度计划（plan[{id,task,owner,depends_on}]）；≥2 席时计划必填 |
roundtable_speak | 发言写入会议记录（可定向，不填交网关） |
roundtable_send_message | 直达消息（平等模式专家互辩；可带 work_item 供对账） |
roundtable_summarize | 拉取汇聚网关结构化摘要 |
roundtable_status | 会议全景（节点活动、连线、预算、待决策、待办行为、知识库缓存命中、talent_pool、round_signals） |
roundtable_request_decision | 暂停会议、请求人类决策 |
roundtable_actions_clear | 清空用户待办行为记录；返回 {cleared, malformed}，malformed > 0 表示有操作因坏行丢失、必须告知用户 |
roundtable_set_budget | 调整预算 / 闭麦恢复 |
roundtable_proxy_think | 代理思考：为黑盒模型做思考铺垫 + 参数翻译 |
roundtable_start_review | 发起针锋相对评审（首轮 reviewPass=1；再调=复审，上限 3，超限须 user_approved_extra_pass=true） |
roundtable_collect_review | 收集红队发言为观点（LLM 拆分含证据分级，失败本地兜底），打开评审弹窗 |
roundtable_finish_review | 结束本轮评审（→ done），附修订说明 |
roundtable_export_review | 导出完整评审记录为 Markdown |
|
🧭 界面
两个入口，同一个「圆桌讨论模式」（状态按会话记，打开聊天框输入 /roundtable 即可见开关状态）：
- 聊天 — 自然语言触发即可；模式开启后，本会话的每条消息都自动按圆桌会议处理
/roundtable 斜杠命令 — 敲命令即开启讨论模式；/roundtable off 关闭；/roundtable 议题… 开启并把议题直接交给主持人- 「圆桌会议」Tab — 打开该 Tab 等于开启讨论模式（切走即关），另含两个视图（顶部切换条）：
- 拓扑（默认）— 实时拓扑图 + 调度面板（波次/对账/缺口/候选池）+ 预算进度 + 网关摘要 + 发言时间轴 + 模式徽章
- 群聊（v0.2.47）— QQ 群聊形态的发言流（气泡 / 品牌头像 / 连续同人合并 / 日期与轮次分隔）+ 底部输入框（Enter 发送、Shift+Enter 换行），可以主持人身份直接往会议里说一句；说出的这句会唤醒主持人（落盘 ≠ 送达，没能送达时界面如实提示）
- 设置页 — 默认模式、预算默认值、专家回答限制、skill 传递方式、右栏面板显示、自建角色预设
视图切换状态不落盘（与讨论模式同理）：这是"此刻在看什么"的交互意图，不是配置。
群聊只显示已有发言；原话完整呈现（快照轮询里那份 20 条 / 90 字截断的是侧栏时间轴，不是群聊）。
输入框发出的消息落成 nodeKey=captain + source=user 的一条发言，不计入会议预算（用户发言不消耗专家轮次与 token）；该标记会随 status / 汇聚网关 / 导出一起送到主持人（v0.2.49），使它能分辨"用户亲口说的"与"我自己说的"。
输入框的 Enter 发送带 IME 组合态守卫（v0.2.49）：中文/日文输入法选词时按 Enter 不会误发半截内容。
还没有会议时，那一屏的输入框用的是同一个组件，但语义不同：它把议题交给主持人开一场会议（等价 /roundtable <议题>），而不是往某个会议里发言。
模式的有效值 = tab 来源 ∨ 命令来源，两者互不覆盖：切走 Tab 只撤自己那一份，命令开的模式仍生效。
状态是进程内存储，重启 DSH 或热重载插件后清零 —— 重新打开 Tab 或再敲一次 /roundtable 即可。
⚠️ 使用边界与注意事项
- 一个主持人同一时间只能带一场活动会议：新开会前先
roundtable_close
- 专家是回合制子代理：消息唤醒 → 干一整轮 → 空闲；「辩论」是消息驱动的异步轮流对话，不是实时并发
- 子代理的最终回复不可被程序直接读取：专家必须经
roundtable_speak 写入记录——这是协议约束，不是 bug
- 设置卡片没有富表单：原生
userQuestions 只有「选项列表 + 一个自由文本框」，所以「可改全部」是靠自由文本 + 回流重建实现（写明改动 → 主持人重出草案再确认）
- skill 由 DSH 原生发现：插件不做导入动作，只读
ctx.skills；导入 = 把 skill 文件放进官方目录。宿主未挂载 skill 服务时清单为空，direct 模式自动降级
- 会议已选 skill 在创建时固化：中途无法改会议 skill 清单，需要新资料时走
relay 路径
- 人类决策依赖
userQuestions 服务：缺失时卡片返回 decision="unavailable"，主持人改用文字确认
- 状态为文件级持久化：单 DSH 进程内串行操作；多进程同时改同一会议不保证一致
- 讨论模式状态不落盘：重启 DSH 或热重载插件后回到「关」，重新打开「圆桌会议」Tab 或再敲一次
/roundtable 即可恢复
- 删会议 = 删整个
.roundtable/<id>/ 目录：不可恢复
- 群聊里的发言不可编辑/撤回：
transcript.jsonl 是 append-only 追加日志，本版不做改写语义（撤销需求请走会议导出后的文本处理）
- 群聊数据源是会议发言，不是真实 QQ 群：
ChatView 是纯展示组件、取数在父级，将来接真 QQ（OneBot/NapCat 一类协议端）时界面层不需返工
- 第三方模型要显式指定：拉 zai / GLM 等厂商专家时写明 provider/model（如
zai/glm-5.2），否则可能路由失败
已知限制
| 限制 | 影响 | 现状 |
|---|
| 跨 Session 越权 | RPC 通道不暴露调用者 session 身份，同进程内其他会话知道会议 id 理论上即可调用其读写端点。现有防线是「归属校验 + 状态机校验」，不是身份校验 | 本版接受现状：单人 / 单工作区无实际影响。多人共用同一实例时请视为同一信任域 |
| Host 侧并发写竞态 | 插件生命周期事件与会议文件写并发时理论上可能交错 | 已知风险暂缓；单进程内写操作已由 withMeetingLock 串行化 |
🛠️ 开发
pnpm install
pnpm typecheck # 双端 tsc：host（tsconfig.json）+ client（tsconfig.client.json）
pnpm test # 零依赖 node --test：Node 原生剥离类型，直接 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
node scripts/export-experts.mjs # 从 settings.yaml 直出 EXPERTS.md 与 experts.yaml
node scripts/export-experts.mjs --check # 只校验专家团与磁盘真相是否一致
pnpm test 用 Node 标准测试运行器（每个测试文件一个子进程）。在禁止子进程管道的环境里（例如 DSH 自带沙箱）会以 spawn EPERM 失败——那是环境限制，不是测试失败；改用 pnpm test:inline（需 Node ≥ 22.8）。
维护说明与本地部署链见 LOCAL-MAINTENANCE.md。
📜 来源与致谢
- 上游：RoundTable 最初由 @huanlin 创作并开源，仓库
9931666/dsh-plugin-roundtable，采用 MIT 许可
- 接手：原作者已停止维护（最后推送 2026-09-13，唯一 issue 长期无回复），本仓自其 v0.2.35 基线接手继续开发
- 本仓独立演进（不回合并上游、不依赖上游更新）：预设装配链、主持人单一出口、成员感知同步、调度面与调度面板、角色预设模型·思考强度贯通等
- 原始 MIT 版权声明与许可条款完整保留，见
LICENSE；上游贡献者署名保留于 package.json 的 contributors
- 上游历史发布说明留存于
release-notes/（v0.2.0 起，供追溯）
问题与建议请提到本仓 Issues，不要提到上游。
📄 许可证
MIT © 2026 dsh-plugin-roundtable contributors
