Skip to content

dsh-multiline-input

Verified

dsh-multiline-input · v0.1.1 · MIT · Web UI

Single/multi-line composer toggle for DeepSeek Harness: an editable Cmd/Ctrl+E shortcut, a tab hint on the composer, a 4-line floor for multi-line drafts, and Shift+Enter to send.

Install

dsh plugin add dsh-multiline-input

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-multiline-input

官网 / Website: https://dsh.zlmix.com/multiline-input/

npm · GitHub · Release v0.1.1 · 市场 PR #9938

把 DeepSeek Harness 的对话输入框在单行 / 多行之间切换的 Web 客户端插件。

  • 默认快捷键 Cmd+E(macOS)/ Ctrl+E(Windows / Linux);输入框上沿有一个与输入框同底色的小 tab 显示当前快捷键与目标模式,点击即可切换。
  • 多行模式输入框默认 4 行高(3–5 行区间内),内容变多自动长高,到原生 336px 上限后滚动。
  • 多行模式 Enter 换行、Shift+Enter 发送;单行模式保持 DSH 原生行为(Enter 发送、Shift+Enter 换行)。
  • 快捷键可在 设置 → 通用 → 快捷键里改成任意组合(冲突校验、恢复默认都由 DSH 官方界面负责)。
  • 模式按设备记住,刷新 / 重启后保持。

单行模式:输入框上沿的 tab

多行模式:输入框变高,tab 显示 Shift+Enter 提交 · Cmd+E 单行输入

安装

# 市场 / CLI 管理的 profile
dsh plugin --profile <profile> add dsh-multiline-input

# 或在应用内「插件」页搜索 / 用绝对路径安装后启用

桌面版使用的 desktop profile 由应用独占(dsh plugin --profile desktop 会被拒绝),请在应用「插件」页安装或手动 link:

cd ~/.dsh/profiles/desktop
pnpm add link:/absolute/path/to/dsh-multiline-input
# 再把 "dsh-multiline-input" 追加到 package.json 的 dsh.profile.bundles

启用后刷新页面即可;插件清单变化不需要重启应用。

卸载:插件页关闭 / 卸载,或 dsh plugin --profile <profile> remove dsh-multiline-input。

使用

操作 单行模式 多行模式
Enter 发送 换行
Shift+Enter 换行 发送
Cmd/Ctrl+Enter 加速提交(不变) 加速提交(不变)
/、@ 菜单打开时的 Enter 选中菜单项 选中菜单项
输入法候选态的 Enter 交给输入法 交给输入法
  • 按 Cmd+E / Ctrl+E(或点击 tab)在两种模式间循环;切换不清空草稿、不抢焦点。
  • tab 常驻显示,输入文字时也不隐藏;多行时显示 Shift+Enter 提交 · Cmd+E 单行输入,单行时显示 Cmd+E 多行输入。
  • tab 是输入框上方独立的一行(占 24px):目标条、待办、队列、额度横条等 DSH 卡片排在它上面,不会被遮住;目标条的暂停 / 编辑 / 清除按钮也能正常点击。

修改快捷键

  1. 打开 设置 → 通用 → 快捷键;
  2. 搜索「多行输入」(命令名:切换多行输入,id multiline-input.toggle);
  3. 点击右侧键位进入录制,按下新组合即可;冲突时官方界面会提示,可随时恢复默认。

tab 实时跟随当前生效的组合;把绑定清空后只显示「多行输入 / 单行输入」,点击仍可切换。

与相近插件的区别

插件 它做什么 本插件
dsh-composer-expand 工具行按钮把输入框撑到 70vh 双模式 + 快捷键 + Enter/Shift+Enter 互换 + 常驻 tab
dsh-fullscreen-input 另开全屏面板写多行,Enter 换行、Ctrl+Enter 发送 内联在原生输入框,多行时 Shift+Enter 发送(带输入法保护)
dsh-ctrl-enter-submit 全局把 Enter 改成换行、Ctrl/Cmd+Enter 发送 单行保持原生 Enter 发送,多行才交换
dsh-composer-ux 可配置发送/换行键位 + 右键菜单 + 快捷指令面板 只专注输入模式与高度
dsh-keyboard-manager Ctrl+Q / Ctrl+E / Ctrl+S 切栏、开设置 Windows/Linux 上它的 Ctrl+E 与本插件默认冲突;可在设置里改键(macOS 本插件用 Cmd+E,不冲突)

实现说明

