跳转到主要内容

构建“AI 原生”独立站

— dawn

项目愿景：构建“AI 原生”独立站

  • 核心逻辑：将独立站从“给人看的 HTML 网页”进化为“给 AI 读的结构化接口”。
  • 通用标准：遵循 Google UCP（通用商务协议）与 Schema.org 行业公认标准。

一、 核心数据基建：通用元字段（Metafields）

所有行业通用的四个“数据支柱”，存在于 Shopify 后台，新主题必须有代码能调用它们。

支柱名称通用 Key存储格式目的
技术参数表custom.tech_specsJSON存储产品的硬核参数（如：材质、尺寸、电压、成分）。
AI 销售指南custom.agent_guideJSON告诉 AI 品牌的独特优势、核心卖点、目标客群话术。
AI 问答库custom.ai_faqsJSON存储关于物流、保修、安装、退换货的 10-20 个专业问答。
精简卖点集custom.key_features_list多行文本存储 3-5 条简短的、可以直接渲染在页面的核心优势。

二、 协议层：AI 握手与发现（Handshake）

这部分文件是独立的，换主题时需在 templates 文件夹下重建。

  1. Agent Manifest (AI 身份清单)
    • 文件：templates/page.agent-manifest.liquid -> 重定向至 /agent-manifest.json。
    • 要求：输出纯净 JSON，声明 product_discovery（搜索建议接口）、direct_buy_endpoint（一键下单路径）、authorized_carriers（物流商白名单）。
  2. AI 友好型门禁 (Robots.txt)
    • 文件：templates/robots.txt.liquid。
    • 要求：放行 Google-InspectionTool、GPTBot 等 AI 爬虫；允许访问 Manifest、物流政策、退货政策及搜索建议 API。

三、 UI/UX 语义化层：AI 视觉与交互（Interface）

这是最核心的“移植”工作。新主题的开发人员必须在 HTML 标签中嵌入以下通用属性：

1. 核心交互识别 (Actionable Tags)

  • 购买按钮：必须带有 data-ai-action="primary-purchase"。
  • 变体选择：选择容器带 data-ai-component="variant-picker"，具体选项带 data-ai-value="..."。
  • 加购表单：带有 data-ai-component="cart-form"。

2. 视觉锚点识别 (Vision Anchors)

  • 产品标题：带有 itemprop="name" 和 data-ai-component="product-title"。
  • 产品价格：容器带 data-ai-selector="price-container"，价格数值带 itemprop="price"。
  • 产品描述：使用 <article itemprop="description"> 封装。
  • 图片 Alt 逻辑：alt 属性应由 Product Title + custom.tech_specs 动态拼接。

3. 搜索与发现 (Discovery)

  • 产品卡片：在列表页的每个卡片上标记 data-ai-component="product-card"。
  • 搜索建议：在 predictive-search.liquid 中标记 data-ai-role="search-match"。

四、 知识库集成：Block 化组件

将 AI 专用的知识内容模块化，方便在主题编辑器中控制。

  1. AI FAQ Block
    • Snippet：snippets/ai-faq-schema.liquid。
    • 功能：同时输出 FAQPage 结构化数据（给 AI 读）和折叠式 UI（给人看）。
  2. Technical Specs Block
    • Snippet：snippets/block-key-features-metafield.liquid。
    • 功能：遍历 tech_specs JSON，输出 AI 易读的 Key-Value 列表。

五、 全局品牌 MCP 引导（Brand Soul）

在 layout/theme.liquid 中植入一段全局 JSON 指令，定义品牌的“人设”：

  • Identity：品牌身份（如：专注于全美配送的高端商用厨具零售商）。
  • Service Area：服务范围（如：Contiguous US only）。
  • Authority：品牌背书（关联物流商、认证机构、质保时长）。

六、 一致性合规核对 (Policy Compliance)

