页面与区块

page.*、page_template.*、section.* 共 17 个操作。

本页由 docs:sync 从 OperationRegistry 生成,请勿手工编辑。

page.create_ai

新建一张 AI 独立页面(访问路径 /{key}/,如关于页 about-us、方案落地页 solutions)。只建空壳,随后用 page.set_ai_source 写入代码;要让访客从菜单进入,再用 nav.update 加一项 target=page:{key} 挂进导航。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

业务参数 params

字段 类型 必填 说明
key string 是 页面标识(URL 路径段,小写字母/数字/中划线)
title string 是 页面标题
seo object 否 页面级 SEO(覆盖式,整体替换)

page.delete_ai

删除一张 AI 独立页面(首页与模板页面不可删)。需要客户确认后才会执行。

项 值
风险分级 R2(删除)
所需权限 layout.edit
需要确认 是
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home

page.patch_ai_source

AI 页面源码的局部替换:把 find(源码中逐字符一致且唯一的片段)替换为 replace。客户点选页面上某段文字/某张图要求小改时优先用它,不要整页重写。find 找不到通常说明那段文字来自 Liquid 数据槽位(产品名/文章标题等)——改对应数据(product.update 等)而不是页面代码。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home

业务参数 params

字段 类型 必填 说明
field string:html / css / js 否 要修改的字段,默认 html
find string 是 源码中逐字符一致且唯一的片段(不唯一时把前后文带上)
replace string 是 替换为的内容(空字符串=删除该片段)

page.revert_to_template

把 AI 接管的页面恢复为平台模板渲染(清除 AI 代码;原模块/文案数据一直保留)。客户说「首页改回原来的」时用。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home

page.set_ai_source

为页面编写整页代码(只传要改的字段,覆盖式合并)。html 为 body 片段、可用 Liquid 数据槽位绑定动态数据(产品/文章/导航等,见 query.ai_pages 的 data_points);css/js 原样内联(不能写 Liquid)。对模板页面(如首页 home)写入即接管为 AI 渲染,原模块数据保留、可用 page.revert_to_template 恢复。重要:模板建站的站点(首页非 AI 接管),独立页面构建时会自动套全站公共页头/页脚(同一份导航/Logo/语言切换)——html 只写正文内容,不要自己写 header/footer/顶部导航,配色沿用主题 CSS 变量(var(--primary) 等)即可与全站一致;首页被 AI 接管的站点页面才自包含(需自带页头页脚)。表单:禁手写 /,一律 {% contact_form '表单键' %}(无参=默认询盘表单)。流程=先 form.create 定义字段(或 query.forms 用已有的),再在布局中引用——字段渲染自表单定义,提交进「线索」。输出结构类名:.lexi-form / .lexi-form-field / .lexi-form-label / .lexi-form-input / .lexi-form-textarea / .lexi-form-submit / .lexi-form-tip,自带基线样式(按钮用 var(--primary));要定制外观就给这些类写 CSS,用自己的外层容器类提高优先级(如 .booking-card .lexi-form-input{…})。硬约束:禁外部脚本/样式/iframe/裸 form;Liquid 语法错误会被拒绝并返回错误位置,修正后重新提交。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home

业务参数 params

字段 类型 必填 说明
html string 否 页面 body 内容(可含 Liquid 数据槽位)
css string 否 页面 CSS(内联进 head,纯 CSS 不含 Liquid)
js string 否 页面 JS(内联在 body 尾,纯 JS 不含 Liquid)

page.update_content

修改模块文案(如首页 Banner 标题/副标题)。可编辑字段由模板声明(先查 query.section_capabilities)。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

page_template.clear

清除某栏目某槽位的 AI 页型、恢复平台模板渲染(内容数据不受影响)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
channel integer 是 栏目 id(query.channels / query.ai_pages 的 template_channels 返回;单页栏目不适用)
slot string:list / detail 是 页型槽位:list=栏目列表页(子栏目的 list 即分类页)/ detail=内容详情页

page_template.patch_source

栏目页型模板源码的局部替换(同 page.patch_ai_source,按 channel+slot 定位)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
channel integer 是 栏目 id(query.channels / query.ai_pages 的 template_channels 返回;单页栏目不适用)
slot string:list / detail 是 页型槽位:list=栏目列表页(子栏目的 list 即分类页)/ detail=内容详情页

业务参数 params

字段 类型 必填 说明
field string:html / css / js 否 要修改的字段,默认 html
find string 是 源码中逐字符一致且唯一的片段(不唯一时把前后文带上)
replace string 是 替换为的内容(空字符串=删除该片段)

page_template.set_source

