dsh-emacs-keys

dsh-emacs-keys

dsh-emacs-keys 是一个 DeepSeek Harness（DSH）插件，接管 DSH Web 的键盘快捷键并重构为 Emacs 风格绑定。激活后，插件在 window 捕获阶段拦截几乎所有 Ctrl/Alt 组合——包括浏览器默认行为（打印/保存/查找/历史/缩放/剪贴板）——改由插件的 Emacs 命令处理。

快捷键不写在代码里：全部配置在工作区的 emacs-keybindings.json，按功能树组织，遵循 Emacs 记法，改完按 C-x C-r 热重载即可生效。

功能

• 全局导航：C-p/C-n 滚动对话（到边缘有"已到顶部/已到底部"提示），C-v/M-v 翻页，M-</M-> 跳到对话开头/末尾
• 区域操作（任何焦点上下文都生效）：C-w 剪切、M-w 复制、C-y yank、M-y yank-pop —— 作用于当前文档选区；C-y 无选区时自动聚焦输入框粘贴；只读内容上的 C-w 降级为复制并提示
• 完整输入编辑（Lexical 输入框）：kill-ring（剪切环）、mark/region、undo/redo、字符/单词/行移动，兼容 Lexical 的选区同步模型
• 前缀键：C-x 前缀序列（C-x k 关会话、C-x o 切面板……），C-u 通用参数
• i-search：C-s / C-r 前向/后向搜索
• 配置热重载：C-x C-r 重新读取配置文件，无需重启插件
• 设置页：DSH 设置 → "Emacs 快捷键"，实时渲染当前生效的配置树与来源

安装

本插件是动态 Cordis 插件（Client + Host 双半，运行时定义），不走静态 bundle 安装。两种方式：

方式一：在 DSH 会话中用 cordis 工具定义（推荐）

在任意 DSH 会话里让 Agent 执行：

1. 读取 _body_config_host.js 与 _body_config_client.js 的内容；
2. 调用 cordis_define（kind: "new"，idPrefix: "emacs"，同时提供 code.host 与 code.client）；
3. 调用 cordis_run 激活返回的 package，并在 UI 上批准客户端包。

git clone https://github.com/renshuo/dsh-emacs-keys.git
cd dsh-emacs-keys   # 把该目录设为 DSH 会话工作区即可

方式二：引用本仓库源码

插件代码即本仓库的两个函数体文件，Agent 可直接 github:renshuo/dsh-emacs-keys 拉取后按上述流程定义。

使用

激活后无需配置即可使用。内置默认键位（节选）：

完整键位见设置页，或直接读 emacs-keybindings.json。

配置

快捷键配置在工作区根目录的 emacs-keybindings.json，结构为功能树：

{
  "categories": [
    {
      "name": "区域操作（任何焦点）",
      "context": "region",
      "bindings": {
        "region.kill": { "key": "C-w", "label": "剪切选中区域（进 kill-ring）" }
      }
    }
  ]
}

• Emacs 记法：C=Ctrl、M=Alt、S=Shift、SPC=空格；序列以空格分隔（如 "C-x k"）
• context 分发层（与 Emacs 的 buffer/global 语义对应）：
  • region —— 任何焦点上下文都生效（最先匹配）
  • global —— 仅输入框外生效
  • editing —— 仅输入框内生效
  • prefix:C-x —— C-x 前缀序列（键名为序列最后一个键）
  • prefix-start —— 前缀启动键
• 同一按键可在不同 context 绑定不同功能（如 C-p 在 global 是滚动、在 editing 是上一行）
• 修改 key/label/增删分类均为纯配置操作；新增 功能ID 需在 _body_config_client.js 的 IMPL 注册表中登记对应实现
• 改完按 C-x C-r 热重载；配置文件缺失或非法时自动回退到内置默认树（行为与上表一致）

接管范围（interception policy）

注意：在普通浏览器标签页中，Ctrl+N（新窗口）/ Ctrl+T（新标签）由浏览器在页面之前处理，任何页面脚本都无法拦截；在 DSH 桌面（Electron）窗口中这些键可正常接管。

架构

emacs-keybindings.json          功能树配置（Emacs 记法）
        │ fs 服务读取
        ▼
┌─────────────────────────┐  包私有 RPC   ┌──────────────────────────────┐
│ Host 半                  │ ───────────▶ │ Client 半                     │
│ _body_config_host.js    │              │ _body_config_client.js       │
│ harness.handle(read)    │              │ 解析配置 → 构建分发表          │
└─────────────────────────┘              │ window keydown（捕获）→ IMPL  │
                                         └──────────────────────────────┘

• Host 半：通过 fs 服务读取配置文件，经 harness.handle 提供包私有 RPC
• Client 半：启动时拉取配置构建分发表（Emacs 记法规范化、前缀序列解析、变体匹配），缺失时回退内置默认树；按键驱动 IMPL 动作注册表
• 键盘事件在 window 捕获阶段拦截，先于 Lexical/React 处理；剪贴板编辑延迟一个宏任务执行，避免与 Lexical 的 selectionchange 模型同步竞态
• 生命周期：监听器由 ctx.effect 持有，插件停止/更新/卸载时自动移除

开发

• _body_config_host.js / _body_config_client.js：实际部署的两半函数体（纯 JavaScript，无 import/TS/JSX）
• _verify/：基于真实 Lexical + Chromium 的回归模拟环境（serve.js + lexsim.js/v7sim.js），可用于本地验证按键行为
• 修改代码后：重新 cordis_define（kind: "existing"，pluginId 不变）→ cordis_run update

兼容性

• DSH Web（http 与桌面 Electron 壳）
• Lexical 输入框（DSH composer，registerPlainText + registerHistory）
• 普通 contenteditable 与 textarea/input 编辑器

许可

GPL-3.0-only（GNU 通用公共许可证第 3 版）。

本项目为自由软件：你可以在该许可证条款下重新分发和/或修改它。衍生作品须同样以 GPL-3.0 发布。