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

44 lines
7.1 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.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](QA-1.15.md),下一手机方案见[PLAN-1.16](PLAN-1.16.md)。
## 本阶段交付目标
用户通过一个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夹具验证。需要真实推理或设备测试时单独记录原结果,不从夹具成功外推成功率。