dsh-focus-composer

dsh-focus-composer

给 DSH 桌面端（DeepSeek Harness / @deepseek-ai/dsh-desktop）加一个 Ctrl+I 把光标送回输入框 的快捷键插件。

Cherry Studio 用惯了 Ctrl+I 聚焦输入框的人，换到 DSH 桌面端会不适应 —— 这个插件就是把那个手感搬过来。

A tiny DSH desktop plugin: press Ctrl+I to send the keyboard back to the session composer.

功能

• 窗口任意位置按 Ctrl+I → 光标回到当前会话的输入框
• 输入框本来就有焦点时按 = 原地不动（幂等）
• 换会话也跟着走：切到哪个会话，按下去就聚焦哪个 —— 右侧栏开着别的会话也不会抢错
• 在终端面板 / 网页面板 / 各种输入框里按，同样生效（走桌面端原生键盘桥）
• 屏幕上没有输入框时（例如停在设置页）不吞键，按键照常传给别的处理器
• 命令已注册进官方快捷键目录：设置 → 快捷键 里能看到「聚焦输入框」，可以自己改键

自定义按键

两条路，按需要挑（不冲突：设置里存过的绑定永远优先于配置里的默认键）。

路子一：直接在设置里改（日常改键用这个）

设置 → 快捷键 → 搜「聚焦输入框」→ 点右边那个键位按钮 → 按下你想用的组合。

• 立即生效，不用改文件、不用重启
• 绑定存在本机设备上（Electron 的 userData/keybindings.json），插件更新/重装都不丢
• 想还原成默认：同一行的「重置」

路子二：在插件配置里改默认键（换机器/给别人预置用这个）

在 profile 的 cordis.patch.yml 里给这一行加 config：

- id: focus-composer
  name: 'dsh-focus-composer'
  config:
    code: KeyI              # 物理键代码（KeyboardEvent.code）
    modifiers: [control]    # control | alt | shift | meta | primary

改完刷新一次页面（Ctrl+R）生效。字段含义：

• 填了不认识的值 → 自动退回 Ctrl+I（不会让插件挂掉，也不会静默绑到别的键上）
• 官方桌面端允许：12 个普通键 + 04 个修饰键；Ctrl+I 这种单修饰键组合在桌面端不受浏览器保留键限制
• 用户在设置里存过绑定的话，设置里的赢；这一项只是"没被改过时的默认值"

安装

方式一：市场 / 仓库地址安装（推荐）

在 DSH 的 插件市场 里填这串（本插件住在一个多插件仓库的子目录里，所以要带子目录选择器 —— pnpm 的 #path:）：

github:Yaoxxxxxxx/dsh-plugins#path:/packages/dsh-focus-composer

装完刷新一次页面（Ctrl+R）即可生效 —— 带客户端半边的插件和官方口径一致。

方式二：本地 tarball

pnpm add ./dsh-focus-composer-<版本>.tgz --dir <你的 profile 目录>

然后把包名加进该 profile package.json 的 dsh.profile.bundles，重启桌面端。

环境要求

卸载

1. 从 profile 的 package.json 删除 dependencies 与 dsh.profile.bundles 里的 dsh-focus-composer
2. 删除 node_modules/dsh-focus-composer
3. 重开桌面端

实现说明

为什么用官方快捷键服务，而不是自己监听 keydown

宿主自带 @deepseek-ai/dsh-client-shortcuts（服务名 shortcuts）。通过 ctx.shortcuts.register({...}) 注册的好处：

• 进官方快捷键目录 → 用户能改键、能看冲突
• Windows / macOS 桌面端会把目录推给原生键盘桥，所以不受焦点在终端 / webview / 弹窗影响
• 不用和别人的键位打架（注册时会做重复 id 与默认键冲突检查）

聚焦的两条路

lib/client.js 先试官方路径，再退到 DOM：

1. 官方：ctx.get("conversation").input.for(scope).focus() 走宿主自己的 Lexical 编辑器，能恢复草稿上次的光标位置。 scope 取 ctx.get("sessions").scope(id)，id 是会话列表里 retainedBy.mainView > 0 的那条（主视图独有，所以右侧栏的会话不会混淆）。
2. 兜底：document.querySelector("[data-composer-input]")（官方给 Lexical 根打的标记）→ focus()，再把光标 collapse 到末尾。 为什么必须自己放光标：官方源码注释写明，裸 DOM focus 会把光标放到开头，那样接着打字会插到最前面。

两条路都包了 try/catch：任一失败只 console.warn 并放行按键，不会影响应用本身。

目录结构

dsh-focus-composer/
├── package.json          # dsh.bundle.patch + dsh.client 双声明
├── cordis.patch.yml      # 挂载行：insert id: focus-composer
├── lib/
│   ├── index.js          # 宿主半边（空实现）
│   └── client.js         # 客户端半边：注册快捷键 + 聚焦
└── README.md

License

MIT