KhalilJar/Remu-desktop-shortcuts

给 官方 DeepSeek Harness Desktop 和 社区版 dsh-desktop 用的快捷键小插件：把「我又想伸手拿鼠标了」的时刻，变成一个自己喜欢的组合键。

**适用范围：Desktop 内容页。**普通浏览器中的 DSH Web 暂不支持；它也不是系统全局热键。下面的功能和安装说明针对本仓库的 0.4.5 代码；安装前请看下载到的 package.json 版本。官方和社区版的行为不完全相同，详情见兼容与实测。

0.4.5 这次更新了什么

• **找回 DSH NEXT 的 DevTools 快捷键：**保留原来的 kana.shortcuts.devtools 动作 ID；社区 Stable 继续使用旧桌面桥，DSH NEXT 2.0.22-next 改走其受控原生命令。没有对应桥的官方 Desktop 不显示这个动作。
• **修好「自定义快捷键」录制按钮一闪就退出：**录制时按钮不再被替换或因失焦立即取消；可以按 Esc 或再次点按钮取消，不需要重置已经保存的键位。
• **实际验证：**用户在 Windows DSH NEXT 2.0.22-next 的插件设置页完成 DevTools 键位录制/修改，关闭设置后按键成功打开 DevTools；本地 22 项自动化测试通过。其他系统及所有动作尚未逐项实测。
• **升级提醒：**社区 Stable 2.0.18 与 DSH NEXT 的快捷键存储不同，前者的旧键位不会因插件动作 ID 保持不变而自动迁移到 NEXT；内置键位也可能需要重新录制。请勿为排查直接清空配置。

它为什么会出现

我平时用社区版 dsh-desktop，最喜欢增强模式：窗口上方那条有点突兀的灰色终于不见了。但随着灰条一起消失的，还有顺手打开 DevTools 的入口；连 Ctrl+Shift+I 也调不出来。于是我请 GPT 帮忙写了第一版插件——那时它只做一件事：让我能用自己设的快捷键打开开发者工具。

后来我又发现，每天真正在意的都是些很小的动作。浏览器可以 Ctrl+数字 切标签页，我也想这样切 DSH 的功能页；从功能页回到聊天时，总要再拿鼠标点一下输入框，我也想一步到位。于是有了会话速切、正文聚焦、返回上一个会话……它们不是凭空设计的功能清单，而是我用着用着，确实想要的东西。

当然，不用鼠标、只用键盘完成一串操作，真的很有一点 hack 感。这也是我想把这个小插件分享出来的原因。如果你也有「这里明明很适合加个快捷键」的瞬间，欢迎来聊。

能做什么

除下方特别注明的固定编号键外，可录制动作默认都不绑定键位：你自己选择，冲突时由 DSH 的快捷键服务校验，不改 Enter 发送行为，也不抢系统级快捷键。

动作	实际效果	说明
返回会话	从功能页回到当前会话，不创建新会话。	官方、社区 Desktop 均提供。
返回会话并聚焦输入框	回到当前会话，让光标进入消息输入框，省一次鼠标点击。	需要已有会话及可用的输入框。
聚焦会话内容（方向键滚动）	将焦点从输入框移到当前会话正文的滚动区，随后可用方向键正常滚动。	不切换会话，也不改正文。
速切最近会话（连按轮换）	按一次切到下一会话；约 1.8 秒内连按，在当前可见的普通会话中继续轮换。	列表也可能包括可见但尚未访问的会话；不跳到归档会话或子 Agent 会话。
返回上一个会话（往返切换）	类似 cd -：在最近访问过的两个会话间往返。	本次页面加载后先访问至少两个会话；重新加载会重置这份临时访问记录。
切换到功能页 1～9	为每个编号分别录制快捷键；1～8 对应左侧当前功能页顺序，9 对应最后一个功能页。	目标页尚未出现时不会乱跳；官方 Desktop 也可用录制方式配置。
开发者工具	用自己录制的键切换 DevTools。	社区 Stable 2.0.18 使用旧桥，DSH NEXT 2.0.22-next 使用其受控桌面指令；NEXT 的自定义录制和按键打开 DevTools 已在 Windows 实机确认。无桥的官方 Desktop 不显示此动作，请用应用菜单。

