Files
Agent-Workbench/docs/PLAN-1.15.md

7.1 KiB
Raw Permalink Blame History

1.15 Windows 桌面宿主与持久连接执行方案

当前状态:A–F已完整实现、独立验收、本地Git保存并正式部署1.15.0;495/495独立源码、23类179组历史UI、真实窗口7/原生UI9/三工程16节点、父8/8、9/9、10/10、同载荷安装/重启/卸载7组(隔离测试登记,正式产品安装器另行stage)、正式18页、1446条工件记录和1357个去重文件核对通过。当前2连接配置/1池、17项目/29全部会话/2567记录/4599事件,正式纠正升级前后每行/全导出/全部工件原字节保持(相对初始16项目,用户启动新增1个示例并将原列表顺移;体验期间另新增1个空白idle会话及对应1事件,全部原28会话/记录/工件保持);旧PID23172已在恢复检查前退出,用户体验时手动启动1.14/PID36552,随后保留这个进程/Provider升级;旧内存Key不可恢复,需在界面重新填写,9229关闭。具体原失败/成功与不可变身份见QA-1.15,下一手机方案见PLAN-1.16。

本阶段交付目标

用户通过一个Windows桌面应用打开现有工作台。窗口和执行宿主各自管理生命周期:关闭、重开窗口可继续观察同一任务;重复启动复用经身份核对的宿主;退出宿主等待所属工具、检查和引擎进程结束。模型连接可由用户选择保存为本机加密凭据,重启后的连接状态有实际核验。安装及升级保持项目、会话、工件和连接,安装失败能退回旧版本。

沿用一个React客户端和现有Runtime/Store/Provider,不另建一套桌面代理。CurrentUser DPAPI和真实Electron已在隔离宿主验收;Windows安装版已完成D–F独立发行与正式状态保留验证。390px只证明窄屏兼容,真实手机配对尚未交付。

必须延续的现有契约

  • Task/Run/Tool、原工件、检查点、累计预算、计划、unknown和显式恢复继续由执行内核负责。重新打开窗口或宿主恢复不重放已经执行的工具。
  • 原生引擎仍通过1.14所属独立工作区和受限工具桥执行,文件提案/检查/父成果审查及Git门槛保持。外部SDK没有单会话取消时,保留所属进程树关闭与原结果核对。
  • 继续区分安装目录、当前runtimeRoot和用户dataRoot。新版在新目录中验收,更新不覆盖正在运行的发行,不把旧启动目录当当前代码版本。
  • Provider凭据留在所属宿主;渲染页、日志、模型请求工件和Git中不能出现明文Key。新增保存功能仅作用于用户在工作台配置或确认导入的连接。

六个可审查切片

切片 实际实现 必须取得的证据
A:宿主身份与单实例 拆分桌面窗口与Node宿主;固定数据目录、用户身份、创建时间、安装清单及随机实例标识;并发启动经过同一注册锁核对 两次启动复用同一实际PID/owner;同名伪服务、旧PID和错误目录拒绝;窗口关闭期间实际任务继续,宿主崩溃后不自动重放
B:本机加密凭据 使用Windows用户级DPAPI或系统凭据库,版本化保存连接ID/配置修订/加密块;内存与磁盘提交失败一起回退;可关闭保存、删除及重新配置 用户显式保存后真实重启可加载;不同用户或损坏块无法解密且状态可见;多连接/导入失败不留部分状态;日志/导出/数据库扫描不含自有明文测试Key
C:桌面窗口与本机入口 Electron主进程管理窗口与窄范围preload;渲染页启用contextIsolation/sandbox并关闭Node集成;项目选择、原文件打开、终端/审查入口绑定已登记项目与当前任务 原桌面窗口实际完成读取/提案/审批/检查/审查;外部导航、任意IPC通道和越界文件入口拒绝;刷新、隐藏与重开保持同一任务/事件/审批身份
D:安装及可回退更新 固定程序/依赖/来源清单;安装包、独立新版本目录、更新候选预检、活动阻挡和失败回退;卸载的数据行为明确 实际安装、启动、更新及卸载演练;任务/审批或原生进程仍活动时拒绝更新;故障注入后旧程序可继续使用;所有持久行、工件和连接修订逐项核对
E:实际工程和生命周期 在桌面中完成固定Node/React/Python工程;测试失败后修复、父审查、检查和Git;覆盖窗口退出、后台任务、宿主停止及unknown核对 原测试/源码基线保持,实际Git范围正确,子/父结果与原日志一致;重开后的事件从原seq恢复;停止后所属心跳不继续写入
F:独立发行和回顾 固定代码/测试/基准,完整回归、真实桌面与390px兼容、干净安装/便携/保留数据更新、原失败与当前身份封存 源码与安装包分别验收;实际运行与Git原字节/清单一致;连接保留有解密及实际状态证据;未测的真实模型推理/手机/电脑操控不计入通过

模块落点

已实现src/desktop/main.mjs、preload.cjs及桌面宿主CLI、身份/窗口登记和本机加密连接;安装管理器、原生启动器和发行脚本已接入,分别以A–F实际验收结果判定交付。宿主复用src/server/runtime.mjs、store.mjs、provider.mjs及src/core的执行管理器。加密存储作为ModelHub/ConfigImporter的宿主适配层,连接选择、池租约和请求账本不换成另一套协议。

Start-Workbench.ps1已改为核对所属数据目录、实例、签名挑战和实际创建身份后复用端口。普通窗口关闭不会调用现有/api/shutdown;明确退出执行宿主才按当前活动/未知状态完成停止。默认运行仍使用本机loopback,手机网关在后续独立阶段开放。

起点1.14的/api/operations只读巡检核对宿主、SQLite quick_check、最近50个工件和连接配置。D已补所属worker/原生driver/MCP及未知结果、来源、磁盘余量和分页旧工件核对,报告本次实际检查数量和未覆盖范围;最近一页正常仍不能当全部历史通过。只读巡检不启动模型、项目命令或自动修复。

外部能力与后续顺序

固定DeepSeek Harness是1.14已实现的受控引擎。Codex实际引擎适配、Claude Code/Cursor/WorkBuddy执行能力继续按具体版本、原工具/模型/审批/取消契约做独立切片;已有静态研究不能替代接入。REA仍用于发行工件及运行证据,完整公开源码直接核对;每项采纳机制需要所属模块、专项和真实工程结果。

桌面宿主通过后实现手机伴随端:一次性配对、设备作用域、加密传输、撤销、同Run审批和断线seq补发,在真实手机上验收。随后推进跨协议能力路由、视觉/语音附件和版本化缓存,再以隔离分支/固定工程评测/多模型复核实现自我迭代候选。每个阶段有独立版本、验收和回退点。

真实模型工程及Purge推理收益继续遵循用户先本地验收的选择;本阶段本机存储和生命周期用自有凭据/HTTP夹具验证。需要真实推理或设备测试时单独记录原结果,不从夹具成功外推成功率。