dsh-shutup · 打断提示（Tell DeepSeek）

DeepSeek Harness 插件：模型思考/输出时按下快捷键——弹出纠偏输入框（输入才暂停），输入纠偏提示（二次确认）或空确认继续；继续时的思考链回填以"可折叠上下文行"呈现，不占界面。像 Claude Code 的 Tell Claude 一样。

使用

1. 模型思考/输出中（状态条会显示快捷键小提示 ⌨ 打断 Ctrl+Shift+Q）
2. 按下快捷键（默认 Ctrl+Shift+Q，用物理键匹配、CapsLock 不影响，且避开空格键——Shift+空格=中文输入法全半角切换会被 IME 层拦截）→ 弹出输入框（未输入不暂停，模型继续想）
3. 三种操作：
   • 开始输入 → 瞬间暂停当前生成；点「载入纠偏」→ 按钮变红「确认载入纠偏？」→ 再点一次才真正发送（steer 中止运行中的回合并注入为新一步，自动加前缀「[打断提示/纠偏]：」，4 秒不点自动还原）
   • 空输入确认 → 从未输入过：直接关闭、模型从未被打断；输入过又删空：发送一句「[继续]」，思考链回填以折叠的上下文行注入（折叠=一行，展开=全文），模型拿到完整上下文
   • 取消 / Esc / 点空白处 → 未输入过：直接关闭零干扰；输入过：同上发送「[继续]」并关闭弹窗

其他时间（模型未运行）快捷键自动禁用，用户可以正常在输入框打字。

输入法（IME）兼容

• 中文输入法激活时也能正常触发：匹配只用 e.code 物理键 + 修饰键（IME 下 keydown 的 key/229 不影响触发）
• 输入法组合期的回车/Esc 全部交给输入法：拼音输入中按回车确认候选词不会误触发发送，按 Esc 取消候选不会误关弹窗
• CapsLock/大小写状态不影响触发
• 防误触只在"正在连续打字"时生效：仅当 1.5s 内刚在输入框敲过字才把快捷键当作普通输入；发送消息后焦点停留在输入框、或只是点开过输入框没打字，快捷键都照常触发——不会再出现"时不时失效"

修改快捷键

设置 → 通用 → 打断提示 (Shutup)：

• 点「修改快捷键」→ 直接按下新组合键（按下即捕获，录制 e.code 物理键）
• 快捷键必须包含 Ctrl / Alt / Meta 至少一个：纯 Shift+字母（如 Shift+A）与正常打字结构性冲突（聊天时输入大写字母既是快捷键又是打字），录制时会拒绝；已存的无修饰键配置自动回退默认
• 「恢复默认」恢复 Ctrl+Shift+Q
• 配置存浏览器 localStorage（dsh-shutup-config，旧版单快捷键/含空格配置自动迁移）

实现机制

• 客户端 + 最小宿主（/shutup/backfill 一次性上下文注入）
• 输入才暂停：弹窗内输入第一个非空字符时调用 session.cancel()——与界面停止按钮相同的 RPC，宿主对活动回合执行 Abort 取消；已生成的截断内容保留在会话中、待处理队列 FIFO 续跑，不会清空或丢弃；按快捷键但未输入则完全不打断
• 载入纠偏（打断并注入）：session.prompt([{ type: 'text', text: '[打断提示/纠偏]：' + hint }], 'steer')——steer 的官方语义本身就是"中止运行中的回合并把这条消息作为新一步"，打断由 steer 自身完成，无需单独调用 cancel；自动拼接纠偏前缀
• 继续 + 可折叠回填（方案 A，v1.1 宿主侧）：双源摘取被打断回合的思考/输出末尾——优先 interrupted === true 的 legacy 节点，回合未收敛时兜底读 snapshot.partial.blocks（最新快照 + 6×500ms 重试，最长 2.5s，绝不拿上一个回合充数），先 POST 到宿主 /shutup/backfill（60s TTL、一次性、20K 字符上限），再发送一句话 [继续] 继续你刚才的思考与工作。；宿主经 systemPrompt.context 把回填注入下一次提示词组装的运行时上下文——官方机制物化为会话里的持久化上下文消息，聊天 UI 折叠显示一行摘要、点击展开全文，模型下一步完整读到回填；三级退化：POST 失败 → 全文直发（内容优先）；摘不到 → 裸 [继续] 指令
• 二级确认：纠偏按钮第一次点击进入红色确认态（4s 自动还原），第二次点击才真正发送
• 会话接口懒解析：sessions 服务在每次调用时通过 apply 暂存的 ctx 重新 get（apply 时点拿不到也能兜底），binding() 调用全程 try/catch；载入失败会在弹窗内显示错误并保留输入，不再静默关闭
• 快捷键状态机防护：
  • 严格作用域绑定：仅当会话处于 running（generating/thinking）且弹窗关闭时才挂载全局监听，其余时间彻底解绑（不是常驻监听+惰性忽略）
  • 防冲突：仅在"1.5s 内刚在输入框敲过字"（正在连续打字）时把快捷键当作普通输入；焦点停留输入框但未打字时正常触发
• 运行状态：挂在 conversation.composer.dock（会话作用域槽位）读取 ConversationSnapshot.running
• 快捷键监听用捕获阶段，抢在页面其他处理之前；弹窗用 createPortal 挂到 document.body，全屏遮罩浮在 UI 之上

目录结构

dsh-shutup/
├── package.json        # dsh.bundle.patch + dsh.client 声明（bundle 形态）
├── cordis.patch.yml    # 挂载声明：insert entry shutup
├── lib/
│   ├── index.js        # 宿主半侧：/shutup/backfill 一次性上下文回填（systemPrompt.context 注入）
│   └── client.js       # 浏览器半侧：快捷键 + 打断弹窗 + 思考链摘取 + 设置录制
└── README.md

更新日志

v1.2.0（2026-08-16）

• 快捷键防护：录制时拒绝无 Ctrl / Alt / Meta 的裸键组合（如 Shift+A——与正常打字结构性冲突，聊天时输入大写字母既是快捷键又是打字）；matchCombo 增加同规则防御纵深；已存的无修饰键配置自动回退默认 Ctrl+Shift+Q
• 思考链保护：修复 v1.1 的 getSnapshot 死代码（SessionFace 并无此方法，重试循环从未真正执行、读的是陈旧快照）——改为 latest-value ref 模式，每次重试读当下渲染的最新快照，被打断回合落定后必然命中；摘取失败时不再静默发裸 [继续]，弹窗重开并警告，二次确认才允许不带上下文继续

v1.1（2026-08-16）

• 宿主侧一次性上下文回填（/shutup/backfill + systemPrompt.context）：继续时的思考链以可折叠上下文行呈现
• 双源摘取（interrupted 节点 + partial.blocks 兜底）、三级退化链（折叠回填 → 全文直发 → 裸 [继续]）
• 输入才暂停、纠偏二级确认、失败提示可重试