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

24 KiB
Raw Blame History

验证记录

历史调研或分阶段记录;当前能力与设计要求见 设计要求。本文件中的订单标识样例已替换为虚构值,旧站点记录不构成兼容要求。

自动续登设置与托管账号数据库唯一性(2026-10-16,当前版本)

  • 页面将“未托管”改为“自动续登未开启”,未配置时提供“开启自动续登”入口;保存账号开启,管理账号可更新密码或关闭。账号字段失焦时只提交用户名查重,提交表单前再检查;过时的检查结果不能覆盖新输入,检查重复时不会发送密码。
  • 托管账号写入本机 bpm-sessions/accounts.sqlite,连接 ID 为主键,规范化账号(去除首尾空格、转小写)的 HMAC 摘要有 UNIQUE 约束;账号/密码/重试冷却信息使用原 AES-GCM 封装加密为 BLOB,密钥继续由 DPAPI 保护。两条连接并发保存同一账号仅一条成功;更换为重复账号时,原凭据与 Cookie 保持。原会话文件继续加密保存。
  • 服务监听前事务迁移旧账号加密文件,提交后才移除源文件。旧文件存在重复时整批回滚,源文件保留;测试覆盖迁移后的冷却信息、账号读取和唯一性。停用/删除清理数据库账号条目,关闭自动续登释放账号唯一占用并保留有效会话。
  • 新增数据库并发/重启/密文、迁移、管理器权限与无损冲突、API 查重和安全返回、页面重复阻止和恢复输入回归,均先复现缺失行为后实现。真实本地 BPM 全栈测试覆盖开启续登后,另一连接查重失败、跳过页面检查直接保存也返回 409、原连接保留登录。
  • 全量 npm test:89/89 通过,0 失败,0 跳过。初轮暴露旧测试先移除临时目录再关闭重启管理器的问题,已将所有重启实例纳入统一清理,重新运行全量通过。生产修改的五个 JS 文件语法检查通过。
  • 正式服务 PID43456,bootstrap required=false/preview=false,stderr 为空。只读检查确认账号数据库和唯一索引建立,当前托管账号数为 0。现有两个活动连接保持已连接;实际页面已打开第一条连接的自动续登表单,账号密码留用户自行录入,尚未将其标为已开启。未保存任何虚构正式账号,未进行 BPM 业务操作。
  • 页面截图:output/verification/bpm-auto-renew-setup-2026-10-16.png。此前阶段记录保留如下。

直接在画面输入与停用后删除(2026-10-16,当前版本)

  • 按用户要求移除画面下方的可见键盘输入区。直接点击远端控件后输入;IME 捕获控件位于点击位置、透明且不拦截鼠标,不增加额外布局。保留远端插入光标,点击不再高亮整个外框;键盘访问画面时仍有焦点提示。处理嵌套事件冒泡,避免普通按键、编辑键和粘贴发送两次。
  • 新回归先失败,修正后确认无下方输入框、画面直接物理按键、点击后连续输入、Tab、中文输入,以及既有 IME/粘贴/缩放事件顺序正确。真实本地 BPM 登录全栈测试确认立即保存并在重载后复用 Cookie,符合正式 CSP。
  • 已停用连接仅管理员显示“删除”。用户确认后先调用会话管理器的停用清理路径,清除托管账号与 Cookie,再在数据库事务内删除连接并记录审计。未停用、非管理员、跨站、额外参数均拒绝;清理失败保留卡片,以便重试。服务不可用时拒绝删除,避免遗留认证数据。
  • 删除存储/API/页面的回归先失败后通过,覆盖取消、确认、权限、前置状态、清理失败、重启后不恢复连接和历史审计保留。使用隔离临时数据,未删除任何正式连接。
  • node --test tests/workspace.test.cjs tests/bpm-http.test.cjs tests/bpm-account.test.cjs tests/bpm-ui.test.cjs tests/bpm-integration.test.cjs:45/45 通过,0 失败、0 跳过。此前输入修正定向测试(含 bpm-session)27/27 通过。修改的三个 JavaScript 文件语法检查通过。
  • 正式服务核实后从 PID32900 更新为 PID35908,18765/18766 监听正常,bootstrap required=false/preview=false,stderr 为空。工作台登录跨服务更新保留。实际打开已保存连接的 BPM 远程画面,直接恢复到已登录的新版门户,确认下方没有输入区;关闭远程窗口后确认两张停用卡片显示删除按钮,未触发删除。
  • 页面截图:output/verification/bpm-native-remote-2026-10-16.png;output/verification/bpm-disabled-delete-2026-10-16.png。以下章节保留此前阶段的实现和验证历史。

