Files
dxdesigner-part-replacement/docs/testing/2026-11-04-dsh-files-native-loading.md
阿白叔 b00ca7dac9
Core regression / Python core and release configuration (push) Successful in 20s
Core regression / JavaScript syntax (push) Successful in 3s
Core regression / Python core and release configuration (pull_request) Successful in 17s
Core regression / JavaScript syntax (pull_request) Successful in 3s
fix(dsh): validate ZIP entries and bound decompression workers
2026-11-04 20:58:06 +08:00

5.8 KiB
Raw Permalink Blame History

DSH 原生文件能力与加载页

基线:同步项目 main@1340f6c,包含 V1.2.2、操作历史与 UI 更新;保留已合并的 PR #17 修复。

变更

  • 恢复官方附件栏、文件引用、目录选择、文件侧栏及其后端;普通对话开放原生 read/read_image、glob/grep、working_directory。启动检查从固定七项任务工具改为七项任务工具加六项文件能力。自动异常会话仍只接受其事件快照。
  • 增加 extract_zip,复用运行时已有的 fflate 并显式固定依赖;向新目录解压后返回真实路径、条目与截断标记。解压前检查目录越界、数量、大小、重复条目和 CRC。路径、校验或写入失败不保留本次半成品,不覆盖已有文件。支持普通 ZIP;不支持加密、多卷、ZIP64。
  • 启动直接打开固定官方前端的原版 index.html,通过其公开 DSH_BOOT_READY 等待信号展示原版 HARNESS 动画。运行时就绪后进入官方 HTTP 页面并关闭本地资源访问;删除额外首页标语。没有改写上游 HTML、SVG、CSS 或动画。
  • 实测一次冷启动需 139.59 秒,原 120 秒计时器提前终止正常启动;等待上限调整到 300 秒。最终验收启动等待 30.49 秒。
  • 模型调用的文件操作追加既有工具审计,记录名称、回执和错误状态,不记录文件内容。

验证

  • CLI:node tools/verify_dsh_files.mjs。先在缺少 read 能力的断言处观察失败;修复后验证中文/空格目录、读取、搜索、切换目录、ZIP 文本和二进制、重复解压不覆盖、路径越界、损坏包及 CRC 拒绝。独立审查也验证了单字节损坏的包在创建输出前被拒绝。
  • 真正上传与模型操作:python -X utf8 tools/accept_dsh_desktop.py --output build/dsh-files-live-verified --port 9298 --provider-config <本机配置目录> --file-check --live-model。
  • 实际点击官方 + → 文件,在真实 Qt 文件选择框输入自有文本和 ZIP 路径并点击打开;在 Harness 存储中核对两份文件字节一致。自然语言提示未指定工具名,真实测试 API 模型调用 read → extract_zip → read,三次均成功,并准确返回 DSH_UPLOAD_CONTENT_中文、DSH_ZIP_UPLOAD_CONTENT_中文 和真实解压目录。没有 CAD 操作或用户原始文件修改。
  • build/dsh-files-live-verified/desktop-report.json:status=passed、storedBytesMatched=true、modelToolSucceeded=true、cleanShutdown=true,uncaughtErrors=false、unexpectedUiErrors=false。官方加载、鲸鱼 SVG 动画、模型选择器、原生取消确认及导航后草稿保留通过。
  • 原版加载页实际截图:build/dsh-files-live-verified/official-loading.png,使用 Chromium Page.captureScreenshot 验证 HARNESS 与官方 spinner。附件截图 file-uploaded.png,真实回复截图 dsh-native-final.png。
  • Python 回归:python -m pytest -q tests/dsh tests/packaging --tb=short 为 217 passed、1 skipped(当前环境未指定官方 7-Zip 发布工具);python -m pytest -q tests/ui --tb=short 为 193 passed。合计 410 passed、1 skipped。
  • 最终 verify_dsh_files.mjs 还实际创建自动诊断会话,确认 read 与 extract_zip 在执行前被拒绝,避免继承普通对话的文件访问;该隔离用例不配置模型,不作自动诊断成功验证。verify_dsh_profile_settings.mjs 的原生配置保留、迁移与原字节备份通过。verify_dsh_runtime.mjs 确认 13 项预期工具、非预期工具拒绝、会话/上下文接口认证及任务中心确认门禁。
  • 最终独立代码审查未发现新增阻断问题;Python 编译、变更 JS 语法及 diff 检查通过。

验收脚本兼容

官方文件菜单实际名称为“文件 file”,修正选择器;CDP 发现页在总时限内重试短暂的连接超时。pytest-qt 会在 fixture 结束前删除注册窗口,UI 夹具现在检查 isValid,避免再次关闭已删除窗口;原失败单项复验通过。

既有协议单测的轻量 UI stub 同步增加 hide、官方加载入口和 WebEngine settings;保留原 UTF-8 分块、重启及坏行恢复断言,并检查真实 HTTP 握手后关闭本地文件访问。

本次未构建或分发新 EXE,不把源码与本机验收等同于发布包验收。

合并前评论 #197:文件名完整性与解压线程

原 fflate 异步 unzip 使用普通对象接收文件,根目录 __proto__ 会被静默漏掉;同时每个较大的条目都可能启动一个 Worker,文件总大小上限无法限制线程数量。新增真实 Harness 回归先在“特殊文件应明确拒绝”的断言处观察失败。

解压现由专用 Node Worker 执行,全进程最多同时处理两个压缩包,其余排队。每包先做不解压的整包元数据预检,明确拒绝无法可靠表示的根目录 __proto__;再在该 Worker 中解压,核对完整名称集合、长度和 CRC 后才传回主进程写入新目录。没有在主服务线程同步解压,也不再按 ZIP 条目创建线程。活动调用取消时终止 Worker,等待退出才结算并释放槽位;排队调用取消后直接移出队列。

node tools/verify_dsh_zip_review.mjs:合法与损坏的特殊文件名均被明确拒绝,无输出目录;4 个压缩包并行、每包 20 个 600 KiB 文件,全部文件完整,恰好创建 4 个 Worker,峰值为 2;活动取消后 Worker 全部退出且不产生半成品。独立审查还验证了 5 个请求中取消一个排队请求,4 个成功、峰值 2、全部线程退出。Worker 文件会随 task-plugin 目录递归打包。

最终 python -m pytest -q tests/v1_1 tests/ui tests/dsh tests/packaging --tb=short:1463 passed、1 skipped(未指定官方 7-Zip 发布工具)、1 条 pywinauto COM 模式警告。原有真实 Harness 文件/目录/ZIP/CRC/自动会话隔离回归再次通过;最终独立审查无新增阻断发现。