另外：社区 Stable 2.0.18 / Windows 保留固定 Ctrl+1～8（按左侧功能页顺序）、Ctrl+9（最后一个功能页），无需录制；与已有绑定冲突时不接管。DSH NEXT 与官方原生 Desktop 不提供这组固定键，可以给上表中的九个功能页动作分别录制键位。系统 Alt+Tab 不受影响。

安装与第一次使用

推荐：在 Desktop 中安装

1. 打开你实际使用的 DSH Desktop，在侧栏进入 插件 → 添加插件；也可以点「添加插件」旁的箭头，选 安装第三方插件。如果这里显示不可用，先确认当前 Desktop 使用了可管理插件的 Profile。
2. 在安装框里填入本仓库地址：https://github.com/KhalilJar/Remu-desktop-shortcuts.git，点击 安装。它接受 Git 地址，不需要把单独的 client.js 复制到 DSH 的安装目录。
3. 安装成功后点击 立即启用；在已安装插件中确认 kana-desktop-shortcuts 已启用。如果界面提示需要重启，就按提示重启 Desktop。
4. 打开 设置 → 自定义快捷键，选择动作，点击 ＋ 录制快捷键；按下希望使用的组合键，确认没有冲突提示。关闭设置后，回到 Desktop 内容页实际按一次试试。除了社区 Stable Windows 的固定 Ctrl+数字，本插件不会替你预设键位。

**版本提醒：**请以实际下载到的 package.json 和安装器显示的版本为准。0.4.5 起包含 DSH NEXT DevTools 适配及录制控件修复；若仍是 0.4.3，则有其他 Desktop 快捷键动作，但 NEXT 不显示 DevTools 动作。仅更新 README 文字不会更新你已安装的插件。

Desktop 安装器拉取 Git 仓库失败？使用本地目录

在仓库页面用 Code → Download ZIP 下载并解压，或者在装有 Git 的终端执行：

git clone https://github.com/KhalilJar/Remu-desktop-shortcuts.git

这条命令把仓库下载到当前目录下的 Remu-desktop-shortcuts 文件夹。然后回到上面的 添加插件，填入解压/克隆后的完整目录绝对路径——即同时包含 package.json 和 cordis.patch.yml 的文件夹，不是其中某一个文件。安装源或 GitHub 连接失败时，本地目录方式不需要由 DSH 再去下载该仓库；若安装器报告依赖脚本需要授权，请先看清具体包名和风险，不要盲点批准。安装本地旧版也不会凭空获得 0.4.5 的 NEXT DevTools 与录制控件修复。

如果你习惯命令行，Desktop 自带的「打开 DSH 终端」也提供 dsh plugin add <Git 地址或本地绝对路径>；先用图形界面更容易看见安装失败原因和启用状态。不要把普通终端里的另一套 DSH CLI 当作当前 Desktop Profile 的安装器。

升级或排查

• **设置页没出现：**确认装在正在使用的 Desktop Profile、插件已启用，并按安装器提示重载/重启；不要只看“安装成功”。普通 DSH Web 不会出现此页。
• **提示“快捷键配置不可读取”：**先检查插件版本。0.4.0/0.4.1 的新增功能页动作 ID 曾与官方原生 Desktop 的校验规则不兼容；0.4.2 起已修复。不要为排查直接清空键位或点“恢复默认”。
• **键位保存了但按下没反应：**先关闭设置或菜单，让 DSH 主窗口获得焦点；检查冲突提示，以及组合键是否被操作系统抢先处理。独立 DevTools 窗口、其他应用或内嵌网页不是本插件的热键作用范围。
• **从社区 Stable 2.0.18 升到 DSH NEXT 2.0.22-next 后键位不见了：**有用户实测插件键位与 DSH 内置键位一起恢复默认，重新绑定后可用。旧版快捷键实际使用 Electron 页面 localStorage；NEXT 改用原生 Desktop 的 keybindings.json，且该产品未提供 Stable/Beta 数据迁移。**这不证明旧数据已被删除。**保留原六个动作 ID 不等于跨产品自动搬运键位；请在 NEXT 中检查并重新录制，别直接复制旧存储或清空新配置。
• **从社区版切到官方版后键位不见了：**不同 Desktop/Profiles 的快捷键存储也不一定相同，需要在各自环境检查并录制。插件不主动迁移或清除旧绑定；若曾在 0.4.0/0.4.1 给新增九个功能页动作录过键，因 ID 已修正，这九项需要重新录制。
• **更新插件：**在插件页核对当前版本和来源；第三方 Git/本地安装不保证自动获得新代码。按插件管理器的升级提示操作，必要时先记下自己的键位，再卸载旧包、安装新版并启用；不同 Profile 要分别处理。

