前言¶
在 DeepSeek Harness（DSH）Web 裏操作會話、觸發斜槓命令、調整插件設置時，常見做法是鼠標點菜單或在輸入框裏逐字輸入命令名。功能分散在界面各處，切換成本不低。
DSH 生態遵循「一切皆插件」：能力通過 Cordis bundle 安裝到 profile，而不是改宿主源碼。dsh-spotlight 是維護者 0xsline 發佈的客戶端插件，用一個全局快捷鍵打開統一面板，在同一處搜索並執行原生斜槓命令、最近會話、當前頁面可操作項和已安裝插件設置，全程可鍵盤完成。
這是什麼¶
@0xsline/dsh-spotlight（GitHub：0xsline/dsh-spotlight）是面向 DSH Web 的命令面板插件。README 將其定位爲 keyboard-first command palette for DeepSeek Harness Web。
插件不維護第二套命令註冊表，而是讀取 DSH Web 已有的 sessions、command-plane、plugin-inventory 等服務，並掃描當前頁面可觸發操作的 DOM 元素，把執行委託回這些原生入口。它向原生斜槓菜單貢獻 /spotlight 命令，卸載時會清理事件監聽、樣式和 DOM 節點。
當前 npm 版本爲 0.0.2，許可證 MIT。GitHub 倉庫約 12 stars、2 forks；SkillHub 目錄分類爲「客戶端」。
核心功能¶
下面介紹 README 中列出的能力，均可在倉庫文檔覈對。
統一入口
- macOS 默認
⌘K，其他平臺默認Ctrl+K打開面板。 - 也可在 DSH Web 輸入框輸入
/spotlight，從原生斜槓菜單進入。
可搜索的內容
- 原生斜槓命令。
- 最近會話。
- 當前頁面可見 UI 操作。
- 已安裝插件的設置項。
搜索使用確定性模糊匹配；方向鍵上下選擇，Enter 執行，Escape 關閉，也可點擊結果。
快捷鍵自定義
面板頁腳提供 Shortcut 控件，點擊後錄製新的組合鍵；Reset 恢復平臺默認。偏好保存在當前瀏覽器 origin 與 profile 下，不寫服務端持久狀態。
生命週期
插件爲獨立 Cordis bundle，掛載於宿主標準服務就緒之後。某類目錄 RPC 失敗時僅降級對應分類，不影響其他來源；卸載時移除自身資源。
安裝與啓用¶
先把 bundle 安裝到 DSH Web profile。官方 README 提供兩種方式。
從 npm 安裝（發佈包已包含構建產物 lib/，安裝時不跑 prepare）：
dsh plugin --profile web add "@0xsline/dsh-spotlight"
從 Git 源碼安裝（會執行包內 prepare，在倉庫本地用 TypeScript 與 tsdown 重建 lib/；若禁用了 lifecycle scripts，請改用 npm 發佈包）：
dsh plugin --profile web add "github:0xsline/dsh-spotlight#main"
安裝後啓動 DSH Web：
dsh --profile web
按 ⌘K 或 Ctrl+K 即可打開面板。
本地開發調試時，README 建議在克隆倉庫並 pnpm install 後執行：
pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web
開發環境要求 Node.js ^22.19.0 || >=24.0.0、pnpm 11.7.0。
典型用法¶
- 用全局快捷鍵打開 Spotlight，或在 composer 輸入
/spotlight並從斜槓菜單選中。 - 輸入關鍵字過濾命令與操作。
- 方向鍵選擇後 Enter 執行，或直接點擊條目。
- 需要改快捷鍵時，點頁腳 Shortcut 錄製新組合；點 Reset 恢復默認。
面板裏的條目最終仍由 DSH Web 原生服務或頁面元素執行，插件本身不新增服務端數據通道。
適用場景與注意¶
適合誰
- 經常在 DSH Web 裏切換會話、調用斜槓命令或改插件設置，希望減少鼠標路徑的用戶。
- 已按 DSH 插件方式管理 Web profile，願意在瀏覽器端增加一個客戶端 bundle 的開發者。
使用前請知悉
- 插件以當前
dsh進程及其 Web 客戶端權限運行；安裝前建議閱讀 GitHub 源碼 與 MIT 許可證，確認符合你的安全與合規要求。 - 部分發現邏輯依賴當前 DSH Web DOM；宿主 UI 變更時，可能需要更新
src/spotlight/discovery.ts中的選擇器（README「How it works」有說明）。 - SkillHub（目錄頁）是社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；版本與安裝命令以倉庫 README 爲準。
小結¶
dsh-spotlight 把 DSH Web 裏分散的原生能力收進一個可搜索、可鍵盤導航的命令面板，並複用宿主命令平面而非平行維護註冊表。若你已在用 DSH Web，可按上文命令安裝到 web profile，用 ⌘K / Ctrl+K 試用。