换主题后，必须手动核对以下“四位一体”设置：

  1. Shopify 后台设置（运输时间、退货天数、运费）。
  2. 网页政策文案（Shipping & Refund Policy 页面文字）。
  3. 代码输出值（JSON-LD Schema 里的数值）。
  4. Google Merchant Center 后台设置。

迁移验收清单（通用版）

  • Manifest 测试：访问 /agent-manifest.json 是否显示正确的 API 路径？
  • 富媒体测试：[Google Rich Results Test] 跑分，Merchant Listings 是否全绿？
  • 属性提取测试：检查页面源码，additionalProperty 数组是否包含了 JSON 元字段里的所有参数？
  • 购买路径测试：尝试访问 /cart/{variant_id}:1 是否能直接进入结账页？

总结建议：
当您交付给开发人员时，告诉他们：“我们要的不是一个漂亮的皮肤，我们要的是一个语义化（Semantic）的系统。请确保所有的 data-ai 属性被精准地放置在对应的功能按钮和数据块上。”

🏆 智能体电商全案通用蓝图 (Comprehensive Blueprint)

1. 数据资产系统 (The Data Engine)

核心思想：将产品信息从“文本描述”转变为“机器可读的结构化数据库”。

  • 通用元字段架构：
    • tech_specs (JSON)：记录产品的物理属性（尺寸、材质、功率、成分、兼容性等）。
    • agent_guide (JSON)：记录品牌的商业逻辑（独特卖点、目标受众、销售话术、竞品对比）。
    • ai_faqs (JSON)：结构化的问答对，解决物流、保修、安装等前置决策障碍。
  • Schema 自动化：全自动将 Metafields 映射到 Product 和 FAQPage 结构化代码中。

2. 通信协议系统 (The Handshake Protocol)

核心思想：为 AI 代理提供一张进入你商店的“入场券”和“地图”。

  • Agent Manifest：部署 agent-manifest.json。声明 API 终点（Endpoint）、支付协议、物流矩阵。
  • UCP 兼容性：遵循通用商务协议，允许 AI 绕过繁琐的 UI，直接进行“意图解析 -> 价格查询 -> 结账跳转”。
  • 智能门禁：优化 robots.txt，对主流 AI 爬虫（GPTBot, Google-InspectionTool等）实行“外交豁免”，优先放行资产路径。

3. 交互语义系统 (The Actionable Interface)

核心思想：在 HTML 源码中植入“动作锚点”，让 AI 代理知道哪里可以“点”，哪里可以“选”。

  • 动作标识 (Action Trigger)：
    • data-ai-action="primary-purchase"：标记核心购买按钮。
    • data-ai-action="select-option"：标记规格选择器（Color, Size, Voltage）。
  • 组件标识 (Component ID)：
    • data-ai-component="variant-picker"：声明规格配置区。
    • data-ai-component="cart-form"：声明结账表单。
    • data-ai-selector="price-container"：声明价格绝对权威区。

4. 多模态视觉系统 (Multi-modal Vision)

核心思想：针对具备“视觉识别”能力的 AI（如 Gemini 2.0, GPT-4o），将图片与数据进行深度对齐。

  • 动态 Alt 增强：图片 alt 属性由 标题 + 硬核参数 自动生成。
  • 特征验证：植入 data-ai-visual-verification。
    • 例子：如果图片显示的是不锈钢材质，代码属性里也写明 Stainless Steel，AI 会大幅提升产品的“真实性评分”。

5. 销售指南系统 (Contextual Intelligence)

核心思想：通过 MCP（模型上下文协议）给 AI 代理一个“隐形提词器”。

  • MCP 指令块：在 theme.liquid 植入全局 application/x-agent-brand-context。
  • 内容涵盖：品牌身份、物流配送矩阵（如 12 家 LTL 承运商）、服务区域（排除 AK/HI 等）、质保与退货条款。
  • 目的：让 AI 代理在推销时像你的“金牌店长”一样专业。

6. 发现与归因系统 (Discovery & Attribution)

