codex/dsh-files
main
DSH 的目录选择、附件呈现和文件工具被裁剪,导致用户无法正常上传、读取文件或分析压缩包。本次恢复官方文件入口与读取能力,增加 ZIP 解压,并直接使用官方前端加载动画。
验证:
详细记录:docs/testing/2026-11-04-dsh-files-native-loading.md。本次支持普通 ZIP;未构建新 EXE。
复审提交:705c15eb930f271d97d5e7b0b2adeb998172938d(PR18)。建议修改后再合并,有两项可复现 P2 问题。
[P2] 解压前后必须核对文件名集合,防止漏文件仍报告成功。 integration/dsh/task-plugin/files.mjs:55-58 仅比较 filter 调用次数和中央目录条目数,然后只校验 Object.entries(files)。当前固定依赖 fflate 0.8.3 使用普通对象存储解压结果,根目录文件名 __proto__ 会命中原型 setter,因此不出现在 own entries 中。真实 Harness 探针:Python zipfile 创建仅含 __proto__ 的合法 ZIP,调用 extract_zip 返回 isError:false, total_entries:1, files:[], truncated:false,输出目录实际为空。把该文件 payload 改坏、保留原 CRC 后仍返回成功,说明这条文件的 CRC 完全没被检查。应支持该文件名,或明确拒绝这类无法可靠表示的条目;成功前必须校验解压结果的名称集合与中央目录/expected 一致,并为合法及 CRC 损坏场景添加回归。
integration/dsh/task-plugin/files.mjs:55-58
Object.entries(files)
__proto__
isError:false, total_entries:1, files:[], truncated:false
[P2] 限制解压工作线程,并在取消/校验失败时终止解压。 integration/dsh/task-plugin/files.mjs:43-54 直接把整个 ZIP 交给异步 unzip。fflate 会为每个大于等于 512 KiB、压缩比较高的文件立即创建一个 Node Worker;现有 256 MiB 输出大小限制并不限制线程数量。真实 Harness 中用 20 个 600 KiB 文本文件(共约 11.7 MiB 解压数据)验证,观察到同时创建 20 个 Worker,进程 RSS 从约 310 MiB 增到 417 MiB。当前限制内可同时创建数百个 Worker,普通多文件压缩包就可能拖慢/耗尽助手进程资源。此外返回的终止函数没有保存,也未与 exec.signal 绑定,用户取消或 filter 抛错时已经启动的解压不能及时停止。应先完成整包元数据预检,再用受限并发或流式方式解压,并连接取消/错误清理;不要用主线程全同步解压阻塞 UI 服务。
integration/dsh/task-plugin/files.mjs:43-54
验证结果:
本次未修改 PR 源码、未合并、未重新构建 EXE,也未调用真实模型或执行 CAD 替换。
fix(dsh): restore native files, ZIP extraction and official loading
merge 9316cf4,first-parent diff 21 文件 +518/−42。重点:新增 extract_zip 工具(zip-worker.mjs + files.mjs)、放开官方文件 UI、dsh_native.py 允许 file:// 引导页。
9316cf4
extract_zip
zip-worker.mjs
files.mjs
dsh_native.py
file://
事实(今天 main 上仍然如此):
integration/dsh/start.mjs:46
sandbox-policy
mode: 'read-only'
workspaceRoot: DX_DSH_WORKSPACE
start.mjs:43
tool-fs
{read:true, readImage:true, write:false, edit:false}
task-plugin/files.mjs:50-77
node:fs/promises
mkdir
writeFile(..., {flag:'wx'})
files.mjs:61
const parent = await realpath(path.resolve(cwd, args.output_directory || '.'))
output_directory
..\..\..
%APPDATA%\...\Startup
触发场景:模型(或被提示注入的用户内容)调用 extract_zip,output_directory 指向工作区之外,ZIP 里放一个 *.bat/*.ps1/*.lnk。wx 只阻止覆盖,不阻止新建;工具执行不需要用户逐次确认。
*.bat
*.ps1
*.lnk
wx
后果:等于在"只读"产品里开了一条不需要用户确认的任意文件写入通道。即使当前模型规矩,这条通道也会被提示注入利用。
建议(任一即可,建议同时做):
parent
is_relative_to(canonical(workspace))
approval: ask
--doctor
fileTools:true
zip-worker.mjs 的 256 MiB / 10000 条限制来自中央目录的 originalSize(checksums 预扫描),随后 unzipSync(bytes) 一次性解压。若归档在中央目录里少报大小而实际膨胀巨大,unzipSync 仍会按真实输出分配内存;而 Worker 与宿主线程共享进程堆 → 不是"worker 被 OOM 杀",而是整个 DSH 宿主进程被杀。
originalSize
checksums
unzipSync(bytes)
unzipSync
Worker
建议:改成流式解压(fflate Unzip),在实际输出字节数上累加,超过上限立即 abort;CRC 校验保留(它已经在最后做)。
Unzip
..
:
CON/NUL/AUX/COM1
.
crc32
node:zlib
package.json
engines: node >=24.9.0
ui-sidebar-files
workspace-files
ui-attachment
file-reference-local
ui-reference
directory-picker*
DISABLED
TASK_TOOLS + FILE_TOOLS
dsh-extracted-*
terminate()
loading_url
LocalContentCanAccessFileUrls=False
__DSH_BOOT_READY__
file:
origin/main
start.mjs:43/46/47
files.mjs:50-77
tools/verify_dsh_files.mjs
verify_dsh_zip_review.mjs
verify_dsh_file_ui.mjs
未在真实 Node 24 / 打包运行时上跑 extract_zip;未构造 ZIP 炸弹或恶意路径样本做动态验证(结论基于代码路径)。
No dependencies set.
The note is not visible to the blocked user.
DSH 的目录选择、附件呈现和文件工具被裁剪,导致用户无法正常上传、读取文件或分析压缩包。本次恢复官方文件入口与读取能力,增加 ZIP 解压,并直接使用官方前端加载动画。
验证:
详细记录:docs/testing/2026-11-04-dsh-files-native-loading.md。本次支持普通 ZIP;未构建新 EXE。
复审提交:705c15eb930f271d97d5e7b0b2adeb998172938d(PR18)。建议修改后再合并,有两项可复现 P2 问题。
[P2] 解压前后必须核对文件名集合,防止漏文件仍报告成功。
integration/dsh/task-plugin/files.mjs:55-58仅比较 filter 调用次数和中央目录条目数,然后只校验Object.entries(files)。当前固定依赖 fflate 0.8.3 使用普通对象存储解压结果,根目录文件名__proto__会命中原型 setter,因此不出现在 own entries 中。真实 Harness 探针:Python zipfile 创建仅含__proto__的合法 ZIP,调用 extract_zip 返回isError:false, total_entries:1, files:[], truncated:false,输出目录实际为空。把该文件 payload 改坏、保留原 CRC 后仍返回成功,说明这条文件的 CRC 完全没被检查。应支持该文件名,或明确拒绝这类无法可靠表示的条目;成功前必须校验解压结果的名称集合与中央目录/expected 一致,并为合法及 CRC 损坏场景添加回归。[P2] 限制解压工作线程,并在取消/校验失败时终止解压。
integration/dsh/task-plugin/files.mjs:43-54直接把整个 ZIP 交给异步 unzip。fflate 会为每个大于等于 512 KiB、压缩比较高的文件立即创建一个 Node Worker;现有 256 MiB 输出大小限制并不限制线程数量。真实 Harness 中用 20 个 600 KiB 文本文件(共约 11.7 MiB 解压数据)验证,观察到同时创建 20 个 Worker,进程 RSS 从约 310 MiB 增到 417 MiB。当前限制内可同时创建数百个 Worker,普通多文件压缩包就可能拖慢/耗尽助手进程资源。此外返回的终止函数没有保存,也未与 exec.signal 绑定,用户取消或 filter 抛错时已经启动的解压不能及时停止。应先完成整包元数据预检,再用受限并发或流式方式解压,并连接取消/错误清理;不要用主线程全同步解压阻塞 UI 服务。验证结果:
本次未修改 PR 源码、未合并、未重新构建 EXE,也未调用真实模型或执行 CAD 替换。
回审已合并 PR #18(
fix(dsh): restore native files, ZIP extraction and official loading)merge
9316cf4,first-parent diff 21 文件 +518/−42。重点:新增extract_zip工具(zip-worker.mjs+files.mjs)、放开官方文件 UI、dsh_native.py允许file://引导页。结论:合并方向正确,但
extract_zip与本产品"只读沙箱"的约定冲突,建议尽快补修(P1)P1
extract_zip绕过只读沙箱,模型可让文件落到任意可写目录事实(今天 main 上仍然如此):
integration/dsh/start.mjs:46明确配置sandbox-policymode: 'read-only'、workspaceRoot: DX_DSH_WORKSPACE;start.mjs:43把tool-fs配成{read:true, readImage:true, write:false, edit:false}——产品级意图是 AI 不能写文件;extract_zip(task-plugin/files.mjs:50-77)用 原生node:fs/promises直接落盘:mkdir+writeFile(..., {flag:'wx'})。自定义工具不受tool-fs/sandbox-policy约束。files.mjs:61const parent = await realpath(path.resolve(cwd, args.output_directory || '.'))。output_directory可以是..\..\..或绝对路径(如%APPDATA%\...\Startup)。触发场景:模型(或被提示注入的用户内容)调用
extract_zip,output_directory指向工作区之外,ZIP 里放一个*.bat/*.ps1/*.lnk。wx只阻止覆盖,不阻止新建;工具执行不需要用户逐次确认。后果:等于在"只读"产品里开了一条不需要用户确认的任意文件写入通道。即使当前模型规矩,这条通道也会被提示注入利用。
建议(任一即可,建议同时做):
parent必须is_relative_to(canonical(workspace)),否则拒绝;extract_zip改成"需要用户确认"的权限类别(approval: ask),并在 UI 里显示目标目录;--doctor里把"文件工具写入是否受沙箱约束"作为可核验项暴露出来(现在fileTools:true只说明工具存在)。P2 ZIP 炸弹防护用的是"声明大小",实际解压不受限
zip-worker.mjs的 256 MiB / 10000 条限制来自中央目录的originalSize(checksums预扫描),随后unzipSync(bytes)一次性解压。若归档在中央目录里少报大小而实际膨胀巨大,unzipSync仍会按真实输出分配内存;而Worker与宿主线程共享进程堆 → 不是"worker 被 OOM 杀",而是整个 DSH 宿主进程被杀。建议:改成流式解压(fflate
Unzip),在实际输出字节数上累加,超过上限立即 abort;CRC 校验保留(它已经在最后做)。P3
zip-worker.mjs只拒绝绝对路径、..、控制字符与:,没有拒绝CON/NUL/AUX/COM1、尾随./空格。当前影响仅限"临时目录里写不出来/写错名",但会产生难懂错误;建议在文件名规范化后统一拒绝。crc32依赖新 Node:node:zlib的crc32需要较新版本;package.json已声明engines: node >=24.9.0,打包运行时应确保一致,否则extract_zip会以导入失败告终(错误信息尚可读)。ui-sidebar-files、workspace-files、ui-attachment、file-reference-local、ui-reference、directory-picker*从DISABLED里移除了。工具数守卫仍然只允许TASK_TOOLS + FILE_TOOLS(13 个),所以没有额外工具被注册;但文件侧栏/附件会把本地路径暴露给模型,建议在文档里写明"文件引用会把路径交给本地 harness"。做得好的部分(建议保留)
../控制字符)、__proto__、重复项、条数与声明大小都在解压前拒绝;crc32与中央目录比对,名称集合必须完全一致;dsh-extracted-*临时目录,wx保证不覆盖已有文件;terminate();dsh_native.py的file://放行只针对loading_url本身,且LocalContentCanAccessFileUrls=False;__DSH_BOOT_READY__只在file:协议下打桩,不会影响本地 http 运行时。验证记录
9316cf4全量 diff(21 文件);关键文件在origin/main上逐一确认仍然存在(start.mjs:43/46/47、files.mjs:50-77、zip-worker.mjs)。tools/verify_dsh_files.mjs/verify_dsh_zip_review.mjs/verify_dsh_file_ui.mjs(需 node + harness),本轮以代码审查为主。未验证边界
未在真实 Node 24 / 打包运行时上跑
extract_zip;未构造 ZIP 炸弹或恶意路径样本做动态验证(结论基于代码路径)。