BLOG / publish-your-first-sku-md.mdx
发布第一份 SKU.md：平台无关的精确交付教程
从来源准备、Basic 生成到根路径交付与线上检查，完成 HTTP 200、text/markdown、canonical 和字节一致验证。
只有已接受文档从声明的 HTTPS URL 直接返回，并通过线上交付检查，第一份 SKU.md 才算真正发布。本地合法的文件依旧只是本地文件。
SKU.md 是由商家托管的商品发现与稳定商品知识：agent 可以找到商品、理解有来源的事实，并知道去哪里复查实时商业状态；它不是新的结账协议。
第一步：准备最小且诚实的来源
收集店面来源域名、公开目录入口、默认语言与市场、稳定商家身份，以及审核者愿意负责的公开来源。先做 manifest-basic，不要为了填满字段而虚构 MCP endpoint、实时查询、标识符或商品 Fact。
| 输入 | 可以接受 | 应拒绝或延后 |
|---|---|---|
| 商家身份 | 稳定公开名称与来源域名 | 猜测的法律主体 |
| 目录入口 | 已存在的同源 URL | 私有管理端接口 |
| Knowledge | 已审陈述与来源 | 自动升级的营销文案 |
| 报价 | 带时间的观察或已声明查询 | 没有时间边界的价格承诺 |
第二步：生成并做离线校验
使用 Basic 生成器或其他能输出 sku.md/0.10-draft 的实现。确认 canonical、内容语言、市场与文档类型，再运行 offline_document，检查安全 YAML、Schema、语义一致与正文对齐。
离线通过只证明这些字节能组成可接受文档；它证明不了 DNS、路由、状态码、媒体类型、缓存、parent 链或公共可访问性。
第三步：发布到精确根 URL
发布者指南要求根清单位于精确 HTTPS /sku.md。响应合同必须逐项满足：
- 请求
https://merchant.example/sku.md，禁止自动跟随跳转。 - 要求精确 HTTP 200，不能是 301、302、206 或通用成功页。
- 要求
Content-Type: text/markdown，只允许合法可选参数。 - 确认 frontmatter 的
canonical等于请求 URL。 - 对比响应正文与已审核、已接受的字节。
托管 HTML 视图、CDN 资源 URL、主题 alternate 或跳转可以提供兼容展示，但不属于严格根路径发布。
第四步：做线上与文档图检查
先对每份公开文档运行 published_resource，再从根运行 document_graph。检查 canonical、parent、语言、链接状态、媒体类型、可解析性、遍历深度与失败行为。未知文档路径不能用 HTTP 200 返回通用 HTML。
| 范围 | 能证明 | 不能证明 |
|---|---|---|
offline_document |
本地结构与语义 | 公共交付 |
published_resource |
单个精确线上资源 | 完整文档图 |
document_graph |
可达的父子合同 | 外部采用或排名 |
第五步：补充发现入口与运营回环
从合适的公开页面或已记录发现表面链接 /sku.md，让 Sitemap、Product JSON-LD、llms.txt 与 agents.md 保持各自职责。记录已接受字节哈希，并在路由、主题、CDN 或域名变化后重跑线上检查。
增加 Product Document 时，继续保持稳定身份与来源审核；当前价格、库存、配送、税费、支付和订单必须回到实时 Catalog 或 Checkout。
延伸阅读
用Schema 通过但还不能发布排查交付错误，再用稳定知识与实时数据给字段分类。