远程画面焦点与键盘输入修正(2026-10-16)

  • 用户反馈远程登录只能看到外框聚焦、无法输入。原实现依赖 1px 隐藏 textarea 的 input 事件,画面本身不处理键盘,截图默认隐藏插入光标。新增真实按键回归先失败(画面聚焦后 Ab-1/Backspace 无任何远程输入),修正后通过。
  • 参考 noVNC rfb.js 的画面聚焦和键盘事件转发方式,画面增加键盘焦点、普通按键和编辑键转发;鼠标按下即定位远端并获得键盘焦点。保留 IME、粘贴和程序输入的 input 路径,preventDefault 避免重复字符。隐藏 textarea 改为正常尺寸的可见键盘输入区,支持直接点击键入;远程截图保留实际插入光标。
  • 定向回归 node --test tests/bpm-ui.test.cjs tests/bpm-integration.test.cjs tests/bpm-session.test.cjs:27/27,通过且无跳过。覆盖画面本身的真实物理键盘、可见输入区、中文和粘贴、缩放、密码不留本地、输入顺序、真实本地登录全栈、Cookie/权限/租约/导航边界。修改 JavaScript 语法检查通过。
  • 实际连到真实新版 BPM 的独立空会话,在完整工作台宽屏和 616px 窄窗口点击账号框并输入测试文字;修正后逐个发送 q/w/e 原生按键,Tab 切到密码框输入两位虚构测试文字,远端分别显示字符及掩码。未提交 BPM 登录、未使用任何真实账号密码。截图为 output/verification/bpm-remote-input-2026-10-16.png。
  • 正式服务 PID32900 已加载新版本,18765/18766 正常,bootstrap required=false/preview=false,新脚本提供可见键盘区和 pointerdown 处理,stderr 为空。工作台账号和业务数据保留。
  • 参考源码:https://github.com/novnc/noVNC/blob/master/core/rfb.js 。采用事件处理方式,未引入 VNC 服务或复制 noVNC 源码。

新版 BPM 单入口(2026-10-16,当前版本)

  • 按用户最新要求仅维护新版 BPM。生产只允许 bpmn.skyworthdigital.com 与 SSO;旧版域名、登录表单、检查、导航、UI 和 partial 状态均移除。新版正向账号验证通过即 connected,checks 仅 portal。
  • 先失败后通过回归:新版无需第二入口就 connected、不请求旧版、detail 导航拒绝。连接迁移删除 detailUrl/checks.detail,旧 partial 转 unchecked,保留负责人、身份、历史成功时间及其他数据。原 Cookie 复用、自动续登、冷却、30 天工作台会话测试继续通过。
  • 最终 npm test:79/79 通过,0 失败,退出 0;39 个 JavaScript 文件语法检查全部通过。独立 delta 审查及 29 项定向验证通过,无阻断问题。
  • 正式服务更新为 PID18800,18765 回环桥接及 18766 正式工作台正常,无 18776 演示监听;bootstrap required=false/preview=false,已提供移除旧版控件的新脚本,stderr 0 字节。实际状态保留 1 个用户和 1 个连接,旧版字段已全部迁移移除,工作台持久会话库存在。
  • 真实 BPM 账号尚待用户首次在产品托管表单录入;未触碰现有浏览器凭据,未执行任何 BPM 业务动作。长期运行边界同下述记录。

