前言¶
DeepSeek Harness (DSH) 生態強調“一切皆插件”。在使用 dsh-better-sidebar 時，默認的代碼預覽功能通常較爲基礎。dsh-code-nav 是一個配套插件，它接管側邊欄的代碼預覽，根據文件類型提供更專業的語法高亮、符號導航和文件內查找功能，解決代碼閱讀體驗不佳的問題。
插件簡介¶
dsh-code-nav 是 DSH Web 插件，作爲 dsh-better-sidebar 的擴展存在。它通過擴展名識別語言，在側邊欄打開代碼文件時自動接管預覽。該插件由 AnakinCao 維護，採用 MIT 許可證。
核心功能¶
按類型語法高亮¶
根據文件擴展名自動識別編程語言，支持深淺色主題自動跟隨。解析邏輯包含關鍵字、註釋、字符串、類型、數字和函數等元素。
符號大綱切換¶
解析代碼中的符號結構，包括類、接口、函數、變量等。支持按“全部 / 類 / 方法 / 變量”進行篩選，點擊列表可定位到對應行。
文件內查找¶
在預覽區域進行查找時，支持高亮全部匹配項和當前匹配項。支持 n / m 鍵計數，使用 ↑/↓ 或 Enter/Shift+Enter 進行上下跳轉，並支持區分大小寫切換。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add <dsh-code-nav-0.1.0.tgz>
- 重啓
dsh web服務（新增 bundle 需 host 側重載）。 - 在瀏覽器中硬刷新頁面（
Cmd/Ctrl + Shift + R）。 - 在 better-sidebar 設置頁的「側邊卡片」中，找到「代碼預覽導航」開關進行啓用或關閉。
典型用法¶
安裝並啓用後，在 dsh web 的側邊欄打開代碼文件即可生效。
* 導航：在符號大綱列表中點擊，或使用鍵盤快捷鍵進行跳轉。
* 查找：在查找框輸入關鍵詞，按 n 下一個，m 上一個，Enter 跳轉。
適用場景與注意¶
- 適用場景：適用於需要快速瀏覽代碼、查看語法高亮和符號導航的場景。
- 已知限制：
- 高亮與大綱基於輕量正則解析，非編譯器級精度。在處理複雜泛型、宏、模板元編程時可能存在漏檢或誤檢。
- 代碼預覽爲只讀模式。如需編輯，可在 better-sidebar 設置中關閉本插件以回退到內置編輯器。
- 單文件內容上限爲 500KB，超出時僅顯示提示。
- Vue / Svelte 文件僅高亮
<script>塊中的 JS/TS 代碼，模板部分不進行高亮。
