7.3 KiB
开发交接(2026-10-18)
接续分支与运行
仓库:https://git.simgreek.com/simgreek/order-notification-automation.git。
当前开发分支是 codex/smb-storage,包含 SMB、预览、ZCode 和守护的全部工作;旧 main 不代表最新能力。最近实现提交:9a23197 服务守护和健康面板、e2bd8c3 BPM 请求异常导致进程退出的修复、3363a88 ZCode 接入、fff2a29 按真实订单号归档、607b240 BPM 会话 SQLite 持久化。
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 仅使用授权快照;固定动作须用户点选并重新检查权限,不执行模型任意命令、文件、审批或邮件操作。
- 健康卡片是上次保存/观测结果,不等同实时外网连通性;刷新不触发外部检查。邮件结果不明保持待核实,不自动重发。
下一步建议(尚未实施)
用户本轮确认并完成的是“服务守护+健康面板”。以下只是后续建议:
- 批量导出/归档与持久任务记录:从扫描列表人工勾选,自动打开详情、采集可见字段、生成 PDF、按真实订单号归档;显示进度、支持取消及失败步骤重试。
- 统一订单任务中心:按订单号和业务版本关联扫描、导出、归档及独立通知状态,保持 PDF 和通知两条链路独立。
- 健康异常跳转具体失败记录,复用已完成结果,只重试允许重试的步骤。
- 可配置业务规则和试运行预览;同事资料核实后再接自动来源。
- 自动备份与恢复演练;跨机或跨 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 上限,不能把它们当安全控制。
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
详细证据见 验证记录。日志/截图位于本机忽略目录 output/verification,新克隆需要重新生成。
运行数据与阅读入口
状态位于 %LOCALAPPDATA%\OrderNotificationAutomation,含工作台、BPM、邮件、扫描、存储、通知、助手、健康与守护的 SQLite,以及加密主密钥和本机运行包。账号密码、Cookie、API Key、数据库、业务 PDF/原邮件、日志、截图不提交 Git。
Git 推送不等于运行数据备份。 备份先 npm run service:stop,保护整个本地状态及业务输出目录和 DPAPI 恢复条件,再 npm start。本机开发/测试连接不视为正式 210 等服务器端到端验收。
阅读顺序:README、当前设计要求、业务资料整理表,按任务查 守护设计、ZCode 接入记录、验证历史。早期阶段文档的“尚未实现”以最新基准及代码为准。