Files
order-notification-automation/docs/HANDOFF.md
T

331 lines
54 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 开发交接(2026-10-23)
## 2026-10-28 路由按需加载与 Windows 启动资源优化
- 在 `codex/system-update` 延续前轮性能改动,首页按路由加载可选脚本。清单由服务端计算实际内容指纹,延迟资源保留长期缓存与 SRI;并行预加载、按各路由顺序执行,旧慢页面不阻塞未加载的新页面,失败可重试或重新加载。18 个页面入口、冷切换、完整性拒绝与重试均有浏览器覆盖。
- 与 `73773f9` 同一隔离 HTTP/合成首页比较、各 3 次中位:冷静态请求 44→13,压缩正文 299130→169652 B,首页就绪约 590→399 ms;重复刷新仍为 0 个静态网络请求。含 3000 个合成文件的跨进程 ACL 检查中位约 1142→587 ms;不是生产 SLA。
- Windows ACL 先检查原始 DACL 与 SID 规则,完全符合原有私有目录策略才复用,任何额外对象/回调/不透明 ACE 均不复用;真实目录验证不重写合规 ACL,并能修复放宽后的策略。DPAPI、路径身份核验和原超时保护保持。监督器连续三次未通过首次健康检查即退出时冷却,持久化安全启动诊断;成功健康检查或人工重试重置连续计数。
- 原目标 `codex/smb-storage` 已合入 `main` 并删除,旧请求 #2 已关闭;本轮纳入 `main` 的邮件期限/隔离发送、修复验证器和监督器异常退出清理修复,合并保留两边全部 70 个测试入口。新请求目标为 `main`,不操作 `dsh`。
- 最终 `npm test` 429/429 通过,0 失败、0 跳过,未再出现保护超时日志。集成安全与服务专项 20/20 通过;早期因 Windows 初始化超时失败的业务切片重跑 12/12 通过,保留原始失败日志。独立审查提出的三项 P2 均补回归并复核,提交内容/依赖/语法/差异检查通过;未运行历史 `test:full`。
- 未部署运行服务,未发送真实邮件、办理 BPM 或改动运行配置。实现、基准和限制见 [启动稳定性与首屏加载](startup-stability-2026-10-28.md),原始聚合收据留在忽略目录 `output/lazy-startup-20261028/`。未声称消除所有 Windows 超时或证明完整服务启动已经加速。
## 2026-10-27 PR #1 合并前审查修复
- 修复旧模板测试邮件旁路:固定隔离QQ、空Cc、无附件,发送前/SMTP验证后复查测试期限与模板版本;未知测试结果禁止重复。样例发送同样接入期限,UI文案与真实信封一致。
- 修复AI验证器关联共享Git目录时的dubious ownership;只为当前验证工作区设置命令级精确信任,不改变全局配置。新增真正执行固定与变更测试的回归。
- Windows守护异常退出的孤儿进程疑点被隔离实测排除,新增PID退出/定时任务停止/端口释放回归;无需修改生产守护行为。
- 审查范围、已修复问题和投产限制见docs/pr-1-review-2026-10-27.md。修复前业务292项、修复后针对性25项通过;最终候选测试单独记录。未手动发信或操作BPM,不更新正式服务机。
## 2026-10-28 缓存刷新收尾与按需区域校验
- 接续 `codex/system-update` 上一轮中断前的静态指纹缓存、后端 revision 与前端区域刷新改动。新增 `GET /api/refresh/revisions?regions=assistant` 等按需校验,旧的无参数八区域响应兼容;校验区域白名单、重复/空参数,保持认证、账号隔离与 `no-store`。助手频繁轮询不再访问订单、BPM、存储或 PDF 台账等无关模块。
- 修复审查复现的手动刷新空操作:取消并等待旧请求后清除消费者的已应用 token,强制本次重读取;定时检查继续跳过未变化区域。并发手动刷新仍合并,草稿、筛选、权限及时间边界保持。
- 合成内存 SQLite、5 万订单、每项 300 次采样:全八区域校验中位 5.44 ms / 635 B / 21 次 SQL,助手单区域 0.135 ms / 104 B / 1 次 SQL;首页加顶栏合计 4.37 ms / 204 B / 11 次 SQL。不是生产 CPU、内存或网络 SLA;夹具与边界见 [缓存与区域刷新](cache-region-refresh-2026-10-28.md)。
- 最新 `npm test` 404/404 通过,无失败或跳过;28 个改动脚本语法检查、依赖树与 `git diff --check` 通过,独立审查发现的手动刷新 P2 已修复复核。未运行历史 `test:full`。测试前基线曾遇一次 Windows ACL 子进程超时,最终完整业务回归未复现;保留原始日志,不降低存储保护。
- 开发与验证使用原目标工作区 `C:/Users/ABS/.codex/worktrees/system-update/Order Notification Automation`,桌面应用直接关联该既有目录时无法核实归属。提交范围仅为源码、测试与文档,诊断日志及基准夹具留在忽略的 `output` 中。未部署服务、修改真实业务配置或调用真实 BPM/SMTP/SMB;主目录 `dsh` 的独立改动保持。
## 2026-10-27 分类规则设置响应优化
- 规则页改用专用configuration读取,只返回编辑元数据和资源摘要;顶栏用轻状态接口。首次进入不再读取业务summary或完整执行/字段快照,样本在第04步点击“读取已采集订单”时按当前流程和连接权限读取。
- 保存、发布、启停使用完整服务端版本回执局部更新,保留当前编辑器与冲突/未保存保护。放弃修改后启停恢复真实保存基线;受限测试暂停/到期回执同步目录与提示;不确定结果核验走轻配置。流程本地搜索取消延迟,避免旧搜索回抢焦点。
- 同一份加密数据种子/固定时钟下各3次受控对比:暖态进入中位数1059→235ms,保存691→103ms;进入GET 8→2,保存后GET 7→0。探测仅使用临时副本和隔离账号,无真实BPM/SMTP/SMB调用,未更新运行服务。
- `npm test`最新323/323通过,另有规则交互5项、普通/惠州试运行1项及规则页兼容3项通过;独立审查问题已修复复核。没有重跑历史全量,上一轮基线33项失败未冒称解决。设计与测量边界见[规则页响应优化](rule-settings-performance-2026-10-27.md)。
## 2026-10-27 系统更新提示(独立分支)
- `codex/system-update` 在菜单左下角显示 `package.json` 版本,登录自动检查一次,支持手动检查、更新标记及含日期/纯文本说明/发行链接的详情框。仅提示正式 Gitea Release,不以分支提交或单独 tag 触发更新。
- 服务端固定公开仓库的 `releases/latest`,使用现有登录权限;5 秒超时、256 KiB 上限、禁止重定向,不读取 Git 凭据或传递业务数据。没有发行版本、当前最新与检查失败分别显示;当前远端无 Release,未创建首个发行版。
- 最终业务回归 304/304 通过,更新专项 12 项通过,独立审查发现的说明文字可读性已修复。历史全量 1312 项中 1278 通过、33 失败、1 跳过;部分旧失败已在基线复现,未核验项仍保留,因此提交草稿请求。
- 发布约定见 [版本发布与更新检查](system-updates.md),完整结果和失败后续状态见 [本次验证记录](verification-system-update-2026-10-27.md)。
## 2026-10-27 业务首页轻量看板
- 用户确认蓝白卡片、流程小场景和少量动效。新增首页独立模块及样式,突出下一计划发送时点、到达截止、时间进度、收集中批次及顺延数量;运行条件和异常独立展示,保留现有业务操作边界。
- Tabler Icons使用MIT授权静态SVG,许可证位于licenses/Tabler-Icons-MIT.txt;未使用需购买授权的Tabler插画。现有Tabler状态点与骨架组件无需升级依赖。动画仅作状态/交互提示,扫描流动仅在实际scanning状态出现;减少动态效果时禁用动画。
- summary追加home字段复用当前已授权收集批次,普通/惠州订单去重,预览最多4组,不返回邮件正文或收件人。倒计时到期只提示刷新确认,不能推断发送成功;暂停、加载失败及内部刷新失败均有明确状态。
- 首页与汇总/查询/批次专项31项通过,桌面1440、窄屏674和手机390截图核验,无横向溢出;内部刷新失败保留旧数据并可重试,离页销毁倒计时与请求。仅展示改版,不更改匹配、归档、发信计划或测试期限。
## 2026-10-27 未发送订单顺延下一批
- 用户明确要求确认未发的订单恢复待汇总,下一时段重新合并;有证明的失败冻结批次保留历史后取消,新批次使用正常模板/新窗口草稿。已发送、sending/unknown、部分接受和无证明旧failed不自动重发。
- 引入逐模式carryForward持久记录,复用列表/冻结/发送窗口资格,保持原到达时间、身份和PDF回执不变。原阻塞窗口结束后顺延,晚完成成员跟随集合决定;运行条件短暂失败仍能复核恢复,当前状态不再永久困住顺延订单。
- 管理员可受控移出离开节点且从未归档编批的capture任务,保留证据及去重。匹配顺延模式的旧missed/build/batch异常退役并同步工作台,不把另一通知模式或其他未完成成员的问题隐藏。
- 验证:282项业务回归通过;核心顺延/查询/发送/旧窗口专项95项通过,独立复核26项通过。额外覆盖运行条件失败后重新复核、旧窗口结果被覆盖后的晚完成成员、孤立编批引用与受阻记录移出保护。
- 真实只读回放:六个海外更改单可进入当天17:00批次,两条sent批次不变。实施细节见docs/superpowers/plans/2026-10-27-unsent-next-batch.md,测试/部署/实机结果保存于忽略output/business-flow-test。
## 2026-10-27 统一邮件账户与DSH受控助手
- 邮件编辑默认共用邮箱/授权码,预设163/126/QQ/Foxmail/Yeah服务器;高级设置保留分开的SMTP/IMAP凭据。新账号可仅发信,IMAP能力与模板自动收信开关分开;旧账号默认保留原IMAP能力与密码,空输入不覆盖。连接检查不发送邮件。
- 主助手运行路径切换为官方DeepSeek Harness0.2.1-rc.2 headless,独立DSH_HOME与scrubbed环境、stdin提示词、环境传密钥;空bundle白名单只挂载核心/模型/runner,不注册本机文件、Shell、网络或MCP工具。官方运行包通过本地Messages假模型验证tools为空、取消与Windows子进程树退出;没有真实模型密钥时保持未启用。配置API为Messages兼容根地址,默认https://api.deepseek.com/anthropic。
- 安装器 scripts/install-dsh-runtime.cjs 使用独立LocalAppData目录,固定DSH版本及已修补zod/undici/fflate/MCP-client overrides;与主项目依赖分离。最新该运行包生产依赖审计为0条已知告警。
- AI操作记录只追加SQLite,记录发起人、上下文、模型结果、操作、Git写文件/提交/测试/恢复;按账号授权且脱敏,不保存内部思考。审计不可用时阻止启动模型/操作,重启运行中结果标为待核验。
- 管理员显式选择已跟踪源码文件生成修复建议,页面展示前后内容;执行前复核权限、仓库及baseline commit。只在独立Git工作区/codex/ai分支写入,成功待审查;固定测试失败恢复基线,保留证据提交。超时/未确认退出/元数据篡改保留锁与needs_review,不冒称自动回退。Git工作区不是OS沙箱,测试以服务账号运行,UI明确提示;不自动合并/部署、不恢复数据库、不办理BPM、不重发unknown。
- 验证:235项当前业务回归通过;最新应用启动/关闭、操作审计翻页、UI修复审查和Git恢复专项37项通过。DSH实际官方运行包已通过本机假模型验证,无真实外部模型调用。补充旧web-closure-ui的5项失败在39afafe基线完全复现(旧字段编辑器等断言/夹具),未计作通过;本次DSH路由单独验收。
- 真实共享仓库补验:Git隔离环境不继承全局safe.directory,因此按管理员选定的原生规范路径仅为当次Git命令增加精确信任项,兼容Z盘映射/UNC及Windows大小写;不修改全局Git配置。对应Git修复/权限/审计26项专项通过,真实仓库读取验证通过。
- 用户批准的两部分设计与计划见同日mail-dsh-controlled-optimization文档。原重复巡检保持删除,五天受限测试及订单数据不因助手接入改变。
## 2026-10-27 PDF导出记录接入自动归档
- 原PDF台账仅查询手工pdf_jobs,自动订单的archive回执完全独立,造成成功归档但列表为空。台账现在只读合并两种来源,先权限过滤与筛选,再统一排序分页;无需补造任务或重新生成PDF。
- 自动记录标记BPM订单自动归档,保留订单号、流水号、项目/型号和归档时间,下载复用原订单文件接口的权限/哈希检查。列表“已归档(下载时校验)”只代表持久回执,不冒充实时文件检查;手工文件继续原可用性校验。
- 已移除订单与其他负责人的连接数据不进入自动记录;已发邮件的订单归档继续可查。诊断output目录里的离线PDF不作为业务记录。当前只读核对有5条业务自动归档,合并查询可找到。
- 验证:182项当前业务回归通过;导出记录/分页导航专项19项通过。独立复核发现的实际项目字段优先级已修复并补回归。
- 专项覆盖超过三页合并分页、搜索、末页回退、权限、软移除、已发送订单、实际项目字段及列表/弹窗下载链接。更新本机服务前备份,保留运行数据、规则和测试期限;不生成PDF、不手动发信、不操作BPM。
## 2026-10-27 通用表单适配与停止重复巡检
- 用户取消每6小时巡检;自动化已删除,应用的五天测试期限及原开关不变。
- 用户批准后端未提供的非业务展示字段留空并记录警告。只在自动订单读取路径启用,字段证据不补值;必需/显式映射字段仍由匹配层阻断,未识别成功不得导出、归档或发信。
- 明细归属改用已核验tid,支持非Applicant主表;修复查询数据源误当保存表、明细汇总尾行误当重复行、空表残留模板及缺字段复制/厂商datamap兼容。保留跨实例、部分行缺字段和复合/歧义值阻断。
- 真实只读历史样本覆盖当前启用28流程,28份PDF生成并经pdfinfo校验(77页);15类实际配置的模板/批次隔离回放通过,收件仍隔离、空Cc、无附件。隔离回放节点/时段是测试输入,不是实际到达证据;未写运行订单或发送邮件,不能称15类真实闭环完成。
- 原宽带更改单已离开待办,不自动恢复或补发。完整细节见 docs/superpowers/plans/2026-10-27-general-form-adaptation.md;原始样本、PDF、邮件预览、部署回执仅在忽略output/business-flow-test。
## 2026-10-26 同表单列表版本兼容
- 列表数字版本变化而流程及已核验完整 V 表单路径相同时,允许只读采集;不继承旧版本的展示字段豁免。
- 运行期仅在持久完整只读样本、原任务 tid/pid、完整表单路径、规则绑定的唯一已验证适配器及所有显式字段类型一致时逐单兼容。已有当前版本适配器时不绕过,多候选、缺字段、身份冲突保持阻断。保留原列表版本,不写回适配器、发布证据或受限配置。
- 验收:146项当前业务回归及78项采集恢复/只读/期限/精确匹配专项通过,独立审查未发现回归。部署前发现测试副本三个表单文件仍精确对应 f2e6dfe 修复前版本(与版本标记不符);本轮补齐 bpm-readonly-form.cjs 等文件并逐文件核验,避免只更新版本标记。
- 用户明确批准海外 IPC 更改单 1.5 / V4 的 CardBoardText 遗留展示控件例外;后端 Columns 与行均未提供且不参与业务映射时忽略并记录警告。后端声明却缺值仍阻断。
- 真实订单315431只读取得480个字段,以1.4已验证映射兼容1.5;离线PDF为3页A4、348473字节。此证据不是实际归档或邮件回执。本机部署、原任务重试及测试结果以忽略目录 output/business-flow-test/version-compat-* 回执为准;五天测试、原规则、账号和发送计划保留,不手动发信或办理BPM。
## 2026-10-26 匹配页面流程目录接入修复
- 规则共涉及29个流程,旧scope-catalog只含其中14个;其余15个中14个已有真实历史采集样本,曾被整个拒绝目录接入。新增scope-process-catalog保留历史流程名与来源,directory新增processes,原scopes仍是精确流程/节点配对。既有目录配置不再阻止一次性迁移;停用采集时延后,恢复后执行。
- 匹配页流程下拉及字段目录显示process-only历史流程;无节点则显示节点待采集。Excel已知名称保留原标点,导入不写采集目录。历史占位节点不进入选择项。
- 当前只读取得19个历史实例ProcessStep记录(458条步骤),内部方法只保存节点名称、实例/版本/采集时间等来源证据,不保存人员意见,不创建通知事件。计划写入后规则涉及流程可确认28/29;剩余指定节点与实采名称差异继续保留提示,不自动替换Excel。
- 真实历史原始证据与差异回执只在忽略output/business-flow-test/catalog-node-evidence-20261026.json及history-catalog-applied-20261026.json;五天测试规则、适配器、订单、批次、签名与邮件数据不因目录完善改变。历史ProcessStep不提供原通知任务ID/到达时间,不能据此自动补发。
- 验证:126项业务回归通过;新增历史名称、精确历史节点、停用/重启/原标点和UI可选项测试先失败后通过。目录预演显示36个实际流程、401个已观测配对,规则涉及28/29流程;仍未观察到的17个Excel指定配对保留提示,包含实际名称差异和样本尚未走到节点的情况,不能据此自动修改规则。
## 2026-10-26 剩余阻塞与读取速度优化
- 发现屏障独立到discovery-barrier.cjs。停用来源的旧待交付/待处理线索只保留证据,不阻断无关的新批次;活动来源及未移除相关不确定任务仍严格检查。
- 后台每30秒触发时整轮共享执行,慢采集期间不再重复排队;stop等待后台完成最终线索回执持久化。三处只读窗口的调用改为直接计算,不再构造完整规则/订单/审计快照。
- 适配器、受限运行配置在同一次同步snapshot内复用,独立检查仍每次读取;不缓存跨请求权限、期限或可编辑批次结果。summary只计算一次收集中批次。相同只读数据、固定时钟比较,snapshot适配器读取58→1次、解密1798→31次;摘要中位耗时120.53→8.18ms,完整输出一致。数值是本机副本基准,不承诺所有页面相同比例。
- 界面“当前生效类别”不再等同全部流程实单已验证;未覆盖流程说明局部待采样/适配。实时待办正常、零匹配订单且无失败扫描时,顶栏显示待验证;其他失败仍显示受阻,providersReady执行门槛不改。能力提示不再误称PDF为邮件附件。
- 旧responsiveness测试补齐当前store接口,强化暂停/关闭/整批发现及零全量快照断言;真实BPM、SMTP、SMB和五天测试设置不用于测试。实际验收及本机更新以忽略目录回执为准。
- 最终业务回归118项、未知结果/发现屏障/测试期限保护专项15项通过。独立复核发现的精简snapshot接口兼容回归已恢复可选get防护并单独复验6项;一条旧文案断言按新“当前生效”含义更新后完整重跑通过。未运行旧千项全量。
## 2026-10-26 审查前两项与依赖修复
- 原通知任务在及时启动的扫描中被接收后,持久保存intakeWindow和intakeStartedAt;慢列表读取、详情采集、归档及重启均复用原窗口,不因跨过发送后60秒而直接ignored。已接收任务最多沿用既有30分钟发送宽限,超期明确受阻留证。到达截止仍提前5分钟,不接纳任意迟到历史,不扩大已冻结批次,unknown/sent不自动重发。
- 新批次扫描屏障排除removedAt历史任务,保留未移除不确定任务及活动来源的完整对账检查;原记录、归档与回执不删除。
- nodemailer升级10.2.1,mailparser升级3.12.4,smtp-server隔离测试依赖升级3.21.1;ExcelJS保持4.4.0,仅覆盖其uuid至CommonJS兼容的11.1.1。工作区及本机预装依赖均干净安装,npm audit(含dev)报告0条已知告警。验证Unicode邮件、无附件信封、Excel读写/扩展条件格式及UUID边界检查。
- 本轮仅修前两项与依赖;扫描报告中的通用“发测试到本邮箱”受限策略旁路仍未修改。真实BPM/SMTP/SMB不参与代码测试;本机测试期、收件箱、签名、标题、规则与业务数据在更新时保留,正式服务机不操作。验收和依赖切换回执保存在忽略的output/business-flow-test。
- 验证:业务回归95项通过;最终慢采集/旧屏障/惠州独立投递/五天期限专项66项通过。新增兼容测试最初使用了不触发扩展格式的Excel夹具,已按ExcelJS声明条件改为真实扩展格式路径复验;一次Windows加密初始化超时单独重跑通过。独立审查发现的普通通知sent/unknown后惠州补充通知宽限丢失已修复,保留普通冻结回执与惠州自身unknown保护。未运行旧千项全量。
## 2026-10-26 五天受限稳定性测试
- 用户授权清空旧订单中心显示后开始连续五天受限测试。旧订单、任务软移除,任务保留防重,原PDF/归档/邮件回执不删;原异常留档。仅新基线后的真实匹配通知参与,固定测试QQ、空Cc、无附件、桌面归档及BPM只读保持。
- stability-test/main持久保存实际开始及结束时间(120小时);到期有效settings和restricted-state暂停,采集/归档/发送前及SMTP验证后均复核期限。重启或启停开关不能绕过到期,不退出受限模式。测试设置显示结束时间。
- 实际起止、软移除数量、备份及核对回执在忽略的output/business-flow-test/five-day-run-20261026.json;不能拿代码实现时间替代实际启用时间。定期巡检不重发邮件,不替代应用到期保护。
## 2026-10-26 发送前五分钟到达截止
- 用户确认:11:00批次接收10:55前到达的订单,10:55起归17:00;16:55起归下一工作日首批。相邻到达区间连续,含起点、不含终点。保留原始接收时间和模板日期。
- 新窗口另存collectionStart/collectionEnd(计划时点提前5分钟),start/end仍表示原计划发送区间,policyVersion=2。旧冻结快照没有这些字段时按原窗口核验,不重写、不重发。
- 当前截止后到达的任务先显示等待下一批处理,下一窗口核验当前来源后采集,不阻塞前批。已到期等待任务如果离开BPM则转历史核验。仅旧规则误报且没有任何完成/冻结/未知证据的相邻最后五分钟任务允许受控恢复;原任务仍须在当前待办且身份一致。
- 订单315475原接收10:59:59属于新规则17:00批次;现场核对时原通知任务已离开待办,不能据历史实例直接补采、归档或发信。
## 2026-10-26 邮件批次待发送/已发送分离
- 邮件批次以 Tabler 页签提供待发送、已发送、全部;替代原范围下拉。待发送含收集中、已冻结、发送中、失败及结果待核实;已发送仅显示 sent,取消记录在全部中保留。
- 修复默认 active 与 status=sent 相交导致历史不可见;服务端和地址状态均将该旧查询规范到 sent 范围。范围在权限筛选后分页,不改冻结正文、收件人、发送回执或发送行为。切换清除状态并回第一页,刷新/前后退恢复地址;点击当前页签不重复加载。
- 批次列表和详情显示发送时间(缺失不造时间);已发送正文和订单详情继续可查,只读且不提供编辑/补发。实机核对当前业务批次表为空,邮箱存在两条独立 sends 回执,不伪造为业务批次历史。
- 验证使用隔离批次与账号,未发送邮件、未办理 BPM、未调整自动处理或发信设置;相关查询/分页/导航/弹窗30项通过。用户三份本地业务设计草稿保持不动。
## 2026-10-26 订单采集失败修复与剩余边界
- 修复动态明细 datamap 包含合法隐藏列时被误判的问题:额外列必须有同表隐藏控件,且每条后端记录都确有对应列;仍拒绝跨表映射、不明确行关系及缺少可见字段。
- 后端字段读取成功而静态 PDF 失败时保存独立字段证据 captureEvidenceId,不写入成功 sampleId,不作为 PDF/归档凭据。保存结构原因、表名、行数与字段路径;授权详情弹窗可查看字段值及接口/表/列/行来源,列表不返回字段值。
- 确定性结构、身份及权限错误暂停自动重试;暂时连接错误指数退避(1分钟起,上限30分钟)。只有新鲜完整待办扫描成功才把已离开待办的失败采集任务转为待历史核验;失败扫描与旧发现线索不能推导任务离开。已归档、发送中、已发送、unknown、冲突及替代任务保持保护。
- 原任务重新出现且人工核验后重试,必须重新采集完整 PDF;独立字段证据不得代替成功快照。成功后清理当前“已离开”标记,保留历史证据,重复扫描不重复归档。
- 待历史核验任务提供显式“核验当前任务并重试”入口,要求确认原任务及填写依据;执行前仍重新读取当前待办验证身份与节点,任务仍不在时只保留阻断,不能拿历史实例替代。
- 监听器交付的完整列表也可用于离开判定,但必须与持久完整对账回执逐项一致、为最新且五分钟内的非未来回执,并且早于该次扫描的失败任务才参与;旧线索不能覆盖更新的任务状态。避免后台持续收到列表而不走直接查询时,失败任务永远留在旧状态。
- 两个真实海外更改单的历史表单只读证据证明:V7 / 列表1.9 的隐藏列误判已解决,但 HTML 仍包含后端 Columns 与行数据都不存在的 SubsidiaryDelivery1、SubsidiaryDelivery2、SoftRequireImage_Remark。当前继续阻断,不猜测字段别名;是否在 PDF 明确标注未提供后继续,已向业务负责人询问,尚待答复。
- 业务负责人已确认忽略上述三个已核验 V7 遗留展示控件:不读取或填造其值,快照记录 warnings;只有该完整表单路径与列表版本1.9生效,必要业务字段仍严格阻断校验。两条真实历史HTML/表数据离线复验均生成3页A4 PDF(364487/360046字节),Poppler pdfinfo及首屏视觉检查通过;PDF仅写入忽略的 output 诊断目录,未作 SMB 回执、邮件或 BPM 操作。
- 当前历史列表只提供实例与开始/完成时间,不能恢复原通知节点到达身份;禁止把历史开始时间当通知到达时间、构造任务或自动补发。零售国内返工订单更改评审在两个已核验历史来源均无样本,继续标明未覆盖,不能声称15类实单闭环完成。
- 分类与测试设置现在列出未覆盖流程的具体名称。隔离回归仍使用临时文件/本机 SMTP;真实资料只保存在忽略的 output,未办理 BPM 或手动发送业务邮件。本机更新与最终测试结果以本轮回执为准。
- 验证:当前业务集72项通过,表单/执行/弹窗专项79项通过,另补成功恢复与完整对账证明相关回归。未重跑旧千项全量。首次集成运行发现“未匹配记录仍可见”的过时断言,按现行业务边界修正;下拉候选断言补上实际渲染等待,避免读取尚未显示的候选。已备份并更新原本机测试副本,原账号、模板、规则、订单、批次和邮件配置/记录在更新时核对一致。自动处理、定时发送及隔离模式保持原开启设置;运行期间正常发现的错过时段任务仍人工核验,不自动补发。
## 2026-10-26 订单中心与发送前收集批次
- 用户确认保留11:00/17:00自动发送,发送前可以编辑,未编辑继续使用分类模板。邮件批次新增“收集中”,按当前发送窗口、分类、规则版本、模板及普通/惠州模式分组;订单中心有对应批次入口。读取分组不写业务订单或冻结批次,不把未匹配记录放入订单中心。
- 收集窗口资格复用restricted-test.orderInWindow,与实际prepare一致,包括先前明确纳入待办的处理规则;普通历史订单不移动到新窗口。截止时点后内容只读;既有prepared/sending/sent/unknown不提供编辑接口。
- 管理员可编辑本批标题及纯文本/HTML正文,保留自动订单明细变量和普通通知目录变量,新订单到达仍加入邮件;编辑存入batch-content-drafts,只作用于本批,不改模板、规则或BPM原文。支持版本冲突、来源配置变化阻断、保存失败保留输入及离页保护。归档未完成时也可提前保存文案,冻结时仍检查全部归档与来源就绪。
- prepare通过原composeBatch读取本批编辑并保存contentEdit证据,账户签名自动追加。冻结后后续改模板/签名不重写正文,仍由既有调度器与隔离SMTP策略发送;不新增人工发送入口。新批次HTML预览独立鉴权并受CSP和sandbox限制。
- 订单/批次详情使用居中弹窗;点批次内订单打开其来源、摘要、归档与状态详情,可返回原批次,地址和筛选不跳转。弹窗关闭/换页中止请求并清理控件、遮罩与滚动锁;后台更新只提示刷新,不重画正在阅读的详情。
- 真实只读核对:现有1条pending海外订单符合当前11:00窗口,可直接显示收集批次,无需补造订单/归档/邮件记录。已办通知补漏、缺少适配流程及完整业务验收仍未完成,本次不宣称全业务闭环。
- 本轮44项相关回归通过;独立复核发现的两项P2及弹窗打开过渡期间离页滚动锁均已补回归并修复。备份后更新原本机测试服务,实机验证315198收集批次、可编辑控件和关联订单弹窗/返回;没有保存真实批次文案,没有人工发信或办理BPM。账号、模板、规则、订单、批次及发信记录核对一致,状态和发送计划保持原值。
## 2026-10-26 BPM竞态修复
- 基于远端42d19c7,修复SignalR握手尚未完成时onClose先于reject的问题:首次关闭在推进轮询状态后立即安排待办/知会只读对账;旧票据使重复关闭和catch不重复推进或入队。既有退避、业务日历、停用及身份隔离继续生效。
- Cookie持久化的四条调用路径均显式传入principal;异步采集与storageState返回后重新核对授权和票据,在Vault同步提交边界前拦截撤销。权限撤销和普通退出登录统一同步作废对应票据,再等待原连接锁清理;保留已有有效会话,不删除历史凭据。
- 清理执行前核对仍是原lease,避免误关排队期间其他合法调用者创建的新窗口;不提升整条连接generation,不作废其他调用者/后台托管的票据。
- 新增14个回归场景均先观察失败,包括握手重复回调、权限撤销/退出登录在save/check/ensure的capture和storage两个阶段,以及新旧窗口清理竞争。测试使用隔离连接/本机浏览器,不访问真实BPM,不发真实邮件。旧测试退出登录后改用新工作台session,避免复用已撤销身份。
- 部署沿用原本机测试副本,更新前备份,保留账号、模板、业务数据与发送设置,不操作服务机。当前版本与验收回执以code-revision.json及忽略的output/business-flow-test目录为准。
- 最终关键回归71项全部通过:29项实际manager/本机隔离浏览器、32项接口/账号生命周期/状态及10项监听。独立复核无剩余P1/P2;未跑旧千项全量。已备份更新并重启原测试服务,规则、订单、批次、适配器、原模板、邮箱配置和发信记录哈希一致。实机账号/同步健康,PDF与自动归档仍按原现场验收状态受阻,不因本次修复改为就绪。
## 邮件模板编辑与账户签名
- 邮件模板页可新建、编辑待确认/已生效模板,支持纯文本、HTML源码及安全预览。active编辑保留模板ID和分类关联,版本递增并保留修改前历史;历史/忽略模板可复制为新草稿。新建/待确认模板仍需确认生效;已生效模板不能直接改变普通/惠州通知模式。
- 邮箱管理→管理邮箱中维护固定尾部签名,可选纯文本或HTML。默认未启用,不自动迁移或删除旧正文中的署名。启用后由实际发件账户在新批次冻结时追加;旧规则署名仅兼容保留,页面不再编辑。模板内已有署名须由用户在正文中调整,避免重复。
- 正文效果预览与实际冻结共用composeBatch,包括模板、签名及容量检查。冻结保存模板/账户签名版本及最终正文,后续编辑不改写已冻结批次;测试发信也使用该账户签名。To/Cc隔离、无附件及unknown不重发约束不变。
- HTML复用现有白名单清理,并生成纯文本备选。编辑预览使用独立受限页面,保留安全内联样式,禁止脚本/远程图片;预览仅在内存中保存最多20条、5分钟并绑定管理员,不写业务数据库。HTML转文本库原已安装,现声明html-to-text 10.0.1为直接依赖。
- 本轮34项相关验收全部通过,另有SMTP服务专项通过;未重跑旧千项全量。独立复核发现的预览签名差异已补失败测试并闭合。已备份并更新原本机测试副本,实机打开HTML编辑/预览及账户签名入口验收。原模板与邮箱配置、规则、订单、批次和发信记录哈希保持一致。本轮未发送真实邮件、未办理BPM,也未操作正式服务机。
## 匹配编辑交互更新
移除分类规则中的独立“搜索流程或节点”框和可见Excel类别编号,内部类别标识保留以兼容导入。流程、节点选择复用Tabler配套Tom Select,输入即时筛选、支持键盘选择,禁止创建未采集项;节点按流程联动。搜索输入不标记草稿变更,切换/离页时销毁控件。此次为界面调整,不修改业务快照、发送设置或BPM行为。
相关15项交互验收完成;其中4项旧选择器在适配新组合框后单独重跑通过。本轮未重跑旧全量。备份后更新本机测试副本并实机验证输入筛选,原业务规则、订单、批次、适配器、设置与发信记录哈希保持一致;未发邮件、未办理BPM。截图及部署回执保存在忽略的output/business-flow-test目录。
## 当前:字段映射仅维护BPM流程和节点(2026-10-23)
- 字段映射页面简化为自动采集开关、只读更新、搜索与流程/节点列表。目录使用原加密数据库中的独立记录持久化,仅由可信BPM列表及真实待办采集更新;初次升级从已保存的服务端证据初始化,不从规则、Excel或历史节点占位名反向生成。
- 分类规则新增行仅使用目录中的流程及对应节点;已有未知值保留并标注,不污染其他行候选。内部详情适配器及证据保留,页面不再编辑客户、数量、型号等业务字段路径。自动采集暂停不改变已有活动规则。
- Excel仅修改分类草稿;新增“下载规则导入模板”,每行一配对,同分类多行合并并要求业务配置一致,附填写说明和BPM可选项。兼容原xls及旧配置导出,支持模板ID、产品线。未知流程/节点逐行警告,可保存草稿,但应用、首次开启测试、恢复测试和正式发布均复核目录。模板无效及同分类配置冲突在预览时报错。
- 实采名称保留原标点,包括全角括号及斜线/加号;导入优先完整匹配实采名称,再兼容旧表多值写法。原已发布规则、受限快照、邮件计划、账号和数据不因迁移改写。未观测名称不等于BPM一定不存在;已办通知补漏及真实PDF/归档能力验收仍未完成。
- 本轮核心54项、采集专项10项、分类交互专项4项和新增流程专项1项通过;未运行旧千项全量。备份后更新原本机测试副本,初始化20个流程/32个配对,规则、订单、批次、内部适配器、真实采集样本、测试快照、设置及发信记录哈希不变。实机新页面已刷新验收。本轮未发送邮件或办理BPM;具体代码版本以code-revision.json为准,正式服务机未操作。
## 本轮:旧记录移除与隔离样例邮件验收(2026-10-23 16:18)
- 按用户要求将唯一旧受阻订单软移出订单中心,原归档与规则快照哈希保持一致,防重数据保留;当前订单中心0条。未新增业务订单或业务批次。
- 四个实时来源(v8/v4待办与知会)均成功完整分页,共16条,精确命中0条;多数停在生效节点,继续严格排除。已办通知任务补漏尚未实现,不能将实时分页完整表述为覆盖全部应通知订单。
- 自动处理、计划发送及受限测试开关保持开启;PDF/归档现场能力检查尚未完成,自动链仍受阻。修复应用单类别时丢失其他类别未覆盖流程警告的问题,仍显示1个缺适配流程。
- 两笔已核验历史订单按Excel同属试产类别,使用既有分类绑定模板合为1封样例邮件,隔离QQ收件、空Cc、无附件;16:17 SMTP已接受,实收待用户确认。另一笔历史订单因节点名称不符继续排除。本次没有生成PDF、归档回执或真实业务批次,不代表自动闭环验收。
- 样例发送复用原邮件通道及发送记录,固定隔离信封,持久幂等;sending/unknown不自动重发,无新增HTTP发信入口。维护前备份两个相关数据库,更新后本机守护健康;正式服务机及BPM流程未操作。
- 本轮仅运行邮件样例、Excel执行桥接和订单查询相关19项测试:19通过、0失败。未重跑旧全量。代码已覆盖本机原测试副本,具体版本以该目录code-revision.json为准;业务数据、预览、回执与备份位于忽略的output目录,不入Git。
## 当前:Excel规则已接入测试执行链
订单中心仅展示有分类匹配证据的订单和执行任务;未匹配候选、不带分类的识别失败记录不进入列表、统计或订单详情。已匹配但缺字段、归档失败或待核验的订单继续显示。原到达与候选数据保留,不删除或重做业务。本机14e48339目录保留为基础版本路径,后续视图补丁按当前分支提交覆盖,不再把目录名当成完整代码版本。默认核心测试另纳入10项订单查询回归;本次查询专项10项通过,不声称重跑旧全量。
本机运行 `%LOCALAPPDATA%/OrderNotificationAutomationReleases/test-excel-import-20261023-14e48339`,代码树 `14e483398ff3d44f4f0948009e6cbac2c5033092`。原76版本保留作回退,正式服务机未操作。
- Excel预览后可“确认导入并应用到测试”;编辑则“保存草稿 → 应用到测试”。直接复用既有匹配、详情采集、PDF归档、批次与调度器,不增加第二套业务链。规则仍严格按Excel流程和节点,不添加节点别名。
- 测试固定邮箱、空Cc、无附件、桌面目录、运行ID/基线及计划不变。应用不回填历史,不重做旧订单和冻结批次;有未完成的旧版本任务时拒绝切换,先完成或人工处理。正式发布路径保留。
- 默认 `npm test` 改跑29项核心业务验收,全部通过,约74秒;旧完整测试保留为 `npm run test:full`,不再每次运行。首次全量曾因下载等待超时失败、第二轮由用户主动中止,均不计通过。导出已改用官方单文件包,保留Excel格式。
- 更新前官方完整备份并自动验证:`%LOCALAPPDATA%/OrderNotificationAutomationBackups/before-excel-execution-20261023-151155`。更新后账号、连接、全部规则/适配器/样本、旧订单/批次/原始回执、SMTP配置/游标/发信记录逐项哈希一致。532个候选文件与对应Git树一致。
- 实机页面已刷新,原始Excel识别15类,“确认导入并应用到测试”可用;仅预览,没有在实机确认导入或应用。本轮没有真实发信或办理BPM。自动通知仍等待真实合格订单的PDF/归档检查;缺少的流程适配与已办通知补漏仍未完成,不声称15类真实业务闭环已验收。
操作说明见[业务配置与Excel导入](business-configuration.md),证据见[整合验收记录](bpm-native-integration-verification-2026-10-23.md)。下文为此前原生代码切换的历史记录,进程入口以前述新版本为准。
## 早前原生整合切换记录(76bbac02版本)
本节为当前交接基准,下文旧日期内容仅保留历史。源码位于 Z 盘项目目录(同一 UNC 共享目录),分支为 codex/smb-storage。当前业务代码提交1848a6c,已经推送;本机运行已切到经过逐文件核对的本地副本,原工作树代码保持不动。
- 业务范围严格取原 Excel 的15类精确流程与节点;海外四流程仅允许“订单专员(订单通知书)”。“生效”和BOM固化不作为通知节点。产品线、模板由分类明确配置,测试产品线标签取规则名称。
- 处理身份为 source + portalSource + taskId;上游未提供业务修订时保持缺失,真实0保留。到达库沿用唯一旧键及首见来源;多个旧键冲突须人工核验,整批回滚,不挑选或删除历史记录。
- 当前新鲜待办只有经服务器读取、精确范围及版本检查后才可纳入不可变允许清单;原 receivedAt 不改,admittedAt 单独保存。冻结与发送前重新确认已纳入任务仍存在、内容一致。
- 只启动一套原生 OrderExecutionCoordinator / OrderRuleDispatcher;根目录旧工作流不启动。只读详情限制已核验路径、字段及表单版本,listVersion 与 formVersion 分开。BPM 不已阅、不审批、不保存、不办理。
- PDF归档及读回校验成功后才能通知;To固定隔离QQ邮箱,Cc与附件为空,归档限定原桌面测试目录。普通与惠州模式均保留模板问候、说明、签名,订单区一单一行且从订单号开始;日期变量使用原始 event.receivedAt 的北京时间日期,跨日按出现顺序去重,不采用发送、纳入或创建日期。
- 按分类、模板及窗口冻结,既有冻结正文不重渲染;sent/unknown不自动重发。每天北京时间11:00/17:00遵循原业务日历,空批次不发送,不自动补发历史窗口。明确纳入的待办可进入下一合法窗口;冻结prepared队列宽限30分钟。
## 实际运行与恢复
本机测试地址:http://127.0.0.1:18766/#notification-orders 。运行副本为 %LOCALAPPDATA%/OrderNotificationAutomationReleases/test-native-20261023-76bbac02 。请从该副本的 scripts/service.cjs start 启动当前测试版本;源码目录用于开发,旧modular-refactor目录仅保留原代码与原PDF输出,不作为新测试版本启动入口。登录自启原为关闭,保持关闭;正式服务机未操作。
状态目录仍为原 %LOCALAPPDATA%/OrderNotificationAutomation。原账号、连接、邮箱、31个字段适配器、32份样本、旧归档及规则快照保留;原PDF输出路径继续使用旧工作树的output/pdf。完整备份位于 %LOCALAPPDATA%/OrderNotificationAutomationBackups/strict-excel-before-20261023-2026-10-23T04-05-17-523Z,已通过官方创建、验证和应用前恢复性检查。
15类受限快照已应用,自动处理及11:00/17:00计划意图已启用。此前已收件测试任务的原身份、批次和证据导入防重;旧运行的一条已归档待发记录保持待核验,不自动重排或发送。惠州附加通知原来未启用,本次保持未启用。
第一次实际切换发现历史对账微任务连续执行阻塞心跳,以及监听层仍拒绝缺失revision。已修复为扫描窗口一次取值、历史线索间让出事件循环及重检暂停/停止,并修正真实待办身份。最终全量990项:989通过、0失败、1项可选ZCode测试跳过。409个运行及测试文件与本地副本逐字节核对一致。
更新后观察同一业务进程持续运行超过十分钟,未新增重启;295份对账线索已完成,17条真实待办读取成功,原82条到达记录的键、首见时间及来源保留。新建业务批次0,本轮没有新增真实邮件。数字是交接时快照,后台后续对账会继续更新。
13:03/13:09 的17条实时待办均未命中Excel通知节点,这是当时待办快照,不能据此判断今天没有应通知订单。随后根据用户提供的当天邮件,在已办列表及只读流程步骤中找到三笔:两笔试产类订单已于11:24/11:25提交Excel的确切通知节点;一笔海外返工订单于11:26结束名为“订单通知书”的节点,与Excel的“订单专员(订单通知书)”不一致,用户已选择继续按Excel,不建立节点别名。严格测试运行基线为12:12,三笔都已离开通知待办。
当前执行器只读当前待办,历史采样只用于字段配置,缺少已办通知任务的补偿发现。已验证的 ProcessStep 只返回节点名称和办理完成时间,没有通知任务ID或节点到达时间;不能用流程实例ID、行号、完成时间构造通知任务。下一步需核实可获取原通知任务ID/到达时间的只读来源,再设计受控历史对账与持久通知快照;历史纳入和补发范围须明确,原已发送/结果不明任务仍禁止自动重演。人工邮件跨类别合并不覆盖Excel分类:这两类仍分别使用分类模板。详见[本轮整合验证](bpm-native-integration-verification-2026-10-23.md)。
运行能力中的PDF导出及自动归档仍待首笔合格真实任务验证,页面显示“自动通知受阻”;不伪造就绪状态,也不处理“生效”订单来补证据。15类真实闭环未完成;零售国内返工订单更改评审仍缺字段适配器,继续阻断。逐类真实节点、PDF视觉核对、计划邮件实收和正式210/SMB另行验收。本次三笔调查未更改代码、规则、测试基线或发送范围,未补发邮件,也未办理BPM。
你提供的两笔历史邮件样本已与BPM历史摘要逐字段核对一致,两流程均属海外类别;未取得当时通知节点证据,不以邮件正文证明触发时点合规。详细证据、已知边界见[本轮整合验证](bpm-native-integration-verification-2026-10-23.md)。业务PDF、数据库、Cookie、密钥、原始采样、截图和本地设计草稿不提交Git。
## 2026-10-18 历史接续分支与运行记录
本节及以下早期能力、命令、路径和测试计数是当时快照,不是本次合并切换回执;继续工作以前述 2026-10-23 权威边界为准。
仓库:`https://git.simgreek.com/simgreek/order-notification-automation.git`。
当前开发分支是 **`codex/smb-storage`**,包含 SMB、预览、ZCode 和守护的全部工作;旧 `main` 不代表最新能力。最近实现提交:`9a23197` 服务守护和健康面板、`e2bd8c3` BPM 请求异常导致进程退出的修复、`3363a88` ZCode 接入、`fff2a29` 按真实订单号归档、`607b240` BPM 会话 SQLite 持久化。
```powershell
git fetch origin
git switch codex/smb-storage
git pull --ff-only origin codex/smb-storage
npm ci
npm start
```
新克隆尚无本地分支时用 `git switch --track origin/codex/smb-storage`。本机源码在 `F:\Sync Tool Skyworth\Work Maps\order`,依赖已安装,无须为继续开发重复安装。
本机交接时守护正常,Windows 当前用户登录自启已启用。工作台 `http://127.0.0.1:18766`,健康页 `/#health`,助手 `/#assistant`。
| 命令 | 用途 |
|---|---|
| `npm start` | 后台守护启动;重复打开复用实例 |
| `npm run service:status` | 查看守护实际响应与持久状态 |
| `npm run service:restart` | 正常重启并检查两个端口 |
| `npm run service:stop` | 显式停止,不自动拉起;保留自启设置 |
| `npm run service:install` / `service:uninstall` | 安装/移除当前用户登录自启 |
| `npm run start:foreground` | 前台排错,需先停守护以免端口冲突 |
自启在当前 Windows 用户登录后执行,沿用其 DPAPI 和 SMB 权限,不是未登录运行的系统服务。移动源码或更换 Node 路径后重新安装自启。
## 已实现
- 工作台账号/角色/持久登录、日历、异常、BPM 远程登录与加密托管续登、只读分页扫描、按到达日查询。
- SMB 主机共享浏览、免填或独立凭据、可取消的有界检查、读取成功后添加、PDF 手动/新文件自动归档。按可见 BPM `OrderNum` 的完整 6/7 位订单号建目录,保留前导零、复用已有目录,不默认截取或从文件名猜号。
- 本机内嵌 PDF、图片、文本、DOCX/XLSX 预览;旧 DOC/XLS 下载,Office 排版不保证与桌面软件一致。
- 邮箱与模板审核,以及独立业务通知队列:来源字段映射、样本预览、产业群组、两个北京时间时段、去重及结果不明核验。
- ZCode 个人对话、加密历史、权限、固定操作卡片、取消及额度。官方桌面包 3.14.3 附带 CLI 实际为 0.16.9,已用官方 CLI + 本机测试模型验证;**真实模型 API 参数尚未配置/认证,后台自主监管未实现**。换机器用 7-Zip 和 `node scripts/setup-zcode.cjs` 校验解包,管理员在页面配置模型,运行包不在 Git。
- 独立守护、双端口实例心跳、退出/持续无响应恢复、退避/冷却、日志轮转、Windows 登录自启、只读历史健康面板与断线恢复。
## 必须延续的业务边界
- **PDF 仅归档,不附加到通知邮件,不因归档而触发邮件。** 邮件正文只取 BPM 简要说明原文,按产业通知接口人。
- 流程范围、简要说明字段、产业与接口人映射由同事整理后配置;不把全部待阅/知会当订单,不猜收件人,不自动已阅或审批。
- “210”是可配置 SMB 能力,不硬编码服务器或目录。免填模式使用部署账号/现有 SMB 会话,不是网页访问者身份。
- ZCode 仅使用授权快照;固定动作须用户点选并重新检查权限,不执行模型任意命令、文件、审批或邮件操作。
- 健康卡片是上次保存/观测结果,不等同实时外网连通性;刷新不触发外部检查。邮件结果不明保持待核实,不自动重发。
## 2026-10-18 历史下一步建议
当时确认并完成的是“服务守护+健康面板”。以下建议仅保留历史,不作为当前业务身份或实施状态:
1. **批量导出/归档与持久任务记录**:从扫描列表人工勾选,自动打开详情、采集可见字段、生成 PDF、按真实订单号归档;显示进度、支持取消及失败步骤重试。
2. **统一订单任务中心**:按订单号和业务版本关联扫描、导出、归档及独立通知状态,保持 PDF 和通知两条链路独立。
3. 健康异常跳转具体失败记录,复用已完成结果,只重试允许重试的步骤。
4. 可配置业务规则和试运行预览;同事资料核实后再接自动来源。
5. 自动备份与恢复演练;跨机或跨 Windows 用户需验证 DPAPI 恢复条件或重新授权。
## 验证与容易重复踩的问题
- 服务守护及受影响回归 20/20、额外加密存储 7/7,共 27 项不同测试通过;19 个 JS 语法检查通过。覆盖实际子进程退出/无响应、冷却、手动重启/停止、鉴权及畸形消息、未知端口保护、中文启动器、安装失败/外来快捷方式、健康历史/权限、浏览器断线恢复。
- 实机独立 CLI 重启后守护保持、两个端口恢复、登录会话保留,健康页无脚本错误。没有重启 Windows,也未验收公司真实邮件及正式全业务自动处理。
- ZCode 官方 CLI 的真实请求已核对地址/模型/鉴权及空工具列表;返回未经请求的 Write 调用时没有写文件。供应商真实认证仍待配置。
- 本环境曾拒绝文件 rename(EXDEV),会话已改 SQLite,不倒退为临时文件 rename。
- BPM `fulfill/abort` 必须在 `try` 内 `await`,否则异步拒绝绕过 catch 导致服务退出。
- Windows PowerShell 明确 UTF-8 输入/输出;VBS 用 UTF-16LE BOM,已执行验证中文及空格路径。
- 管理令牌仅用于本机管道,HTTP 心跳每次启动独立随机。超时不能当停止成功,须通道关闭且同一实例的 stopped 状态落盘。
- CLI 工具禁止名单按精确名称,`*` 不代表全部;旧 provider 导入忽略 `tool_call:false` 和输出 token 上限,不能把它们当安全控制。
```powershell
node --test --test-concurrency=1 tests/service-supervisor.test.cjs tests/service-control.test.cjs tests/windows-startup.test.cjs tests/runtime-health.test.cjs tests/health-http-ui.test.cjs tests/server.test.cjs tests/workspace-http.test.cjs tests/bpm-runtime.test.cjs tests/dashboard-http.test.cjs
node --test tests/bpm-vault.test.cjs
```
详细证据见 [验证记录](verification.md)。日志/截图位于本机忽略目录 `output/verification`,新克隆需要重新生成。
## 运行数据与阅读入口
状态位于 `%LOCALAPPDATA%\OrderNotificationAutomation`,含工作台、BPM、邮件、扫描、存储、通知、助手、健康与守护的 SQLite,以及加密主密钥和本机运行包。账号密码、Cookie、API Key、数据库、业务 PDF/原邮件、日志、截图不提交 Git。
**Git 推送不等于运行数据备份。** 备份先 `npm run service:stop`,保护整个本地状态及业务输出目录和 DPAPI 恢复条件,再 `npm start`。本机开发/测试连接不视为正式 210 等服务器端到端验收。
阅读顺序:[README](../README.md)、[当前设计要求](design-requirements.md)、[业务资料整理表](business-configuration.md),按任务查 [守护设计](superpowers/specs/2026-10-18-service-health-design.md)、[ZCode 接入记录](zcode-integration-2026-10-18.md)、[验证历史](verification.md)。早期阶段文档的“尚未实现”以最新基准及代码为准。
- 最终验证:当前业务回归173项、provider/采集恢复/版本兼容/期限保护专项60项通过;独立复核46项通过。新增缺字段/空明细/复制/汇总行回归均先复现失败再修复。
- 最终候选版本验证:301项业务测试全部通过,0失败/0跳过;修复专项25项通过,生产依赖审计0条已知漏洞。审查结论:两项确认问题已修复,可合并代码;正式投产验收边界不变。