6.4 KiB
1.15 Windows 桌面宿主与持久连接执行方案
2026-10-31。此阶段尚未实现,接续点已经明确。1.14的独立源码445/445、178组界面、三功能工程、最终便携/归档和保留状态升级及14页复验全部通过,具体前置证据见1.14验收。下一轮从A宿主身份与窗口生命周期开始,沿用B–F六切片。每个切片继续审查、保留原失败、复验并本地Git提交,失败的候选不进入正式服务。
本阶段交付目标
用户通过一个Windows桌面应用打开现有工作台。窗口和执行宿主各自管理生命周期:关闭、重开窗口可继续观察同一任务;重复启动复用经身份核对的宿主;退出宿主等待所属工具、检查和引擎进程结束。模型连接可由用户选择保存为本机加密凭据,重启后的连接状态有实际核验。安装及升级保持项目、会话、工件和连接,安装失败能退回旧版本。
沿用一个React客户端和现有Runtime/Store/Provider,不另建一套桌面代理。当前390px网页验收只证明窄屏界面;真实手机配对、Windows安装版和加密凭据尚未交付。
必须延续的现有契约
- 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原字节/清单一致;连接保留有解密及实际状态证据;未测的真实模型推理/手机/电脑操控不计入通过 |
模块落点
拟增加desktop/main、desktop/preload、宿主注册与desktop发布脚本;这是拟定目录,不能从本文推断文件已经存在。宿主复用src/server/runtime.mjs、store.mjs、provider.mjs及src/core的执行管理器。加密存储作为ModelHub/ConfigImporter的独立宿主适配层,连接选择、池租约和请求账本不因持久化换成另一套协议。
已有Start-Workbench.ps1只按健康响应复用端口;桌面阶段必须进一步核对所属数据目录、实例和实际创建身份。普通窗口关闭不会调用现有/api/shutdown;明确退出执行宿主才按当前活动/未知状态完成停止。默认运行仍使用本机loopback,手机网关在后续独立阶段开放。
现/api/operations只读巡检核对宿主、SQLite quick_check、最近50个工件和连接配置,不能把这项范围写成全库/全引擎巡检。桌面阶段同步补所属worker/原生driver/MCP及未知结果、来源、磁盘余量和分页旧工件核对,报告本次实际检查数量和未覆盖范围;读巡检不启动模型、项目命令或自动修复。
外部能力与后续顺序
固定DeepSeek Harness是1.14已实现的受控引擎。Codex实际引擎适配、Claude Code/Cursor/WorkBuddy执行能力继续按具体版本、原工具/模型/审批/取消契约做独立切片;已有静态研究不能替代接入。REA仍用于发行工件及运行证据,完整公开源码直接核对;每项采纳机制需要所属模块、专项和真实工程结果。
桌面宿主通过后实现手机伴随端:一次性配对、设备作用域、加密传输、撤销、同Run审批和断线seq补发,在真实手机上验收。随后推进跨协议能力路由、视觉/语音附件和版本化缓存,再以隔离分支/固定工程评测/多模型复核实现自我迭代候选。每个阶段有独立版本、验收和回退点。
真实模型工程及Purge推理收益继续遵循用户先本地验收的选择;本阶段本机存储和生命周期用自有凭据/HTTP夹具验证。需要真实推理或设备测试时单独记录原结果,不从夹具成功外推成功率。