dsh-debate-plugin

DeepSeek Harness 的辩论插件：/debate 人工命令发起一场正反对抗辩论，双方由立场锁定的 subagent 逐轮交锋，可选五段式中立评审；Web 端为每场辩论渲染专属卡片。

• 逐轮 one-shot：每个辩手发言都是一个独立 subagent（persona 锁立场、对方上次发言注入 prompt），任何一轮异常即 fail-loud 终止
• 中立评审：结构化五段输出——双方核心论点 / 论证质量 / 精彩交锋 / 未决分歧 / 综合评价
• 完全独立：不写任何 session 事件、不注册投影；辩论记录存插件自己的 JSONL store，Web 卡片经 RPC 拉取
• 命令输出：命令先返回“辩论已开始”确认，后台继续运行；完整辩论记录由 Web 卡片通过 Remote 轮询获取并渲染
• 逐步完善中

安装

前提：宿主 profile 的 bundle 组合提供全部 peer 依赖（@deepseek-ai/dsh-base 即可覆盖）。

# 在 deepseek-harness checkout（或任意 dsh 安装位置）内
pnpm dsh plugin --profile debate add /path/to/dsh-debate-plugin
pnpm dsh --profile debate --dump-config   # 应出现 "# == dsh-debate-plugin" 配置层

• 本地路径安装建立 link/junction 直连：插件仓库内 pnpm build 后产物立即生效，无需重新安装
• git / registry 安装走包内 prepare 脚本（tsdown 构建 lib/index.js 与 lib/client.js），devDependencies 随安装就位

用法

从命令菜单选择 /debate（或输入 /debate 后发送）：

/debate [--rounds N] [--no-judge] 
  --rounds N   逻辑轮数（每轮正反各一次发言），2-12，默认 3
  --no-judge   跳过评审环节

示例：

/debate 人工智能将取代程序员
/debate --rounds 2 --no-judge 远程办公利大于弊

运行中 Web 卡片显示"进行中"并每 1 秒轮询增量；辩手的本地 subagent 输出会以流式文本展示，并通过 MarkdownText 渲染 Markdown。完成后展示辩题、轮次流（正方 / 反方 · 开篇立论 / 驳论 / 结辩）与评审面板。运行中的辩论可从卡片中止；失败时记录错误并以失败态展示。

配置

schemastery 字段（写入 profile 配置）：

字段	类型	默认	说明
provider	string	spawn	正反辩手与评审 subagent 使用的 provider 名
dataDir	string	~/.dsh-debate-plugin/debates.jsonl	辩论记录 JSONL 文件路径

架构

首版走完全独立路线（B 路线）：外部插件的自定义 session 事件尚无法进入 harness 的持久事件词汇表，因此辩论数据不落会话日志，全部住在插件自己的存储里。

graph LR
    U["/debate 命令"] --> C["command.ts 解析"]
    C --> E["engine.ts DebateService"]
    E --> S1["subagent 正方"]
    E --> S2["subagent 反方"]
    E --> S3["subagent 评审"]
    E --> ST["store.ts JSONL last-wins"]
    C -->|admission CommandResult| SL["session log command/run + command/done"]
    W["client DebateCard"] -->|RPC getByCommand| E
    SL -->|CommandNode fold| W

• host 半（）：手动解析参数并立即 admission → 后台逐轮 ；本地子会话的 / 事件折叠为节流的 快照，写入 JSONL。，暴露 / / 读方法和 控制方法