前言¶

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