跳到正文
SKU.md
菜单
简体中文

BIGCOMMERCE · SKU-MD v1.0.0-beta

先发布 BigCommerce 最小根文档，再按需添加有来源的知识

输入公开店面或目录，或单个公开商品页。先生成最小根文档，再可选添加一份关联 Source 的商品知识文档。

打开 BigCommerce 生成器

不使用凭据 · 不访问私有 API · 不批量抓取 · 不自动发布

BigCommerce 负责实时商业，SKU-MD 承载已审查知识

这项接入让动态交易与稳定商品知识继续留在真正能够负责它们的系统中。

BIGCOMMERCE

实时商业权威

负责当前商品、变体、渠道价格、库存、购物者、购物车、订单与结账行为。

SKU-MD

最小公开文档契约

在 /sku.md 发布 v1 根文档，并仅在有用时添加一份可选的 Source 关联商品知识文档。

当前生成器只使用公开证据

流程只使用公开输入并在本地生成文件。

  1. 01

    输入公开网址

    提供公开店面或目录，或单个公开商品页。

  2. 02

    先生成最小根文档

    添加任何可选文档前，先创建并验证 v1 根文档。

  3. 03

    只添加有来源的知识

    可选从用户明确提交的商品页创建一份 Source 关联商品知识文档。

  4. 04

    发布并验证

    发布 /sku.md，然后执行 document、published 与 graph 验证。

BigCommerce 官方能力分别解决生命周期中的不同问题

下列能力均有 BigCommerce 官方文档；列出它们不代表当前公开生成器已经调用。

公开页面

店面、目录或商品页

当前生成器只读取用户提交的公开网址，不推断其他商品，也不抓取目录。

店面

GraphQL Storefront API

可查询公开商品、变体、价格、店面 metafield、路由和内容；请求需要合适的 bearer token，当前生成器不接收。

管理

REST Management API

获得授权的 API 账户可通过有权限范围的凭据管理目录和店铺数据；这是未来服务端同步输入，不是公开浏览器数据源。

授权

API 账户与 OAuth

店铺级与应用级账户包含 access token 和 OAuth scope；秘密必须留在服务端并遵守最小权限。

事件

Webhooks

HTTPS、Pub/Sub 或 EventBridge 事件可触发增量刷新；接收方仍需验证、幂等、重试处理和定期对账。

店面 UI

Scripts API

获得授权的应用可增加按渠道生效的店面脚本；脚本可以提供发现链接，但客户端代码不是目标 Markdown 响应。

交付

Stencil 与 headless 店面

Stencil 自定义模板绑定到既有页面类型；商家控制的 headless 或 edge 层可实现精确的同源文档路由。

已核对的官方资料没有记录 BigCommerce 采用 SKU-MD。平台能力、兼容发现、严格合规与实时权威必须分开表述。

根据能够证明的响应选择交付方式

三种模式生成相同 Markdown；只有真实部署响应决定发布是兼容还是严格。

发现

Stencil 店面

通过主题、既有内容页或应用管理脚本增加可见或机器可发现的链接。

Stencil 模板渲染既有页面类型，Scripts API 安装脚本；两者都不能单独证明根路径 text/markdown 响应。

严格候选

商家控制的 headless 路由

由店面应用提供不可变的预验证文件，并把 canonical 与 parent 保持在同一来源域名。

要求精确 HTTP 200、Content-Type: text/markdown、字节一致、有效文档图、可预测缓存替换和未知文件精确 404。

严格候选

同源 edge 路由

在请求进入托管店面之前，通过 /sku.md 和商品文档路径提供已存储文档。

路由规则不是证明；每次发布变更后都要验证真实响应。

模式能够实现什么证据边界
Stencil通过主题、自定义页面或 Scripts API 提供发现说明。只算兼容发现；官方记录的能力不能证明可以提供任意根路径 Markdown 响应。
Headless由商家控制的店面应用在店铺域名提供已接受文件。精确路由、媒体类型、字节、文档图、缓存替换和 404 全部通过后才是严格。
Edge在托管店面之前拦截同源文档路径并返回已存储字节。必须独立验证真实公开响应，配置界面本身不是证据。

