变量与模板
SEO 规则模板的变量来源、过滤器与路由匹配优先级。
变量来源
| 来源 | 示例 | 说明 |
|---|---|---|
| 站点品牌 | {brand}、{brandTagline}、{logo} | 来自 站点管理 → 品牌 |
| 内置 | {year}、{locale}、{path}、{host} | SDK 自动提供 |
| 页面注册 | {title}、{summary}、{author}、{cover}、任意自定义键 | geo.set() 或 meta name="geo:*" |
| 内容库 | {category}、{publishedAt} | 由平台内容库渲染的页面自动带上 |
过滤器
{title | truncate:60}
{summary | truncate:160 | strip}
{publishedAt | date:YYYY-MM-DD}
{category | upper}truncate 按字符数截断并补 …；中文等 CJK 语言按字计数。
路由匹配
路径模式使用 path-to-regexp 语法：
/ 首页
/blog/:slug 文章页
/docs/:path* 任意深度
/products/:id(\d+) 仅数字多条规则命中同一路径时按 优先级 数字从大到小取第一条；规则可按语言分别填写模板，缺失语言回退到默认语言模板。
模式：fill 与 replace
fill：只写入页面缺失的字段，适合已有部分 SEO 实现的站点逐步迁移replace：平台规则优先，覆盖页面已有的title/meta description/canonical等
预览
在 SEO 头部规则 → 预览 输入路径与变量，可以看到命中的规则、渲染后的 head、JSON-LD 与 hreflang，等价于调用 POST /sites/{siteId}/seo-rules/preview。