核心思想：确保 AI 在搜索阶段就能优先发现你，并正确记录订单来源。

  • 搜索建议 API：优化 predictive-search.liquid，让 AI 在实时下拉框阶段就能提取价格和 SKU。
  • 归因追踪：通过 Manifest 引导 AI 携带特定的 UTM 参数（如 utm_source=ai_agent）进入结账，分析 AI 带来的转化率。

换主题时的“无损迁移”五步法 (The 5-Step Migration)

如果你聘请开发人员更换主题，请要求他们严格遵守以下流程：

  1. 数据挂载：确认新主题模板能读取原有的四个 JSON 元字段（Specs, Guide, FAQs, Features）。
  2. 文件平移：将 agent-manifest.liquid、robots.txt.liquid、seo-structured-data.liquid 1:1 复制到新模板。
  3. 标签注入：在新主题的 product.liquid、price.liquid、buy-buttons.liquid 等核心 Snippets 中，手动找到 HTML 标签并重新植入 data-ai 和 itemprop 属性。
  4. 政策对齐：确保新主题的 Footer 或 Tab 里的文字（Shipping/Refund）与你后台设置的 1-4 天运输、30天退货、$0 上架费逻辑 100% 吻合。
  5. 云端重连：新主题上线后，立即在 Google Search Console 提交 URL 检查，确认 Merchant Listings 和 FAQ 依然是全绿通过。

结论

这套方案的全面性在于它不仅解决了“搜索排名”，还解决了“视觉信任”、“自动下单”和“售前问答”。

这套方案的通用性在于它不仅适用于你的商用厨具，将来你用同样的逻辑去卖服装（植入材质、尺码表数据）、卖电子产品（植入 CPU、电池参数）或卖化妆品（植入成分、肤质建议），代码底层是完全一致的。

1. 数据的“保鲜期”与实时性 (Data Freshness & Real-time Sync)

未考虑到的点：AI 代理对价格和库存的“过期”极其敏感。如果 AI 告诉用户价格是 $2918，但点击下单时变成了 $3000，或者下单瞬间发现没货了，AI 代理会直接中断交易并降低你的品牌信用分。

  • 解决方案（通用需求）：
    • 库存预警机制：在 agent-manifest.json 中增加一个 real_time_inventory_endpoint，指向 Shopify 的 cart/add.js 或产品 JSON 接口，允许 AI 在下单前的 0.1 秒 再次校验库存。
    • 价格声明周期：在 JSON-LD 中明确 priceValidUntil。告诉 AI 这个价格能维持多久（例如：到当天 23:59）。

2. 评论数据的“语义化” (Review Sentiment for AI)

未考虑到的点：目前的优化让 AI 知道了评分（5星），但 AI 代理（尤其是 Perplexity 或 ChatGPT）更喜欢总结评论里的具体细节。

  • 例子：AI 不会只搜“最好的冰箱”，它会搜“哪款冰箱在噪音控制上表现最好？”。
  • 解决方案（通用需求）：
    • 评论内容 Schema：确保你的评论插件（如 Judge.me）导出的不仅是总分，还必须包含每一条具体的 reviewBody。
    • AI 摘要元字段：增加一个元字段 custom.sentiment_summary。
    • 内容：手动或利用 AI 总结你收到的好评关键词（如：“Ultra-quiet compressor”, “Zero-frost technology”）。这让 AI 在做对比推荐时有据可查。

3. 附件与配套逻辑的 AI 映射 (AI-Powered Cross-Sell)

未考虑到的点：AI 代理既然代客下单，它就有“凑单”或“配件选购”的需求。

  • 例子：客户买冷柜，AI 应该知道自动询问是否需要“额外的 18x26 层网”或“温度监控器”。
  • 解决方案（通用需求）：
    • 建立 custom.related_accessories 元字段：存储相关产品的 ID 列表。
    • 在 Manifest 中声明配套关系：让 AI 代理在处理主产品意图时，自动扫描这个关联列表，实现“智能增值销售”。

