更新日志

这个版本让 AEO manifest JSON assets 先经过 Worker，确保生产环境能输出 crawler-visible schema headers。

• •为 `/aeo-manifest.json` 与 `/aeo-manifest.schema.json` 增加 Cloudflare `run_worker_first` routing。
• •只把覆盖范围限制在这两个 AEO JSON assets，其他普通静态资源仍保持 asset-first。

这个版本在 Cloudflare 边缘恢复静态 AEO manifest assets 的 crawler-visible headers。

• •通过 middleware 为 `/aeo-manifest.json` 加回 schema `Link` header，避免 OpenNext static asset delivery 丢失。
• •在边缘恢复 `/aeo-manifest.json` 与 `/aeo-manifest.schema.json` 的 cache-control headers。
• •继续只给 HTML 页面输出 hreflang Link headers，确保 manifest schema discovery 不被覆盖。

这个版本补齐首页剩余翻译缺口，覆盖 guide cards、capacity clusters 与 popular verdict checks。

• •首页 featured guides 改为读取本地化 guide catalog。
• •新增 guide、capacity/limit 与 popular-check 区块的首页本地化标签。
• •补齐首页 capacity 与 Wh-limit 卡片的本地化文案。
• •热门判定链接的句式已本地化，同时保留品牌、型号和航司名称。

这个版本将语言 alternate 从 Next Metadata HTML 序列化迁移到标准小写 hreflang HTTP Link headers。

• •移除会在原始 HTML 中输出驼峰 `hrefLang` 的 Metadata API language alternates。
• •为 HTML 页面路由通过 HTTP `Link` headers 输出小写 `hreflang` alternates。
• •保持 sitemap XML 的 `hreflang` 输出不变，原本已是小写。
• •不对 JSON、XML、图片和 robots assets 注入 hreflang header，避免影响既有 schema 与 sitemap headers。

这个版本将可索引 programmatic verdict surface 收缩到精选高价值航线，同时保留低需求组合可访问，并用 noindex 与 canonical 收口。

• •将 sitemap 暴露从穷举 model-airline-country 组合收缩到 914 个精选可索引 URL。
• •保持 `/sitemap-priority.xml` 聚焦 95 个高价值 URL，其中包含 50 个 curated long-tail verdicts。
• •低需求 `/p/...` 组合改为 `noindex, follow`，canonical 指向对应 catalog model page。
• •同步 Search Console 监控基线与 AEO guards，匹配新的小规模可索引 surface。

这个版本增强 verdict 页 JSON-LD 溯源结构，覆盖 citations、applied rules、source integrity 与 ingest metadata。

• •为每个 verdict citation 增加嵌套 source-integrity details。
• •扩展 rulesApplied，加入 rule identifiers、temporal coverage、scope、trigger/effect payloads 与完整 rule citations。
• •扩展 sourceIntegrity，加入 feed identity、measurement techniques、source document items、tracked counts 与 last-ingested metadata。
• •通过 hasPart 与 isBasedOn 串联 provenance 部件，同时保留原有顶层字段兼容旧消费者。

这个版本打包今天完整的 AEO 与 citation structured-data 加固工作，用于部署。

• •扩展 AEO manifest contract，覆盖 22 个 question guides、11 个 brand hubs 和 50 个 curated long-tail verdicts。
• •对齐 long-tail manifest `article_body` 与 /p/... Article JSON-LD `articleBody`，并加入 parity guards。
• •在 manifest sources、页面 JSON-LD、schema、llms.txt、/developers 和 /mcp 中加入 `citation_kind`、`citation_jurisdiction`、`pulled_at` structured citation metadata。
• •新增共享 citation/payload constants、citation JSON-LD contract tests、Search Console sampling guidance 和 handoff docs。
• •已通过完整 preflight 和 production build 验证。

这个版本建立第一批专门面向 2026 ICAO/IATA 充电宝规则的答案引擎表面。

