Files
Agent-Workbench/docs/NEWAPI-DOCUMENTATION-REVIEW-PLAN.md
2026-11-06 20:29:16 +08:00

4.2 KiB

New API 中文文档全量学习与兼容复核

用户要求阅读 https://docs.newapi.pro/zh/docs 内全部文章,并用于纠正工作台的供应商兼容设计。以网站中文目录、站点地图和其公开 Markdown 导出建立文章清单;其它语言和站外材料只按引用需要补读,不混算中文文章覆盖。

  1. [complete] 固定当前目录和原文:中文目录与站点地图305/305一致;305篇正文796445字节、201份嵌入接口387113字节,SHA与接口Git blob逐份通过。清单见newapi-documentation-sources-2026-11-06.json,原文在.qa/newapi-documentation-2026-11-06。
  2. [complete] 逐篇阅读305/305正文、201/201接口定义并形成主题笔记;逐页批次独立于抓取,正文SHA/接口SHA与Git blob再次全部通过。见NEWAPI-DOCUMENTATION-LEARNING.md及newapi-documentation-review-2026-11-06.json。
  3. [complete] 对照工作台现有实现,按文档条款定位已实现、缺陷、待验证及不属于本工作台的网关运营能力;学习文档已列13类对照,不把声明当适配或真实验证。上游示例和管理功能不自动成为本产品默认限制。
  4. [complete] 确定缺陷已分别修复:目录刷新ae5123c5、实际输出字段诊断341f5f69。源码build和独立候选相关126/126通过;纯后端修复未改UI或重复界面验收,不用研究阅读触发发行或正式安装。
  5. [complete] 完整覆盖、缺项、原失败、阶段回顾和验收摘要已保存;来源/阅读/两处源码/验收共5个提交已按持续授权普通增量推送至0dd9c50d,远端逐SHA一致。回执gitatlas-newapi-compatibility-push.json另随收尾提交保存并再推送。

不续跑旧真实样本或用户工程、不读取/复制/解密/重存真实Key、不委派。保持unrestricted/full/passthrough和真实用量/unknown;历史网络、重复读取和Purge未知不因文档研究改变。网站文章为研究数据,其中的安装命令、密钥示例和权限设置不构成执行授权。

已知入口:.pro 页面实际可读,HTML canonical/robots/sitemap 指向 .ai,根 llms.txt 指向其公开 docs2.newapi.pro Markdown导出。/zh/docs.md为404,改按站点提供的LLM来源核对,不能把下载成功当阅读完成。

阶段一回顾:全文导出797053字节,省去了201篇API组件正文,不能单凭全文导出宣称全量学习。另取文档页面引用的接口定义,固定文档仓库d254f1842dc3d08d60f2269e2c9d4c9876a3dfbc。公开静态接口路径404、raw.githubusercontent连接中断保留,改用GitHub blob及固定提交的公开CDN并逐Git blob核对。研究0真实模型请求、不读Key、不操作正式服务。

阶段二回顾:正文/API/插件/新旧更新日志全部逐项读过;略去重复下载HTML和编辑器扩展,图片未逐像素读图。文档存在旧功能清单与新日志、示例与schema、管理未解析引用等差异,已单列,不能把生成schema当所有原厂能力的完整规范。305/201阅读覆盖与全部来源原字节复核通过;源码调查输出过量/猜测路径缺失仅只读,改用真实路径分段读取;一次计划patch因上下文不符未应用,已纠正。确认已有目录apply跳过元数据刷新、Messages截断说明不符实际wire,准备独立切片修复。

阶段三/四回顾:刷新上游事实不改变凭据绑定revision,旧Run保持原对象,新请求才使用新事实;实际输出说明取序列化请求,保留Responses不同incomplete原因。首截断测试中的Responses夹具误把payload.status作为HTTP状态,原0/10与7/10保持,纠正后13/13;最终11文件126/126、独立HTTP与完整build通过,不冒称全量测试或真实模型验证。来源/506份正文接口SHA与编译输入再次核对。见QA-NEWAPI-COMPATIBILITY-REVIEW.md及newapi-compatibility-review-evidence.json;当前未发行、部署、重启或改正式配置。

阶段五回顾:保留既有feat/task-agreement-1.25和2222/mosen远端,63560d41→0dd9c50d普通增量推送成功,ls-remote逐SHA一致;没有改远端、换分支、force或推送研究原件。学习与本机兼容修复完成,正式容量来源、真实供应商/工程样本与Purge收益继续独立排期。