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

6.2 KiB
Raw Permalink Blame History

1.16 手机伴随端执行方案

2026-10-31开始实施。从06c9fac/正式1.15.0在feat/mobile-companion-1.16推进。用户选择iPhone,可配合证书信任;Windows提供HTTPS服务,iPhone Safari/PWA通过同Wi-Fi联调。各切片状态以实际验收为准,未通过的能力不能计为交付。

A–F已完成,最终不可变20261031114604110通过独立源码/便携、同载荷安装和正式保留状态升级。iPhone 14 Pro Max/iOS 27.2为用户提供;用户确认信任、配对、原审批、差异/报告SHA、主屏幕、锁屏、切网恢复、停止及撤销,原宿主审计/进程/文件另行核对,无手机截图。具体结果及原失败见QA-1.16,原字节身份见发行记录。

用户成果

用户在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。