工作区目录选择增强 qwertyuiop314/dsh-workspace-picker-enhance

dsh-workspace-picker-enhance

DeepSeek Harness 增强版工作区目录选择器为 DSH“选择工作区”面板增加跨盘符/挂载点浏览、面包屑一键跳转、手动输入模式，以及无权限/系统目录视觉提示。

为 DeepSeek Harness 提供的增强版工作区目录选择器：跨盘符/挂载点浏览、可点击面包屑、手动路径模式，以及针对不可访问目录和系统敏感目录的视觉提示。

为 DeepSeek Harness (DSH) 的“选择工作区”目录选择器提供增强能力。它通过 DSH 官方 UI 插槽注入，不修改 DSH 核心代码，也不修改原生日录选择器源码；卸载后原界面可完全恢复。

本插件通过 DSH 官方 UI 插槽系统增强 DSH“选择工作区”目录选择器。它不修改 DSH 核心代码，也不修改原生日录选择器源码，卸载后原界面可完全恢复。

功能 / Features

- 跨盘符 / 挂载点浏览
- Windows：从“此电脑”开始，可进入 C:、D: 等盘符
- Linux / macOS：从 / 根目录开始，显示 /mnt、/media、/Volumes 等挂载点
- “向上 / 返回上一级”
- 任意目录可返回上一级
- 在盘符根目录或 / 再点一次，回到“此电脑”/根目录列表
- 面包屑导航
- 动态展示完整路径，例如：此电脑 > C: > data > helper > Programming
- 每一级均可点击，点击后立即跳转，无逐级动画
- 手动输入模式
- 保留原有“手动输入路径”习惯
- 图形模式与手动模式共享当前路径
- 可输入完整路径后直接“浏览”或“选择此路径”
- 风险目录视觉提示
- 无读取权限目录：灰色 + 删除线 + 🔒，Tooltip 提示“无访问权限，不可选择”，点击被拦截
- 系统敏感目录：⚠️ 橙色警告图标，Tooltip 提示“系统目录，修改可能影响系统稳定性”
- “此电脑”与所有可用盘符/根目录始终可访问
- 跨平台
- 自动适配 Windows \ 与 Unix / 路径分隔符
- 自动识别当前操作系统并展示对应的盘符/挂载点

- 跨盘符 / 挂载点浏览
- Windows：从“此电脑”开始，可进入 C:、D: 等盘符
- Linux / macOS：从 / 开始，可看到 /mnt、/media、/Volumes 等挂载点
- 向上返回上一级
- 可从任意目录返回上一级
- 从盘符根目录或 / 返回“此电脑”/根目录列表
- 可点击面包屑
- 动态显示完整路径，例如 此电脑 > C: > data > helper > Programming
- 每一级均可点击并立即跳转
- 手动路径模式
- 保留原有“输入路径”工作流
- 图形模式与手动模式共享同一当前路径
- 支持输入完整路径后“浏览”或“使用此路径”
- 风险目录提示
- 不可访问目录：灰色 + 删除线 + 🔒，Tooltip 提示“无访问权限，不可选择”，点击被拦截
- 系统敏感目录：⚠️ 橙色警告图标，Tooltip 提示“系统目录，修改可能影响系统稳定性”
- “此电脑”与所有可用盘符/挂载根目录始终可访问
- 跨平台
- 自动使用 Windows \ 或 Unix / 分隔符
- 自动检测操作系统并显示匹配的盘符 / 挂载点

版本兼容 / Compatibility

已针对 DSH 0.1.7 复核（同时兼容 0.1.5）：宿主与 slot 契约原样可用，客户端图标导出需要一处适配。

- 宿主路由 webServer.register({ kind: 'exact', path, handler(req, res) }) 契约未变（WebRoute）。
- 客户端 conversation.hero.workspace.directoryFlow / sidebar.workspaces.directoryFlow 仍是 single slot，owner props 仍是 open / busy / onPicked / onCancel（0.1.7 另加 onError，本插件不使用）。
- 抢占官方 directory-flow occupant 仍靠 priority: -1：0.1.7 的 slot 规则只拒绝相同 priority 的重复注册，且渲染取 priority 最小者，因此本插件依旧是赢家。
- dsh.client.inject 依赖的 @deepseek-ai/dsh-client- 包在 0.1.7 中同名存在。
- 图标导出已改名（硬断点）：@deepseek-ai/dsh-client-ui-primitives 的图标从像素尺寸后缀（IconFolderOpen16 / IconChevronUpOutline14 …）改成了描边粗细后缀（…Regular / …Medium）。客户端半包现在两代都探（primitives[modern] ?? primitives[legacy]）；旧写法在新版会解构成 undefined，React 报 error #130、slot 崩溃，界面上只是“没反应”而不报错。

English: 已针对 DSH 0.1.7 验证 —— 宿主 WebRoute 契约、两个 directory-flow 单槽以及 priority: -1 覆盖规则均未改变；客户端半包需要一处适配，因为 ui-primitives 将其图标导出从像素后缀（…16/…14）重命名为描边粗细后缀（…Regular/…Medium）。该 bundle 现在会在运行时解析任一世代，因此一次构建即可在 0.1.5 和 0.1.7+ 上运行。