正式 BPM 自动账号托管与长期会话(2026-10-16)

  • 最终完整回归 npm test:76/76 通过,0 失败,退出 0;node --check 覆盖 src/web/tests/scripts 共 38 个 JavaScript 文件,均通过。
  • 实际 Chrome 本地登录夹具验证:托管账号自动登录一次、后续检查及管理器重启复用 Cookie、同账号保存保留会话、失效自动续登、15 分钟冷却跨重启保留、验证码/未知表单/不安全表单不提交、网络故障不重复提交。密码不出现在返回元数据、审计或存储明文中。
  • 独立审查发现门户成功但旧版待验证码时丢弃门户 Cookie,已先复现后修复。新增连续检查及重启回归确认门户只提交一次;网络不确定或身份冲突保留旧加密快照。实际生产 SSO 的表单、控件、POST action 在独立空浏览器中确认,未输入真实凭据。
  • 全栈隔离夹具验证正式 CSP 下远程输入/立即保存、首次托管复用已登录 Cookie、账号保存响应不含密码、刷新后管理表单密码仍为空;浏览器无脚本错误或 CSP 拒绝。
  • 工作台 token 哈希持久化至 SQLite,验证 30 天到期、29 天活动续期、注销撤销、服务重启同一 Cookie 仍返回 /api/me 200。后台托管启动检查、每 5 分钟检查、交互租约/停用排除、无重叠和停止等待均有回归。
  • 通过独立代码审查,未留阻断问题。正式进程从已核实的 PID42884 更新为 PID23632,监听 18765 回环桥接及 18766 正式工作台,无 18776 演示监听。bootstrap/status 为 required=false、preview=false;新前端已提供,stderr 为空,保留原管理员与 BPM 主连接。
  • 尚未录入真实托管凭据,因此未证明真实 BPM 的认证续登与长期运行。30 天工作台期限通过时钟场景测试,未等待实际 30 天;外部 BPM 的强制到期依靠续登恢复,不能改写其服务端期限。未执行知会、审批、已阅、订单处理或外部通知。