兼容与实测

这不是「所有 DSH、所有系统、所有组合键都保证生效」的承诺。以下是已经观察到的范围，不是仅凭单元测试推测：

环境	已有证据	尚未保证
社区版 Windows Desktop 增强模式	早期版本的原六项与固定 Ctrl+1 获用户实际按键确认。	新版所有组合键并未逐一复测。
社区版 Windows Desktop 兼容模式	0.4.1 起用户确认设置页出现、原有“返回并聚焦输入框”键位生效。	DevTools 与所有固定编号键尚未逐一实测。
社区版 Windows Desktop 扩展模式	用户截图确认设置页及旧绑定可见，并反馈已测试键位生效。	每个动作和固定编号键未逐一实测。
DSH NEXT 2.0.22-next / Windows	0.4.3 的普通动作用户重新录制后可用；0.4.5 的“开发者工具”已在插件设置页持续录制、保存/修改，关闭设置后按键实际打开 DevTools；同一动作也出现在 DSH 自带快捷键弹窗。	其他键位未逐一复测；旧 Stable 的固定 Ctrl+数字 不会在 NEXT 接管。
官方 Windows DSH Desktop 0.2.1-rc.5	0.4.2 起用户确认配置可读、录制可用，录制的“返回并聚焦输入框”从功能页触发成功。	官方原生环境不显示社区 DevTools 动作；九个功能页动作尚未逐一实测。
macOS / Linux Desktop	按相应环境的桥接与快捷键校验能力尝试降级。	暂无真机验证；允许的组合和实际送达可能不同。
普通 DSH Web	本版刻意不启用。	不要在浏览器里寻找这个设置页。

本地 0.4.5 通过 22 项单元测试，且 NEXT 2.0.22-next / Windows 的录制控件与 DevTools 按键已获用户实机确认；这不等于其他模式、系统或全部键位都已验收。插件依赖 DSH 的 shortcuts、settings.section、会话、布局、工作区等客户端服务和部分页面结构；未来版本若改动这些接口，仍可能需要适配。

万一以后官方也做了同样的功能？

我当然也担心「好不容易做出来，官方更新就有了」。但仓库里的代码不会被 DSH 更新自动改写；真正要留意的是接口变动可能让插件失效，或内置快捷键与自己的设置发生冲突。遇到重叠功能，可以优先用更稳定的内置实现，移除冲突绑定，或关闭本插件；不必为了“证明插件有用”硬撑。

如果官方后来真的做了，那说明这些小麻烦也被更多人看见了。至少我已经把每天真实想用的操作做成了一个可以分享、改进、选择是否启用的东西；这件事本身就不算白做。

反馈与一起完善

欢迎在 Issues 提你日常想要、但还没有快捷键的动作，也欢迎提交 Pull Request。遇到问题时请附上：官方/社区版、DSH 与插件版本、操作系统、所用模式、录制的组合键、预期与实际现象；能给复现步骤更好。请勿上传账号凭据、会话正文或私有配置。

想参与本地验证：在仓库根目录安装 Node.js 后运行 node --test test/client.test.mjs（--test 使用 Node 自带测试运行器）；node --check client.js 只检查语法，不改你的键位。测试通过不等于你那台机器上的按键一定能触发，最有价值的反馈仍然来自真实使用。