讨论模式 buguoshixc/dsh-discuss-mode

// 讨论模式激活时，动手类工具一律拒绝
ctx.tools.guard((call) => {
if (!isDiscussMode()) return
if (MUTATING_TOOLS.has(call.name)) {
return { deny: 讨论模式中不能调用 ${call.name}。先把想法聊清楚，再退出讨论模式动手。 }
}
})

拒绝理由会原样回到模型那里，所以它不会以为工具坏了，而是知道「现在不该动手」。只读工具（读文件、搜索、git status 之类）照常放行——讨论需要事实，不需要副作用。

只读工具照常可用

讨论不是空谈。模型可以读代码、查文档、跑只读命令，把判断建立在真实情况上。被拦住的只有会改变世界的动作：写文件、改文件、执行命令、提交。

安装

dsh plugin install dsh-discuss-mode

或者从源码装：

git clone https://github.com/owner/dsh-discuss-mode.git
cd dsh-discuss-mode
npm install
npm run build
dsh plugin install .

装完重启 DSH，侧边栏图标和 /discuss 命令就都在了。

配置

插件读取 ~/.dsh/plugins/dsh-discuss-mode/config.json：

{
"guardMutatingTools": true,
"showPolicyInPanel": true
}

| 字段 | 默认 | 说明 |
| guardMutatingTools | true | 是否硬拦动手类工具。关掉之后只剩提示词约束，不推荐 |
| showPolicyInPanel | true | 面板里是否展示策略原文 |

兼容性

- DSH 0.2.1-rc.2 及以上
- 需要 @deepseek-ai/dsh-web-app 提供侧边栏面板 API
- 命令行与 Web 两种会话都支持

许可

MIT
- 被拒绝：write、edit、pwsh、bash、subagent、subagent_fork、workflow、spawn_teammate、send_message、create_goal、update_goal、job_kill、schedule_、agent_teams_、team_task_
- 照常可用：read、glob、grep、read_image、web_search、web_fetch、ask_user_question、todo_write、skill、各类只读的 list/status 工具

只读探索是故意保留的：讨论已有项目时，策略要求它先读相关代码再开口。

「单调」是 DSH 的机制保证——拒绝一旦成立，任何后续监听器都无法把它翻回允许。拒绝理由会作为 Error: 内容回到模型上下文里，所以模型能立刻改道，而不是反复撞墙。

状态从会话日志折叠，而不是另存一份

模式状态是一个 sessionProjections 单元，从两处日志折叠出来：/discuss 命令自己的 command/run / command/done 记录，以及会话一开始就记着的 agentPreset（表头字段与 agent-preset/selected 事件）。这带来三个白拿的好处：会话恢复、fork、重放都能自动还原状态。

这也是必须的做法：DSH 不允许插件 append 自定义类型的事件——不认识该类型的读取方会拒绝重新打开会话。

两个入口在折叠时是有先后的，不是并列的：只要有一次 /discuss 跑完并落进日志，之后这条会话就听那个决定——否则在预设会话里敲 /discuss off 会被预设当场撤销。在那之前，会话的预设说了算，所以预设入口不需要任何命令就生效。

侧边栏面板读的就是这个投影的 wire.view，并通过执行同一条命令来改变它，所以界面不可能和日志脱节——预设入口也是同一个 view，面板显示的「已开启」和你看到的一致。

配置

作为 bundle 安装时，默认值是内置的，无需任何配置。要覆盖，在 profile 的 cordis.patch.yml 里重述你保留的字段（patch 是整体替换 config，不是深合并）：

- id: discuss-mode
name: 'dsh-discuss-mode'
config:
blockedTools: ['write', 'edit', 'pwsh', 'bash', 'subagent']

