前言¶
在 DeepSeek Harness (DSH) 的開發工作流中,經常需要在側邊欄同時打開多個文件。當需要查看某個文件在本地磁盤的具體位置(例如複製路徑、檢查文件樹結構)時,往往需要右鍵點擊或打開新窗口,操作不夠直接。dsh-sidebar-enhancement-folder 插件通過向編輯器標籤頁注入按鈕,解決了這一痛點。
插件介紹¶
這是一個爲 dsh-better-sidebar 設計的增強插件。它會在每個打開的文件編輯器標籤頁的工具欄中插入一個「打開所在文件夾」按鈕。點擊按鈕,系統資源管理器會打開該文件所在的目錄,並自動選中該文件。
該插件由用戶 mastereal 維護,目前處於純自用階段,未經過大規模測試。
核心功能¶
-
按鈕內嵌
按鈕位於標籤頁自身的工具欄行內。對於 Markdown/HTML 文件,按鈕出現在「預覽」與「編輯」按鈕旁邊;對於 PDF、圖片或二進制文件,按鈕出現在標題欄。按鈕始終跟隨該標籤頁。 -
標籤頁獨立性
每個標籤頁擁有獨立的按鈕,不依賴哪個窗格處於激活狀態。即使切換到非活動標籤頁,按鈕依然存在且可用。 -
佈局兼容
按鈕是宿主 DOM 結構的一部分,因此它支持窗口布局的任何變化,包括拖拽、拆分窗格以及調整寬度。 -
Windows 定位可靠
插件使用explorer.exe /select命令打開文件。代碼中處理了windowsVerbatimArguments和引號,能夠可靠處理包含空格或中文字符的文件名。 -
自愈機制
插件內置了清理邏輯,能夠識別並移除重複或殘留的按鈕,保持工具欄整潔。 -
路徑解析
插件運行在宿主側(瀏覽器端),負責剝離file://前綴,並將相對路徑按會話工作目錄進行解析。
安裝與啓用¶
使用官方安裝命令從 GitHub Release 下載安裝:
dsh plugin --profile web add https://github.com/mastereal/dsh-sidebar-enhancement-folder/archive/refs/tags/v1.0.7.tar.gz
安裝完成後,需要執行以下步驟以確保生效:
- 重啓
dsh web服務。 - 在瀏覽器中硬刷新頁面(Windows/Linux:
Ctrl + Shift + R)。 - 關閉所有舊的 DSH 窗口和標籤頁。
注意:舊實例可能會殘留舊代碼,導致按鈕重複,必須徹底關閉舊窗口。
使用方法¶
- 在 DSH 的側邊欄中打開任意文件。
- 在對應的編輯器標籤頁工具欄中,會看到一個文件夾圖標(帶放大鏡)的按鈕。
- 點擊該按鈕,系統資源管理器將彈出並定位到該文件所在的文件夾,同時選中該文件。
注意事項¶
- 系統限制:目前僅支持 Windows 系統。
- 依賴版本:需要 dsh-better-sidebar v0.14+。該插件通過操作 DOM 注入按鈕,如果 better-sidebar 升級導致 DOM 結構變化,插件可能會失效。
- 風險提示:作者未經過大規模測試,安裝與使用有風險,請自行評估。
- 舊實例殘留:如遇按鈕錯位或重複,請務必執行上述安裝步驟中的「關閉舊窗口」操作。
結尾¶
該插件通過極小的體積和直接的操作邏輯,優化了在 DSH Web 環境下管理文件路徑的體驗。如果你主要在 Windows 環境下工作,且對 better-sidebar 的 DOM 結構有一定了解,這是一個值得嘗試的實用工具。
- 插件目錄: dsh-sidebar-enhancement-folder
- 源代碼: GitHub