前言¶

DSH 的「添加工作區」流程需要選擇工作區目錄。默認情況下，目錄選擇器會從用戶主目錄開始；如果項目固定在 E:\python_project 這類非主目錄，每次添加工作區都要手動導航。下面介紹的 dsh-workspace-default-dir 用來改變這個默認初始目錄。

這是什麼¶

dsh-workspace-default-dir 是由 dragan2023 維護的 DSH 客戶端插件，MIT 許可。它設置 dsh「添加工作區」目錄選擇器的默認初始目錄，覆蓋 native Windows dialog 和 browse picker 兩種後端，並提供 Settings → Workspace default directory 的 GUI 設置卡片。

核心功能¶

• 設置 Add workspace 目錄選擇器的默認初始目錄。
• 覆蓋 native Windows dialog 和 browse picker 兩種後端。
• 提供 GUI 設置卡片：Settings → Workspace default directory。
• 提供 CLI 命令：dsh-workspace-default-dir set/get/clear/status。
• GUI 與 CLI 同步寫入 DSH_PICKER_INITIAL_DIR（setx-persisted）。
• Registry fallback：先讀進程環境變量，再讀 HKCU\Environment。
• Self-healing：每次 dsh boot 冪等地重新應用兩個後端補丁。
• patch-type 插件：對 dsh 安裝內兩個 picker 包文件做冪等、只增加式修改。

安裝與啓用¶

安裝前提¶

資料說明 package.json 要求 Node >=18，peerDependency 爲 react ^18.2.0。

安裝命令¶

先執行下面命令，從 GitHub 倉庫安裝插件：

dsh plugin --profile web add https://github.com/dragan2023/dsh-workspace-default-dir

README 中的 npm 安裝命令標註爲發佈到 npm 後使用；由於發佈狀態未確認，本文只給出 GitHub 安裝命令。

啓用¶

安裝後重啓 dsh web。經過上面的步驟，Settings 下會出現 Workspace default directory 入口。

典型用法¶

GUI 設置¶

1、打開 Settings → Workspace default directory。
2、輸入絕對路徑，例如 E:\python_project，點擊 Save。
3、下次打開 Add workspace 目錄選擇器時，從該目錄開始。
4、如果需要恢復默認，輸入框留空並保存，或點擊 Clear，恢復爲用戶主目錄。

CLI 設置¶

GUI 與 CLI 寫入同一個 DSH_PICKER_INITIAL_DIR，所以兩者保持同步。常用命令如下：

dsh-workspace-default-dir set E:\python_project
dsh-workspace-default-dir get
dsh-workspace-default-dir clear
dsh-workspace-default-dir status

適用場景與注意¶

適合在 Windows 下使用 DSH、且工作區目錄經常固定的場景。使用它前，注意下面幾點：

• 已在 Windows + dsh 0.1.0-rc.6 驗證；其他平臺支持情況未確認。若其他平臺/版本的補丁編輯對不匹配，會記錄警告並跳過補丁，dsh 仍可啓動。
• 這是 patch-type 插件：會修改 dsh 安裝內兩個 picker package files，修改是冪等、只增加式。
• browse 後端補丁模塊在 dsh 啓動時加載，安裝/升級後需要一次 dsh web 重啓；native dialog 每次打開讀取 worker。
• 插件以當前 dsh 進程權限運行；安裝前建議檢查 GitHub 倉庫源碼，並確認 MIT 許可證。
• README 的 npm 安裝命令標註爲 when published to npm，發佈狀態未確認；本文不使用 npm 安裝方式。

參考鏈接¶

• 插件目錄頁：https://www.skillhub.cn/plugins/dragan2023/dsh-workspace-default-dir
• GitHub：https://github.com/dragan2023/dsh-workspace-default-dir