精简 metafields.shopify 翻译

Ascent 会在产品规格表、商品比较表等位置显示 Shopify 分类 metafields。字段名会通过类似下面的翻译键输出：

{{ 'metafields.shopify.material' | t }}

Shopify 分类体系可能会在每个前台语言文件里生成非常大的 metafields.shopify 对象。如果店铺实际只使用少量分类 metafields，可以按需精简这些键，减少翻译文件体积。

哪些内容可以精简

只精简下面这个范围里的键：

{
  "metafields": {
    "shopify": {}
  }
}

不要顺手删除其它翻译分组，除非已经确认它们没有被主题使用。

遇到以下情况时，需要保留对应的 metafields.shopify 键：

• 店铺产品实际使用了这个 Shopify 分类 metafield。

• 商品比较表区块里选择了这个 key。

• 不确定商家后续是否会继续使用这个字段。

如果删除了某个键，但主题仍然渲染 {{ 'metafields.shopify.key' | t }}，前台可能会显示缺失翻译提示。不确定时，优先保留。

准备保留清单

先创建一个文本文件，每行写一个需要保留的 key：

color
material
size
target-gender

这里只写 metafields.shopify. 后面的部分。例如 metafields.shopify.material 对应保留 material。

同时检查商品比较表区块里配置过的 key。Ascent 的商品比较表可以读取 product.metafields.shopify[block.settings.key]，这些手动配置的 key 也要放进保留清单。

批量精简前台语言文件

把保留清单保存为 metafields-shopify-keep.txt，然后在主题根目录运行：

node <<'NODE'
const fs = require("fs");
const path = require("path");

const keep = new Set(
  fs.readFileSync("metafields-shopify-keep.txt", "utf8")
    .split(/\r?\n/)
    .map((line) => line.trim())
    .filter(Boolean)
);

for (const file of fs.readdirSync("locales")) {
  if (!file.endsWith(".json") || file.endsWith(".schema.json")) continue;

  const filePath = path.join("locales", file);
  const json = JSON.parse(fs.readFileSync(filePath, "utf8"));
  const source = json.metafields?.shopify;

  if (!source || typeof source !== "object" || Array.isArray(source)) continue;

  const trimmed = {};
  for (const key of Object.keys(source)) {
    if (keep.has(key)) trimmed[key] = source[key];
  }

  json.metafields.shopify = trimmed;
  fs.writeFileSync(filePath, `${JSON.stringify(json, null, 2)}\n`);
  console.log(`${file}: kept ${Object.keys(trimmed).length} of ${Object.keys(source).length}`);
}
NODE

检查结果

精简后建议检查：

• 搜索主题里的 metafields.shopify.，确认需要的 key 都在保留清单中。

• 预览会显示产品规格表的商品。

• 预览使用了商品比较表的页面。

• 检查所有已启用的前台语言，尤其是默认语言。

Shopify 分类 metafield 的具体值来自产品 metafield 本身，例如 value.label。这里的 locale 翻译键只控制主题显示的字段名。