• •新增 2026 充电宝规则指南，并补充数量、机上使用、机上给充电宝充电、100-160Wh 批准与打包五个高混淆问题页。
• •继续扩展 2026 问题簇，加入随身携带、两个 20,000 mAh 充电宝、无标签机场风险页面。
• •新增 MagSafe / 无线充电宝问题页，覆盖磁吸电池包、机上使用、飞机电源充电和两件数量限制。
• •将精选长尾判定扩展到 24 个型号 x 航司 x 国家页面，覆盖 Anker、Baseus、CUKTECH、小米、UGREEN、INIU 与 RAVPower 出行查询。
• •从品牌页链接匹配的精选判定检查，让高需求品牌直接暴露优先级 `/p/...` 页面。
• •新增 `/aeo-manifest.json` 与 `/aeo-manifest.schema.json`，作为面向智能体和答案引擎的机器可读发现文件。
• •从 `llms.txt`、`robots.txt`、`/developers` 与 `/mcp` 链接 AEO manifest。
• •新增 `npm run test:aeo`，防止 guide、长尾判定、manifest、sitemap、来源、FAQ 与内链漂移。

这个版本将 Free 明确为 evaluation access，将 Founder Special 明确为 production starter package。

• •将 Free 配套调整为 verifier、catalog、API evaluation、Widget preview 与带来源 verdict。
• •将 Founder Special 配套调整为 production query 额度、API/Widget、verdict records、Email support 与规则变更 digest。
• •统一 `/pricing` 与 `/founder-special`，让两层 package 读起来更像自然升级路径。

这个版本从公开定价表面移除剩余内部商业文案。

• •从 `/pricing` 移除剩余内部说明。
• •从 `/founder-special` 移除内部商业条款。
• •页面只保留价格、包含内容、适合对象、信任信号与联系承接。

这个版本从公开定价页移除内部启动期规则文案。

• •从 `/pricing` 移除启动期规则列表。
• •让公开页面只聚焦方案名称、价格与包含内容。
• •保持 Free 与 Founder Special 作为仅有的公开启动期 offer。

这个版本将启动期定价的公开文案收口到条款、适用范围与包含内容。

• •从公开定价文案中移除内部定价逻辑。
• •将 pricing 与 Founder Special 的开头文案改为启动期条款与包含内容。
• •保持两个公开启动期选项不变：Free 与 Founder Special。

这个版本在 Founder Special 页面增加可核验信任信号，并把 offer 连接到 sources、compliance、changelog 与 privacy 证据层。

• •新增来源引用、公开 compliance scorecard、变更记录与隐私边界四个信任卡片。
• •新增 proof 区块，说明 verdict ID、ruleset version、citations 与 final-authority notice。
• •通过 `subjectOf` 将 Founder Special JSON-LD 连接到支撑证据页面。

这个版本新增 Founder Special 落地页，并把定价页与 ROI 页收口到一个清晰转化路径。

• •新增 `/founder-special`，集中展示价格、包含内容与适合对象。
• •将 `/pricing` 与 `/roi` 的 Founder CTA 收口到新的落地页。
• •保持启动期 offer 聚焦 Founder Special 条款与邮件承接。
• •将 `/founder-special` 纳入 sitemap，并加入 Offer JSON-LD。

这个版本新增一页式 ROI 估算，用于计算减少电池相关咨询工单后的每月节省。

• •新增 `/roi`，只保留三块：当前工单痛点、CertiWatt 减少比例、每月节省金额。
• •页面刻意保持极简，适合销售沟通和 Founder plan 外联。
• •加入本地化 ROI 文案与 WebApplication JSON-LD。
• •将 `/roi` 纳入 sitemap 生成。

这个版本新增公开定价页，展示启动期 Free access 与 Founder Special 方案。

• •新增 `/pricing`，只展示两个启动期报价：前 90 天 Free 与 Founder Special。
• •写明 API、托管 Widget、查询额度、基础支持和规则变更通知。
• •将定价入口加入桌面导航、移动导航、本地化路由与 sitemap 生成。
• •发布 pricing OfferCatalog JSON-LD，帮助搜索与答案引擎理解价格结构。

这个版本为 Conditional 与 Banned 程序化判定页增加面向旅客的 HowTo 结构化数据。

