[Bug] Windows 原生目录选择器:路径含 U+XX00 字符时被截断,添加"报销"工作区失败

[JeanneAlt]

问题描述

在 Windows 上通过"添加工作区"选择中文名称的文件夹时,workspace 创建失败,报错路径中被截断了一个字。

报错信息:

workspace create failed: workspace-invalid-path: cannot create a workspace at
"%USERPROFILE%\Desktop\报": ENOENT: no such file or directory, realpath '%USERPROFILE%\Desktop\报'

注意路径是 Desktop\报,而不是实际文件夹 Desktop\报销。

复现步骤

1. 桌面存在文件夹「报销」
2. 打开 DSH Web GUI,侧边栏 → 添加工作区
3. 在 Windows 文件夹选择对话框中选择「报销」文件夹并打开
4. 出现上述报错

期望行为

工作区「报销」创建成功。

实际行为

创建失败,返回 workspace-invalid-path;选中路径被截断为 %USERPROFILE%\Desktop\报。

环境

• 系统: Windows 11
• DSH 版本: @deepseek-ai/dsh 0.1.1-rc.2(dsh --profile web,127.0.0.1)
• 使用 native 目录选择器(dsh-host-directory-picker-native,Win32 IFileOpenDialog)

根因分析

dsh-host-directory-picker-native/lib/worker.cjs 的 readUtf16() 从 COM 返回的指针读取选中路径(UTF-16LE),扫描 NUL 终止符时只检查每个 2 字节单元的低字节:

function readUtf16(koffi, address) {
    const bytes = Buffer.from(koffi.view(address, 32768));
    let end = 0;
    while (end + 1 < bytes.length && bytes[end] !== 0) end += 2; // 错误:低字节为 0 即视为结尾
    return bytes.toString("utf16le", 0, end);
}

任何码位形如 U+XX00 的字符,低字节必为 0x00,会被误判为字符串结尾:

• 「销」= U+9500,UTF-16LE 字节 [00, 95],因此 %USERPROFILE%\Desktop\报销 被读成 %USERPROFILE%\Desktop\报
• 「一」= U+4E00,同样受影响

修复建议

按 UTF-16 单元双字节判断真正的 NUL 终止符(两个字节均为 0):

- while (end + 1 < bytes.length && bytes[end] !== 0) end += 2;
+ while (end + 1 < bytes.length && (bytes[end] !== 0 || bytes[end + 1] !== 0)) end += 2;

并补充含 U+XX00 字符路径(如 C:\test\报销、C:\test\一)的回归测试。

临时缓解

本地将该行改为上述双字节判断;或改用 browse 目录选择器(远程/无桌面场景,走 node:fs,不受影响)。

[denial123789]

这个定位是准确的，而且与此前 开 U+5F00、一 U+4E00 等报告属于同一个 decoder defect：UTF-16LE 字符串终止条件必须是完整 code unit 00 00，不能只看低字节。销 U+9500 → 00 95 是非常好的回归 fixture，因为普通“中文路径”测试不一定包含 U+XX00。

建议 upstream 测试至少覆盖：

• ASCII 路径；
• 普通 CJK 但不含 U+XX00；
• 开 U+5F00；
• 销 U+9500（完整目录名 报销）；
• 以 U+XX00 开头、位于中间和末尾的三种位置；
• cancel/abort 不返回残留前缀；
• 返回值与 GetDisplayName(SIGDN_FILESYSPATH) 的完整 WCHAR 序列逐 code unit 一致。

临时恢复优先用已发布的 browse backend 覆盖同一个 picker row，而不是修改 npx/global 安装中的 generated lib/worker.cjs：

- id: directory-picker
  name: "@deepseek-ai/dsh-host-directory-picker-browse"

要点是“按同一 id 替换”，不要并排加载 auto 与 browse 两个 capability provider。重启后分别验证 报销、ASCII 路径、取消和 workspace 持久化。

我已把本报告加入现有 Windows picker 诊断树，里面也区分了 UTF-16 截断、Node/Koffi worker crash、native install 和 stale Host 四个分支：
https://sandbaseai.github.io/deepseek-harness-handbook/windows-folder-picker-crash.html