输入区增强 luzonghao/dsh-input-light

dsh-input-light

输入区增强插件，用于 DeepSeek Harness（dsh）： Tab 循环权限档、⌘S 按两下继续中断的工作、权限 chip 按档配色。
纯客户端、零配置、中英双语。

功能

| 功能 | 触发 | 行为 |
| 切换权限档 | Tab | 只读 ⇄ 工作区内修改 —— 永不自动进 Full access / Auto |
| 继续中断的工作 | ⌘S 按两下，或 chip 右侧的 ↻ 按钮点两下 | 发送「你的工作中断了，请你继续。」 |
| 权限 chip 配色 | 自动 | 只读 = 黄、工作区写入 = 蓝、完全访问 = 红 |

1. Tab 循环权限档

Read Only ⇄ Workspace Write

为什么只有两档：/permission <preset> 作为命令是直接执行、无确认的（只有通过可见控件选择才需要确认风险）。所以循环刻意只用两档安全模式 ——要 Full access 仍请走 UI 的确认弹窗。

从危险档（Full access / Auto）按 Tab 会收回只读（安全方向）。

2. ⌘S 继续中断的工作

发送固定文案：「你的工作中断了，请你继续。」

走宿主自己的输入面提交，因此与手动按 Enter 行为完全一致：

ctx.sessions.binding(sessionId) // → 会话 binding
→ ctx.uiSession.sourceFor(binding) // → 该会话的 provide 通道面 → .props.inputActions // → { setDraft, submit, … } → setDraft(RECOVERY_TEXT); submit();

结果会在会话日志里产生真正的 user/message（source.kind === "user"），而不是"调用返回 ok 但什么都没发生"。

⚠️ 反例备忘：ctx.remote.session.prompt(...) 是 ACP 协议方法，调用会 resolve，但不会产生 user 消息（实测会话日志 0 条）。不要改回它。

两步确认（防误触） —— ⌘S 与按钮共用同一状态机：

| 第几步 | ⌘S | 按钮 | 表现 |
| 第一下 | 按一下 | 点一下 | 进入确认态：按钮变 ✓ 黄底、tooltip 变「再按一次确认发送」，不发送 |
| 第二下（3 秒内） | 再按一下 | 再点一下 | 发送 |

- 两条路径共享状态 ⇒「⌘S 一下 → 再点按钮」也能确认（反之亦然）
- 确认窗口 3 秒，超时自动撤销回灰色 ↻
- 按钮带原生 tooltip，显示功能与快捷键键帽（⌘ S）

3. 权限 chip 按档配色

| 档位 | 颜色 | 宿主主题变量 |
| Read Only | 黄 | --dsw-alias-state-warn-primary |
| Workspace Write | 蓝 | --dsw-alias-state-business-primary |
| Full access | 红 | --dsw-alias-state-error-primary |

用主题变量而非写死色值 ⇒ 明暗主题自动跟随。
chip 的原始内联样式会被保存，插件卸载时完整还原，不留痕。

键位可改绑

两个键位注册在宿主快捷键服务里，会出现在快捷键面板（⌘/）：

| 命令 id | 默认键 | 说明 |
| input-light.cycleMode | Tab | 切换权限模式 |
| input-light.recover | ⌘S | 继续中断的工作（按两下） |

在那个面板里改绑即可，无需改代码。

安装

plugin_manager action=install_bundle
target=<dsh-input-light 的路径>

详见 INSTALL.md。要点：把 bundle 注册进 DSH profile，然后重启 DSH （新增 bundle 只在启动时被读取；之后改代码只需刷新页面）。

实现约束

完整工程日志见 index.md。一路上导致反复返工的四条约束：

1. 外部客户端插件只能渲染进 root 作用域座位。 conversation.input. 这类座位是 scope: "session"：插件注册成功但永不渲染 （实测 5/5 座位 mounted: false）。本插件用 shell.overlay（kind: "list", scope: "root"）。

2. 快捷键必须走 ctx.shortcuts。 裸 DOM keydown 永远看不到 Tab / ⌘S —— 宿主键盘层在 DOM 之前就消费掉了它们（普通字符能到，这两个从来不到）。注册还必须带 regions: ['page', 'editable']，否则输入框聚焦时命令不触发。

3. Cordis 服务及其子命名空间都必须 inject。 访问未声明的会抛异常*（cannot get property "remote.commands" without inject）。

4. 注册必须幂等。 apply 会被调用多次；重复注册同一命令 id 会抛 Duplicate shortcut command，而若这次抛错发生在注册第二个命令之前，两个命令都不会注册上 ——会悄悄弄坏一个本来能用的快捷键。

自检

node test/logic.test.mjs # 60 例纯逻辑，不需要 DSH

浏览器控制台里：

__dshInputLight.probe() // { chipFound, preset, sessionId, tooltip }
__dshInputLight.state() // 最近一次 cycle / recover 的结果
__dshInputLight.confirmStage() // 'idle' | 'confirm'
__dshInputLight.cycle() // 手动切一次
__dshInputLight.confirm() // 走两步确认（与 ⌘S 同一条路）
__dshInputLight.send() // 跳过确认直接发送（仅自检）
__dshInputLight.restoreChip() // 还原 chip 样式

许可

MIT © 2026 luzonghao