# 模块化重构与鲁棒性修复验证(2026-10-19) 本轮基于 `9854d2d`,开发分支 `codex/modular-refactor`。工作区为 `C:\Users\ABS\.codex\worktrees\modular-refactor\Order Notification Automation`;原工作区源码保持原状,未推送、合并或部署。 ## 目录与职责 - `src/app/`:生命周期装配、扩展桥接、HTTP、资源映射和请求约束;`src/server.cjs` 保留正式入口与三个导出。 - `src/modules/<业务>/`:dashboard、workspace、bpm、mail、storage、notifications、assistant、health、pdf。 - `src/platform/`:浏览器、加密与 Windows/守护能力;`src/shared/`:资源路径、时段和脱敏。 - `web/modules/` 与 `tests/<业务>/` 对齐业务边界。通知拆为 store/service/mapping;登录表单交互从 BPM 会话编排中分离。 ## 修复与故障回归 | 问题 | 修复 | 验证边界 | |---|---|---| | 第二实例恢复活动通知导致重发 | 在业务数据库初始化前获得状态目录独占;显式恢复;发送前事务核实完整预留归属 | 首实例停在假 SMTP verify,第二次 main 被拒且恢复调用为零;首实例继续只发送一次 | | 已保存 SMB 操作无期限、无法停止 | 可取消工作进程、队列期限、等待实际退出、进程树终止、IPC 大小/二进制校验 | 真实本地子进程及其后代、挂起/错误响应、取消/超时、队列恢复、归档字节及摘要 | | 浏览器断开后永久复用缓存 | 按浏览器与 Promise 身份失效缓存和租约,并发重建 | 本地真实无头 Chrome 关闭后重建、漏事件兜底、旧事件不清理新实例 | | 通知次数耗尽无恢复出口 | 明确 exhausted;管理员填写依据单项重新入队;批次 CAS 与加密审计 | 假 SMTP 实际重试成功、角色权限、证据/重复/跨失败周期旧请求、未知发送结果保持人工核验 | | JSON/Cookie 等凭据脱敏遗漏 | 共享递归 JSON、敏感键规范化、完整头部脱敏,覆盖输入/回复/历史/摘要 | 虚构凭据实际传给 runtime 和写入加密历史前已去除,包含嵌套数组与转义 JSON | | 改端口后守护误杀健康替代进程 | 每次启动重读校验端口,失败状态明确;控制确认对应新重启状态 | 真实夹具子进程 A→B、未知占用不被终止、修正配置后真实 CLI 等待成功 | | 中文自启动路径被 ANSI 转换 | Unicode IShellLinkW/IPersistFile 创建与读取 | 本机代码页 1252 的中文项目/状态/启动路径、读回/隐藏执行/外来快捷方式保护 | 总复核另补两项生命周期缺口:关闭入口立即停止接受新导出,等待已接受渲染与自动归档结束再停止依赖并释放锁;数据库初始化中途失败时关闭已分配的句柄/加密资源。回归覆盖晚到请求体、同步渲染失败、重叠归档与新渲染,以及损坏的持久连接 JSON 修复后重新启动。 ## 验证环境与范围 使用临时 SQLite、临时文件、假 SMTP、本地 HTTP 和真实本地 Chrome/Node 子进程。依赖版本及 `package-lock.json` 未改;测试通过以下进程级环境使用原工作区依赖和此前临时补齐的依赖,没有修改正式依赖: ```powershell $env:NODE_PATH='Z:\Order Notification Automation\node_modules;C:\Users\ABS\AppData\Local\Temp\order-review-deps-20261019\node_modules' npm test ``` 迁移静态检查已确认原有 49 个测试文件全部保留,74 个脚本语法正常,56 个模块可加载,18 个公开资源地址可定位。加密 vault 实现与迁移前逐字节相同;原路径、密钥身份与 AAD 保持兼容。 最终代码提交 `a420d2d` 的全量 `npm test` 正常退出(exit 0):**222 项,221 通过、0 失败、1 跳过,236.10 秒**。最终复核两项 P2 均关闭,任务规格与代码质量复核通过,无遗留重要问题。补修定向测试 15/15、受影响模块测试 135/135 通过。首轮集成全量为 207 项、206 通过、0 失败、1 跳过;上述最终结果包含其后新增的生命周期回归。 本地完整日志和复核记录保存在忽略目录 `output/verification/modular-refactor-2026-10-19/`,不随 Git 发布。54 个测试文件包含原有全部 49 个文件。计划六个任务均已完成;代码、方案与本记录保留在本地工作分支供审阅。 未访问真实 BPM、SMB、邮件或模型提供方,未操作正式服务/配置/业务数据。官方 ZCode CLI 测试需要显式提供 `ORDER_TEST_ZCODE_CLI`,未配置时保留跳过。硬终止 SMB 归档可能留下隐藏临时上传文件或已完整发布但未返回结果的文件;记录保持失败,同摘要重试可核对已有发布结果。 渲染任务若永不结束,正常停止会持续等待并保留独占权,避免旧任务在交接后继续写数据;守护仍保留已有的强制停止路径。本轮不代表公司 BPM→导出→SMB→通知的真实端到端验收,来源适配与自动详情/PDF 仍属后续业务工作。