Files
Agent-Workbench/docs/PLAN-1.16.md
T
2026-10-31 21:31:41 +08:00

45 lines
6.2 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.
# 1.16 手机伴随端执行方案
2026-10-31开始实施。从06c9fac/正式1.15.0在feat/mobile-companion-1.16推进。用户选择iPhone,可配合证书信任;Windows提供HTTPS服务,iPhone Safari/PWA通过同Wi-Fi联调。各切片状态以[实际验收](QA-1.16.md)为准,未通过的能力不能计为交付。
A–F已完成,最终不可变20261031114604110通过独立源码/便携、同载荷安装和正式保留状态升级。iPhone 14 Pro Max/iOS 27.2为用户提供;用户确认信任、配对、原审批、差异/报告SHA、主屏幕、锁屏、切网恢复、停止及撤销,原宿主审计/进程/文件另行核对,无手机截图。具体结果及原失败见[QA-1.16](QA-1.16.md),原字节身份见[发行记录](mobile-companion-release-identity.json)。
## 用户成果
用户在Windows工作台开启手机连接,扫描一次性配对码后,在手机查看指定项目的同一Task/Run、进展、实际文件差异和检查结果;在授予审批权限后,可确认原审批或停止所属任务。离开电脑、关闭桌面窗口不影响后台宿主,手机断线后从原seq补发,撤销设备立即失去访问。执行文件、命令、模型和Git仍由原宿主控制。
首版为PWA伴随端,覆盖观察、原审批、停止和原报告,不在手机上另做一个执行内核。真实手机验收和390px兼容分别记录。完整手机编辑器、原生Android/iOS包、跨公网托管和手机本地执行是后续独立能力。
## 六个切片与门槛
| 切片 | 实现范围 | 验收结果 |
| --- | --- | --- |
| A:配对网关 | 执行宿主继续只监听loopback;用户显式开启独立HTTPS网关;一次性256位配对随机值、短有效期、原宿主/用户/网关身份绑定、串行消费和设备登记 | 错误宿主、过期/重复/并发配对、未知设备与原服务变化拒绝;关闭网关不结束任务;不把原Workbench管理token交给手机 |
| B:设备权限 | 每个设备选择项目范围和观察/审批/停止权限;服务端路由及归属检查;撤销/到期、会话轮换、连接速率限制及原操作审计 | 越项目、换Task/Run、字段扩展、绕过UI直接调用、已撤销设备和旧会话拒绝;设备审计不保存凭据明文 |
| C:手机界面 | 配对、项目/任务列表、原进展、原文件差异、工程检查、预算/unknown状态和报告;触控、软键盘、安全区及前后台恢复 | 在实际Android或iOS浏览器操作;长路径/大量进展/原审批可读,后台切回状态正确;宽窄界面共用原Task/Run和工件 |
| D:审批与停止 | 手机确认同一原审批ID、Task/Run、输入指纹和当前修订;重复请求幂等;明确停止等待所属工具及进程结束 | 桌面与手机同时审批只执行一次;已取消/过期/换Run审批拒绝;断线期间完成的工具不重放;停止后原心跳不再写入 |
| E:断线与撤销 | 从原持久事件seq分页补发,设备仅收到授权项目;重复/乱序处理,原结果SHA核验;撤销立即关闭活动连接 | Wi-Fi断开/切网/刷新/后台/重连均恢复同一结果;无越项目历史;设备撤销时仍在运行的原Task继续由宿主保留 |
| F:独立发行与回顾 | 固定源码/设备契约、全量历史回归、真实手机/桌面、干净安装、保留连接和全部持久数据升级 | 原源码/测试基线和失败保留;手机真实设备信息、步骤/结果/日志有证据;没有真实设备时不能把手机交付标完整通过 |
## 传输和凭据选择
默认关闭远程监听。局域网首版需要手机实际信任的HTTPS证书和固定网关地址;本机生成证书与设备上的信任安装要有明确操作和实测结果。仅访问一个HTTP局域网地址或忽略证书错误,不算PWA与加密传输完成。已有可信域名/证书可作为用户选择的配置,公网或第三方隧道另行配置,不自动公开工作台。
配对随机值仅用于短期单次授权。设备登记与权限修订在宿主事务中保存;持久秘密使用本机加密适配层,手机侧采用安全会话或实际平台可支持的设备密钥。具体认证格式通过实际浏览器验证后固定,不预先宣称硬件密钥或跨平台安全存储已可用。原模型Key始终留在Provider;手机模型状态和用量不包含Key。
## 模块与原契约
拟新增gateway传输/设备登记、共享设备与审批契约、配对管理界面及mobile伴随页面。Runtime、Store、Provider、Task/Run/Tool、工件、计划、累计预算、worker和受控引擎仍复用;新增网关只转发经设备权限和归属核对的固定操作。配对、撤销和设备审计不触发模型或项目命令。
手机不能访问Workbench完整管理API、任意宿主路径、任意命令或全部会话导出。观察权限只读取授权工程;审批或停止需要原身份和当前输入,UI隐藏按钮不是权限边界。每个操作写入设备身份/请求ID/Task/Run/结果,重试不产生第二次副作用。unknown必须显示需核对,不能因断线自动恢复工具。
## 实际验收素材
使用自有Node/React/Python项目、独立端口、数据目录及测试凭据,复用既有失败修复/父审查/原审批/检查/Git样本。设备端保存原步骤和截图,宿主保存原事件/工具行及工件SHA;分别覆盖只读设备、审批设备、撤销、原审批竞争、断线和停止。最终正式升级核对原PID/Provider、全部表每行与全部会话/工件,测试不读取或复制真实模型Key。
每个切片通过相关验收后回顾并本地Git提交,原失败候选不部署。A–E可以先以自有协议/浏览器夹具开发,但F必须增加真实手机结果;需要的设备或证书选择在实际接入前取得用户信息,不能用等待时间替代授权。
## 后续能力顺序
手机完成后,按实际协议接入更多模型,验证工具调用、用量、流式断开和池路由,再做视觉/语音附件、项目范围缓存;最后用独立分支、固定工程评测、多模型复核和可回退候选开发自我迭代。Codex、Claude Code、Cursor、WorkBuddy适配和Purge真实收益均以具体版本/原协议/原工程结果判定,不能以名称或静态研究替代接入。参见[NEXT-STEPS](NEXT-STEPS.md)。