前言¶
在 DeepSeek Harness（DSH）裏跑多會話、長對話時，側邊欄自帶的搜索往往夠用，但範圍和預覽方式有限：要在一堆 Session 和聊天記錄裏定位某句話，時常需要多次點開、來回翻。IDE 用戶更習慣 Cmd/Ctrl+K 喚出居中搜索框，上面是命中列表、下面是帶行號的上下文預覽——這和「在路徑中查找」的節奏接近。
下面介紹社區客戶端插件 dsh-spotlight（維護者 mdalboni）：用居中模態搜索替換側邊欄搜索體驗，同時覆蓋 Session 與聊天消息，並支持實時檢索與 SQLite FTS 持久化歷史。插件歸類爲客戶端，面向 Web 端 DSH（--profile web）；在 SkillHub 插件目錄 可查閱條目，源碼與說明見 GitHub 倉庫。DSH 生態奉行「一切皆插件」；SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-spotlight 是 DSH 插件，將側邊欄搜索升級爲 Apple Spotlight 與 IntelliJ/PyCharm 風格的居中搜索對話框，搜索對象包括 Sessions 與 chat messages。當前 package 版本爲 1.0.2，許可證 MIT（Maxwell Dalboni）。運行要求：dsh 與 @deepseek-ai/dsh 均爲 >=0.2.1-rc.3；客戶端通過 cordis.patch.yml 注入，依賴 @deepseek-ai/dsh-client-ui-workspace 與 @deepseek-ai/dsh-client-ui-layout，並在 Web 端 immediately 加載。
核心功能¶
居中搜索與觸發方式¶
- 點擊側邊欄搜索放大鏡，或按
Cmd+K/Ctrl+K，打開居中模態搜索框。 - Filter Selector 可在 Sessions、Chat messages 或兩者同時（默認）之間切換。
IntelliJ「Find in Path」式佈局¶
- 上方面板（搜索結果）：展示匹配的 Session 與聊天摘錄，高亮查詢詞，並顯示相對時間戳、目錄標籤。
- 下方面板（實時上下文預覽）：以帶行號的對話上下文（用戶與助手輪次）展示命中位置，搜索詞高亮。
鍵盤與快捷操作¶
↑/↓：在結果間移動。Enter或雙擊：打開所選 Session。- 每條結果上的快速打開按鈕（
↗）。 Esc：關閉對話框。
檢索與界面¶
- 即時 live search：檢索當前活動 Session 收件箱；持久對話歷史由 SQLite FTS 支撐。
- 移動端：全屏響應式佈局、單擊進入 Session、專用關閉按鈕、虛擬鍵盤兼容、側邊欄抽屜自動收起。
- 主題：使用 DSH
--dsw-alias-*主題令牌，適配淺色與深色模式。
安裝與啓用¶
安裝前請自行閱讀倉庫源碼與 MIT 許可證；插件在當前 DSH 進程權限下運行，與任何 DSH 插件一樣，只安裝你信任的源。
通過 DSH 插件市場（dshmarket）¶
在 DSH Plugin Marketplace 中搜索 dsh-spotlight，點擊 Install。
通過 DSH CLI¶
Web 配置檔下添加插件名（與倉庫 README 一致）：
dsh plugin --profile web add dsh-spotlight
倉庫 README 還說明可從本地源碼以 link: 方式添加；若你採用該路徑，需自行 git clone 倉庫並在本地執行 dsh plugin --profile web add link:./dsh-spotlight，此處不展開步驟細節。
典型用法¶
啓用插件並重啓或刷新 Web 客戶端後，可按下面順序操作：
- 在任意 DSH Web 界面按
Ctrl+K（macOS 爲Cmd+K），或點側邊欄搜索圖標。 - 輸入關鍵詞；觀察上方結果列表中的 Session 與消息摘要。
- 用篩選器限定只搜 Session、只搜聊天，或保持默認的聯合搜索。
- 用方向鍵選中條目，在下方面板覈對對話上下文與高亮命中。
Enter、雙擊或↗打開對應 Session；Esc關閉搜索框。
維護者提供的單元測試命令（用於驗證插件包，而非終端用戶必做步驟）：
node --test test/index.test.js
適用場景與注意¶
適合誰：經常在 DSH 裏維護多個 Session、需要在歷史聊天中全文檢索某配置名、報錯片段或口令的開發者；習慣 IDE 式「搜索 + 預覽」而非純列表跳轉的用戶。
注意：
- 插件分類爲客戶端，安裝命令使用
--profile web；其他 profile 是否適用應以你本地 DSH 文檔與插件package.json中dsh.client聲明爲準。 - 引擎版本需滿足 >=0.2.1-rc.3，過低版本可能導致注入或 UI 依賴不可用。
- 搜索範圍與 FTS 索引行爲以實現爲準，升級 DSH 或插件後若結果異常，可對照 Issues 與倉庫更新說明。
結尾¶
經過上面的步驟，你可以在 Web 端 DSH 裏用統一快捷鍵完成 Session 與聊天內容的集中檢索，並在打開 Session 前通過下方面板確認上下文。dsh-spotlight 把側邊欄搜索升級爲居中、可篩選、可預覽的流程，適合會話與消息都較多的日常開發。
