hy
6e5332670a
- Updated multiple e2e test files to replace 'launchMode: real' with 'serviceMode: real' for consistency in service mode configuration. - Refactored the electronApp.ts to introduce E2EServiceMode and related types for better clarity and maintainability. - Enhanced run-e2e-case.ts to accommodate the new service mode structure, ensuring proper handling of test cases. - Created workspaceFixture.ts to manage temporary workspaces more efficiently during tests.
脚本目录
脚本按用途分组，不再兼容旧路径。
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。