插件遵守 DSH 的第三方客户端插件契约(dsh.client + dsh.bundle.patch),Host 半只保留一个可安装 / 启停的 bundle row,功能全部在 client.js:

  • 模式状态:模块级 store + localStorage['dsh-multiline-input.mode.v1'],投影为 <html data-dsh-ml-input="multi">;
  • 高度:一条 CSS 规则给 [data-composer-card] [data-composer-input][contenteditable="true"] 设 min-height: calc(4 * 1lh + 8px),不碰 DSH 的滚动上限;
  • tab 提示:注册到 conversation.input.dock 座位(order: 1000,排在 todo 0 / 额度横条 5 / 目标条 10 / 队列 20 之后),成为输入卡片正上方独立的一行:整行只有 24px,宽度与卡片同列、tab 右对齐到卡片右边缘;margin-bottom 吃掉栈的行距(dock 态 6px、hero 态 8px,运行时按实际 row-gap 同步),让 tab 底边与卡片上沿齐平、视觉上仍是「卡片肩上的 tab」,但因为占位而不可能压到任何上方卡片。旧实现走 conversation.input.overlay 浮层(bottom: 100% + z-index: 2),会盖住目标条右侧的文案与暂停 / 编辑 / 清除按钮;
  • Enter / Shift+Enter:在 document 捕获阶段拦下多行模式下的 Enter,向编辑器重放一个翻转了 shiftKey 的合成按键——仍由 DSH 自己的 composer keymap 决定「换行」还是「提交」,撤销历史、输入法保护、busy-enter(queue/steer)、菜单仲裁全部保持原逻辑;
  • 快捷键:通过 ctx.shortcuts.register() 注册命令,编辑与持久化完全交给 DSH。

源码依据(DSH 0.2.1-rc.3,commit 22ddee3):

契约 源码文件
输入卡片 / 覆盖层锚点 packages/client/ui-conversation/src/client/skeleton/InputBar.tsx、InputBar.module.css
composer 卡片栈(conversation.input.dock) packages/client/ui-conversation/src/client/skeleton/ConversationContent.tsx、ConversationRoot.module.css
可编辑面 / 占位符 packages/client/ui-conversation/src/client/input/editor/DraftEditor.tsx、ComposerContentEditable.tsx
Enter 语义 packages/client/ui-conversation/src/client/input/editor/keymap.ts
公开输入动作面 packages/client/ui-conversation/src/client/contract/input.ts
座位与标准 props packages/client/ui-conversation/src/client/contract/slots.ts、packages/extensions/cordis-client-runner/src/client/slot-catalog.ts
快捷键命令契约 packages/client/shortcuts/src/client/types.ts、binding.ts
客户端清单 packages/util/package-manifest/src/types.ts、packages/client/modules/README.zh.md

兼容性

  • 在 DSH 0.2.1-rc.3(桌面版 / Web)验证;dsh.compatibility.dsh = >=0.2.1-rc.3 <0.3.0-0。
  • 依赖 composer 的 data-* 锚点与 role="listbox",属 DSH 内部实现;升级 DSH 后需要回归(锚点缺失时插件只 warn,不会崩)。
  • tab 行的宽度与右对齐复用了 DSH 布局变量 --dsh-composer-card-max-width / --dsh-composer-side-clearance(都带兜底值),若 DSH 改了输入区宽度算法,tab 会与卡片右边缘错开几像素。
  • Web + Linux 没有默认快捷键(DSH 对 Web 可选组合有白名单限制),需在设置里自行指定。

开发

dsh-multiline-input/
├── package.json            # dsh.bundle.patch + dsh.client(platform: web)
├── cordis.patch.yml        # 1 个 Host row
├── index.js                # Host 半(空实现,仅为 bundle 契约)
├── client.js               # Client 半(手写,无构建、无第三方依赖)
├── icon.svg / assets/      # 插件图标与市场截图
├── locale/{zh,en}.json     # 插件展示元数据
├── test/                   # node --test
└── docs/                   # 计划、发版清单
  • 测试:npm test(node --test,当前 13 条用例)。
  • 语法:node --check client.js && node --check index.js。
  • 调试:HMR 默认忽略 **/node_modules,链接安装的 client.js 改动不会被热加载;改完客户端代码后在插件页关/开一次(或重启应用),再刷新页面。

已知限制

  • 仅作用于 Web GUI(桌面版与浏览器),TUI / CLI 不适用。
  • 多行起始高度是代码常量 4 行,暂不提供配置项。
  • tab 行占输入框上方 24px:输入区整体比没有 tab 时高约 18px(24px 行高抵掉 6px 栈间距),消息区相应少 18px。
  • hero(空会话)状态下栈行距是 8px,tab 行会按运行时读到的实际 row-gap 自适应,视觉上与 dock 态一致。
  • 若默认键位与其它插件的命令默认值冲突,插件会降级为「点击 tab 切换」并在控制台输出一次警告。

文档

License

MIT