dsh-client-composer-enter

dsh-client-composer-enter

中文（默认）：README.md ｜ English: README.en.md

面向 DeepSeek Harness（dsh）的第三方非官方插件。 Enter 插入换行，Shift/Alt+Enter 发送。不修改 dsh 任何源码。

dsh 的 composer 默认「裸 Enter 发送、Shift+Enter 换行」。写多行提示词时这是反的：一不留神就发出去了，想换行还得按修饰键。本插件把两个手势对调，同时原样保留 Cmd/Ctrl+Enter 的官方「互补」Queue/Steer 手势。

已在 dsh 0.1.7-rc.2 / 0.2.0-rc.2 / 0.2.1-rc.2（桌面版与 Web profile）上验证。

行为

按键	结果
Enter	插入换行
Shift + Enter	发送（重放官方 enter 手势）
Alt + Enter	发送（同上，第二个发送键）
Cmd/Ctrl + Enter	不改动 —— 官方互补 Queue/Steer 手势
Shift + Alt + Enter、AltGr+Enter 等	不改动
IME 组合中（isComposing / keyCode 229）	交还输入法
/、@ 菜单或命令弹层打开	交还官方选择器
已认领命令 / 提交中（data-phase ≠ plain）	交还官方提交路径

Cmd/Ctrl+Enter 在官方快捷键表里是 fixed.complementary（「使用互补的 Queue/Steer 方式」）：默认「繁忙时排队」设置下，它在智能体运行时等于插话发送，空闲时等同普通发送。本插件不动它。

安装

本包是标准的 dsh profile bundle（package.json 声明 dsh.bundle.patch，cordis.patch.yml 插入一行 Loader 条目）。从本地检出安装：

桌面版 —— 「设置 → 插件 → 安装」，粘贴本目录的绝对路径（如 D:\Code\dsh-client-composer-enter）；装完是停用状态，需在面板里启用。桌面 profile 由 Electron 独占，CLI 会拒绝 dsh plugin --profile desktop …。

其它 profile（CLI）：

dsh plugin --profile web add /absolute/path/to/dsh-client-composer-enter

pnpm 会把包链接进 profile 的 node_modules，dsh 会把它追加进 dsh.profile.bundles。实测启用后即时生效，若未生效重启一次应用。

卸载：面板里移除，或 dsh plugin --profile web remove dsh-client-composer-enter。

配置

每次按键都会读 localStorage，改完无需刷新：

键	取值	作用
dsh.composerEnter	off	回到官方按键表：Enter 发送、Shift+Enter 换行、Alt+Enter 无行为
dsh.composerEnterSendKeys	both（默认）/ shift / alt	哪个组合键发送

为什么不用改源码

官方 composer keymap 在 CRITICAL 优先级处理 Enter：裸 Enter 提交、shiftKey 落到纯文本编辑器的换行、altKey 被吞掉、ctrlKey/metaKey 走加速提交。本插件因此在 window 捕获阶段拦下按键，让原事件在编辑器看到之前就被消费，然后重放官方已经实现的手势：

你按下	重放成	官方结果
Enter	shiftKey: true 的 keydown	换行
Shift+Enter	无修饰 keydown	发送（遵循繁忙模式设置）
Alt+Enter	无修饰 keydown	发送

两个关键细节：重放事件带自持标记（__dshComposerEnterReplay）避免自我拦截；重放先造好并验证可标记，再吞掉原手势 —— 宿主拒绝标记时退回官方按键表，而不是留下死键。重放还会透传原事件的 repeat，所以长按 Shift+Enter 不会连发。

兼容面

下表全部由 dsh 拥有；任一项改名或移除，插件只会退回官方按键表（不会破坏 composer）。

选择器 / 语义	归属
[data-composer-input][contenteditable="true"]、data-phase="plain"	ui-conversation
[data-trigger-menu]	ui-input-trigger
[data-composer-card] [role="listbox"]	ui-commands 弹层
keymap 的四种修饰键语义、按住键守卫（event.repeat）	ui-conversation composer keymap

已知限制

• 设置 → 快捷键里显示的仍是官方映射（fixed.send / fixed.newline / fixed.complementary 由官方只读注册）。实际生效以本插件为准。
• Shift+Enter/Alt+Enter 走官方 enter 手势，繁忙时的投递方式遵循官方设置（默认排队），插件从不插话。
• 官方没有提供可用的按键 seam（固定输入观察回调在 window 冒泡阶段，晚于编辑器的 target 阶段），所以是 DOM 层改道——这也是上面兼容表存在的原因。
• 只改文本输入区的 Enter；按钮、队列/插话控件、工作区选择器均不变。

开发

零依赖、无打包器、不联网：

node scripts/build.mjs      # 由 src/client/index.js 重新生成 lib/
node test/logic.test.mjs    # 22 个用例，跑在零依赖 DOM harness 里

lib/ 是有意提交的：克隆下来即可安装，无需构建。CI 会重新构建并在 lib/ 与源码不一致时失败。

许可

MIT，见 LICENSE。本项目与 DeepSeek 官方无隶属关系。