云指建站助手

要解决什么问题

在使用 SAAS 建站平台时，开发者常需要在编辑器里手工粘贴 HTML 片段、拼接动态数据、维护表单提交逻辑，还要反复确认页面 ID、分类 ID 和表单 ID 是否对应真实站点。手工操作容易踩三类坑：

• 模板语法写进编辑器后被过滤或报错，例如在 <script> 标签内插入了 {% if %}；
• 域名写死导致换环境后链接全部失效；
• 写操作误覆盖已有页面，或删除页面后无法恢复。

技能如何工作

云指建站助手 把建站拆成「产出代码 + 站点读写」两条线：

• 代码产出：按交付物类型生成可直接粘贴到编辑器的 HTML/CSS/JS/Twig 代码，覆盖静态区块、自由页、动态列表页、详情页、自定义表单、产品询盘与在线查询页。
• 站点读写：通过用户站点的 MCP 服务查询真实数据（list_page、get_page_info、get_product_list、list_custom_form 等），写入前展示目标与影响并要求确认。

核心工作流如下：

1. 明确交付物类型；如需在线操作，先索取 MCP 地址 与 Bearer Token，调 test 验证连通性。
2. 用查询工具拿真实 ID 与数据，不盲目假设页面或分类；修改已有页面前必须先 get_page_info 读取 SourceCode。
3. 选择数据能力：系统信息用 DataTag.sys，后台业务数据用 DataTag.custom，系统内容用 FnGet* 系列函数。
4. 表单优先走系统动态表单：list_custom_form → 用户选择 → FnGetCustomForm(表单ID) 生成，保留完整校验与 AJAX 提交逻辑。
5. 输出完整代码后自检约束，保存前再 list_page 确认是新建还是更新。

适用边界与注意点

• 写操作不可回滚：save_ai_page_batch 中途失败时已写入的页面不会自动撤销，覆盖、删除、设首页、清缓存前必须逐项确认。
• 删除不可恢复：del_page 前必须 list_page + get_page_info 核对站点、页面 ID、名称与 URL，并单独取得永久删除确认。
• 模板约束严格：控制语句只能放在完整 HTML 元素外部，禁止写进 <script> 或标签属性；语法限 Twig 1.3，|default 不嵌套。
• URL 动态化：拼接完整 URL 时域名用 {{ FnGetHost($type) }} 获取，本站内链保持相对路径。
• 结构化数据：JSON-LD 必须来自真实渲染内容或数据源，产品评分字段只作结构化补充，不得显示为站内虚假评分。
• 公共头尾需自包含：common_top / common_foot 要自带 <style> 与全部 @media 断点，通过 {{ FnInclude($codePath) }} 嵌入。