Yoan Huang
bc7794813f
- Introduced E2EResourceScope for managing resources during E2E tests. - Updated test cases to register resources and handle disposal in a structured manner. - Enhanced error handling during resource disposal to capture and report errors. - Modified workspace setup functions to ensure proper cleanup after tests. - Adjusted imports and added necessary utility functions for resource management.
脚本目录
脚本按用途分组，不再兼容旧路径。
scripts/build/native/：准备 Electron 和 Node 使用的原生模块。scripts/build/package/：生成暂存包、混淆 main、审计暂存包和最终安装包。scripts/build/runtime/：检查 bundle 边界、递归追踪运行时依赖、验证暂存依赖。scripts/build/sidecar/：构建和检查网页爬虫 sidecar。scripts/release/：本地发布入口。scripts/release/r2/：R2 上传、元数据和发布收尾。scripts/release/shared/：发布流程共享能力。scripts/test/：源码/正式包 E2E 编排和真实更新测试。scripts/postinstall.mjs：安装完成后的唯一根级入口。
打包主流程
pnpm run build 最后调用 scripts/build/package/prepare-stage.mjs。该脚本固定按以下顺序执行：
- 用
@vercel/nft递归追踪 main 和 preload 的文件依赖。 - 按追踪结果生成最小生产依赖并安装到
release-stage/app。 - 使用暂存目录中的真实
DocxLoader和PDFLoader读取测试文件。 - 混淆
out/main并验证输出哈希和受保护明文。 - 执行暂存包内容审计。
追踪规则在 build/runtime-trace-policy.json。新增显式包含项时必须同时写清原因和对应测试；未知追踪告警会直接中止构建。
最终安装包由 scripts/build/package/audit-app.mjs 再次检查。它会核对追踪到的包和关键文件是否真的进入 app.asar。
Electron E2E
pnpm test:e2e:source：构建out后运行全部 E2E。pnpm test:e2e:package：构建当前平台安装包，安装后运行同一套 E2E。- 正式包测试不会自动加入发布流程，只在明确执行命令时运行。
- macOS 测试应用保留在
~/Applications/NCurator-E2E/馆长.app，后续运行直接覆盖。 - 正式包构建、安装和用例汇总保存在
tests/logs/package/<run-id>。 - Workbench 和需要真实文件的 Settings 用例复制
tests/fixtures/workspace到临时目录，结束后删除临时副本。 - 每个 E2E 必须显式声明
serviceMode；fixture 还必须提供fixtureReason。 - 知识库缓存按构建隔离：source 使用
tests/.cache/workspace-knowledge/source/<build-sha256>，package 使用tests/.cache/workspace-knowledge/package/<artifact-sha256>；同一轮所有用例共用选中的目录。 --fresh-knowledge-cache强制清空当前构建缓存；--reuse-knowledge-cache只用于人工调试时跨构建复用。- 每个 case 的附件都有
knowledge-cache-summary.json，正式包汇总也记录缓存路径、构建指纹和 hit/miss。