| 字段 | 默认 | 含义 |
| section | 内置中文策略文本 | 讨论模式激活时渲染为 discuss:policy 提示词段落的内容 |
| denial | 内置中文拒绝语 | 工具被拒绝时返回给模型的理由；{tool} 会替换为工具名 |
| blockedTools | 见上文清单 | 被拒绝的工具；精确名，或以 结尾表示前缀匹配（如 agent_teams_） |
| presetId | discuss | 哪条 Agent 预设的会话一进去就在讨论模式里；写 null 关掉这个入口，只留 /discuss |

未知的配置键会在激活时报错，而不是被静默忽略——cordis.patch.yml 里的笔误会立刻暴露。

策略文本是可以改的，而且应该改。 它才是这个插件的正文；代码只是把它接到正确的时机上。注意面板里显示的是随插件发布的默认文案，若你覆盖了 section，以你的版本为准。

兼容性

本版本（0.2.1）针对 DSH v0.2.1-rc.2 编写：

| 声明 | 值 |
| engines.dsh | >=0.2.1-rc.2 <0.3.0 |
| 五个 @deepseek-ai/dsh- peer | 0.2.1-rc.2 |
| dsh.manifestVersion | 1 |

DSH 的插件兼容性预检（v0.2.1-alpha.3 起）先读 manifest 自己的 engines.dsh，没有才拿运行时版本逐个匹配 @deepseek-ai/dsh- peer（includePrerelease 语义）。把范围写进 manifest，装错宿主版本时由预检直接拒绝，而不是等运行到一半才炸。

DSH 0.2.0-rc.2 及更早不再支持：旧清单把五个 peer 固定为 0.2.0-rc.2，精确范围不满足运行时 0.2.1-rc.2，预检会判为不兼容并拒绝加载插件的行。

安装

要求 DSH v0.2.1-rc.2（见上文「兼容性」）。本包是一个 bundle（package.json 里的 dsh.bundle.patch 指向两个补丁层：cordis.patch.yml 挂插件行，presets/discuss.patch.yml 声明那条 Agent 预设），安装它就会自动激活，无需手工编辑 profile：

& 'D:\DSHD\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'D:\OneDrive\Desktop\Code\dsh\dsh-discuss-mode'

装完需要完全退出并重启 DeepSeek Harness。两个原因：本机正在运行的进程早于这次安装；而宿主侧与浏览器侧的新模块都需要在启动时重新组装。

升级时注意：profile 默认跑 HMR，往已装过的包上再执行一次 add 会被以 already-installed 拒绝（换版本、换路径也一样）。要换，先移除再装：

& 'D:\DSHD\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop remove dsh-discuss-mode

而这个仓库是以 linked checkout（本地目录）方式挂进 profile 的：只是更新了检出内容时不必重装，完全退出并重启 DSH 即可。

重启后侧边栏出现「讨论模式」图标即安装成功。也可以在 Plugins 页确认并开关。

已知边界

