为 AI 而重构：Shopify 用更精简的代码重写店面主题

电商平台 Shopify 近日透露，正在开发一款以可读 HTML 为核心的全新店面主题，代码量较当前旗舰主题 Horizon 减少 93%。官方表示，这一重构的背后推手并非纯粹的设计哲学，而是 Shopify 内部日益普及的 AI 助手 Sidekick。

为什么把 JSON 换掉

Shopify 店面产品总监 Ben Sehl 在 X 平台撰文称，过去的「Online Store Editor」为了让商户（merchant）获得更高的页面定制自由度，把模板指令序列化成了 JSON。「灵活性上来了，但代价是开发者再也读不懂一个页面——只要模板变成 JSON，它就从优秀的开发面退化成了自动保存的产物。」他说。

更关键的问题在于，AI 也同样读不懂。Shopify 在测试 Sidekick 为商家改主题时发现，AI 代理需要与人类相同的条件：易读的代码、明确的接口契约、以及可执行的反馈。于是团队决定把架构原则从「机器可序列化」调整为「人机都易读」。

HTML 比 JSON 更适合大模型

Sehl 给出的核心理由是：「所有主流模型都已经理解 HTML，它表达力强、本地化、token 利用率高。」这一判断与业界对 LLM 的认知一致——大模型毕竟是用人类语言训练的，在处理符号密集、嵌套沉重的 JSON 与 DSL（领域特定语言）时往往表现欠佳。例如有开发者做过对比，SQL 比 17 款工具自带的 DSL 都更易被模型处理；Anthropic 在提示工程中也推荐使用语义更丰富的 XML。

为了让 Sidekick 顺畅工作，Shopify 还需要让代码「对 AI 友好」：

模板目录里是易解析的纯文本文件，而非冗长难懂的 JSON 字符串；
新主题采用「声明式 + 设置驱动」架构，开发者只需描述「背景色为蓝色」，AI 代理即可执行；
模板若需增加按钮，只需将其包裹在 HTML 的 div 标签中，无需像旧架构那样预先声明数量。

Liquid 新语法与可组合块

新主题继续使用 Shopify 自有的模板语言 Liquid，但团队给它加了一套新语法和解析器，支持更复杂的后端指令，同时向开发者暴露「可组合、类型化」的块标签，类似 React 中的 props，但省去了虚拟 DOM。

新机制的关键改进包括：

新增「partial primitive」，允许只更新页面某一区域而不必重新渲染整页；
统一的事件触发原语（standard actions），例如「更新购物车」即可替代 Horizon 中数千行响应式代码；
20 条新增规则，覆盖契约、结构、校验、复杂度、嵌套层级与文件大小等约束；
Liquid 新增布尔表达式、带优先级的运算符、以及字面量数组与对象支持；
未来计划接入 Tailwind CSS 框架。

数据方面，Shopify 透露 Sidekick 当前已被约 20% 的商家采用，今年累计完成 2500 万次主题编辑。

更广泛的意义

Shopify 的实践呼应了一个正在浮现的工程理念：让代码既对人友好，也对 AI 友好。Sehl 认为，根本问题不在于 JSON 本身，而在于序列化配置天然词汇受限；当 AI 代理成为软件交互的另一类「用户」时，易读、显式、可组合的代码就成为新的第一性原理。

对正在设计面向 AI 代理 API、工具或模板的团队来说，这是一份相当具体的实操参考：精简结构、用自然语言友好的格式（如 HTML/XML）、并在接口处提供清晰的契约与反馈循环。