Files
Agent-Workbench/docs/vision-inputs-f-release-evidence/0034-finalize-vision-docs.mjs
T
2026-11-01 02:12:50 +08:00

66 lines
16 KiB
JavaScript
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.
import fs from 'node:fs';
import assert from 'node:assert/strict';
const read = file => fs.readFileSync(file, 'utf8');
const identity = JSON.parse(read('docs/vision-inputs-release-identity.json'));
assert.equal(identity.success, true); assert.equal(identity.version, '1.18.0');
assert.equal(identity.independentSource.tests.pass, 576); assert.equal(identity.ui.groups, 196);
const c = identity.formal.counts;
const summary = `1.18.0完整本地交付:PNG/JPEG工程截图、原图/发送副本SHA、Chat/Responses实际视觉输入、按任务能力选池、独立视觉检测和具体预算诊断已实现;冻结预览确认后在同Task新建Run续接,原完成/未知工具不重放。独立源码576/576、26类196组历史UI、随包原生窗口7项/原生流程9组/桌面三工程16节点、Responses三工程13节点、新截图三工程7节点及Node8/8、React9/9、Python10/10通过;源码/便携各7组伴随端、5组协议和5组视觉流程,同载荷隔离安装/重启/卸载7组、正式20页及原生回看通过。正式PID36552/Provider保持,${c.projects}项目/${c.sessions}全部会话/${c.records}记录/${c.events}事件,全部表每行/会话导出/模型中心/工件原字节保持;${identity.formal.artifactRecords}条工件和${identity.formal.blobFiles}个去重文件核对通过,9229关闭。手机新增截图只读观察/SHA/下载,正式网关保持关闭、无QA设备或证书迁入。本轮验收发起真实模型请求0;安装期间工作台新增的原1.17调用单独保留,不计为1.18视觉验收。真实模型视觉工程/Purge收益及新增iPhone流程实机仍分别待验。`;
const links = '见[1.18验收](QA-1.18.md)、[回顾](RETROSPECTIVE-1.18.md)与[发行身份](vision-inputs-release-identity.json)。';
const edits = new Map();
const current = file => edits.get(file) ?? read(file);
const put = (file, text) => edits.set(file, text);
function paragraph(file, prefix, text) {
const parts = current(file).split(/\r?\n\r?\n/), i = parts.findIndex(p => p.startsWith(prefix));
assert.ok(i >= 0, file + ': ' + prefix); parts[i] = text; put(file, parts.join('\n\n'));
}
function replace(file, from, to) { const text = current(file); assert.ok(text.includes(from), file + ': missing text'); put(file, text.replace(from, to)); }
function prepend(file, text) { const value = current(file), end = value.indexOf('\n'); put(file, value.slice(0, end + 1) + '\n' + text + '\n' + value.slice(end + 1)); }
function row(file, prefix, text) { const rows = current(file).split(/\r?\n/), i = rows.findIndex(p => p.startsWith(prefix)); assert.ok(i >= 0, file + ': ' + prefix); rows[i] = text; put(file, rows.join('\n')); }
function append(file, text) { put(file, current(file) + '\n\n' + text + '\n'); }
replace('README.md', '1.17.0已完成本地正式升级。', '1.17.0历史交付模型协议、流式和能力路由。');
replace('README.md', '模型声明和实际检测分别显示;视觉/语音输入仍属后续开发。', '该版本的模型声明和实际检测分别显示;视觉输入由1.18补齐,语音仍为后续能力。');
prepend('README.md', '1.18.0已完成本地正式升级。可为工程任务添加PNG/JPEG截图,核对实际视觉选路及原图/发送副本;预算暂停会显示具体分解,预览确认后继续同一Task。独立源码576项、196组历史UI及截图Node/React/Python工程通过,原项目、会话和模型连接保持。见[工作台](http://127.0.0.1:4318/?release=1.18.0)、[截图与续接](docs/INPUT-ATTACHMENTS.md)、[验收](docs/QA-1.18.md)、[发行身份](docs/vision-inputs-release-identity.json)和[下一阶段](docs/PLAN-1.19.md)。');
replace('README.md', '下一[1.18工程附件、视觉输入与长任务续接](docs/PLAN-1.18.md)按完整工程流程推进。', '1.18工程截图、视觉选路与预算续接已完整本地交付;下一[1.19项目上下文缓存与长任务效率](docs/PLAN-1.19.md)先测量已有复用机制,再按工程证据扩展。');
replace('README.md', 'Windows x64 1.15桌面/便携包自带', 'Windows x64 1.18桌面/便携包自带');
replace('README.md', '最终1.15安装/发行状态见[QA-1.15](docs/QA-1.15.md)。', '当前安装/发行状态见[QA-1.18](docs/QA-1.18.md)。');
replace('README.md', ';桌面安装端、手机配对及其他外部引擎按后续阶段继续建设。', ';Windows桌面与手机伴随端已交付,其他REA工具及引擎适配按后续契约推进。');
paragraph('README.md', '支持 Chat Completions 的', '支持Chat Completions的tools/tool_calls/tool_call_id和Responses的实际工具Items/call_id,按连接协议请求/chat/completions或/responses。填写服务实际提供的接口根地址,例如Ollama http://127.0.0.1:11434/v1、vLLM http://127.0.0.1:8000/v1,工作台不强制添加/v1。可读取模型列表或直接填写名称;工具/流式/视觉能力按声明及明确范围的实际检测分别显示。1.18工程截图经PNG/JPEG校验及派生后发送,视觉任务在租约前排除不兼容模型;见[截图输入契约](docs/INPUT-ATTACHMENTS.md)。');
prepend('CHANGELOG.md', '## 1.18.0 · 工程截图、视觉选路与预算续接\n\n- 支持完整解码PNG/JPEG、方向归正、有界发送副本、原图/副本SHA和Task所属引用;手机按观察权限核对/下载。\n- Chat/Responses发送实际图像输入,在模型租约前排除不兼容成员;视觉检测绑定连接和凭据修订。\n- 预算暂停显示输入/图像/工具/输出与累计额度分解,通过冻结预览明确续接同Task,保留完成和未知工具。\n- 修复预算预览显示被视觉排除成员、时间单位及窄屏触控;576项独立源码、196组历史UI、三类截图工程和保留状态升级通过。真实视觉推理收益及新增iPhone实机另行验收。');
prepend('docs/VALIDATION.md', '## 1.18 · 工程截图、视觉输入与同Task续接(完整本地交付)\n\n' + summary + ' ' + links);
paragraph('docs/CAPABILITIES.md', '1.17当前完整交付:', '1.17历史交付:' + current('docs/CAPABILITIES.md').split(/\r?\n\r?\n/).find(p => p.startsWith('1.17当前完整交付:')).slice('1.17当前完整交付:'.length));
prepend('docs/CAPABILITIES.md', summary + ' ' + links);
row('docs/CAPABILITIES.md', '| C14 ', '| C14 模型协议与路由 | Chat/Responses、有界SSE、能力筛选/检测、固定Run路由与已验证格式导入保持;1.18新增实际PNG/JPEG输入、视觉前选池和修订绑定probe,语音待做 | ModelProvider能力声明与实测、流式文本/工具参数、模型配置快照、按任务角色路由与可解释回退 | CX-2、DS-1 / models / M1、M3 | 支持/不支持的工具/流式/视觉能力可见;Run绑定实际模型;故障不串结果或重放工具 |');
row('docs/CAPABILITIES.md', '| C15 ', '| C15 预算与用量 | 完整请求预检、Run/Task/worker累计预算、unknown usage保持;1.18新增具体输入/图像/响应分解、冻结预览及同Task单Run续接。图像为本地预留,实际价格/费用待做 | 时间、token、费用、步骤、重试与worker总预算;无进展检测;可配置价格与未知usage标记 | CC-2、DS-2 / models、tasks / M1–M4 | 子任务/重试纳入总预算;耗尽时保存检查点;缺失usage不伪造准确费用 |');
row('docs/CAPABILITIES.md', '| C24 ', '| C24 工程能力评测 | 固定40份基准、Node/React/Python真实工具链、父审查/Git和失败保持;1.18新增截图工程7节点,两视口React各12步及8/8、9/9、10/10;真实模型自主完成率和视觉/Purge收益待验 | 封存真实工程任务、独立验收、重复运行和错误分类;追踪人工介入/成本/恢复 | 全部目标 / evaluation、artifacts / M1–M6 | 发布能力可链接实际任务记录;报告含失败样本与环境,固定回答不替代模型推理评测 |');
replace('docs/MILESTONE-AUDIT.md', '## 当前节点:1.17完整本地交付', '## 1.17历史节点:完整本地交付');
prepend('docs/MILESTONE-AUDIT.md', '## 当前节点:1.18完整本地交付\n\n' + summary + ' ' + links + ' 下一[1.19方案](PLAN-1.19.md)聚焦已有工程上下文复用、失效与长任务效率,尚未实现。以下旧节点保留。');
paragraph('docs/PRODUCT-PLAN.md', '更新:', '更新:2026-10-31。当前正式基线1.18.0。' + summary + ' ' + links + ' 下一[1.19缓存与效率](PLAN-1.19.md)仅方案,先测量当前机制再开发。');
paragraph('docs/NEXT-STEPS.md', '更新:', '更新:2026-10-31。' + summary + ' ' + links);
paragraph('docs/NEXT-STEPS.md', '当前接续:', '当前接续:1.18 A–F本地开发/发行已完成,真实模型视觉工程及新增iPhone实机单列待验。下一[1.19项目上下文缓存与长任务效率](PLAN-1.19.md)先记录当前SHA解析复用、冷/热/失效实测,再决定扩展;不把缓存命中等同于token节省,不缓存工具副作用或凭据。每切片保留原失败、完成回顾和本地Git。');
row('docs/NEXT-STEPS.md', '| 5:', '| 5:模型与多模态(1.17协议/流式、1.18截图/视觉完成) | 工程截图、视觉选路、预算分解与同Task续接已交付;下一1.19研究已有上下文复用/失效;语音后续独立实现 | 每种协议的工具调用/用量/取消实测;凭据和附件隔离 | 截图工程有实际协议/测试/Git,真实视觉推理与iPhone新增流程单列;缓存绑定项目/权限/源码版本并可关闭/清除;原失败可核查 |');
paragraph('docs/PLAN-1.18.md', '本文件是后续方案', 'A–F已完成本地实现、完整独立验收、保留状态升级和回顾,实际结论见[QA-1.18](QA-1.18.md)。本文保留原范围及门槛:E原先列出的iPhone文件选择/旋转/弱网实机并未在本轮完成;最终手机范围为原observe权限下的图片读取/SHA/下载,上传及预算管理留在电脑端。Edge390视口/自有TLS与真实模型视觉推理分别记录,不替代实机或真实收益。下一[1.19](PLAN-1.19.md)仍仅方案。');
replace('docs/PLAN-1.18.md', '# 1.18 后续方案:', '# 1.18 实施方案与交付范围:');
replace('docs/INPUT-ATTACHMENTS.md', '1.18开发中。', '1.18已完整本地交付,实际验收见[QA-1.18](QA-1.18.md)。');
paragraph('docs/QA-1.18.md', '开发基线0d1ab74', '开发基线0d1ab74,分支feat/vision-attachments-1.18。最终已完整本地交付:' + summary + ' 不可变' + identity.immutableRelease + ',产品/QA输入来源' + identity.codeCommit + ';见[身份](vision-inputs-release-identity.json)。');
replace('docs/QA-1.18.md', '## A–C:', '以下切片记录保留当时的失败/待验描述,最终状态以文末F正式交付及发行身份为准。\n\n## A–C:');
append('docs/QA-1.18.md', '## F最终独立发行和正式交付\n\n' + summary + '\n\n399输入/22构建/40原基准冻结保持;372输入与Git原blob严格一致,22仅仓库声明CRLF/LF差异,5个示例生成文件逐字节对应已提交生成器。源码归档14,598文件同卷改短物理路径后逐一SHA保持,独立离线安装/构建、576项完整整轮和全部原生/工程门槛通过。便携14,293文件原ZIP、实际随包Node/REA/SDK/Edge及受控工程通过;安装使用同载荷独立QA登记,正式产品安装器另外stage,原处理器只升级一次。\n\n原失败、完整成功及原字节见[封存清单](vision-inputs-f-release-evidence/manifest.json)。首次完整UI漏两个Purge来源环境变量为验收执行器失败,原结果独立保留;修正后整轮26类196组通过。卸载日志延迟终结若有追加,仅接受与原SHA严格对应的前缀和固定199字节四行,前缀与最终日志分别封存,不改原收据。包内说明保留构建时快照,最终本地Git/验收由独立ACCEPTANCE绑定,不回写原包。');
replace('docs/RETROSPECTIVE-1.18.md', '## F:尚待完成', '## F:发行前的门槛记录');
const stage = JSON.parse(read('.qa/vision-f-formal-stage.json'));
const seconds = Math.round((Date.parse(stage.finishedAt) - Date.parse(stage.startedAt)) / 1000);
const reconciliation = JSON.parse(read(identity.formal.baselineReconciliation.receipt));
assert.equal(reconciliation.success,true);assert.equal(reconciliation.installerRerun,false);
const concurrent = '正式stage首次核对保留原失败:安装期间原1.17工作台发生一次已完成模型运行及配置修订/模型池移除旧默认成员,新增7记录、14事件、3工件文件,旧记录/消息/事件/工件保持。没有覆盖原配置或重跑安装;对全部差异逐项核对后,保留最新空闲全量快照与私有备份,再从已安装候选续验,后续比较仍严格逐字段/逐行/逐字节。原调用不是本轮验收器发起,也不作为1.18视觉收益结论。续验首轮误将legacy摘要事件数组当完整事件表,原失败保持;改按实际一条摘要及数据库14条原事件分别核对后完成。';
append('docs/QA-1.18.md','## 正式安装期间的并行使用与续验\n\n'+concurrent+' 证据见发行身份formal.baselineReconciliation和原件清单。');
append('docs/RETROSPECTIVE-1.18.md', '## F最终回顾及下一阶段\n\n' + summary + '\n\n本阶段保持原持久记录归属、原工具执行与已封存请求,扩展真实截图输入及可解释的预算续接。工程通过证明协议和实际工具交付,未证明任意模型的视觉能力、所有客户端格式或自主成功率。原生回看观察到1.18截图入口,旧任务仍保持原预算错误;没有启动正式原任务或补造其分解。\n\n正式stage实际' + seconds + '秒,包含完整候选清单、原数据库/导出和工件核对。下一[PLAN-1.19](PLAN-1.19.md)先测已有工程索引的SHA解析复用,再扩有界缓存、严格失效及可见效率;完整性核验仍保持。语音、通用电脑控制、更多引擎适配及受控自我迭代继续分别推进。新增iPhone流程与真实模型视觉/Purge收益仍待验,原1.16用户实机结论保持。');
append('docs/RETROSPECTIVE-1.18.md', '## 并行使用的真实边界\n\n'+concurrent+' 安装日志“成功”与安装进程退出是两个时点,不能用其中一个冒充完整阶段结束;本次同时记录原日志、结束码、逐文件验证及明确续验基线。前述stage耗时是首次尝试时间,包含并行使用导致的核对拒绝。');
paragraph('AGENTS.md', '1.17.0完整本地交付:', summary + '不可变' + identity.immutableRelease + ',产品/QA输入来源' + identity.codeCommit + '。原件见docs/vision-inputs-f-release-evidence/manifest.json和docs/vision-inputs-release-identity.json,下一PLAN-1.19仅方案。');
replace('AGENTS.md', '当前1.17.0,沿用用户手动启动的PID36552与原Provider', '当前1.18.0,沿用用户手动启动的PID36552与原Provider');
replace('AGENTS.md', '当前运行目录及数据身份以docs/model-protocols-release-identity.json为准', '当前运行目录及数据身份以docs/vision-inputs-release-identity.json为准');
replace('task_plan.md', '6. [in_progress] F:含附件工程、完整历史回归、独立发行及保留状态升级、原生回看/证据/Git。', '6. [complete] F:' + summary + '399输入/22构建/40基准及原失败/成功原件封存,独立ACCEPTANCE绑定最终Git;下一PLAN-1.19仅方案。');
append('findings.md', '## 1.18最终结论\n\n' + summary + '\n\n输入引用需要遵循持久归属,能力排除先于租约,预算预览显示实际候选;本地图像预留、上游计费和视觉推理质量分别记录。下一阶段先测量ProjectIndex现有SHA复用,不重复造缓存,也不把解析命中当token节省。');
append('progress.md', '## 1.18 A–F完整本地交付\n\n' + summary + '\n\n不可变' + identity.immutableRelease + ',输入来源' + identity.codeCommit + ',封存' + identity.evidence.files + '份/' + identity.evidence.bytes + '字节。阶段回顾、能力矩阵及下一1.19方案已同步;准备最后原字节/链接/索引核对及本地Git,不推送远端。');
assert.ok(!summary.includes('undefined'));
for (const [file, text] of edits) fs.writeFileSync(file, text);
console.log(JSON.stringify({ success: true, version: identity.version, edited: [...edits.keys()], summary }));