hy
fb0c157809
- Deleted the `update-real.mjs` and `update-real-windows.mjs` scripts as they are no longer needed. - Updated `package.json` to remove references to the real update test commands. - Adjusted documentation in `test.md`, `settings-test.md`, and `release.md` to reflect changes in the update testing process, focusing on simulated updates instead of real updates.
脚本目录
脚本按用途分组，不再兼容旧路径。
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。