- PTC 模式的 run_code 没有被拦截。 它只在非 native 呈现模式下可见，而拦截它会连带切断模型调用一切工具的通道。通过它发起的嵌套工具调用仍然会被本插件的 guard 按名字拦下，但如果 run_code 的运行时有裸的文件系统访问，那是一个缺口。native 模式（默认）下不存在这个工具。
- 子代理在模式激活时被拒绝启动，因为子代理不在本 guard 的管辖范围内——它们的工具调用属于另一个智能体会话。堵住入口比事后追溯可靠。
- 讨论模式与 plan mode 可以同时激活，此时两段策略文本都会渲染（顺序为 500 的 plan:policy，然后是 550 的 discuss:policy）。实际使用中你不会想同时开两个。
- 面板的按钮切换的是「当前显示的会话」，判定方式是 retainedBy.mainView > 0——与 DSH 自带的 Workspace、Open-in-app 插件用的是同一个办法。没有打开会话时按钮禁用。
- 模式下拉框那条预设只对新会话生效。 DSH 的 Agent 预设是会话级的：空白会话可以换，开过一轮之后宿主直接拒绝（agent-preset/locked）。所以「当前会话进讨论模式」永远走 /discuss 或面板，下拉框只负责开一条新的。
- 预设里那份工具面是快照，不是引用。 它抄的是 @deepseek-ai/dsh-web-app@0.2.1-rc.2 的 presets/standard.patch.yml：这一版的标准模式多了 time-context、tool-schedule、tool-plugin-market（最后一个 disabled），少了 tool-subagent-codex、tool-subagent-claude-code、tool-ralph 三行以及 backgroundMode 配置。升级 DSH 后标准模式再变时，讨论模式预设里那份不会自己跟着长——跑 node tools/sync-preset.mjs 重抄；node test/verify.mjs 会检查生成标记、{{cwd}} 缺席与这些关键行的有无，tools/sync-preset.mjs --check 则直接告诉你它是否已经过期。宿主没有「预设继承另一条预设」的写法，这是唯一的选择。
- 预设的 id 是可配置的（presetId，默认 discuss）：只装插件、不装这条预设的部署完全不受影响——没有哪条会话的 agentPreset 会等于它，模式照旧只由 /discuss 开关。
- 0.2.1 新增的 working_directory 不在拒绝清单里。 它是「查询当前目录」和「进入另一个目录」二合一的工具：只读查询对讨论有用，换目录也只是把读取范围挪进项目内部，真正会改变世界的仍是 write / edit / pwsh 那些。想要更严格的立场，把它加进 blockedTools 即可。
- 不强制「必须讨论 N 轮」：那不是约束能解决的问题，只会制造噪音。这个模式只保证两件事——模型没法自己出去，也没法动手。
- 对齐是话轮协议，不是状态机。 「什么时候算聊完」由模型自己判断，而交付是纯文本、没有工具调用可供拦截，所以策略文本仍可能被绕过——模型仍可能把草案和交接提示词放进同一轮。若这种情况频繁发生，下一步不是继续加措辞，而是把「要提示词」做成用户侧事件（面板按钮或命令），让交付由用户触发。

实现速览

没有构建步骤：两个手写的普通 JS（宿主半 + 浏览器半）、两层补丁（插件行 + Agent 预设声明）、图标与两份 locale；Agent 预设那份快照由仓库里的 tools/sync-preset.mjs 重抄（开发期工具，不随包发布）。

| 关注点 | 机制 |
| 兼容性 | package.json 声明 engines.dsh: '>=0.2.1-rc.2 <0.3.0'、五个 @deepseek-ai/dsh- peer 固定 0.2.1-rc.2、dsh.manifestVersion: 1——宿主兼容性预检据此放行 |
| 提示词段落 | ctx.systemPrompt.section({ name: 'discuss:policy', order: 550 }) |
| 工具拒绝 | ctx.tools.guard(exec => string \| undefined)，按会话状态条件判断 |
| 斜杠命令 | ctx.commands.register({ name: 'discuss', input: { hint: '[off\|message]', attachments: true } }) |
| 状态 | ctx.sessionProjections.register({ key: 'discuss', apply, wire })，stateVersion: 2 |
| 预设入口 | package.json 的 dsh.bundle.patch 是有序数组：cordis.patch.yml 之后追一层 presets/discuss.patch.yml，后者插一行 @deepseek-ai/dsh-agent-preset（config.id: discuss） |
| 预设会话的默认状态 | 投影 init(header) 读表头的 agentPreset，apply 再折叠 agent-preset/selected；一旦有 /discuss 的 settled 决定，决定优先于预设 |
| 侧边栏入口 | ctx.slots.inject('sidebar.panellist', ...)，order: 20 |
| 面板页面 | ctx.slots.inject('main', ...)，keyed，key 同为 discuss-mode |
| 面板 → 宿主 | ctx.remote.commands.execute(sessionId, '/discuss' \| '/discuss off', []) |
| 宿主 → 面板 | sessions.binding(id).session.projections.faceOf('discuss') |
| 生命周期 | 每个注册都包在 ctx.effect(...) 里——服务侧注册挂在服务自己的 fiber 上，不包的话插件重载会留下陈旧段落并导致重名冲突 |
客户端不引入任何 DSH 客户端包（它们随版本变化，而手写 JS 没有类型检查），只用模块表里的 react，样式走 --dsw-alias- 主题变量并带兜底值。

