前言¶

DeepSeek Harness（簡稱 dsh）把模型適配、工具、會話、智能體循環和界面都做成可替換的插件，官方說法是「一切皆插件」。日常使用裏，很多人會開 Web 界面：一邊看會話，一邊切設置、找 Slash Command、在已經裝上的插件之間跳轉。插件一多，這些入口就散在側邊欄、斜槓菜單和設置頁裏，離開鍵盤去點鼠標會打斷節奏。

macOS 有 Spotlight，不少編輯器有 Ctrl+K / ⌘K 命令面板，思路都一樣：一個輸入框，把當前能做的事搜出來再執行。dsh-spotlight 就是把這件事接到 DSH 網頁界面上的社區插件。它由 0xsline 維護，按 MIT 許可證開源，社區目錄歸在「界面增強」一類。需要說明的是，DeepSeek Harness 插件目錄 是獨立站點，和 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。

截至 2026 年 8 月 18 日，GitHub 倉庫顯示 7 星；npm 包名爲 @0xsline/dsh-spotlight，當前版本是 0.0.2。本文內容以插件目錄頁、GitHub README / 源碼和 npm 頁面交叉覈對後的結果爲準。

這是什麼¶

dsh-spotlight 是一個面向 DeepSeek Harness Web 的鍵盤優先全局命令面板。打開後，可以在同一個面板裏搜索原生 Slash Command、最近會話、當前頁面上的界面操作，以及已安裝插件的設置入口，用鍵盤完成篩選和執行。

它不是再造一套命令系統。README 寫得很明確：插件會發現並觸發 DSH Web 已經提供的操作，只向原生斜槓菜單貢獻一條 /spotlight 命令，不維護第二套命令註冊表。實現上，它是一個獨立的 Cordis Bundle，帶一個輕量 Web Client；package.json 裏把客戶端平臺聲明爲 web，需要裝到 Web Profile 裏纔會生效。

核心功能¶

根據倉庫 README 和客戶端源碼，當前能力可以分成下面幾塊。

1、一個全局快捷鍵。macOS 默認是 ⌘K，其他平臺默認是 Ctrl+K。面板底部可以改快捷鍵，設置寫在當前瀏覽器裏，按 Origin 和 Profile 分開保存，不會落到服務端。

2、四類可搜索條目，界面上分別標成「操作」「命令」「會話」「插件」：
- 操作：從當前頁面發現可點擊元素，以及若干內置動作。源碼裏目前包含聚焦輸入框、新建會話、打開插件設置、跳到會話開頭、跳到會話末尾；帶 aria-label / title 的按鈕、鏈接和標籤頁也會被收進來。
- 命令：讀取當前會話的宿主命令目錄，結果以 /命令名 的形式出現。無參數命令會嘗試直接執行；需要參數或執行失敗時，會把 /命令名 填回輸入框，交給原生斜槓流程。
- 會話：直接讀宿主的 sessions 服務，按最近順序打開已有會話。
- 插件：讀取已安裝插件清單，選中後跳到設置裏的插件分區。

3、穩定的模糊匹配。對標題、說明和關鍵詞做規範化後再打分，空查詢會列出當前能發現的條目；輸入關鍵字後按相關度排序。單個目錄 RPC 失敗只讓對應類別降級，不會把整個面板打掛。

4、全鍵盤操作。上下方向鍵選擇，Enter 執行，Escape 關閉；也可以直接點結果。卸載時會摘掉事件監聽、樣式和 DOM 節點。

5、不新增服務端數據通道，也不保存持久化的服務端狀態。快捷鍵配置只存在當前瀏覽器的 localStorage 中。

安裝與啓用¶

社區目錄頁給出的安裝命令是：

dsh plugin add github:0xsline/dsh-spotlight

這條命令會從 GitHub 解析插件並裝到當前配置。如需可復現安裝，目錄頁建議固定 commit 哈希，寫法是：

dsh plugin add github:0xsline/dsh-spotlight#<commit>

把 <commit> 換成倉庫裏實際的提交哈希即可，不要用佔位符直接跑。

