前言¶
DeepSeek Harness（DSH）把界面能力拆成可組合的客戶端插件。設置、插件列表、會話切換、主題和快捷鍵往往分散在不同入口裏；若還要記住每個功能的鍵位，日常操作成本會偏高。VS Code、macOS 等環境普遍用「命令面板」把可執行項集中到一個可搜索的浮層裏。下面介紹社區插件 dsh-spotlight（維護者 hakulat2023），它在 DSH Web 客戶端或桌面應用中提供同類體驗：全局快捷鍵或 / 打開面板，搜索並執行設置、插件、會話、快捷鍵、主題，以及其它插件註冊的命令。
這是什麼¶
dsh-spotlight 是 DSH 的 bundle 型客戶端插件（分類：客戶端）。它在 shell.overlay 上掛載一個全局命令面板，把 Harness 內置操作與可配置快捷鍵目錄鏡像到同一列表，並通過 spotlight 服務供其它客戶端插件擴展。當前版本 1.0.1，許可證 MIT；開發與驗證針對 DSH 0.2.x（README 寫明在 0.2.1-rc.5 上驗證）。
核心功能¶
全局面板與快捷鍵¶
- 在 Settings → Shortcuts 中可重新綁定的打開命令：
Cmd/Ctrl+Shift+P切換面板；在非文本輸入區域按/也可打開。 - 面板內：
↑/↓移動高亮，Enter執行，Esc關閉。打開器走 shell 的 shortcut 服務，桌面端經原生鍵盤橋接生效。 - README 說明：默認不用
Cmd/Ctrl+Shift+/，因 macOS 上 Electron 會先消費該組合鍵；另有模態層打開時面板不會彈出，以免無法聚焦輸入框。
內置命令分組¶
| 分組 | 能力（英文標籤與 README 一致） |
|---|---|
| Navigate | Open Settings、Open Plugins、Search Sessions、Add Workspace、Keyboard Shortcuts |
| Session | New Session、Archive Current Session、Compact Session |
| View | Toggle Sidebar、Toggle Right Sidebar、Workspace Files |
| Appearance | Theme: Dark / Light / System；Language: English / 中文 |
Archive Current Session 複用 shell 的 session.archive 快捷鍵邏輯（含運行中確認與歸檔提示）。Compact Session 通過 Host 的 /compact 執行，需空閒 agent 且歷史可壓縮。Workspace Files 與 Toggle Right Sidebar 優先走 shell 快捷鍵，必要時回退到 sidebarRight 控制器。
Shortcuts 鏡像組¶
除上述一等命令外，插件把 shell 可配置快捷鍵目錄中剩餘項列入 Shortcuts 組，每行顯示本地化名稱與當前生效的鍵位；執行時走 shell 自身的 resolve()，因此 rename、fork、split、fullscreen、terminal 等未單獨暴露 client 服務的命令也可從面板觸發。窗口/頁面關閉及刪除類操作被刻意排除。
擴展註冊表¶
其它客戶端插件通過 Cordis 的 spotlight 服務註冊命令：id、run 必填；可選 title / titleKey、group、hint、keywords（中英文均可檢索）。register() 返回 disposer，應掛到 ctx.effect 以便插件禁用或 HMR 時卸載。服務還提供 open、close、toggle、isOpen、list。
樣式表在 bundle 物化時注入並由模塊系統認領；locale、命令表、快捷鍵項與 overlay 槽位以 Cordis effect 註冊，禁用或熱更新 teardown 時會一併移除。
環境要求¶
| 項 | 說明 |
|---|---|
| DeepSeek Harness | 0.2.x |
| 運行面 | Web 客戶端（dsh-web-app）或桌面應用 |
| 構建 | 無需單獨構建；瀏覽器 bundle 爲手寫 JavaScript |
| Node.js | 使用插件本身不需要；倉庫測試套件需 Node 20+ |
安裝與啓用¶
包在 package.json 中聲明 dsh.bundle.patch 與 dsh.client，cordis.patch.yml 插入 host 行。安裝後須出現在 profile 的 dsh.profile.bundles 列表中；僅寫在 dependencies 而未選 bundle 時，客戶端半部分不會進入模塊圖。
從 GitHub 安裝（官方 README 命令）：
dsh plugin --profile desktop add github:hakulat2023/dsh-spotlight#v1.0.1
省略 #v1.0.1 則跟蹤默認分支。本地目錄可用 plugin_manager install_bundle 或 dsh plugin --profile desktop add /absolute/path/to/dsh-spotlight（路徑需爲絕對路徑）。
安裝或更新後應重啓應用。 Host 半部分是 Node 模塊，運行中的進程保留已加載的模塊代際；客戶端模塊圖在發佈前也會快照 bundle，僅刷新頁面可能仍服務舊 bundle。重啓可保證新客戶端半部分加載，並重新向原生鍵盤橋接註冊面板快捷鍵。
社區目錄頁（與 DeepSeek / 幻方無官方從屬關係）：skillhub.cn/plugins/hakulat2023/dsh-spotlight。
典型用法¶
- 安裝並重啓 DSH 桌面 profile（或對應 Web 部署）。
- 在任意非輸入焦點處按
Cmd/Ctrl+Shift+P，或按/，打開面板。 - 輸入關鍵詞（如
theme、插件、session）篩選，用方向鍵選中後Enter執行。 - 在 Settings → Shortcuts 中按需改綁「切換命令面板」快捷鍵。
其它插件向面板貢獻命令時，在 client 模塊中 inject: ['spotlight'] 並調用 ctx.spotlight.register({ ... })；完整字段與 TypeScript 接口見 GitHub README。
適用場景與注意¶
- 適合：習慣命令面板工作流、希望少記分散快捷鍵、需要在同一入口切換主題/語言/側欄/會話，或希望把自有客戶端能力暴露爲可搜索命令的插件作者。
- 權限與安全：插件在當前 DSH 進程權限下運行；安裝前請閱讀倉庫源碼與 MIT 許可證，確認 bundle 列表與
cordis.patch.yml變更符合預期。 - 限制：面板無法在其它模態打開時使用；部分 mirrored 快捷鍵在無當前會話、無聚焦頁面或無空閒 agent 時會被 shell 攔截，面板關閉後行爲與直接按快捷鍵一致。
結尾¶
dsh-spotlight 把 DSH 常用客戶端操作與快捷鍵目錄收進一個可搜索的 Spotlight 式浮層，並留出 spotlight 服務供生態擴展。源碼與詳細說明見 GitHub：hakulat2023/dsh-spotlight；插件索引見 SkillHub 目錄頁。