• •为 Conditional 与 Banned 判定页新增可见的机场安检 HowTo 区块。
• •加入匹配的 `schema.org/HowTo` JSON-LD，让搜索与答案引擎理解操作步骤。
• •覆盖三个旅客动作：准备电池证据、安检时说明设备、被拒后安全处理。
• •将 Wh/mAh 标签、中国 3C 证据（适用时）与厂商证明/规格页列为所需材料。
• •Allowed 页面不输出 HowTo schema，避免给无需行动的页面增加无关结构化数据。

这个版本移除公开页面中可被爬取的 verifier 与 catalog filter 参数链接，减少 Google Search Console 的 alternate page 噪音。

• •将可爬取的 `?model_id=` verifier 链接改为 GET form，用户流程不变，但 crawler 只看到干净 URL。
• •从品牌页移除可爬取的 `?brand_id=` catalog filter 链接。
• •扩展 indexability smoke，防止可爬取的 `?model_id=` 与 `?brand_id=` 链接回归。
• •加入 coverage drilldown 样本检查，覆盖干净的 guide、brand、catalog 与本地化判定页。

这个版本移除 WebSite SearchAction 占位模板，避免 Google Search Console 报告字面量 `?q={search_term_string}` alternate URL。

• •在真正的搜索结果 URL 存在之前，移除站点级 WebSite JSON-LD 的 `potentialAction.SearchAction`。
• •在 indexability smoke 中加入断言，防止 `{search_term_string}` 回归。
• •保留 HTTP 到 HTTPS 的 alternate canonical 行为；该 GSC example 属于预期。

这个版本新增自动化冒烟测试，检查 sitemap 健康、站内爬取路径、程序化页面质量信号、JSON-LD 与 API credential 行为。

• •新增 `npm run test:indexability`，可检查生产站或自定义 base URL。
• •检查 sitemap index 与抽样子 sitemap 分片。
• •检查首页、guides、catalog、程序化判定页质量信号、JSON-LD 与 API access 行为。

这个版本把目录型号页链接到匹配的高价值航班判定页，让目录内容到程序化判定页形成更深的爬取路径。

• •在目录型号页加入按型号过滤的热门航班判定链接。
• •将这些型号专属判定链接作为 ItemList JSON-LD 暴露。
• •复用精选热门判定数据集，让首页、guides 与 catalog 页面保持一致。

这个版本从首页与指南中心加入精选内链，指向高价值程序化判定页。

• •新增共享的热门判定数据集，用于精选爬取路径。
• •从首页链接 8 个高意图 `/p/...` 判定页。
• •从 `/guides` 链接同一批判定页，并写入 CollectionPage JSON-LD。

这个版本为程序化判定页补强可见复核信息、判定理由、安检准备建议，以及结构化 FAQ/面包屑数据。

• •为 `/p/...` 页面加入可见的最后复核、规则集、来源数量与来源完整性状态。
• •新增航线级判定理由与安检准备内容，降低 thin-page 风险。
• •加入 FAQPage 与 BreadcrumbList JSON-LD，并稳定 Article 复核元数据。

这个版本将 sitemap index 与分片改为静态 XML 资产，避免爬虫触发 Worker 生成限制。

• •在 build 阶段生成 `/sitemap.xml` 与 `/sitemap/*.xml`，作为 Cloudflare 静态资产发布。
• •从生产请求路径移除动态 Next sitemap 生成。
• •继续保持 Search Console 只提交 `/sitemap.xml`。

这个版本缩小 sitemap 分片大小，让 Search Console 更稳定抓取所有分片。

• •将 sitemap 每个分片从 5,000 URLs 降到 1,000 URLs。
• •继续保持 `/sitemap.xml` 作为唯一需要提交的 sitemap index。
• •降低 Cloudflare 上首次抓取 XML 的生成体积，提高爬虫稳定性。

这个版本让 sitemap 分片只生成自身 URL，确保搜索引擎能稳定抓取所有分片。

• •将 `/sitemap/[id].xml` 从先生成全量再 slice，改为只输出当前分片。
• •降低后段 sitemap 分片，例如 `/sitemap/7.xml`，在 Cloudflare 上的 CPU 压力。
• •保持 sitemap index 结构不变：`/sitemap.xml` 仍列出 8 个分片。

这个版本强化指南页的信任信号，帮助搜索收录与答案引擎抽取。

