ANP

English

简体中文

English

简体中文

Appearance

官网 1.1 升级方案 ​

1. 背景与输入源 ​

本方案基于 2026-06-27 拉取的两个上游仓库最新内容制定，当前阶段只制定方案，不修改官网实现代码。

  • 协议仓库：agent-network-protocol/AgentNetworkProtocol，最新快照 6fc3854。
  • SDK 仓库：agent-network-protocol/anp，最新快照 2b8938e。
  • 官网当前实现：VitePress 站点，源码在 docs/，配置在 docs/.vitepress/，内容同步脚本为
    scripts/update_website_content.py。

协议仓库 README 已明确 1.1 规范集：did:wba、WNS、Agent Description、Agent Discovery、端到端即时消息、
AP2 为 1.1 发布线；ANP-06 元协议仍为 Draft / not released，不应继续作为已发布核心架构层表达。

2. 总体目标 ​

  1. 将当前线上协议页面冻结为 1.0 版本。
  2. 将协议仓库最新内容发布为 1.1 版本。
  3. 首页架构表达、SDK 页面、博客入口和导航链接全部与 1.1 认知一致。
  4. 清理异常链接，并把链接检查纳入升级验收。

3. 首页升级方案 ​

3.1 架构图与分层描述 ​

首页当前使用 /images/protocol-layer-design.png 和五层描述，已经不匹配 1.1。应改为协议仓库 README 中引用的
images/anp-architecture2.png，并同步更新说明：

  • Open Internet Infrastructure：复用 HTTP、CA、DNS、CDN、Search、TLS。
  • Identity and Encrypted Communication Layer：did:wba 身份、认证、端到端加密消息基础。
  • Application Protocol Layer：Agent Description、Agent Discovery、应用协议，如 AP2。
  • Meta-protocol：标记为草案，不放入已发布架构层；可在说明中作为 experimental/draft 能力补充。

实施时从协议仓库复制 images/anp-architecture2.png 到 docs/images/、docs/public/images/ 和
docs/zh/images/，中英文首页使用同一张图，alt 文案分别使用英文和中文。

3.2 首页右上角图片压缩 ​

当前首页 hero 图片 /images/anp-hero-network.png 在三个位置均约 1.56 MB：

  • docs/images/anp-hero-network.png
  • docs/public/images/anp-hero-network.png
  • docs/zh/images/anp-hero-network.png

建议保留原构图但生成压缩版，目标小于 250 KB。优先方案是导出 WebP，并在 VitePress hero 中改用
/images/anp-hero-network.webp；如果需要兼容旧引用，则同步生成压缩 PNG。压缩后需检查移动端和桌面端显示效果。

4. 协议规范页面 1.0 / 1.1 版本化 ​

4.1 目录与路由 ​

新增版本化目录，避免 1.0 与 1.1 互相覆盖：

  • 英文 1.0：docs/specs/1.0/
  • 英文 1.1：docs/specs/1.1/
  • 中文 1.0：docs/zh/specs/1.0/
  • 中文 1.1：docs/zh/specs/1.1/