安装 / Install

⚠️ 当前插件仍在测试阶段。请先在隔离沙盒、模拟环境或 DSH 测试实例中完整验证，再部署到生产环境或公开发布。

⚠️ This plugin is still in testing. Please validate it in an isolated sandbox, simulation environment, or a DSH test instance before deploying to production or publishing.

从本地源码安装 / Install from local source

dsh plugin --profile web add /path/to/dsh-workspace-picker-enhance

安装后重启 DSH Web 生效。
Restart DSH Web after installation.

从 Git 仓库安装（发布后）/ Install from Git (after publishing)

dsh plugin --profile web add github:/dsh-workspace-picker-enhance

卸载 / Uninstall

dsh plugin --profile web remove dsh-workspace-picker-enhance

卸载并重启后，原生日录选择器界面自动恢复。
The original directory picker UI is restored after uninstall and restart.

使用 / Usage

1. 重启 DSH 后打开 WebUI
2. 点击“添加工作区”或“选择工作区”
3. 在弹出的“选择工作区目录”窗口中：
- 从“此电脑”/根目录开始浏览
- 点击盘符/挂载点进入
- 使用顶部“↑”返回上一级
- 点击面包屑任意层级直接跳转
- 点击标题栏“手动输入路径”图标，可切换为纯手动输入
4. 选择目标文件夹后点击“选择此文件夹”，完整路径自动回填

1. Restart DSH and open the WebUI
2. Click "Add Workspace" or "Select Workspace"
3. In the "Select Workspace Directory" dialog:
- Start from "This PC" / the root directory
- Click a drive or mount point to enter it
- Use the "↑" button to go up one level
- Click any breadcrumb level to jump directly
- Click the "Enter path manually" icon in the title bar to switch to manual input
4. Select a folder and click "Select this folder"; the full path is filled in automatically

安全说明 / Security

- 插件仅读取目录结构和权限元数据，不写入、不修改、不删除用户文件
- 无权限目录仅做视觉提示与点击拦截，不会尝试绕过系统权限
- 系统目录仅做警告提示，仍保留“可进入查看”的能力；是否选择由用户自行决定
- Host 路由固定为 /plugins/workspace-picker-enhance/，不占用其它插件命名空间
- 文件枚举接口带有基本的同源/回环地址校验；请勿将 DSH Web 暴露到不可信网络或公网，若必须暴露，请在反向代理层增加鉴权

- The plugin only reads directory structure and permission metadata; it does not write, modify, or delete user files
- Inaccessible directories are only visually marked and click-blocked; the plugin never tries to bypass OS permissions
- 系统目录只是警告；用户仍然可以进入并查看它们，并自行决定是否选择它们
- 宿主路由命名空间位于 /plugins/workspace-picker-enhance/* 下，不会与其他插件冲突
- 文件枚举端点包含基本的回环 / 同源检查；不要将 DSH Web 暴露到不受信任的网络或公共互联网。如果必须暴露，请在反向代理层添加身份验证。

原理 / How it works

| 部分 | 文件 | 机制 |
| 宿主路由 | lib/index.js | 注册 /plugins/workspace-picker-enhance/roots 和 /list；提供驱动器/挂载点枚举、权限检查以及系统目录标志 |
| 浏览器 UI | lib/client.js | 由 dsh-client-modules 通过 dsh.client.platform: web 发现；以 priority: -1 注册到 conversation.hero.workspace.directoryFlow 和 sidebar.workspaces.directoryFlow，以遮蔽原始选择器 |

cordis.patch.yml 是 bundle 补丁层：当 bundle 在 profile 中列出时，它会插入 workspace-picker-enhance 行。

已知限制 / Known limitations

- 超大目录（如 /usr）单次最多返回 1000 条，超出部分会标记 truncated: true，不会自动分页
- Windows 下 fs.access 对目录权限的判断是尽力而为，🔒 无权限提示可能不如 POSIX 精确
- 隐藏目录会显示但视觉弱化（半透明），方便选择 .config 这类目录
- 符号链接指向自身或祖先目录时会被标记为“目录循环”并阻止进入，避免无限深入

- Very large directories (e.g. /usr) return at most 1000 entries per request; extra entries are marked truncated: true and are not paginated yet
- On Windows, directory permission detection via fs.access is best-effort; the 🔒 indicator may be less precise than on POSIX
- Hidden directories are shown but visually dimmed, so folders like .config remain selectable
- Symlinks pointing to themselves or an ancestor are marked as a directory loop and blocked, preventing infinite navigation

开发 / Development

dsh-workspace-picker-enhance/
├── package.json
├── cordis.patch.yml
├── README.md
├── lib/
│ ├── index.js # Host: HTTP routes + filesystem metadata
│ └── client.js # Browser: enhanced directory browser UI
└── test/
└── plugin.test.mjs # Automated tests

运行测试 / Run tests:

npm test

License

MIT