5.7 KiB
5.7 KiB
RPA 迁移后续工作完整清单(2026-11-06 定稿)
前提:阶段 0 前置作业 + 阶段 1 收口 + 本仓库代码活已 100% 完成(含 C# actuate 原型、A++ 字段、NodeState 两态)。本清单是"接下来做什么"的唯一权威账本,按可动性分四档。更新规则:完成一项就划掉并记提交号;新工作先进"待评估"再入档。
三个"不知道"的设计提案(已定稿,发对面确认即可,不再阻塞)
提案 1(原 Q1):平台字段怎么表达
对面 plugin-contract 的 CapabilityDefinition 增可选字段 platforms?: readonly ("win32"|"darwin"|"linux")[]:
- 缺省 = 全平台——旧插件清单不加字段,零破坏;
assertPluginManifest校验值域,未知平台值直接拒绝;- plugin-worker 认领动作时按宿主
process.platform过滤,不匹配的能力对宿主不可见; - RPA 插件清单不手工维护:rpa-adapter 从 rpa-core catalog 的
platformTag自动生成(687 win32 / 326 null 单一事实源)。
提案 2(原 Q2):utilityExtended 权限归属
utilityExtended 在对面源码中无同名物(纯 RPA 侧能力域)。映射到对面 13 项 PermissionScope 的 desktop.process:
- 理由:RPA 命令执行发生在用户电脑 Electron 宿主进程内,"宿主即桌面进程",与
desktop.process语义吻合; - 该域全部标
highImpact + idempotencyRequired(走审批,与 ADR-R1/R6 一致); - 备选:若对面坚持 desktop.process 严格指"桌面进程管理",则新增
desktop.commandscope(对面 plugin-contract 加一个 union 成员 + Set 一行)。
提案 3:晨间助手截图时机 —— 已搁置(2026-11-06 用户拍板,不再作为工作项)
不设专门时机,若未来重启则全挂既有证据节奏:observe 基线 + 人审弹窗前证据 + actuate 动作后自动双证据。当前不要求对面任何配合。
提案 4:rpa.browser 备案单(发给对面即可登记)
| 项 | 值 |
|---|---|
| pluginId | rpa.browser |
| capabilities | rpa.flow.execute(RPA 流程整体入口,方案 A) |
| runner | 双 runner:对面 PlaywrightBrowserRunner(AI 智能体场景)+ 我方 CDP 接管(RPA 场景主力,ADR-R4) |
| PermissionScope | browser.domain(白名单复用对面 BrowserContextPolicy 三重复检)+ filesystem.download(下载类流程) |
| manifest 类型 | browser 能力按对面现行 browser-plugin 口径(域名白名单强校验) |
| 证据 | snapshot/截图走对面证据体系(SHA-256 落盘),不自建 |
第一档:本周就能做(不依赖对面)
- W1 发提案包:上面 4 个提案 + 6 项 ADR 结论,一条消息发对面负责人,等书面确认(Q1/Q2 提案已写入 V2 §10)
- W2 C# actuate 合入对面主干(你自办):按
contrib/windows-runner-actuate/PATCH-NOTES.md执行——3 文件 + Program.cs 最小 diff + 同一提交更新当前事实.json 与 README 区块,跑document-facts --check+ci-gate --mode fast过门禁 - W3 rpa.browser 侧准备(本仓库):浏览器能力 transport 单命令超时 + 统一 resolveElement 修复(ADR-R4 前置,V2 §7-A6 列明的迁前必修项)
第二档:等对面书面确认后立即动(预计 1-2 天内解锁)
- W4 git subtree 迁包:rpa-core →
code/backend/packages/rpa-core改名@agent-worker/rpa-core;Bun 1.4.3 复验(本机 1.4.4 冒烟 37/37 已绿)+ PowerShell 编码冒烟 - W5 rpa-adapter 骨架(对面仓库新建):CapabilityRunner(gateway.execute → ref→componentId → RunContext → handler)+ 权限映射表(34 域 × 13 scope,utilityExtended→desktop.process)+ 状态映射直接 import 本方
toStepStatus()+ 719 能力"未经 authorize 不得触达 handler"全量冒烟 - W6 platform 字段实现(对面 plugin-contract):按提案 1,registry 校验 + worker 过滤 + 契约测试
第三档:阶段 3+(前置:W4/W5 完成)
- W7 垂直切片:1 文件能力 + 1 HTTP 能力全链(create/start → authorize → adapter → handler → 事件/证据回传 → 中途取消);Run 终态与 RunResult 一致性断言
- W8 A++ 检查点最小验证:崩溃 → resumeToken 重入 → 幂等键去重(
checkpointId/idempotencyKey已定稿,只差实现) - W9 双 ADR 落地:R4 浏览器(W3 产物接对面白名单)+ R3 桌面(W2 产物接 TS 宿主适配器——actuate 前先 observe 解析精确标题)
- W10 TS 宿主 actuate 适配器:native-observer.ts 扩展(请求侧精确标题解析、响应侧证据逐项复核、宿主超时 ≥15s)
第四档:规模化与收尾(阶段 5/6)
- W11 34 域分批接入:files/data/http/ftp → office/excel/word → desktop/utility 高影响(末批 + 审批矩阵抽查)
- W12 ocr-smoke 素材治理(迁移时必做,非可选):素材入库
test-fixtures/ocr/+ evidenceDir 改os.tmpdir()——硬编码D:/office-test2在对面机器必然失效 - W13 平台扩展:Linux/macOS 驱动按 ADR-R3 原生通道(阶段 6)
- W14 demo 侧冻结:本 demo 仓库转入只读维护
挂账小项(低优先)
晨间助手截图时机:已搁置(2026-11-06 用户拍板),见提案 3 说明.workbuddy/tmp/actuate-build编译沙盒:留作 W2 合入前复验环境,合入后可删
里程碑对照
| 里程碑 | 依赖 | 预计解锁 |
|---|---|---|
| Q1/Q2/备案 书面确认 | W1 | 第二档全部 |
| 对面仓库可提交 | W1 | W2/W4/W5/W6 |
| 垂直切片全链绿 | W4-W7 | 阶段 4(W8-W10) |
| 高影响域过审批矩阵 | W11 | 阶段 5 完成即"接入就绪" |