deepseekplugins

DeepSeek Harness 插件

dsh-composer-enter

DSH web plugin: remap how Enter behaves in the chat composer (send / newline / interject), persisted to settings.yaml.（英文原文）

工具与能力
跳到安装方式

来源信息

GitHub 仓库
FrankZhangIronly/dsh-composer-enter
最近更新
2026年8月14日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/FrankZhangIronly/dsh-composer-enter
插件名：dsh-composer-enter
作者：FrankZhangIronly

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.zh-CN.md来源说明 · 只读预览
README 语言

dsh-composer-enter

> DeepSeek Harness (DSH) Web 插件：让你自定义回车键在对话框里的行为——可分别指定哪个组合键「发送消息」、哪个「插入换行」、哪个「插话(另一行为)/ 立即发送排队消息」。

插件为双面 DSH 插件:宿主(Node)侧负责设置命名空间与 loopback RPC 通道,浏览器侧在「设置 → 通用」渲染键位录制行,并在 document 捕获阶段拦截回车事件。

---

功能特性

  • 设置 → 通用 中新增一行「回车键映射」:三个键位录制框,分别对应 *发送消息*、*插入换行*、*插话(另一行为)*。
  • 配置持久化到 <dsh home>/settings.yaml 的 ui-composer-enter 命名空间。直接编辑文件,UI 会在保存时自动刷新。
  • document 捕获阶段拦截回车,在 React 根容器监听之前执行;对输入法组合期(isComposing / keyCode 229)和只读态一律放行。
  • 不变式自动维护:发送与换行必须恰好一个为单独 Enter;插话键必须是与前两者不同的组合键。冲突的选择会被自动纠正。
  • 零修改 DSH 主干,作为普通插件安装,@deepseek-ai/dsh 升级不影响。

---

安装

dsh plugin --profile web add dsh-composer-enter

安装后重启 dsh web,在 设置 → 通用 中即可看到新增的「回车键映射」一行。

从本地 checkout 安装:

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

---

配置项

命名空间 ui-composer-enter 暴露三个字段,均须匹配 ^(?:enter|(shift|ctrl|alt|meta)(\+(shift|ctrl|alt|meta))*+enter)$:

字段默认值含义
sendComboenter发送消息 的组合键。
newlineComboshift+enter插入换行 的组合键。
steerComboctrl+enter插话(另一行为) 的组合键:空闲时等同发送,智能体运行时插话或立即发送排队消息。必须与前两者不同,且不能是单独的 Enter。

可以在「设置」UI 改,也可以直接改 settings.yaml:

ui-composer-enter:
  sendCombo: enter
  newlineCombo: shift+enter
  steerCombo: ctrl+enter

插件监听 settings/document-updated 事件,文件被外部修改后会自动重读。

---

拦截原理

当映射等于应用默认值(enter / shift+enter / ctrl+enter)时,完全不拦截,DSH 原生行为原样保留。

其他任意映射下:

  • 插话组合 → 合成一个 Ctrl+Enter 事件,沿用应用自带的 busy/queue 逻辑(空闲时立即发送,智能体运行时插话)。
  • 发送组合 → 合成一个普通 Enter 事件,沿用应用自带的弹层仲裁 / 队列提交逻辑。
  • 其他所有 Enter 变体 → 通过 document.execCommand('insertText', false, '\n') 插入换行。

合成事件用 dispatching 标志防重入(否则合成的 Enter 会再次落入「其他→换行」分支)。监听器在 捕获阶段 执行并调用 stopPropagation(),确保先于根容器监听器。输入法组合期与只读输入框一律放行。

---

仓库结构

composer-enter/
├── cordis.patch.yml       # 宿主 bundle patch:插入 composer-enter 行
├── lib/
│   ├── index.js           # 宿主半(Node):设置命名空间 + /composer-enter RPC
│   └── client.js          # 浏览器半:设置行 + 回车拦截
├── package.json
├── pnpm-workspace.yaml
├── pnpm-lock.yaml
└── README.md / README.zh-CN.md

cordis.patch.yml 向宿主组合树插入一行,声明 inject: [connection],确保 RPC 通道在宿主连接服务就绪后才注册。

---

RPC 协议(宿主侧)

通道:/composer-enter · 权限:loopback(非本机调用方自动 403)。

端点入参返回
get{}{ ok: true, value: <已解析命名空间> }
set部分命名空间对象合并写回 settings.yaml 后 { ok: true, value: <已解析值> };校验失败返回 { ok: false, error }。
status{}{ ok: true, value: { exitAvailable } }(健康探针,同 dsh-system-control)。

handler 走宿主 settings 服务(dsh-settings-file),绕过浏览器侧的 WEB_SETTINGS_NAMESPACES 白名单——这是插件能托管第三方命名空间 ui-composer-enter 的关键。

---

兼容性

  • @deepseek-ai/dsh 当前 web profile(插件消费 connection、slots、locale、remote,以及可选的 settings 服务)。
  • Node ≥ 18(与 DSH 宿主运行时一致)。
  • 浏览器:Chromium 内核(使用 KeyboardEvent 合成与 document.execCommand)。

---

许可证

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类