编写某栏目页型(列表页或详情页)的整页代码——按 (channel, slot) 挂载,自定义模型栏目同样可用(AI 为自定义模型生成版式)。detail 槽位构建时按每条数据循环渲染(上下文多一个当前实体,如 {{ product.name }};自定义模型按其所属内置契约取数,见 query.ai_pages 的 data_points)。设置后该栏目该槽位走 AI 渲染,未设置的继续用平台模板;page_template.clear 可恢复。约束同 page.set_ai_source。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
channel integer 是 栏目 id(query.channels / query.ai_pages 的 template_channels 返回;单页栏目不适用)
slot string:list / detail 是 页型槽位:list=栏目列表页(子栏目的 list 即分类页)/ detail=内容详情页

业务参数 params

字段 类型 必填 说明
html string 否 页面 body 内容(可含 Liquid 数据槽位)
css string 否
js string 否

section.add_custom_block

新增一个「AI 自定义代码块」。当结构化版式/参数(set_layout/set_params)无法表达客户需求、需要写真 HTML/CSS/JS 时使用。新建后再用 section.set_custom_code 写入代码。要把某个现有区块(如首页产品区)改造成自定义代码版时,传 target.replace=该区块 key:新块会直接占据它的位置、并自动隐藏原区块(无需再手工 reorder/set_visibility),改造效果就长在原位。不传 replace 则新块接在页面末尾(之后可用 section.reorder 调位置)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home
replace string 否 可选:要被此自定义块替换掉的现有模块 key(如 products)。给了则新块占据该模块位置并隐藏它——用于把结构化区块改造成自定义代码版。

业务参数 params

字段 类型 必填 说明
title string 否 区块标题(编辑器里的人话标签)

section.delete_custom_block

删除一个「AI 自定义代码块」(仅 type=custom)。需要客户确认后才会执行。结构化区块(hero/产品等)不能删,只能用 section.set_visibility 隐藏。

项 值
风险分级 R2(删除)
所需权限 layout.edit
需要确认 是
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

section.reorder

调整页面模块顺序。order 必须是该页面全部模块 key 的完整排列(先查 query.site_overview)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key(query.site_overview 返回),如 home

业务参数 params

字段 类型 必填 说明
order array 是 模块 key 数组,按期望顺序排列

section.set_custom_code

为「AI 自定义代码块」写入 HTML/CSS/JS(只传需要改的字段,覆盖式合并)。仅能用于 type=custom 的区块(先用 section.add_custom_block 新建)。代码在隔离沙箱(iframe sandbox,无同源权限)中渲染:访问不到平台会话/Cookie、页面其它区块或 。html 支持 Liquid 数据槽位绑定站点数据({{ site.name }}、{% for a in articles limit:6 %}{{ a.title }}{% endfor %},articles/products/cases/collections 与 AI 页面同一数据上下文,见 query.ai_pages 的 data_points)——动态列表(如"更多新闻/推荐产品")必须用槽位而不是硬编码,内容更新自动跟随;css/js 为纯静态不支持 Liquid。表单同 AI 页面规则:禁手写 /,用 {% contact_form '表单键' %}(先 form.create 定义字段),输出 .lexi-form-* 类名结构、自带基线样式,可用块内 css 覆盖定制。块内可以写站内链接:一律用「站点根相对路径」(query.articles/products/cases 返回的 url 字段,如 news/xxx.html、products/、cases/xxx.html),发布后点击会在整页正常跳转、预览态只看样式不跳转;禁止编造 URL、禁止绝对路径(以/开头)和外部链接。不要写弹窗/表单提交/全局样式。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

业务参数 params

字段 类型 必填 说明
html string 否 区块 HTML(注入沙箱 body 内)
css string 否 区块 CSS(注入沙箱 head 内,作用域仅本块)
js string 否 区块 JS(在沙箱内执行,触达不到平台/其它区块)
title string 否 区块标题

section.set_layout

切换模块预设版式。版式必须在模板声明的枚举内(先查 query.section_capabilities)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

业务参数 params

字段 类型 必填 说明
layout string 是

section.set_params

调整模块参数(如产品列数)。可调键与取值范围由模板声明(先查 query.section_capabilities)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 否(仅 SaaS)

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

section.set_visibility

显示或隐藏页面模块(隐藏不删除数据,可随时恢复显示)。

项 值
风险分级 R1(修改内容)
所需权限 layout.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

业务参数 params

字段 类型 必填 说明
visible boolean 是

section.update_stats

整组替换模块的数据展示(统计数字,如「20年/3000+客户/30+国家」)。统计数字是结构化数组、不在文案字段内,改它用本操作。先查 query.site_overview 看当前 content.stats 以保留不变的项。

项 值
风险分级 R1(修改内容)
所需权限 content.edit
需要确认 否
触发重建 是
独立部署可用 是

定位参数 target

字段 类型 必填 说明
page string 是 页面 key,如 home
section string 是 模块 key(query.site_overview 返回)

业务参数 params

字段 类型 必填 说明
stats array 是 整组统计项(覆盖式替换)