前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许用户通过外部输入增强工作流。dsh-codex-micro 插件将 Vaydeer 九键小键盘映射为 DSH 的编程代理遥控器。它接收键盘固件发出的 HID 组合键，将其翻译为 DSH 的具体动作，并提供「按键到底有没有触发 / 页面上到底有什么」的证据链。
插件信息¶
- 名称：dsh-codex-micro
- 一句话：把 Vaydeer 九键小键盘变成 DSH 的编程代理遥控器
- 所有者：harmless0819-dev
- 许可证：MIT
- 版本：0.1.0
核心功能¶
- 动作映射：将 9 个键翻成 DSH 的动作（发送、停止、新会话、模型、侧栏、设置、复制最近一条、重试，以及第二层的指令/工具/文件/插件/查看/关闭等面板入口）。
- 证据链：提供
health、events、dom端点，用于验证插件注入情况、按键触发记录以及页面按钮的真实文案。 - 九键紧急关闭：当 9 个不同的键码在一次约 600ms 的「铺开」内全部按下时，触发红屏 panic。
- 提权确认卡支持：支持通过键盘物理按键（7/8/9）确认 DSH 弹出的权限请求卡片。
- 离线测试：支持在无真实键盘连接的情况下进行单元测试。
安装与启用¶
安装命令需在用户终端中运行：
dsh plugin --profile web add github:harmless0819-dev/dsh-codex-micro
安装完成后，必须重启 dsh web 才能加载 lib/index.js 的改动。
# 重启命令示例（具体路径请根据实际环境调整）
& D:\deepseek\dsh-whale-emote\restart-web.ps1
键盘配置¶
本插件接管键盘的两层（Layer 0 和 Layer 1），层 2/3 为原生层，插件不参与。
- 硬件说明：键盘通过固件发送标准 HID 组合键，电脑无法区分其与笔记本键盘发出的信号。因此，插件只能识别组合键，绝不能使用裸数字。日常使用不需要 Vaydeer keyboard 控制程序，该程序仅作为配置工具；绑键完成后可关闭或卸载。
层 0：Agent 主控¶
| 键 | 按键组合 | 动作 |
|---|---|---|
| 1 | Ctrl+Alt+Shift+1 |
发送消息（找不到按钮则 Ctrl+Enter） |
| 2 | Ctrl+Alt+Shift+2 |
停止 / 中断（找不到按钮则 Esc） |
| 3 | Ctrl+Alt+Shift+3 |
新建会话 |
| 4 | Ctrl+Alt+Shift+4 |
模型（加载中显示文案待补） |
| 5 | Ctrl+Alt+Shift+5 |
访问模式（工作区内修改 / 只读） |
| 6 | Ctrl+Alt+Shift+6 |
侧栏开关（收起 / 展开侧边栏） |
| 7 | Ctrl+Alt+Shift+7 |
任务看板 |
| 8 | Ctrl+Alt+Shift+8 |
轨迹视图 |
| 9 | Ctrl+Alt+Shift+9 |
下一层（键盘固件动作，不经插件） |
层 1：UI 面板与诊断¶
| 键 | 按键组合 | 动作 |
|---|---|---|
| 1 | Ctrl+Alt+Shift+F1 |
指令面板 |
| 2 | Ctrl+Alt+Shift+F2 |
添加附件 |
| 3 | Ctrl+Alt+Shift+F3 |
更多操作 |
| 4 | Ctrl+Alt+Shift+F4 |
视图选项 |
| 5 | Ctrl+Alt+Shift+F5 |
打开右侧边栏 |
| 6 | Ctrl+Alt+Shift+F6 |
展开底部面板 |
| 7 | Ctrl+Alt+Shift+F7 |
搜索会话 |
| 8 | Ctrl+Alt+Shift+F8 |
探测 DOM（抓页面结构回传，排错用） |
| 9 | Ctrl+Alt+Shift+F9 |
上一层（键盘固件动作，不经插件） |
验证与排错¶
安装并配置键位后，通过以下端点验证插件是否正常工作：
- 客户端加载状态：
Invoke-WebRequest http://127.0.0.1:3080/dsh-codex-micro/health.json -UseBasicParsing
# clientsLoaded 应该 >= 1
- 按键触发记录：
# 最近 300 条事件（含失败原因）
Invoke-WebRequest http://127.0.0.1:3080/dsh-codex-micro/events.json -UseBasicParsing
# 按一下触发键后，seq 应该增长，lastReport 里出现 label / ok
- 页面按钮清单：
# 用于修点击目标
Invoke-WebRequest http://127.0.0.1:3080/dsh-codex-micro/dom.json -UseBasicParsing
单独验证键盘硬件：使用 key-probe.html 浏览器工具逐个按 9 个键，确认收到的是预期的组合键（code 应该是 Digit1…/F1…，且带 Ctrl+Shift）。
注意事项¶
- 权限与运行环境：插件以当前 dsh 进程权限运行。安装前应检查源码与许可证（MIT）。
- 不支持的动作：插件不支持模拟文本输入、宏、鼠标键、打开网址或程序、托盘切层等需要电脑侧模拟的动作。
- 提权确认卡：目前故意没放危险动作（如批准/拒绝/删除）。若需添加，请先按下对应键让插件抓取真实按钮文案（
dom.json），确认无误后再修改配置。 - 离线测试：可通过
test-harness.mjs和test-panic.mjs进行本地单元测试。