這個插件的客戶端只掛在 Web 上，倉庫 README 要求裝進 DSH Web Profile。更穩妥的做法是帶上 --profile web。從 npm 安裝：

dsh plugin --profile web add "@0xsline/dsh-spotlight"

從 Git 源碼安裝（跟 main 分支）：

dsh plugin --profile web add "github:0xsline/dsh-spotlight#main"

裝好後啓動 Web 界面：

dsh --profile web

進入頁面後按 ⌘K 或 Ctrl+K，就應該能看到命令面板。如果快捷鍵沒有反應，先確認當前用的是 web profile，而不是 headless 或其他沒有網頁客戶端的組合。

插件以當前 dsh 進程的權限運行，安裝時可能會執行代碼。裝之前應查看 GitHub 倉庫 的源碼和 MIT 許可證，確認可以接受再安裝。

典型用法¶

下面步驟來自 README，可以按同樣順序復現。

1、打開面板。用全局快捷鍵，或者在 DSH Web 輸入框裏輸入 /spotlight，從斜槓菜單裏選「打開 Spotlight」。

2、輸入關鍵詞過濾。例如搜會話標題、Slash Command 名稱、插件名，或「新建會話」「設置」這類界面文案。中英文關鍵詞都可以，源碼裏對內置動作同時寫了中英文檢索詞。

3、用上下方向鍵移動高亮，Enter 執行；也可以直接點擊某一條。結果右側會看到類別標籤，方便區分這是操作、命令、會話還是插件。

4、改快捷鍵：點面板底部的「快捷鍵」，按一次新的組合鍵即可。點「恢復默認」會清掉本地覆蓋，回到平臺默認的 ⌘K / Ctrl+K。

一個常見路徑是：Ctrl+K 打開面板 → 輸入會話名切過去 → 再打開面板輸入 / 後面的命令名直接執行。需要改插件配置時，搜插件名或「打開插件設置」，會先點開設置，再切到插件分區。

適用場景與注意事項¶

比較適合這些情況：已經在用 DSH Web，會話和插件都不少，希望少碰鼠標；習慣 Slash Command，但記不住每一條的名字；需要在「當前頁面上看得見的按鈕」和「宿主服務裏的命令 / 會話 / 插件」之間快速跳轉。

使用前有幾點需要知道。

第一，它依賴標準 DSH Web 部署裏的 sessions、命令平面、插件清單和命令 UI 服務。這些在官方 Web 組合裏是固定組成；如果自己裁過 profile，缺了其中某一項，對應類別就會空，或者面板掛不上。

第二，部分動作發現跟着當前頁面的 DOM 走，選擇器寫在 src/spotlight/discovery.ts。宿主界面改版後，內置操作或界面條目可能失效，需要同步改選擇器。這是倉庫自己標出的限制，不是使用問題。

第三，快捷鍵存在當前瀏覽器，換機器、換 Origin 或清站點數據後要重新設置。它不會在服務端同步。

第四，社區目錄和其他彙總列表裏的安裝寫法可能不一致。以目錄頁原文和本倉庫 README 爲準：包名是 @0xsline/dsh-spotlight，GitHub 源是 github:0xsline/dsh-spotlight。不要從第三方列表裏抄未經覈對的 scope 名稱。

第五，項目仍是早期版本（0.0.2），GitHub 主題標了 dsh-plugin。DeepSeek Harness 本身也還在 developer preview，核心插件和 API 會繼續變。把它當提高 Web 操作效率的小工具即可，不要默認它能覆蓋 TUI 或無界面運行。

小結¶

dsh-spotlight 做的事情很集中：在 DSH 網頁裏提供一個鍵盤優先的命令面板，把 Slash Command、最近會話、可見界面操作和插件設置收進同一次搜索。安裝按目錄頁或 README 的命令執行，記得放到 web profile；用之前看一眼源碼和許可證。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-spotlight/

GitHub：https://github.com/0xsline/dsh-spotlight

npm：https://www.npmjs.com/package/@0xsline/dsh-spotlight