Bug: Windows 盘符根目录（C:\ / D:\）作为项目目录时无法创建会话（fs.mkdir EPERM）

[leng870613]

Category(分类)建议: 选 General(如果没有 General 就选最接近的 Feedback / Q&A)

Title(标题):

Bug: Windows 盘符根目录（C:\ / D:\）作为项目目录时无法创建会话（fs.mkdir EPERM）

Body(正文):

说明：本仓库 Issues 功能当前是关闭的，所以把 bug 反馈发到这里。这是一个可稳定复现的问题，附完整复现步骤、根因分析和修复建议。

问题描述

在 Windows 上，把盘符根目录（如 C:\ 或 D:\）选为项目目录/工作区时，工作区可以正常创建，但在该工作区里新建会话必然失败。失败在界面上是静默的：会话没有出现、工作区始终为空，只有浏览器控制台会打印 new session failed: ...，看起来像是"新建会话跳到了别的工作区"。

这不是沙箱/权限问题——工作区记录本身创建成功，只有会话创建这一步失败。

环境

• 操作系统：Windows（win32）
• Node：v23.11.1
• 版本：@deepseek-ai/dsh 0.1.0-rc.6（通过 npx @deepseek-ai/dsh web 运行）

根因

dsh-host-apiproxy 的 ensureSession 会无条件执行 fs.mkdir(cwd, { recursive: true }) 来"确保项目目录存在"：

try {
  await mkdir(cwd, { recursive: true });
} catch (error) {
  throw new Error(`failed to ensure project directory "${cwd}": ${String(error)}`, { cause: error });
}

在 Windows 上，对已存在的盘符根目录（D:\、C:\）执行 fs.mkdir（recursive: true）会抛出 EPERM——这是 Node.js 在 Windows 上的一个怪癖，违反了 mkdir -p "目录已存在则不报错"的语义。普通已存在目录则完全正常。最小复现：

node -e "fs.mkdirSync('D:\\', {recursive:true})"             → EPERM: operation not permitted, mkdir 'D:\'
node -e "fs.mkdirSync('C:\\', {recursive:true})"             → EPERM: operation not permitted, mkdir 'C:\'
node -e "fs.mkdirSync('D:\\workspace\\x', {recursive:true})" → OK

通过 GUI 自身的 API 复现 session.create 时拿到的原始报错：

failed to create session "session-...": Error: failed to ensure project directory "D:\": Error: EPERM: operation not permitted, mkdir 'D:\'

这个问题不只影响"选盘符根做工作区"：如果从盘符根目录启动 harness（defaults.cwd 为盘符根），同样会踩中。

复现步骤

1. Windows 主机，npx @deepseek-ai/dsh web 启动；
2. 添加路径为盘符根的工作区，例如 D:\；
3. 在该工作区点击"新建会话"；
4. 会话创建失败；浏览器控制台显示 new session failed: ... EPERM: operation not permitted, mkdir 'D:\'。

期望行为

以盘符根作为 cwd 正常创建会话（至少也应给出用户可见的明确报错，而不是静默失败）。

修复建议

在 ensureSession（dsh-host-apiproxy）中容忍"路径已作为目录存在"的情形——遇到 EPERM/EEXIST 时 stat 确认是目录则放行：

try {
  await mkdir(cwd, { recursive: true });
} catch (error) {
  // Windows: fs.mkdir(recursive) on an existing volume root (e.g. "D:\")
  // throws EPERM even though the directory exists. Tolerate that case.
  let alreadyDir = false;
  if (error?.code === 'EPERM' || error?.code === 'EEXIST') {
    try { alreadyDir = (await stat(cwd)).isDirectory(); } catch { alreadyDir = false; }
  }
  if (!alreadyDir) {
    throw new Error(`failed to ensure project directory "${cwd}": ${String(error)}`, { cause: error });
  }
}

附注

我已在本地安装副本上应用了上述补丁并验证语法通过；此贴用于让官方修复进入 upstream。