BUG 反馈：dsh 网页端目录选择器（browse picker）在 Windows 上无法打开旧版 junction 目录

[beta-sx]

反馈对象：deepseek-ai/deepseek-harness（dsh）
反馈日期：2026-08-15
提交人环境：Windows 10 (10.0.19044) / Node v24.14.1 / dsh 0.1.0-rc.6

---

一、问题概述（Summary）

在 Windows 上，将目录选择器固定为 browse 交互（网页内目录浏览框）后，点击进入用户主目录下的旧版 junction 目录（如 C:\Users\<用户名>\Application Data、C:\Users\<用户名>\Cookies 等）会直接报错：

cannot list C:\Users\beta\Application Data: EPERM: operation not permitted, opendir 'C:\Users\beta\Application Data'
cannot list C:\Users\beta\Cookies: EPERM: operation not permitted, opendir 'C:\Users\beta\Cookies'

这些目录是 Windows 为兼容旧程序保留的 junction（reparse point），分别指向 AppData\Roaming、AppData\Roaming\Microsoft\Windows\Cookies 等真实目录，普通用户完全可以访问（资源管理器、cmd 均可正常进入）。但 Node 的 fs.opendir/readdir 对 junction 路径本身直接返回 EPERM。

---

二、复现步骤（Steps to Reproduce）

1. Windows 系统，用户主目录存在旧版 junction（默认都有：Application Data、Cookies、Local Settings、My Documents、Recent 等）。
2. dsh web 组合使用 browse 目录选择器（@deepseek-ai/dsh-host-directory-picker-browse + @deepseek-ai/dsh-client-ui-directory-picker-browse；即 dsh-host-directory-picker-auto 解析为 browse，或直接在配置中固定 browse）。
3. 点击「新增工作区」→ 在网页目录浏览框中导航到主目录 → 点击 Application Data（或 Cookies、Local Settings 等任一 junction 行）。

实际行为：对话框顶部路径区显示 cannot list <junction路径>: EPERM: operation not permitted, opendir '<junction路径>'，无法进入该目录。

期望行为：与资源管理器一致，正常进入 junction 指向的真实目录（或至少不报 EPERM）。

---

三、根因分析（Root Cause）

3.1 Node 对 junction 路径的行为

在本机验证（Node v24.14.1）：

操作	对 C:\Users\beta\Application Data 的结果
fs.stat	OK（跟随 junction，isDirectory() === true）
fs.realpath	OK → C:\Users\beta\AppData\Roaming
fs.readdir	EPERM: operation not permitted, scandir
fs.opendir	EPERM: operation not permitted, opendir
fs.opendir(realpath(...))	OK

即：Node（libuv）对 Windows junction 路径的目录打开操作返回 EPERM，而路径解析（stat/realpath）正常。这属于 libuv/Node 在 Windows 上对 reparse point 的处理行为（junction 虽在 Dirent 中表现为 isSymbolicLink() === true，但按链接路径打开目录仍被拒绝）。

3.2 出错的代码位置

@deepseek-ai/dsh-host-directory-picker-browse 的 BrowseDirectoryPicker.list()（lib/index.js）：

const opening = opendir(target);
const level = await raceAbort(opening, signal).catch((error) => {
    opening.then((dir) => dir.close().catch(swallowCloseFailure), () => {});
    throw error;   // ← EPERM 直接冒泡
});

外层 catch 把它包装为：

throw new DirectoryPickerError("directory-unreadable", target, `cannot list ${target}: ${messageOf(error)}`);

于是客户端只看到 cannot list ... EPERM ...，没有任何可操作提示。

3.3 影响范围

• 任何 Windows 用户的主目录里点击 junction 行都会触发（Application Data、Cookies、Local Settings、My Documents、Recent、SendTo、Start Menu、Templates 等十几个旧版 junction 全部受影响）。
• 其他目录中的 junction（如 C:\Users\Public\Documents 等）同样受影响。
• 由于 browse 后端也服务于远程/无桌面场景，这个问题在 Windows 上具有普遍性。

---

四、建议修复（Suggested Fix）

方案（已本地验证）：EPERM 时经 realpath 解析后重试

在 list() 中，当 opendir 因 EPERM 失败且平台为 win32 时，先 realpath 解析 junction 到真实路径，再用真实路径重试一次；成功后列表行、面包屑、返回的 path 均使用解析后的真实路径（后续导航也不会再次踩到 junction）。

补丁（对 dsh-host-directory-picker-browse/lib/index.js）：

-import { mkdir, opendir, stat } from "node:fs/promises";
+import { mkdir, opendir, realpath, stat } from "node:fs/promises";

-		const target = resolve(path ?? home);
+		let target = resolve(path ?? home);

 		try {
 			const opening = opendir(target);
-			const level = await raceAbort(opening, signal).catch((error) => {
+			const level = await raceAbort(opening, signal).catch(async (error) => {
 				opening.then((dir) => dir.close().catch(swallowCloseFailure), () => {});
-				throw error;
+				// Windows legacy junctions (e.g. `C:\Users\<name>\Application
+				// Data` → `AppData\Roaming`) refuse directory opens through the
+				// junction path with EPERM; resolve to the real target and retry
+				// once so the level still lists (and rows/crumbs carry the real
+				// path, which also opens cleanly on later navigation).
+				if (process.platform !== "win32" || error?.code !== "EPERM") throw error;
+				let resolved;
+				try {
+					resolved = await realpath(target);
+				} catch {
+					throw error;
+				}
+				if (resolved === target) throw error;
+				target = resolved;
+				const retry = opendir(target);
+				return raceAbort(retry, signal).catch((retryError) => {
+					retry.then((dir) => dir.close().catch(swallowCloseFailure), () => {});
+					throw retryError;
+				});
 			});

备选方案（更彻底）

• 在 list() 入口对 win32 的 target 先做一次 realpath 规范化（所有路径都解析 junction），UI 行为一致且无重试路径；代价是多一次 syscall，且 resolve 不存在的路径时 realpath 会失败（需回退）。
• 或在上游目录选择 seam（dsh-host-directory-picker）约定：所有 Windows 路径统一走 realpath 后的规范形式。

修复验证

本地用修补后的包直接调用 list()，三组用例均通过：

OK   junction itself: path=C:\Users\beta\AppData\Roaming entries=135 crumbs=C:\ > Users > beta > AppData > Roaming
OK   home dir:        path=C:\Users\beta entries=73 crumbs=C:\ > Users > beta
OK   normal dir:      path=C:\Users\beta\AppData\Roaming entries=135 crumbs=C:\ > Users > beta > AppData > Roaming

注意：本地补丁改的是已安装包文件，dsh 升级会被覆盖，所以希望官方在下一版本中合入该修复。

---