DeepSeek Harness (DSH) 的右側欄通常用於文檔展示。開發者在處理代碼時,經常需要在查看代碼、引用特定行或搜索工作區文件之間切換。dsh-sidebar-editor 解決了這個痛點。它是一個免構建的 DSH 插件,在右側欄的文檔面板中提供彩色代碼預覽、按名字搜索工作區文件,並將選中行一鍵引用進對話框。
核心功能¶
右側欄預覽與引用¶
在右側欄文檔面板中彩色預覽代碼文件,支持按行渲染。插件內置分類着色,覆蓋註釋、字符串、關鍵字、函數名等多種語法元素。點選行或拖選多行,選中行會實時顯示在面板上方。點擊「引用選中行」按鈕,會將 @路徑 L10-L20 格式插入到對話輸入框。工具條提供「引用整個文件」和「引用所在目錄」按鈕,也可通過菜單項操作。
工作區搜索與定位¶
在文件面板工具欄(路徑欄最左)的搜索框輸入名字,可匹配工作區文件和文件夾。按 Ctrl/Cmd+Shift+P 可直接打開文件面板並聚焦搜索框。點擊搜索結果,若爲文件會自動展開並高亮;若爲文件夾則只展開定位。打開文件後,工具條上的「查找」按鈕或 Ctrl+F 可在當前文件內查找內容,支持跳轉和計數。
文件樹快捷操作¶
在右側文件樹的行上右鍵,可直接選擇「引用整個文件」、「引用這個目錄」或「複製絕對路徑」。此功能不依賴先打開文檔面板,直接作用於文件樹。
其他特性¶
- 大文件處理:超過 4000 行時自動關閉着色,僅顯示純文本,行仍可選可引用。
- 編輯與保存:默認關閉。插件 bundle 中包含編輯器與保存邏輯,但出於瀏覽器撤銷棧兼容性和側欄不適合寫代碼的考慮,默認形態爲只讀預覽。
注意事項¶
- 編輯與保存默認關閉:如需啓用,需在
client.js中修改editingEnabled()的返回值。受控<textarea>會清空瀏覽器的原生撤銷棧,且側欄環境不適合進行完整的代碼編輯。 - 搜索限制:搜索功能不認識
.gitignore,也不做模糊評分,僅按文件名匹配。 - 文件樹右鍵行爲:在文件樹右鍵會頂掉瀏覽器的原生菜單。
- 宿主接口:插件在宿主端註冊了
POST /api/sidebarEditor/save路由用於保存文件。
總結¶
dsh-sidebar-editor 通過在 DSH 右側欄提供代碼預覽和引用能力,簡化了查看代碼和引用文件的操作流程。插件採用預覽優先的設計策略,默認爲只讀模式,適合開發者快速查閱和引用代碼片段。