保持 v1 文档家族最小化

专用生成器与通用流程复用相同的 v1 构建器和验证器。

最小根文档优先

用公开店铺身份和目录入口创建 v1 根文档。

一份可选商品文档

只为用户明确提交的单个公开商品页添加商品知识。

关联 Source 的事实

每条事实都链接公开 Source；graph 验证器检查文档关系。

保守范围

没有可用的有来源商品知识时，保留有效根文档，不创建可选文档。

验证每个发布范围

创建与发布是不同步骤，因此每个范围都要有独立证据。

  1. document

    验证生成字节

    发布前运行当前 v1 文档验证器。

  2. published

    验证公开响应

    检查真实 /sku.md 的状态、MIME 类型和字节。

  3. graph

    验证关系

    检查每个引用文档和 Source 关系。

  4. 重复

    每次变更后复核

    发布文件变更后重新运行全部范围。

当前流程不连接 BigCommerce 账户，也不会自动发布文件。

当前版本的权限与限制

公开流程刻意保持范围窄、可检查，并把发布决定留给商家。

  • 不登录 BigCommerce，不使用 API 账户、OAuth、access token、storefront token 或 private token。
  • 不调用 REST Management API 或 GraphQL Storefront API，也不抓取商品目录。
  • 不访问订单、客户、购物车、结账、支付或私有商品。
  • 不订阅 Webhook，不后台同步，不编辑主题，不安装脚本，也不自动刷新。
  • 不修改 DNS、代理、edge、缓存或生产发布配置。
  • 不声称 BigCommerce 背书、合作、官方支持 SKU-MD 或带来采用收益。

从品牌的角度看接入

阅读平台专题，了解 SKU.md 能补充什么，以及如何从一个商品开始尝试。

BigCommerce 的 SKU.md 集成

2026-08-07 核对的官方来源

BigCommerce 能力事实来自 docs.bigcommerce.com；SKU-MD 交付要求会单独标为独立验证规则。

BigCommerce 接入常见问题

生成器会连接 BigCommerce 账户吗？

不会。它只读取公开 HTML 和一个用户明确输入的同源商品页，没有登录、token、OAuth 或 BigCommerce API 连接。

为什么不直接调用 GraphQL Storefront API？

BigCommerce 要求合适的 bearer token；公开生成器刻意不接收凭据，也不代理 private token。

Stencil 能直接发布 /sku.md 吗？

已核对的自定义模板文档覆盖既有品牌、分类、商品和页面类型，不能证明可以提供任意根路径 Markdown 响应。

Scripts API 能发布文件吗？

Scripts API 安装客户端店面脚本；脚本可以提供发现链接，但不是请求所需的 HTTP 200 text/markdown 文档响应。

Headless 店面可以做什么？

商家控制的 headless 应用可以实现路由，但只有真实同源响应通过状态、MIME、字节、文档图、缓存和 404 检查后才是严格交付。

生成器先创建什么？

它始终先创建最小 v1 根文档；关联 Source 的商品知识文档是可选项。

商品知识文档会替代实时目录吗？

不会。它只包含明确关联 Source 的事实，不携带实时价格或库存状态；购物车、结账、支付和订单仍由 BigCommerce 负责。

BigCommerce 官方支持 SKU-MD 吗？

已核对的官方来源没有这样说。本独立指南把已记录的 BigCommerce 能力映射到商家可控流程，不代表 BigCommerce 官方采用或背书 SKU-MD。

从公开证据开始，只发布能够验证的内容

无需凭据创建可审查草稿；使用 Stencil 做发现，或使用商家控制的 headless、edge 路由提供可验证的 Markdown。

打开 BigCommerce 生成器