9931666/dsh-plugin-roundtable ↗★ 5

@huanlin/dsh-plugin-roundtable

将会话转为可视化圆桌会议拓扑 适合需要多专家节点协同讨论、对抗性评审和可视化拓扑的用户。

包名
@huanlin/dsh-plugin-roundtable
兼容性
待验证
Harness 依赖范围
^0.1.5-rc.1
Cordis 依赖范围
^4.0.2
版本
0.2.35
许可证
MIT
最近更新
2026年9月13日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:9931666/dsh-plugin-roundtable

使用界面

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

配置

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

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

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

偏好默认说明
默认协作模式orchestrated主持人统筹 / 多模型平等 / 针锋相对
最大轮数 / 最大 Token10 / 200000会议预算,超限闭麦
互通开关开只看当前对话会议 / 看全部
专家每轮输出上限(token)0(不限制)专家组模型 max_tokens
专家每轮最多意见数0(不限制)专家 prompt 约束
反馈开关开会议结束后是否询问 1 键有用度(关闭即永久不再弹)
skill 传递方式主持人中转 relayskill 由主持人读后转交 / 专家自行用 skill 工具加载(direct)

使用边界与注意事项

  • 一个主持人同一时间只能带一场活动会议:新开会前先 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// 目录:不可恢复,删除前确认。
  • 第三方模型要显式指定:拉取 zai / GLM 等厂商专家时,在 UI 下拉或消息中说明 provider/model(如 zai/glm-5.2),否则可能路由失败或模型不符。

已知限制(迭代中)

限制影响现状
跨 Session 越权(A1)RPC 通道(connection 与插件自有 web 路由)不暴露调用者的 session 身份,因此同进程内其他会话只要知道会议 id,理论上就能调用该会议的读写端点(改连线、改知识库路径、评审表态、专家增删队列)。现有防线是「会议归属校验 + 状态机校验」,不是身份校验。本版接受现状:单人 / 单工作区使用无实际影响。多人共用同一 DSH 实例、或不信任同实例其他会话时,请把该实例视为同一信任域。彻底收紧需要宿主 connection 暴露调用者身份,属后续版本。
Host 侧并发写竞态插件生命周期事件(stop/dispose)与会议文件写操作并发时,理论上可能交错写入 / 丢行已知风险暂缓;单进程内的会议级写操作已由 withMeetingLock 串行化,正常使用基本不会触发

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