6.6 KiB
1.15 Windows 桌面宿主与持久连接执行方案
2026-10-31。A–C已分别实现、验收和提交(249f191、72a496a、5354d95);D的16项补强回归、6组UI、11组实际安装演练通过并提交f7a5969;E的桌面三工程16节点和原生停止/恢复9组通过并提交b77783b;F元数据/源码离线运行与17相关检查已补齐,独立发行和正式部署进行中。1.14原445/445、178组UI、三工程及发行证据保持,具体前置结果见1.14验收。每个切片保留原失败、回顾、复验并本地Git提交,失败的候选不进入正式服务。
本阶段交付目标
用户通过一个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夹具验证。需要真实推理或设备测试时单独记录原结果,不从夹具成功外推成功率。