前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的理念。在 Web GUI 環境下，快速定位文件並直觀區分文件類型是日常開發中的常見需求。現有的資源管理器功能在搜索靈活性和視覺區分度上存在侷限。本插件通過在 dsh-better-sidebar 的內置 Explorer 標籤頁中增加搜索功能和文件類型徽章，直接在現有界面中提升了文件管理效率。
插件介紹¶
該插件由用戶 mastereal 維護，開源協議爲 MIT。它是一個客戶端插件，主要解決兩個問題：一是無需跳轉即可在資源管理器內進行模糊搜索，二是通過彩色徽章在資源管理器樹和編輯器標籤頁中展示文件類型。
核心功能¶
-
內嵌篩選框
篩選框直接位於內置 Explorer 標籤頁的「工作文件夾名」下方。輸入關鍵詞即可即時篩選文件列表。 -
Codex 式子序列匹配
搜索採用子序列匹配算法（字符按順序命中即可）。例如，輸入bxmd可以匹配到博客.md。算法對連續命中和分隔符邊界進行了加權，文件名匹配優先於路徑匹配。 -
文件類型徽章
插件會在資源管理器樹和編輯器標籤頁的文件圖標旁添加彩色徽章。支持的類型包括 TXT、DOC、XLS、PPT、PDF、IMG、ZIP、PY、JS、CFG、SH、C、WEB 等。Markdown 文件 (md) 按設計保留內置的#圖標。 -
搜索結果可定位
在搜索結果列表中，懸停行尾的文件夾圖標，可以將資源管理器窗口定位到該文件夾中。 -
自愈機制
插件包含心跳兜底觀察器。當觀察器失效時，會自動嘗試恢復，以防止徽章顯示異常。
安裝與啓用¶
安裝需要 DeepSeek Harness Web GUI 環境，並依賴 dsh-better-sidebar 版本 0.14（v1.0.2+ 已適配 0.14 的 editorTreeSearch 掛載點）。
dsh plugin --profile web add https://github.com/mastereal/dsh-sidebar-enhancement-search/archive/refs/tags/v1.0.6.tar.gz
安裝完成後，請執行以下步驟確保插件生效：
1. 重啓 dsh web 服務。
2. 在瀏覽器中進行硬刷新（Ctrl + Shift + R）。
3. 關閉所有舊的 DSH 窗口或標籤頁，避免舊實例殘留代碼導致界面重複。
使用方法¶
- 打開側邊欄的資源管理器標籤頁。
- 在「工作文件夾名」下方的篩選框中輸入關鍵詞（如
bxmd）。 - 點擊搜索結果在側邊欄編輯器打開；將鼠標懸停在行尾的文件夾圖標上，可在系統文件夾中定位。
- 觀察資源管理器樹和編輯器標籤頁，文件圖標旁會顯示對應類型的彩色徽章。
風險與注意事項¶
本插件屬於 vibecoding 作品（與 AI 協作編寫），作者純自用，未經過大規模測試。
- 代碼依賴風險：插件直接操作
better-sidebar的 DOM（CSS 類名後綴、MutationObserver、注入樣式表）。如果宿主軟件升級，插件可能失效。 - 顯示異常：安裝有風險，可能出現徽章不顯示或佈局異常的情況。
- 免責聲明：作者不對數據丟失、功能異常或使用後果負責，也不保證修復時間。遇到問題歡迎提 Issue，但不保證回覆。
結語¶
該插件通過輕量級的 DOM 操作和子序列匹配算法，在不增加額外標籤頁的前提下，增強了 DSH 內置資源管理器的可用性。對於需要頻繁在 Web 環境下管理文件的開發者，這是一個實用的增強工具。
插件目錄：https://www.skillhub.cn/plugins/mastereal/dsh-sidebar-enhancement-search
GitHub 地址：https://github.com/mastereal/dsh-sidebar-enhancement-search
