本页由 docs:sync 从 OperationRegistry 生成，请勿手工编辑。
query.ai_page_source
回读一张 AI 页面（target.page）或栏目页型（target.channel+slot）的当前源码（html/css/js 全文）。仅在局部修改前需要确认现状时调用；整页重写不需要回读。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
否（仅 SaaS） |
定位参数 target
| 字段 |
类型 |
必填 |
说明 |
page |
string |
否 |
页面 key（与 channel 二选一） |
channel |
integer |
否 |
栏目 id（与 page 二选一，需搭配 slot） |
slot |
string：list / detail |
否 |
页型槽位（channel 定位时用，默认 list） |
query.ai_pages
查询站点页面清单（含渲染方式 template/ai）、页型模板现状、可用的 Liquid 数据接入点文档。编写/修改任何 AI 页面前必须先调用本操作。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
否（仅 SaaS） |
query.articles
查询文章列表或详情（params.id 返回详情，keyword 模糊搜索标题，channel 按栏目过滤）。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
id |
integer |
否 |
|
keyword |
string |
否 |
|
channel |
integer |
否 |
按所属栏目过滤（query.channels 查 id） |
query.cases
查询工程案例列表或详情（params.id 返回详情，keyword 模糊搜索标题，channel 按栏目过滤）。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
id |
integer |
否 |
|
keyword |
string |
否 |
|
channel |
integer |
否 |
按所属栏目过滤（query.channels 查 id） |
query.channels
查询站点栏目清单（内置三栏与自建栏目）：id、名称、网址标识、内容模型、显隐、自定义字段集。往指定栏目发内容（channel 参数）、修改/删除栏目前，都先用本操作拿栏目 id。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
query.collections
查询站点内容集合（数据源）清单。客户要"这个区块展示推荐产品/精选文章/绑定某集合"时先查这里；绑定语法：AI 页面 {% for p in collections['slug'].items %}，模板产品区块 section.set_params 设 collection=slug。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
query.company_profile
查询企业资料：公司名称、简称、简介、成立年份、Logo、电话、邮箱、地址。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
query.forms
查询站点自定义表单清单（留言/简历投递/预约…）。页面渲染语法：{% contact_form 'key' %}；提交进「线索」按表单归属。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
query.knowledge
检索客户上传的知识库文档（企业资料、产品手册等）。撰写文案、回答产品细节前先检索，引用真实资料而不是凭空编写。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
query |
string |
是 |
检索关键词或问题 |
limit |
integer |
否 |
返回片段数，默认 5 |
query.media
查询素材库（客户上传的真实图片）。设置产品图、文章封面、Logo 等图片字段前必须先调用本操作获取真实 URL，禁止编造图片地址。可按 category/keyword 过滤。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
category |
string：logo / product / article / case / general |
否 |
按用途分类过滤 |
keyword |
string |
否 |
按文件名模糊搜索 |
query.products
查询产品与产品分类。不带参数返回分类和产品列表；params.id 返回单个产品详情；可按 keyword/category_id/channel（栏目 id）过滤。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
id |
integer |
否 |
产品 ID，返回详情 |
keyword |
string |
否 |
按名称模糊搜索 |
category_id |
integer |
否 |
|
channel |
integer |
否 |
按所属栏目过滤（query.channels 查 id） |
query.section_capabilities
查询某类型模块在当前模板下可用的版式、可调参数和可编辑文案字段。切换版式/调参数/改文案前必须先调用本操作确认能力范围。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
否（仅 SaaS） |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
type |
string |
是 |
模块类型（query.site_overview 返回的 type），如 hero / about / products |
query.site_overview
查询站点整体结构：页面、模块、当前版式与可见性。生成写操作前应先调用本操作了解现状。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
query.template_css
查看本站私有模板的样式表。传 contains 关键词（选择器/属性值）返回相关片段（patch 前必查，find 须与原文逐字符一致）；不传返回分区目录。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
否（仅 SaaS） |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
contains |
string |
否 |
定位关键词，如 .hero h1、box-shadow |
query.translation_units
查询某语言的可译条目与状态（未译/待更新/已译）。要翻译前先调本操作定位到具体条目的 type/id/field——条目的键不在页面上，光看选中的文字猜不出来。可用 keyword 按源文或字段名筛，status 按状态筛。
| 项 |
值 |
| 风险分级 |
R0（查询） |
| 所需权限 |
site.view |
| 需要确认 |
否 |
| 触发重建 |
否 |
| 独立部署可用 |
是 |
业务参数 params
| 字段 |
类型 |
必填 |
说明 |
locale |
string |
是 |
目标语言代码，如 en |
keyword |
string |
否 |
按源文或字段名筛选（可选） |
status |
string：missing / stale / translated |
否 |
按状态筛选（可选） |