前言¶
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進行本地單元測試。
