SA1992X/dsh-ctrl-enter-submit

dsh-ctrl-enter-submit

npm version
license

DeepSeek Harness (DSH) 插件：将文本输入的提交快捷键从 Enter 改为 Ctrl/Cmd+Enter。覆盖主对话框与 Agent 提问卡片（ask_user_question）的所有输入控件；可在「设置 → 插件」中随时开关，禁用后恢复默认行为。

行为

| 按键 | 插件启用时 | 插件禁用后 |
|---|---|---|
| Enter | 多行框换行；单行框/选项按钮不动作 | 提交消息 / 回答 / 下一题 |
| Ctrl/Cmd+Enter | 提交消息 / 回答 / 下一题 | 提交（DSH 原本就支持） |
| Shift+Enter | 多行框换行 | 提交消息（DSH 原生行为） |

适用范围：主对话框 composer，以及 Agent 提问卡片（ask_user_question）的所有输入控件——多行 textarea（普通 Enter / Shift+Enter 换行）、单行自定义输入框（普通 Enter 不动作）、选项按钮（普通 Enter 不再选中/跳题，鼠标点击与空格选择不受影响）。

/ 和 @ 触发菜单打开时，Enter 仍然正常选择菜单项，不会被拦截。输入法组合状态下也不会被拦截。

安装

从插件市场安装：打开 Settings → Plugin Market，搜索 dsh-ctrl-enter-submit，一键安装。

或用命令行：

dsh plugin --profile web add dsh-ctrl-enter-submit

安装后刷新浏览器页面即可生效（纯客户端插件，无需重启服务）。

启用 / 禁用

在 DSH Web 界面的 设置 → 插件（Plugins） 中找到 ctrl-enter-submit，用开关切换：
- 关闭：立即恢复 Enter 提交（刷新页面后生效）
- 打开：恢复 Ctrl/Cmd+Enter 提交

卸载：

dsh plugin --profile web remove dsh-ctrl-enter-submit

工作原理

插件在浏览器端的 document 捕获阶段拦截 keydown 事件，因此一定早于编辑器根元素上的键盘监听与 React 在容器上的委托监听：

- 主对话框输入面按版本分两种：
- DSH ≥ 0.1.2：composer 是 Lexical contenteditable（[data-composer-input]），普通 Enter 会被伪装成 Shift+Enter，由 DSH 自己的 INSERT_LINE_BREAK 命令插入换行，与用户按住 Shift 按 Enter 完全一致；伪装失败时退化为阻断提交链路
- 更早版本：composer 是 textarea，普通 Enter 与 Shift+Enter 调用 stopImmediatePropagation() 阻止 React 的 onKeyDown（即 DSH 的提交逻辑），但不调用 preventDefault()，因此照常换行
- Ctrl/Cmd+Enter：一律放行，由 DSH 正常提交
- /、@ 触发菜单打开时不接管，Enter 仍然选择候选项；输入法组合状态（中文/日文/韩文输入等）也不接管
- 无会话的工作区引导态（composer 不可编辑）不接管
- 插件 Host 端为空操作，所有功能均在浏览器 Client 端实现

兼容性

- 需要 dsh web 0.1.0-rc.6 或更高版本；已在 0.1.2-rc.1 的 contenteditable composer 上验证
- 在 Windows、macOS、Linux 上均可工作（Ctrl 和 Cmd 都识别）

本地开发

用本地路径以链接方式安装，改完 client.js 后刷新浏览器即可看到效果，无需重新发布：

dsh plugin --profile web add ./dsh-ctrl-enter-submit

DSH Desktop 用的是 desktop profile，把 --profile web 换成 --profile desktop 即可。

English

A DeepSeek Harness (DSH) plugin that changes the submit shortcut from Enter to Ctrl/Cmd+Enter. It covers the main composer and every input control in the agent question card (ask_user_question). Toggle it on/off anytime in Settings → Plugins; disabling restores the default Enter-submit behavior.

Behavior

| Key | Plugin enabled | Plugin disabled |
|---|---|---|
| Enter | Newline in multiline fields; no action in single-line inputs / option buttons | Submits the message / answer / advances |
| Ctrl/Cmd+Enter | Submits the message / answer / advances | Submits (DSH supports this natively) |
| Shift+Enter | Newline in multiline fields | Submits the message (DSH native behavior) |
范围：主编辑器与代理问题卡片（ask_user_question）——多行文本域（直接按 Enter / Shift+Enter 插入换行）、单行自定义答案输入框（直接按 Enter 不执行任何操作），以及选项按钮（直接按 Enter 不再选中/前进；鼠标点击和空格键仍可选中）。

当 / 或 @ 候选菜单打开时，Enter 照常选中高亮项。输入法组合输入永远不会被拦截。

安装

从插件市场安装：打开 设置 → 插件市场，搜索 dsh-ctrl-enter-submit，一键安装。

或从命令行安装：

dsh plugin --profile web add dsh-ctrl-enter-submit

安装后刷新浏览器页面（纯客户端插件，无需重启）。

启用 / 禁用

在 设置 → 插件 中找到 ctrl-enter-submit 并切换：
- 关闭：Enter 恢复为提交（刷新页面后生效）
- 开启：Ctrl/Cmd+Enter 提交

卸载：

dsh plugin --profile web remove dsh-ctrl-enter-submit

工作原理

该插件在捕获阶段拦截 document 上的 keydown，因此它总是先于编辑器根节点的键盘监听器和 React 的委托监听器执行：

- 编辑器输入界面取决于 DSH 版本：
- DSH ≥ 0.1.2：编辑器是一个 Lexical contenteditable 宿主（[data-composer-input]）；直接按 Enter 会被转换为由 DSH 自身的 INSERT_LINE_BREAK 命令处理的 Shift+Enter 手势，与按住 Shift 再按 Enter 完全一致。如果该手势无法应用，插件会回退为阻止提交链。
- 更早版本：编辑器是一个 textarea；直接按 Enter 和 Shift+Enter 会调用 stopImmediatePropagation()，使 React 的 onKeyDown（DSH 的提交逻辑）永远看不到它们，同时不调用 preventDefault()，因此文本域仍会插入换行。
- Ctrl/Cmd+Enter 始终不受影响，照常提交。
- 当 / 或 @ 触发菜单打开时，按键不会被拦截，输入法组合输入也永远不会被拦截。
- 非会话的工作区触发状态（编辑器不可编辑）不受影响。
- 宿主入口为空操作；所有行为都位于浏览器客户端中。

兼容性

- 需要 dsh web 0.1.0-rc.6 或更高版本；已针对 0.1.2-rc.1 的 contenteditable 编辑器验证。
- 适用于 Windows、macOS 和 Linux（Ctrl 和 Cmd 均可识别）。

许可证

MIT