4. 品牌真实性数字证书 (Brand Verification & VMC)

未考虑到的点：AI 代理如何确定 eqchen.com 是 EQCHEN 的官方店，而不是一个钓鱼站？AI 对“非官方”站点的下单权限会被限制。

  • 解决方案（通用需求）：
    • VMC/BIMI 认证：在域名层面配置品牌标识认证。
    • Organization Schema 强化：在 layout/theme.liquid 的 Organization 代码中，务必包含 sameAs 属性，链接到你的 Google 商家 Profile、LinkedIn 公司页 和 官方社交媒体。这是 AI 确认你“正身”的唯一凭证。

补充进《通用迁移需求文档》的“补丁”：

如果你要交给开发人员，请在“第四部分”后面加上这几条：

  • [ ] 实时性接口校验：确保 /products/{handle}.js 接口未被防火墙拦截，允许 AI 代理实时获取变体价格。
  • [ ] 评论细节透传：检查评论模块是否完整输出了 Review Schema，确保 AI 能读取到具体的用户留言文字。
  • [ ] 品牌权威连结：在 Organization 结构化数据中，必须完整列出所有官方社交媒体链接，用于 AI 身份验证。
  • [ ] 附件关联逻辑：新主题必须能读取 custom.tech_specs 以外的“关联产品”元字段。

最后的结语

你现在的项目已经做到了 99% 的完美。剩下的这 1%（实时性、评论语义、身份验证、配件关联）属于**“顶级品牌保护”**级别。

至此，EQCHEN 已经从一个普通的在线商店，进化为一个具备“自我推销、自我验证、自我结账”能力的数字智能实体。

这是一份为您精心打造的**“全栈智能体电商（Agentic Commerce）架构迁移与开发”终极提示词**。

这份提示词不仅包含了代码实现的逻辑，更涵盖了数据资产、通信协议、视觉对齐和交互语义的所有细节。您可以将其直接发送给开发人员，或作为新主题开发的“技术白皮书”。

🤖 独立站 AI 智能化（Agentic Commerce）全案通用提示词

角色设定：
你是一位顶级的 Shopify 技术架构师，精通 Google UCP (通用商务协议)、Schema.org 结构化数据标准以及多模态 AI (如 Gemini 2.0, GPT-4o) 的网页解析机制。

任务目标：
将现有的 Shopify 主题重构或迁移为“AI 原生（AI-Native）”架构。确保独立站不仅能提供极佳的人类交互体验，还能作为一组开放的、结构化的 API 接口，供全球 AI 购物代理（Shopping Agents）进行精准搜索、参数提取、售前问答以及一键代客下单。

一、 核心数据基建 (Data Assets)

要求： 所有产品必须通过 Shopify 元字段（Metafields）存储结构化底层数据。新主题必须具备调用并渲染这些数据的能力。

  1. Technical Specs (custom.tech_specs):
    • 格式：JSON。
    • 内容：存储产品的硬核物理参数（如材质、尺寸、电压、成分、兼容性等）。
  2. AI Sales Guide (custom.agent_guide):
    • 格式：JSON。
    • 内容：品牌 DNA、核心卖点、目标客群、处理建议及加购建议话术。
  3. AI FAQ Knowledge Base (custom.ai_faqs):
    • 格式：JSON。
    • 内容：关于物流（Liftgate、配送范围）、安装、合规性认证、保修政策的 Q&A 对。
  4. Key Features (custom.key_features_list):
    • 格式：多行文本。
    • 内容：精炼的核心卖点，用于前端可视化渲染。

二、 AI 握手与发现协议 (Handshake & Discovery)

