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

181 lines
26 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-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)。早期阶段文档的“尚未实现”以最新基准及代码为准。