前言¶
在通過遠程瀏覽器(如 Tailscale、局域網或手機)操作 DeepSeek Harness(DSH)Web UI 時,側邊欄的「添加工作區」按鈕會完全失效。這不僅是一個按鈕無法點擊的問題,更會引發連鎖反應:當原生文件夾選擇器在宿主機上彈出卻無法在瀏覽器中渲染時,WorkspacePickFlow 會持續持有 directoryBusy 標誌,後續的所有點擊操作都會被靜默忽略,沒有任何錯誤提示。dsh-quick-workspace 插件通過用「名稱對話框」替代原生文件夾選擇器,解決了這個問題。
是什麼¶
dsh-quick-workspace 是一個 DeepSeek Harness 客戶端插件,由維護者 wilsonchengassistant 維護。它的核心價值是:當從非宿主機設備訪問 DSH Web UI 時,允許用戶通過輸入工作區名稱來創建文件夾,而不是依賴宿主機的原生文件夾選擇器。插件以 -100 的優先級註冊,在 SlotCore.register 的排序機制中優先渲染,從而「佔用」原本由原生/瀏覽選擇器佔據的槽位。
核心功能¶
- 名稱輸入對話框:點擊側邊欄的「添加工作區」按鈕或編輯器的「選擇工作區」時,彈出名稱輸入框。
- 路徑預覽:對話框中會顯示將要創建的文件夾的完整路徑,讓用戶確認目標位置。
- 自動創建與註冊:輸入名稱並確認後,插件在指定父目錄下創建文件夾,並將其註冊爲工作區,然後自動打開。
- 多語言支持:對話框內置英文和簡體中文,通過
ctx.locale.register("quickWorkspace", { zh, en })註冊,共 12 個鍵對。
安裝與啓用¶
dsh plugin --profile web add file:/path/to/plugins/dsh-quick-workspace
安裝後必須重啓 dsh web,以便宿主機端重新導入插件。編輯 lib/index.js 後也建議重啓,因爲宿主機端不支持熱重載。
典型用法¶
- 通過遠程瀏覽器訪問 DSH Web UI。
- 點擊側邊欄的「添加工作區」按鈕。
- 在彈出的對話框中輸入工作區名稱,例如
my-agent。 - 確認後,插件會在當前工作區的默認父目錄旁創建該文件夾,並將其註冊爲工作區。
- 工作區隨即在側邊欄中顯示,並自動打開。
適用場景與注意¶
- 適合通過 Tailscale、局域網或移動設備遠程訪問 DSH 的場景。
- 插件以當前
dsh web進程的權限運行,創建文件夾的位置取決於workspaceRegistry的配置。 - 安裝前建議查看源碼,確認其行爲符合預期。
- 插件許可證爲 MIT,可自由使用與修改。
短結尾¶
dsh-quick-workspace 讓遠程瀏覽器中的工作區創建流程變得可用且可控,避免了原生選擇器在遠程場景下的盲區。項目地址:https://github.com/wilsonchengassistant/dsh-quick-workspace