当前 docs/specs/*.md 和 docs/zh/specs/*.md 作为 1.0 快照复制到 1.0/。协议仓库最新规范复制到 1.1/。
建议把 /specs/ 和 /zh/specs/ 做成版本选择页或默认跳转到 1.1，避免旧 URL 直接混入无版本内容。

4.2 1.1 内容映射 ​

更新 scripts/update_website_content.py 的规范映射，让 1.1 复制到版本目录，并补齐新增 P9：

  • message/09-message-mentions.md -> specs/1.1/message/message-mentions.md
  • chinese/message/09-消息Mention扩展.md -> zh/specs/1.1/message/message-mentions.md

同时更新导航和侧边栏，将 Messaging Profiles 增加 P9。ANP-06 文案应显示 Draft，不要与 Released 规范并列为
同等发布状态。

4.3 顶部横排版本导航 ​

在所有规范页顶部增加横排版本选择栏：

  • ANP 1.0
  • ANP 1.1

推荐实现为 VitePress 主题组件或 Markdown 注入块，而不是在每个规范文件中手工维护。规则如下：

  • 位于正文标题上方或标题下方第一屏可见位置。
  • 同一规范存在两个版本时，互相跳到同名 slug。
  • 1.1 新增页面如 P9，在 1.0 侧显示“1.0 无此页面”并跳到 1.0 规范首页。
  • 中英文站点分别使用 /specs/... 与 /zh/specs/... 路由。

5. SDK 页面升级 ​

当前 docs/code/index.md 仍是旧 AgentConnect 单仓库介绍。最新 SDK 仓库 README 已改为
“AgentConnect: Multi-language SDK for ANP”，Python 包名为 anp，并包含多语言 SDK。

页面应重构为以下结构：

  1. SDK 总览：说明这是 ANP 多语言 SDK 和参考实现。
  2. 发布状态表：Python anp 0.8.8、Go github.com/agent-network-protocol/anp/golang v0.8.8、
    Rust anp 0.8.8、Dart anp 0.8.7；TypeScript 和 Java 标注为源码预览 / 本地构建。
  3. 快速开始：优先展示 Python OpenANP 示例和三个自动端点：
    GET /agent/ad.json、GET /agent/interface.json、POST /agent/rpc。
  4. 学习路径：DID WBA、Proof、WNS、ANP Crawler、AP2、Direct E2EE、Group E2EE。
  5. 仓库入口：主链接改为 https://github.com/agent-network-protocol/anp，协议仓库作为关联链接。

中文 docs/zh/code/index.md 同步更新，避免中英文信息不一致。

6. 博客更新方案 ​

博客不宜全量搬运，应优先选择与 1.1 发布、SDK 升级和官网定位直接相关的高质量内容。建议首批发布 / 精选：

  • blogs/10-Major-Upgrade-to-the-ANP-Message-Protocol.md
  • blogs/cn/10-新版本IM协议.md
  • blogs/04-In-Depth-Analysis-of-Google-AP2.md
  • blogs/cn/04-深度解读谷歌最新发布的AP2.md
  • blogs/cn/08-智能体支付.md
  • blogs/cn/05-ANP的核心概念和交互模式.md
  • blogs/cn/但我们设计一个协议的时候，我们在设计什么.md

同步要求：

  • 为英文和中文博客建立稳定 ASCII slug，避免当前中文页面中 07-2-、01--- 这类不可读 slug 继续扩散。
  • 更新 docs/blogs/index.md、docs/zh/blogs/index.md 和博客导航精选项。
  • 博客图片进入 docs/blogs/images/ 与 docs/zh/blogs/images/，大图压缩后再提交。

7. 导航与链接清理 ​

当前站点配置中 ignoreDeadLinks: true 会掩盖链接问题，升级阶段应临时关闭或增加独立链接检查脚本。只读抽样检查已发现
约 92 个本地绝对链接候选异常，主要集中在：

  • docs/docs/links.md 和 docs/zh/docs/links.md 仍链接到源仓库路径，如 /03-did-wba-method-design-specification.md。
  • 部分博客仍链接到原始文件名或 PDF 路径，如 /blogs/ANP-Presentation-at-W3C-WebAgents-cg.pdf。
  • 中文博客索引存在不可读或重复 slug，如 /zh/blogs/posts/07-2-、/zh/blogs/posts/01---。
  • DID 规范中的 /references/did_web-method-specification.html 和 /LICENSE 需要映射到官网可访问路径。

修复策略：

  1. 建立源仓库路径到官网路由的映射表，先覆盖 specs、message、blogs、docs 四类。
  2. 运行内容同步后统一重写内部链接。
  3. 将 PDF、HTML reference、LICENSE 等非 Markdown 资源复制到 docs/public/ 下的稳定路径。
  4. 最终运行 VitePress build，并用脚本扫描所有站内绝对链接。

8. 实施步骤 ​

  1. 创建 upgrade/1.1 分支，确认当前线上内容对应的提交或构建产物。
  2. 冻结 1.0：把当前 docs/specs 和 docs/zh/specs 复制为版本化 1.0 快照。
  3. 导入 1.1：拉取协议仓库最新内容，复制规范、图片、P9 Profile 和 AP2 文档到 1.1 目录。
  4. 改同步脚本：让后续内容更新默认写入 1.1，同时保留 1.0 快照不被覆盖。
  5. 改首页：替换架构图、更新分层描述、压缩 hero 图片。
  6. 改规范导航：增加版本选择栏，更新 nav/sidebar，补齐 P9。
  7. 改 SDK 页面：按最新 anp 仓库 README 重写中英文 Code 页面。
  8. 改博客：导入首批精选文章，统一 slug、图片路径和索引。
  9. 修复链接：处理已知异常链接，补齐静态资源，关闭或替代 ignoreDeadLinks。
  10. 验收后再部署：先 dry-run，再正式发布。

9. 验收清单 ​

  • npm run build:content 不覆盖 1.0 快照。
  • npm run lint 通过。
  • npm run build 通过，且无 VitePress 死链告警。
  • 首页架构图显示 anp-architecture2.png，hero 图片体积小于 250 KB。
  • /specs/1.0/、/specs/1.1/、/zh/specs/1.0/、/zh/specs/1.1/ 均可访问。
  • 规范页顶部可以在 1.0 和 1.1 间切换。
  • 1.1 规范导航包含 P9 Message Mentions。
  • Code 页面指向 agent-network-protocol/anp 并展示多语言 SDK 状态。
  • 博客索引无重复标题、不可读 slug 或缺失图片。
  • npm run deploy:prod:dry-run 输出符合预期后再执行正式部署。

10. 风险与决策点 ​

  • 需要确认 /specs/... 旧链接是默认跳 1.1，还是保留为 1.0。建议默认到 1.1，并在版本栏提供 1.0。
  • 需要确认 1.0 快照来源：建议以当前线上生产构建对应提交为准，而不是仅以当前工作区为准。
  • P9 是 1.1 新增内容，1.0 没有同名页面，需要设计清晰的降级提示。
  • TypeScript 和 Java SDK 目前只是源码 / 本地构建状态，官网不能写成已公开发布包。
  • 图片压缩可能影响视觉质量，应在桌面和移动端各检查一次截图。