应用框架(2026-10-16)

  • 最终完整回归 node --test tests/*.test.cjs:27/27 通过,退出码 0;包含原真实 Chrome PDF/扩展回归、新 SQLite 持久化、事务认领冲突、异常转交权限与核验依据、日历日期/时段、只读和同源限制、演示空间隔离测试。
  • 对 src/workspace-store.cjs、workspace-api.cjs、dashboard.cjs、schedule.cjs、server.cjs、scripts/preview.cjs、web/workspace.js、app.js 执行 node --check,均退出 0。
  • 独立审查发现演示与正式空间使用同名 Cookie 会相互覆盖。已改用独立 order_preview_session,回归确认两个空间可同时登录、退出演示不影响正式登录;修复经过先失败后通过验证。
  • 浏览器实际操作隔离演示空间:进入演示;2026-10-17 从周末默认改为补班并保存,页面重载后保留;认领虚构 BPM 异常并转交 colleague,负责人和历史正确;虚构 PDF 异常提交验证、填写人工核验依据并关闭;新建虚构连接保持未连接;监管负责人及重试次数草稿保存成功。服务重启后异常状态和历史仍保留。
  • 现场页面为窄侧栏浏览器,菜单按钮、卡片、月历及详情可用;没有将此记录当作所有桌面/手机尺寸的完整验收。完整页面截图能力不可用,保存了正常视口截图 output/verification/framework-overview-2026-10-16.png。
  • 正式进程运行于 18765 回环桥接 + 18766 局域网工作台,演示仅监听 127.0.0.1:18776。正式 bootstrap/status 返回 preview=false、required=true,管理员留用户自行设置。演示 preview=true,独立用户和数据。运行日志 stderr 为空。
  • 没有从另一台电脑实测局域网访问,没有设置开机自启或修改防火墙。远程 BPM 浏览器登录、Cookie 持久化、ZCode、实际告警、自动处理规则及发送尚未接入。

以下保留此前阶段的历史验证记录。

日期:2026-10-15。环境:Windows,Node.js 24.19.0,Chrome 154,playwright-core 1.62.1。

已验证

  • node --test tests/*.test.cjs:11 项测试通过。覆盖四字段命名、缺字段阻止导出、Windows 非法文件名、真实 PDF 字节、同名文件保留、真实浏览器 DOM 采集、隐藏/密码/操作元素移除、CSS 异步资源按源顺序合并、本地 HTTP 鉴权/跨域/大小限制、异步任务到真实 PDF 的集成、启动准备失败不占用端口,以及扩展重启后的任务恢复。
  • 最初 6 项功能测试在实现前均失败;CSS 顺序测试先复现错误,再修正。新增 HTTP 集成使用真实本地服务器和实际 Chrome 排版。
  • npm install --ignore-scripts --no-audit --no-fund 成功,已生成依赖锁文件。
  • JS 语法检查通过。
  • 独立代码审查发现并修复了两项问题:扩展准备失败后的端口残留、MV3 长请求导致状态卡住。扩展准备改在监听前完成;导出接口改为立即返回任务编号,扩展短请求轮询进度,面板重开时恢复状态。
  • 实际调用 启动工具.cmd 已启动回环服务,并生成本机配对配置和本机扩展目录。发现 PowerShell 执行策略禁止脚本后,已改成直接运行 Node,未更改系统策略。
  • node scripts/export-snapshot.cjs --snapshot <先前采集的 snapshot.json> --assets <assets.json> --output output/verification 实际生成当前订单 PDF:331144 字节,2 页 A4,无 PDF 脚本。已渲染并逐页检查,内容到“订单评审参考资料”。

验证边界

  • Chrome 扩展尚未在用户 Chrome 里加载,真实登录会话下的扩展点击、权限提示、CSS/图片读取和本机连接仍需加载后验收。测试没有向 BPM 提交或重放请求,没有复制内置浏览器登录状态。
  • 页面导出仍是样稿,不能作为 XForm 原生打印一致性证明。软件特性要求/配置表图片区域保留了页面占位;附件仅显示条目,未合并附件文件。
  • 当前字段绑定只针对已探查的海外运营订单更改评审 V7 表单。其他订单表单未经验证。

本文件不保存浏览器认证数据。测试快照与回归输出只在本机使用。

Web 看板(2026-10-16)

  • node --test tests/*.test.cjs:17/17 通过。新增持久化/版本冲突、密码哈希/角色、任务记录、上海时区/周末、HTTP 登录与权限、跨站拒绝、PDF 路径限制、旧请求不覆盖新页面测试。
  • 独立审查的慢请求覆盖与启动异常端口残留已修复;前者有先失败后通过的回归。浏览器检查发现 Tabler 1.6.1 顶栏 class 导致侧栏隐藏,已按布局规则修正并现场确认。
  • 隔离测试服务 127.0.0.1:18767 使用临时测试数据;浏览器登录、侧栏导航和修改时间为 10:30/16:30 后重载保留已确认。测试配置不写入正式数据库。控制台无错误/警告。窄屏覆盖未实际生效,未宣称手机布局验收通过。
  • 实际启动工具后,正式看板 127.0.0.1:18766 和原桥接服务 18765 已启动;首次管理员留给用户自行设置。未测试另一台局域网电脑的连通性,未修改防火墙。
  • 尚未实现 BPM 无人值守扫描、业务表格匹配、210 上传和邮件发送;没有发送真实邮件或上传业务文件。青龙仅完成官方资料参考。

公司 SMTP / IMAP 邮箱与模板审核(2026-10-16)

  • 最终 npm test:104/104 通过,0 失败、0 跳过,退出 0;日志 output/verification/mail-full-test-2026-10-16.log。其中 15 项邮件专项测试覆盖 MIME 中文/HTML/CID/附件、未授权来源、错误主题、加密与唯一邮箱、版本冲突、历史和旧草稿、重启游标与去重、后台不重入、连接验证不发信、真实本地 SMTP 发送、API 权限和正式 CSP 下的浏览器审核流程。
  • 8 个新增/修改业务 JS 文件 node --check 通过;npm audit(含开发依赖)报告 0 漏洞。依赖版本固定到 package-lock.json。
  • 独立审查发现并修复:首次空搜索丢失七天边界、范围正则回溯误识别默认模板、轮询反复解密完整历史邮件、CID 重复展开无界内存。分别增加边界回归;列表改读 SQLite 摘要,内嵌图片展开累计限制 12 MB。发信图片使用 CID 附件。
  • 隔离真实浏览器操作:填写 SMTP/IMAP 配置并保存、解析 HTML 模板、在隔离 iframe 展示表格、修改发信标题并确认、确认前仍为 pending、390 px 页面无横向溢出。无浏览器脚本错误。
  • 正式服务 PID43456 更新为 PID15984,监听 18765 回环桥接及 18766 团队工作台。bootstrap/status:required=false、preview=false。stderr 为空;原工作台登录会话保留。正式页实测“添加邮箱”按钮打开表单、名称输入响应、模板状态筛选及群组入口正常;没有写入测试邮箱或模板。
  • 邮件数据库在部署机 %LOCALAPPDATA%\OrderNotificationAutomation\mail\mail.sqlite,邮箱密码与完整邮件载荷加密;测试源与接收服务均为隔离本地夹具。公司真实邮箱参数尚未录入,因此未验证其实际 SMTP/IMAP 连通性,没有发送真实公司邮件。

ZCode 受控对话(2026-10-18)

  • 新增及受影响回归 22/22 通过,涵盖助手存储/策略/服务、CLI 驱动、API/真实浏览器、PDF 桥接及工作台 HTTP;日志 output/verification/zcode-final-regression.log。
  • 最后调整 Windows 路径脱敏及 4000 字输入处理后,助手与浏览器专项重新验证 11/11 通过;日志 output/verification/zcode-context-final.log。先复现路径外泄、输入被截为 2000 字和更换供应商后旧密钥重入历史,再修正。
  • 12 个新增或受影响 JavaScript 文件语法检查通过;独立只读审查核对固定包的内置工具注册项、配置迁移、网络刷新边界及取消结果,重要问题已修复。
  • 官方安装包 SHA-256 已匹配,解包后的 CLI 为 0.16.9;运行包自动识别已核对摘要。正式工作台首页、assistant.js 及 bootstrap/status 均 HTTP 200,required=false、preview=false;助手 disabled,模型名/密钥均未配置。
  • 首版界面参考 Open WebUI 的交互方式,自行实现,共用现有身份。390 px 无横向溢出,聊天刷新恢复、卡片明确点击才执行、停止回复与 HTML 原样显示已在实际浏览器验证。
  • 未配置真实供应商认证,未发送业务邮件或操作生产审批。详细来源和控制边界见 docs/zcode-integration-2026-10-18.md。
  • 官方 CLI 最终专项 1/1 通过(output/verification/zcode-official-final.log):真实模型请求无 tools;恶意 Write 响应确实发送一次,攻击轮产生两次模型请求后正常回复,canary 文件不存在。接口为本机测试模型,不是付费供应商认证。

BPM 请求异常导致工作台退出(2026-10-18)

  • 正式日志捕获 route.fulfill: Fetch response has been disposed 未处理拒绝,Node 24 退出,18765/18766 均 ECONNREFUSED。问题发生于 BPM 路由异步回调,不是助手页面路由。
  • 路由在 try 中直接返回 route.fulfill / route.abort 的 Promise,异步拒绝绕过同层 catch。改为 return await,异常进入既有兜底终止当前请求,保留域名与附件拦截规则。
  • 新增 tests/bpm-route-errors.test.cjs 先复现同样 disposed 错误,再验证修复。覆盖响应提交失败、附件/重定向/弹窗拦截失败、fetch 失败及后续有效请求恢复;没有使用全局吞错处理。
  • 正式服务已重启;首页及 bootstrap 状态 HTTP 200,真实浏览器可见登录表单、无页面脚本错误。没有使用或更改工作台密码。
  • 崩溃专项 1/1、既有 BPM 真实浏览器与服务重启回归 12/12 通过;后者日志 output/verification/bpm-route-crash-regression.log。语法与 Git diff 检查通过。

服务守护与健康面板(2026-10-18)

  • 用户确认先实施服务守护和健康面板。新增独立进程守护、双端口实例心跳、命名管道控制、退避/冷却、Windows 当前用户登录自启及只读健康页面;没有新增邮件重发或 BPM 审批操作。
  • 最终相关测试 20/20 通过,0 跳过,日志 output/verification/service-health-final.log:真实子进程退出及 HTTP 无响应恢复、手动重启、停止不再拉起、重复实例、控制鉴权与畸形消息、未知端口保护、实际冷却流程、中文路径启动器执行、外来快捷方式保护、安装失败、健康历史/权限/来源异常、HTTP 与浏览器断线恢复、既有 PDF/工作台及服务重启。
  • 共用 PowerShell 助手明确 UTF-8 输入/输出,修复中文状态目录 ACL 设置失败;加密存储 7/7 与自启 2/2 重新验证通过,日志 output/verification/startup-vault-final.log。主回归与自启重叠 2 项,总计 27 个不同测试通过。Windows 快捷方式使用真实 COM 创建、读取、移除,并以 cscript 实际执行 UTF-16LE BOM 启动器,在中文且带空格的项目路径下启动隔离 JS。
  • 独立只读审查后修复:未认证 null/对象令牌导致守护退出、心跳复用管理令牌、停止超时误报成功、快捷方式未生成却标为启用、VBS 中文路径编码。对应复现均先失败后通过。心跳现在每轮独立随机,控制令牌只用于本机管道;停止须通道关闭且同一实例的 stopped 状态已持久保存。
  • 最初并行回归遇到一次临时端口 EACCES,独立重跑通过;最终完整相关回归串行运行 20/20 通过。中文目录 ACL 问题已明确修复,没有将失败记录算作通过。
  • 实机已安装 Windows 当前用户登录快捷方式,并核实目标和参数;未重启 Windows。业务服务改由独立守护程序在后台运行,未接管未知端口进程。启动器重复打开会复用已有实例。
  • 实机管理命令执行一次业务重启:守护 PID 47552 保持,业务 PID 从 62420 变为 59864;双端口检查通过,恢复计数为 1。使用临时测试会话验证重启后原会话仍可访问;测试会话随后撤销,没有修改账号密码。
  • 正式首页 HTTP 200;真实浏览器系统健康页显示守护正常、登录自启启用,脚本错误为空。摘要 output/verification/service-health-live.json;隔离截图 service-health-desktop.png,正式页截图 service-health-live.png,均留在本机忽略目录。页面 390 px 无横向溢出,断线时保留旧值并更新连接中断提示,恢复后可继续刷新。
  • 健康模块显示最近保存/观测结果,不等同实时外网连通性;未配置邮箱明确显示未配置。没有以健康展示触发 SMB 写入、BPM 登录或真实业务邮件发送。守护恢复遵循现有邮件 unknown 核验与任务中断规则。

2026-10-19 正式账号恢复与演示移除

  • 备份正式状态后重置既有管理员密码,撤销其旧会话;新凭据仅保存在本机恢复目录,不进入仓库。正式 HTTP 登录、角色、15 类规则读取与退出均验证成功。
  • 移除演示启动脚本、npm 命令、免登录接口和按钮;旧演示 cookie 不能认证。演示服务已停止,演示数据移至本机恢复目录;正式配置及15类规则草稿保留。
  • 正式邮箱管理可进入只读历史查询;只读邮箱不列入发信邮箱管理或模板发信选择。
  • 相关认证、权限、工作台、规则和邮件回归16项通过,0失败;git diff --check通过。正式18765/18766健康,18776/18786无监听。

2026-10-19 账号密码维护

  • 所有角色均可通过右上角“修改密码”维护自己的密码;管理员可在团队账号中重置其他成员密码,两种操作均验证操作者当前密码。账号界面及密码校验分别拆为独立模块。
  • 密码哈希、持久化密码版本及审计原子更新;目标账号全部旧会话失效,重启后仍生效。密码接口响应不写 cookie,避免延迟响应覆盖其他标签页的新登录;排队中的已撤销 BPM 登录操作也会被阻止。
  • 相关回归74项通过,0失败、0跳过:node --test --test-concurrency=2 "tests/app/*.test.cjs" "tests/dashboard/*.test.cjs" tests/workspace/workspace-http.test.cjs tests/bpm/bpm-http.test.cjs tests/bpm/bpm-session.test.cjs。覆盖角色权限、密码校验及限流、会话撤销、并发响应、浏览器操作与移动端;未运行整个仓库测试集。
  • 独立审查发现的排队 BPM 登录撤销与延迟密码响应覆盖 cookie 问题均已修复,并经回归及复核确认。一次未限制并发的运行遇到 BPM 临时目录权限初始化失败,按仓库并发参数重新运行后全部通过。
  • 正式服务已备份并重启,18765/18766健康;状态指纹核对确认原账号、密码及配置未改变,既有会话迁移成功。正式个人账号页截图:output/verification/formal-account-password.png;未在真实账号上提交密码修改。