Files
Agent-Workbench/docs/PLAN-1.17.md
T
2026-11-01 00:19:52 +08:00

43 lines
7.3 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.17 执行计划:模型协议、流式执行与能力路由
A–F已完成实现、独立验收、正式状态保留升级及阶段回顾。1.17.0完整本地交付:Chat/Responses实际协议、有界SSE、完整工具组核验、能力选池、显式检测与原请求证据已实现。独立源码558/558、25类191组历史UI、随包原生窗口7项/原生流程9组/桌面三工程16节点、Responses三工程13节点及两套父Node8/8、React9/9、Python10/10通过;源码与便携各7组伴随端/5组新协议界面、同载荷隔离安装/重启/卸载7组、正式20页通过。正式PID36552/Provider保持,17项目/30全部会话/2590记录/4653事件,全部表每行/会话导出/工件原字节保持;1455条工件及1366个去重文件核对通过,9229关闭。公开模型中心仅增加逐项核对的默认能力字段,原存储不迁移。正式手机网关继续关闭、无设备/证书,未迁入QA身份。真实模型工程/Purge收益继续按用户选择单列待验,本轮真实模型请求0;1.17没有新增iPhone实机流式结论。 见[1.17验收](QA-1.17.md)、[回顾](RETROSPECTIVE-1.17.md)与[发行身份](model-protocols-release-identity.json)。 本文保留原实施范围与契约,下一具体方案见[PLAN-1.18](PLAN-1.18.md)。
用户目标是让接入的多个模型在真实工程中稳定承担合适工作。当前基础是兼容Chat协议的多连接、轮询/权重、Run粘连、并发租约、冷却及请求账本,另有受控DeepSeek引擎桥;这些不证明所有品牌的原生协议、流式、视觉或语音都可用。WorkBuddy未知配置格式、未知登录态导入及真实Purge收益仍须独立核验。
## 本阶段应交付的成果
用户能看到每条连接的实际协议和已验证能力,选择适合工程任务的模型或池;不支持工具调用的成员不会接到需要工具的任务。请求超时、429、认证失败、流中断和取消各自有明确状态与原始依据,已开始执行的工具不因换线路而再次执行。桌面和手机继续显示同一Run的实际状态及已完成结果。
先审查现有Provider、ModelHub、受控引擎桥、连接导入和请求账本,固定扩展位置与向后兼容契约;再依据对应官方协议文档和指定版本逐项实现。协议名称、上游宣称或一次普通文本应答均不能单独证明工具、多模态或中断能力。
| 切片 | 实现范围 | 可核验的结束条件 |
| --- | --- | --- |
| A:协议与能力登记 | 固定连接协议、模型标识、文本/工具/流式/附件声明与实际检测结果,保留来源及检测版本 | 旧连接可读;声明、已测、不支持、未知分别显示;检测不用正式任务数据,不暗中发付费请求 |
| B:协议适配 | 先增加一种经过文档与样本核对的实际协议,统一请求/应答、工具参数、错误和原用量映射 | 同一受控Node任务经过真实Provider链路完成;保留工具ID/结果配对,未知用量不补造;原兼容协议回归保持 |
| C:流式与停止 | 增量文本/工具片段、请求身份、序列、断开、明确取消、迟到结果与原账本 | 半截工具参数不执行;断网/取消不重复调度;已派发而结果未知仍保留unknown;实际HTTP进程与原Task/Run对应 |
| D:按能力选池 | 在现有租约/冷却/轮询基础上增加任务所需能力筛选、可解释拒绝和有界切换 | 不兼容成员不被选中;401/429/超时分开记账;完成工具不因换成员重放;池耗尽准确反馈,不承诺上游永不中断 |
| E:真实任务界面 | 协议/能力配置、检测范围、当前选路、流状态、中断核对和失败原因;沿用已有品牌与中文任务布局 | 用户可完成添加、检测、禁用、入池、执行、停止与核对全流程;实际桌面/390px/iPhone观察状态与原事件一致 |
| F:工程与发行回顾 | 固定Node/React/Python样本、故障注入、完整历史回归、独立源码/便携/安装与保留状态升级 | 原失败保留;模型协议、夹具执行、真实推理收益分别报告;版本与源码/工件/实际部署身份可追溯 |
E原计划包含iPhone新增流式实机观察,本轮完成的是桌面/390px及真实TLS配对伴随端;1.16已有的用户实机结论保持,1.17新增流式仍单列待验,不将本地A–F交付表述为新增实机通过。
## 已核对的扩展位置
1.16发行期间只读核对了当前源码,未开始1.17产品实现。`src/server/provider.mjs`的`complete`固定调用`/chat/completions`,`request`读取完整有界JSON后返回;已有请求AbortController和停止等待,不能据此宣称支持逐片输出。`src/shared/contracts/model-request.mjs`负责封存请求体与预算,新协议需要封存它实际发送的字节,而不是只保留旧Chat请求的摘要。
`src/core/models/model-hub.mjs`固定`protocol: chat-completions`,公开能力中tools只是`protocol_declared`、vision/audio为unknown;已有租约/Run粘连/冷却/逐请求账本可以保留。A切片先版本化连接与能力来源,兼容原schema:1;D在既有acquire前按任务需要筛选,池拒绝原因进入原Run,不能从模型名称推断能力。C的文本/工具片段只作为进展,完整工具参数与终结状态核验前不得派发工具。
`src/core/models/config-import.mjs`目前明确跳过非Chat协议,CC Switch按已验证SQLite列解析;扩展时同步导入预览和启停规则,未知品牌/格式继续显示未支持。凭据仍复用`credential-vault.mjs`与已有当前用户加密,不另建明文号池。原model-center、upgrade-model-center和请求封存回归作为兼容门槛;新增测试覆盖实际协议差异、半截工具、错误分类和原结果保留。
## 真实模型与评测边界(执行约束)
用户此前选择先完成本地验收,真实模型工程与收益对照继续单独待验。开发和协议回归使用自有loopback夹具,不读取已有客户端未知登录态,不抽取模型Key;正式Provider与当前配置保持。实际模型工程使用用户在工作台配置的连接并按已有执行权限运行,公开连接状态可用本身不代表收益验收完成。固定回答夹具可以证明协议、账本和工具链路,不能证明模型能自主解决工程需求。未有真实样本的协议/能力要明确保留未验状态。
评测首先固定输入工程、需求、允许范围与外部独立检查,保存首次失败、修复、检查、浏览器交互、本地Git及人工介入;比较结果以成功率、错误修改、耗时和原已报告用量为依据。不要只增加测试数量而缺少实际工程结果。
## 后续分层
视觉、语音和附件在协议/能力/取消契约明确后,作为独立切片接入,分别处理项目授权、文件类型/大小、保留期限、缓存失效和实际样本。通用电脑操作、未知格式自动导入、其它代理引擎和OS沙箱另设具体版本及验收条件。自我迭代最后建立在独立分支、固定工程评测、多模型复核与可回退发行之上;候选失败不能修改正在运行的版本。
安装校验耗时、进度反馈和超长自定义安装路径预检继续作为已有体验欠项登记;性能优化必须保留完整性与数据核对,不以减少校验掩盖延迟。