• •为每个指南页新增可见的 last-reviewed、ruleset version 与 reviewer 信息。
• •扩展指南页 Article JSON-LD，加入 datePublished、dateModified、reviewedBy 与 ruleset/source references。
• •强化 Sources 区块，让用户与爬虫理解指南内容如何对应来源完整性发布闸门。

这个版本新增可引用的短答案指南页，覆盖高价值充电宝飞行问题。

• •新增 `/guides` 目录和 8 个指南页，覆盖充电宝飞行规则、Wh 限制、中国 3C、泰国 mAh 上限、韩国规则、托运、标签证据与召回。
• •加入 Article、FAQPage、BreadcrumbList 与 CollectionPage JSON-LD，方便答案引擎抽取短答案。
• •从首页和导航加入 guides 内链，让爬虫发现不只依赖 sitemap。
• •把 guide URLs 纳入 sitemap，并刷新 `llms.txt` 的 AI 推荐引用目标。

这个版本强化 CertiWatt 的发布流程，确保公开判定只引用可访问、真实的来源。

• •新增有效规则引用审计，拦截 placeholder URL、不可访问来源以及首页/规范化回退。
• •强化实时来源探测，加入重试机制以及 final/canonical URL 检测。
• •停用官方来源被阻挡、缺失或无法验证可访问的航司专属规则。
• •更新部署手册、一键部署脚本与 CI preflight，让它们共用同一个发布闸门。
• •记录实时来源探测与发布后 smoke check，后续发布不再依赖聊天记录。

这个版本围绕电池合规判定引擎方向，刷新搜索、答案引擎与 sitemap 覆盖。

• •扩展 sitemap，从有效目录、航司与司法辖区数据自动生成程序化判定 URL。
• •刷新 `llms.txt`，写入当前定位、覆盖范围、API routes、MCP tools 与 AI 引用建议。
• •更新 JSON-LD，让答案引擎理解 CertiWatt 是带来源引用的电池合规判定引擎。
• •为 `/developers` 与 `/partners` 增加结构化数据，强化 API、MCP 与 B2B 集成发现。
• •同步搜索与 AI 爬虫 robots 策略，同时继续屏蔽内部 API 与后台路径。

这个版本将 CertiWatt 推进为带来源引用的电池合规判定引擎，并明确合作伙伴、API 与法律边界。

• •新增公开 `/developers` 与 `/partners` 页面，承载 API、智能体与 B2B 集成路径。
• •将首页和文档重新聚焦为面向航空出行、带来源引用的电池合规判定。
• •把 `/compliance` 文案改为公开运营评分卡，避免被误解为监管认证。
• •为合作伙伴 API key 与 bearer token 增加真实校验，同时保留匿名旅客调用。
• •在 `phase-5/product-direction.md` 记录当前产品方向，方便后续交接。

这个版本让 CertiWatt 为 Codex 之外更广泛的智能体发现做好准备，同时继续保留同一个规范 MCP 后端。

• •新增可复用的 Hermes 兼容 `certiwatt` skill，说明何时以及如何使用已发布 MCP server。
• •扩展共享 agent bundle 文档，加入 OpenClaw / ClawHub 的安装与验证说明。
• •更新公开 MCP 页面，说明 OpenClaw 分发、Hermes 兼容使用方式以及共享包接入。
• •刷新四种语言版本，MCP 页面不再把 server 描述为仓库内或尚未发布。

这个版本继续保持包为专有软件，同时让 npm 元数据直接指向包内真实的法律条款。

• •将 npm license 字段从 `UNLICENSED` 切换为 `SEE LICENSE IN LICENSE`。
• •继续以专有 `LICENSE` 文件作为包条款的真实来源。
• •保留上一版本新增的 npm 搜索关键词。
• •将公开包版本提升到 `@certiwatt/mcp@0.1.4`。

这个版本让公开的 MCP 包更容易理解，也更容易在 npm 搜索中被发现。

• •将 npm license 字段切换为专有包的规范写法：`UNLICENSED`。
• •保留明确的专有 `LICENSE` 文件，让法律条款继续可见。
• •新增 MCP、Model Context Protocol、充电宝、电池、旅行、航空、飞行安全与核验相关的 npm 搜索关键词。
• •将公开包版本提升到 `@certiwatt/mcp@0.1.3`。

