SHOPLINE 商家如何为 AI Agent 准备商品知识

v1.0.0 专题

面向托管平台的准备指南，区分商家可控内容、发现提示、托管路由限制、严格校验和兼容性报告。

发布于 2026年10月9日

更新于 2026年10月12日

原始规范版本: v1.0.0-beta

当前状态： 本文依据当前 v1.0.0-beta 边界撰写，只陈述方法和证据要求，不把尚未验证的平台采用、排名、引用、推荐或销售结果写成事实。

托管平台可能限制商家能够控制的根路径和响应头。这种限制不能靠文字宣称已经解决，而应形成两种名称清楚的发布模式，并用验证报告说明 SHOPLINE 上究竟哪一种能够工作。

当前状态与证据条件

目前尚未登记完成的 SHOPLINE 验证报告。本文现已公开，用于定义严格模式和兼容模式，但不宣称任一路径已在 SHOPLINE 上通过验证。

严格模式要求在商家自有来源和首选根路径提供规范目录，返回允许的 Markdown，并能确定性发现。当 SHOPLINE 路由、受支持的应用能力或同源边缘函数可以提供响应，且不存在登录墙或店面回退时，应优先采用。

测试必须使用公开商店域名，不能使用内部预览地址；重定向、缓存和自定义域名行为都属于结果的一部分。

托管店面无法控制 /sku.md 时，可以从商家控制的 HTML 页面声明备用 Markdown 资源。消费者必须依次执行规范规定的同源、HTTPS、凭证、查询、片段、重定向和冲突检查。

之所以明确称为兼容模式，是因为信任路径发生了变化。外部主机或跨来源 URL 不能自动等同于商店自身资源，除非规范明确允许并验证该安排。

盘点商家可以批准的稳定陈述：事实、建议、限制、兼容性、标识符和来源。排除实时价格、库存、折扣、配送承诺、支付和订单状态。先建立小目录，避免路由实验掩盖内容质量问题。

两种模式应使用完全相同的知识文档，只让发布和发现路径发生变化。

测试声明缺失、声明冲突、Markdown 地址返回店面 HTML、跨来源重定向、私有预览链接，以及文档有效但来源链接无效等情况。报告应说明每种情况被拒绝、警告还是接受。

只有报告包含可重复公开运行、准确写明使用的平台能力，并且没有把候选技巧扩大成平台整体支持声明时，才能把 SHOPLINE 兼容性报告为已验证。单个商店成功只能证明该配置可行。

选择路径前，列出 SHOPLINE 公共自定义域名上可编辑的主题 head、页面、应用端点、重定向、响应头、资源和代理能力。必须测试正式店铺，预览与后台地址可能有不同登录、缓存和同源行为。平台文档只说明候选机制，实际响应才证明配置。

记录每种表面的 URL 归属、能否返回 Markdown、能否设置响应头、更新是否原子。拒绝私有预览和带凭据链接。严格模式测试商家域名首选路径；兼容模式测试商家控制的 HTML 或 HTTP 声明，并执行同源、重定向、冲突和文档检查。

报告要包含店铺背景、套餐假设、请求与最终 URL、MIME、缓存、发现轨迹、Validator 版本、哈希和复现步骤，并测试缺失或冲突声明、HTML 回退、跨域跳转和不可访问 Source。

只有其他人能重复公开运行后才能把 SHOPLINE 兼容性报告为已验证。一家店成功只证明一个有边界的配方，不能代表全平台采用。实时报价、库存、配送、支付和订单继续由交易系统负责。

发现目标仍是不可信输入。消费者要强制 HTTPS、拒绝凭据 URL、执行同源政策、限制重定向、阻止私网目标、限制响应大小和时间，并把文档当数据而非指令。外部文件托管更方便，不代表可以降低这些要求；无法满足时应在报告中标为不支持。

在平台报告完成前，商家仍可先盘点稳定说法、负责人、Source、Variant 标识符和 Limitations，在本地校验并排除实时商业字段。路径验证后先发布小目录，从后台会话之外重复发现并归档证据，理解更新和回滚后再扩大。

报告最后应明确三种结论之一：支持严格模式、在列明限制下支持兼容模式，或暂不支持。每种结论都附精确证据与下一步，帮助商家选择路径，也防止一次充满警告的实验后来被概括成“原生支持”。

验证材料应保存脚本、响应、哈希、配置和日期。平台、主题或应用变化后，团队可重新运行并和最后一次成功结果比较，而不是凭记忆重建环境。

报告要写明维护负责人和重新测试触发条件。主题升级、自定义域名变化、路由功能调整或安全策略更新，都可能让原有证据失效。应安排公开健康检查，并把“最后一次可访问验证成功时间”和“最后一次内容编辑时间”分开显示：前者回答文件还能否被发现，后者回答知识是否已更新。

任何一项失败，都应暂停集成结论，先定位问题并重新完成公开运行。这样，SHOPLINE 接入报告是一份可维护的运行合同，而不是只在发布当天成立的截图。

当根路径无法直接发布时，HTML discovery 只能提供候选地址，消费方仍需验证链接关系、同源要求、响应类型、重定向和内容大小。候选地址不可自动获得信任，页面中的其他链接也不能被当成商品知识入口。验证报告应分别记录严格模式和兼容模式的结果，避免把兼容路径误写成平台原生支持。