参考实现：@deepseek-ai/dsh-plan-mode（同体系的姊妹模式）、@deepseek-ai/dsh-persona（ctx.effect 包装的写法）、dsh-mobile-remote（侧边栏面板 + sidebar.panellist）。

推送（网络受限时）

本机到 github.com:443——也就是 git push 用的那个端点——不稳定，实测会连接超时或被重置；而 gh 走 api.github.com 完全正常。所以仓库带了一个走 Git Data API 的推送脚本：

powershell -ExecutionPolicy Bypass -File tools\push-via-api.ps1

它不是复制：git 的对象 id 是内容的纯函数，上传同样的 blob / tree / 作者 / 提交者 / 时间 / 提交信息必然得到同一个 SHA。脚本在每一步都比对 git 自己的答案，对不上就拒绝移动 ref——所以本地和远端不会悄悄分叉，git status 保持准确，等网络恢复后 git push 也没有多余的事可做。

前提是远端仓库已有至少一个提交（GitHub 对完全空的仓库会以 409 Git Repository is empty 拒绝创建 blob/tree）。

验证

test/verify.mjs 是随附的隔离测试：给 @deepseek-ai/dsh-llm 打桩后真实导入宿主侧代码，用假 ctx 跑通 apply() 的接线，并检查状态机（两个入口的先后、/discuss off 不会被预设撤销）、配置校验、工具匹配器、命令分支、两层补丁的清单与形状、客户端契约（含两半策略文本必须逐字相同的一致性断言）。0.2.1 适配后它还盯住兼容性声明与预设快照：version 是 0.2.x、engines.dsh 的范围、五个 @deepseek-ai/dsh- peer 固定 0.2.1-rc.2、dsh.manifestVersion === 1，以及生成标记存在、{{cwd}} 缺席、time-context / tool-schedule / tool-plugin-market 在列、codex / claude-code / ralph 行与 backgroundMode 不在列。设了 DSH_APP_ASAR 时它还会顺带跑一次 sync 的 --check，没设就跳过，不算失败。

node test/verify.mjs

不需要安装任何依赖——桩模块由脚本自己生成在 test/.sandbox/（已 gitignore）。应输出 N passed, 0 failed（N 为检查项数）并以 0 退出。

tools/sync-preset.mjs 回答的是另一个问题：生成区是否还等于安装里的标准预设。

$env:DSH_APP_ASAR='D:\DSHD\resources\app.asar'; node tools/sync-preset.mjs --check

一致时 exit 0；不一致时 exit 1，并说明 presets/discuss.patch.yml 需要重抄（去掉 --check 就是就地重写）。它依赖装好的 DSH（从 app.asar 里读标准预设），所以和离线可跑的 test/verify.mjs 分开。

tools/asar-extract.mjs 是查装好的那份 DSH用的：仓库旁边的参考检出往往落后于安装版本（本插件这一版就是照着安装的 0.2.1-rc.2 适配的），而 presets/standard.patch.yml、dsh-agent-preset-registry 的实现都躺在 app.asar 里。它只读不写：

node tools/asar-extract.mjs 'D:\DSHD\resources\app.asar' list 'dsh-agent-preset'
node tools/asar-extract.mjs 'D:\DSHD\resources\app.asar' read 'dsh/node_modules/@deepseek-ai/dsh-web-app/presets/standard.patch.yml'
node tools/asar-extract.mjs 'D:\DSHD\resources\app.asar' dump <路径> 落地文件