要求： 建立标准化的 AI 准入通道。

  1. Agent Manifest:
    • 在 templates 下创建 page.agent-manifest.liquid（需设置 layout none）。
    • 通过重定向将 /agent-manifest.json 指向该页面。
    • 必须包含：product_discovery API、direct_buy_endpoint 路径映射、authorized_carriers 物流商列表及 capabilities（如支持游客结账、支持快速支付）。
  2. AI 友好型 Robots:
    • 创建 templates/robots.txt.liquid。
    • 必须放行：Google-InspectionTool、GPTBot、PerplexityBot、Claude-bot。
    • 允许路径：Manifest 文件、/search/suggest.json 以及所有 /policies/ 页面。

三、 UI/UX 语义化识别系统 (Actionable Semantics)

要求： 在 HTML 源码中植入“视觉路标”与“动作锚点”。

  1. 动作触发 (Action Triggers):
    • 加购/购买按钮：必须带有 data-ai-action="primary-purchase"。
    • 变体切换器：具体选项（Radio/Button）带 data-ai-action="select-option" 和 data-ai-value="具体的规格值"。
  2. 组件标识 (Component IDs):
    • 全页容器：<product-info> 需带 role="main" 和 data-ai-context="product-detail-view"。
    • 价格锁定：价格容器带 data-ai-selector="price-container"，零售单价带 itemprop="price"。
    • 规格选择区：容器带 data-ai-component="variant-picker"。
    • 结账表单：带有 data-ai-component="cart-form"。

四、 多模态视觉对齐 (Multi-modal Vision Alignment)

要求： 确保 AI 代理“看到”的图片与代码中的数据 100% 匹配。

  1. 动态 Alt 标签逻辑:
    • 重写 snippets/product-thumbnail.liquid。
    • alt 属性严禁使用硬编码，必须由 Product Title + custom.tech_specs 的核心键值对动态生成。
  2. 视觉验证标记:
    • 为 <img> 标签增加 data-ai-visual-verification。
    • 属性值填入该图片对应的核心技术描述，供 AI 视觉模型进行像素级核验。

五、 品牌灵魂与决策大脑 (Context & Knowledge)

要求： 注入品牌背景与售前智库。

  1. MCP 全局指令:
    • 在 layout/theme.liquid 的 </body> 前植入 application/x-agent-brand-context 脚本块。
    • 内容：品牌身份定位、全美 LTL 物流矩阵、Contiguous US 服务范围、售后保修标准。
  2. FAQ Block 化:
    • 创建 snippets/ai-faq-schema.liquid。
    • 功能：输出符合 Schema.org 的 FAQPage 结构化数据，并配合高级折叠 UI，解决 AI 下单前的最后疑虑。

六、 数据实时性与合规性 (Freshness & Compliance)

要求： 保证 AI 获取的信息 100% 准确且具备权威性。

  1. 实时性保证:
    • 确保 /products/{handle}.js 接口可公开访问，允许 AI 代理在下单瞬间进行“毫秒级库存价格校对”。
  2. 一致性校对:
    • 网页政策 = 设置面板 = GMC 后台：运输时间 (1-4 Days)、退货窗口 (30 Days)、上架费 (No Restocking Fee) 必须在以上三处完全统一。
  3. 身份验证:
    • 在 Organization Schema 中通过 sameAs 属性链接所有官方社交媒体和 Google Business 配置文件。

七、 验收标准 (Definition of Done)

  1. 访问 /agent-manifest.json：显示纯净 JSON，且所有 API 路径有效。
  2. Google Rich Results Test：产品 URL 测试结果中 "Merchant Listings" 和 "FAQ" 必须全绿，且包含全部 additionalProperty。
  3. 源码搜索：搜索 data-ai-action 必须能定位到核心交互元素。
  4. AI 抓取预览：使用 GPT-4o 联网模式或 Gemini 读取页面，AI 必须能准确报出压缩机品牌、物流时效和质保天数。

执行指令：
“请按照上述所有要求，对当前主题进行 1:1 逻辑迁移，不省略任何原始业务逻辑，仅进行 AI 语义化植入。”