这个版本修正首个公开 MCP 包的两个粗糙点，让对外说明与真实产品行为保持一致。

• •明确公开 MCP server 默认使用线上 CertiWatt API；localhost 仅用于开发覆盖。
• •将公开 `/mcp` 页面中的安装示例简化为真实生产启动命令：`npx -y @certiwatt/mcp`。
• •用明确的专有许可证文件与包声明，替换含糊的 npm `UNLICENSED` 元数据。
• •将 npm 包版本提升到 `@certiwatt/mcp@0.1.2`，承载修正后的公开元数据。

这个版本将 MCP server 发布为 npm 包，并把 plugin 从仓库内路径切换为可移植安装方式。

• •已将 `@certiwatt/mcp@0.1.1` 发布到 npm。
• •将 plugin 启动方式切换为 `npx -y @certiwatt/mcp`，不再依赖仓库相对路径。
• •更新 MCP 与 plugin 文档，改为描述已上线的正式包，而不是未来占位方案。
• •包体保持精简：压缩后约 6 kB，解包后约 22 kB。

这个版本新增公开的开发者向 MCP 页面，让智能体与集成方能一眼看懂工具、流程、示例与边界。

• •新增公开 `/mcp` 页面，面向外部开发者与智能体构建者。
• •说明五个 MCP 工具、推荐调用流程与代表性示例问题。
• •加入真实的接入与限制说明，而不是暗示已有托管连接器。
• •将该页面接入桌面导航、移动端导航与 sitemap。
• •新增页面已覆盖英文、中文、韩文与日文。

这个版本让智能体可以先按主题发现规则、再拉取来源，补上了最后一个 MCP 评测缺口。

• •新增规则搜索 API，用于发现监管规则与航空公司政策。
• •新增 MCP `search_rules` 工具，让智能体能解析 “China 3C rule” 这类模糊规则话题。
• •当多个规则同时匹配时，优先返回监管机构规则，再返回航空公司叠加规则。
• •收紧 MCP 路由说明，让产品、召回、相关型号和规则问题能选择更合适的工具。
• •完整真实智能体评测提升到 16/16 通过，且已无 known gap。

这个版本修复了智能体评测发现的真实核验边界问题，并让 MCP 评测环境更可信。

• •当规则要求仅限随身携带时，选择托运会直接返回禁止判定。
• •新增回归用例，防止“仅限随身携带”再次退化成托运也显示允许。
• •规范化目录搜索，使 “Anker 525” 这类查询能稳定命中。
• •优化未知型号时 MCP 的无匹配提示。
• •将智能体评测与仓库隔离，确保测到的是 MCP 能力，而不是本地文件访问能力。

这个版本把更多 CertiWatt 能力沉淀为可复用的平台接口，为后续 MCP 与智能体集成做准备。

• •抽出共享的型号与来源 domain service，让网页和 API 共用同一套实现。
• •新增型号详情 API 与标准化来源 API，为后续智能体工具做准备。
• •在型号详情 API 中加入目录页已使用的相关型号分组。
• •新增首版 MCP server MVP，包含搜索、型号查询、核验与来源工具。
• •优化 MCP 工具说明与结构化覆盖缺口返回，让智能体更容易正确使用。

这个版本完善了 CertiWatt 的分享、探索和版本追踪体验。

• •将 Open Graph / Twitter 分享图替换为与网站一致的截图卡片。
• •在型号页新增相关型号模块，支持同品牌、Wh 接近、接近上限三类浏览。
• •新增相关型号 ItemList JSON-LD，强化站内实体关系。
• •优化窄屏目录筛选布局，让搜索框保持可用宽度。
• •新增多语言更新日志系统，让之后每次上线都有可读的版本说明。

这个版本把目录升级成了更完整的浏览与核验入口。

• •新增品牌页、品牌索引卡片，以及更丰富的目录排序。
• •新增型号详情页，包含证据、乘机提示与相关型号。
• •新增 Product、CollectionPage、BreadcrumbList 与相关型号 JSON-LD。
• •优化目录到核验器的跳转，支持已选型号预填。
• •将社交分享图替换为与网站视觉一致的 Open Graph 卡片。