AI 如何理解你的网站
SmartForge 的 AI 智能体不是靠猜测来理解网站功能。它通过一套称为 CL 标签（Component Label）
的系统，精确掌握网站的每一个功能模块。
1
页面加载 → 标签扫描
当 AI 智能体被激活时，它首先获取目标网站的所有 HTML 页面。通过内置的标签扫描器，
自动识别所有 data-ai-code 属性标签，构建一张完整的"网站功能地图"。
比如扫描到 CL-0078 就知道"这个网站支持添加用户"，
扫描到 CL-2230 就知道"这里展示核心功能卡片"。
2
标签 → 功能清单
每个 CL 标签对应平台维护的 Manifest（标签清单），包含：
— 标签编号（如 CL-0078）
— 功能名称（如"添加用户"）
— 所需参数（如 name / email / role）
— 操作类型（如 user.add）
AI 智能体加载 Manifest 后，完全理解每个标签能做什么、需要什么参数。
3
自然语言 → 标签映射
当你说"帮我添加一个叫张三的用户"，AI 用大语言模型分析这句话的意图：
— 动作：添加用户 → 匹配到 CL-0078
— 参数：name=张三，role=user
— 缺失参数：email 未提供 → AI 会主动追问
这个过程完全由 LLM 完成，无需任何规则匹配或关键词配置。
AI 如何执行任务
理解用户意图后，AI 智能体通过标准化的动作 API 执行具体操作。整个流程分为 3 个阶段。
1
意图解析阶段
用户输入（如"更新所有特价商品打8折"）→ AI 提取结构化信息：
{ action: "product.batch_update", filter: {category: "特价商品"}, changes: {price: "x0.8"} }
解析时 AI 会检查参数完整性和合法性，缺少必要信息则主动追问。
2
动作执行阶段
AI 调用平台统一 API：POST /smartforge/v1/action/execute
— 传入标签编号和解析后的参数
— API 层做权限验证（site_id + api_key + 用户角色）
— 执行具体操作（写数据库 / 调第三方API / 生成内容）
— 所有操作记录到 audit log，可追溯
3
结果反馈阶段
任务执行完成后：
— 简单操作（添加用户/更新价格）：秒级返回结果
— 复杂操作（建站/批量优化）：入任务队列，异步执行，前端轮询进度
— AI 将结果翻译为自然语言回复用户（如"已更新3个产品的价格"）
— 结果同时写入 long-term memory，供后续上下文引用
CL 标签体系详解
CL 标签是 SmartForge 的核心创新——让 AI 能够像读地图一样理解任意网站的功能结构。
1
三种标注方式
方式一：Data 属性（推荐）
<button data-ai-code="CL-0078" data-ai-action="user.add" data-ai-params='{"role":"user"}'>添加用户</button>
方式二：自定义元素
<ai-user-manager data-mode="list"></ai-user-manager>
方式三：HTML 注释（AI扫描用）
<!-- CL-0078:add_user {role: "admin"} -->
2
标签编码规则
所有 CL 标签按功能领域分段编码，方便管理和扩展：
CL-0100~0199 — 核心基础设施（插件激活、数据库、REST API）
CL-0200~0299 — 应用市场（插件发现、安装、发布）
CL-0300~0399 — AI 聊天机器人
CL-0500~0599 — AI 建站引擎
CL-0600~0699 — SEO & 营销
CL-1000~1999 — 商家站点组件库
CL-2000~2999 — SmartForge 门户页面组件
3
前端运行时 (ai-runtime.js)
每个生成的商家网站内嵌 ai-runtime.js，暴露 window.SmartForgeAI 对象：
— SmartForgeAI.execute(actionCode, params) — 执行 AI 动作
— SmartForgeAI.scanTags() — 扫描页面所有标签
— sf-ai-before-execute / sf-ai-after-execute / sf-ai-error — 事件系统
这个轻量运行时（约 1KB）让任何静态网站都具备 AI 可编程能力。
长期记忆与持续进化
传统 AI 对话每次都是"重新认识你"。SmartForge 为每个网站维护独立的长期记忆，AI 智能体越用越懂你的业务。
1
记忆存储什么
对话历史 — 最近 N 天的所有交互记录（按套餐决定保留天数）
网站状态摘要 — 产品数量、文章数量、用户数量、订单统计等
用户偏好 — 品牌风格、常用操作频率、偏好的沟通方式
业务知识 — 产品信息、价格策略、目标客户画像
所有记忆按 site_id 严格隔离，不会跨站泄露。
2
主动建议机制
AI 不是被动等待指令，而是主动观察你的网站状态，给出优化建议：
— "您的产品列表还是空的，需要我帮您添加吗？"
— "您的关于页面缺少联系方式，要现在补充吗？"
— "本周有 15 个访客查看了某产品但没下单，要我生成优惠券吗？"
— "您的博客 30 天没更新了，要我根据行业热点生成一篇吗？"
建议基于网站实际数据驱动，而非泛泛提醒。
3
母智能体学习
所有子智能体（每个网站一个）可匿名分享脱敏数据给母智能体：
— "80% 的手工艺品网站使用了产品变体功能"
— "服装类商家平均需要 15 个分类才能覆盖完整产品线"
母智能体据此优化全局标签建议和新站默认配置，形成正向飞轮。
智能体架构
SmartForge 采用"母智能体 + 子智能体"双层架构，既保证全局一致性，又允许每个站点个性化。
1
母智能体 (Master Agent)
运行在平台核心，职责：
— 维护全局标签 Manifest 和组件库
— 管理行业模板和最佳实践
— 汇总匿名统计数据优化全局策略
— 升级基础提示词和合规规则
母智能体不直接操作任何具体网站。
2
子智能体 (Site Agent)
每个网站拥有独立的智能体实例：
— 继承母智能体的基础能力（标签理解、意向解析、动作执行）
— 拥有独立的记忆库（对话历史、业务数据、用户偏好）
— 可自定义追加专属提示词（品牌语调、业务规则、敏感操作审批流程）
— 记忆按套餐等级保留 7/30/永久 天
3
技术栈
AI 模型层：DeepSeek（默认）/ Claude 可选切换
编排框架：基于 LangChain 的自定义 Agent 引擎
记忆存储：向量数据库（按 site_id 分区）
任务队列：基于 MySQL + Cron 的持久化队列（支持断点续传）
API 网关：WordPress REST API + LiteLLM 统一模型代理
部署环境：Hostinger 共享主机 (WordPress) + Linux VPS (AI 引擎)
AI 建站全流程
从一句话到一个完整的商业网站，AI 在 6 个步骤内自动完成。整个过程用户只需等待约 3-8 分钟。
1
需求分析 & 站点规划
用户输入描述（如"手工艺品商城，需要产品展示、在线咨询和 SEO"）→ AI 调用大语言模型
生成结构化站点计划：确定页面数量、布局类型、色彩主题、功能模块清单。
如果 AI 调用失败，自动回退到模板预设方案确保可交付。
2
创建部署环境
自动创建子域名目录 ~/domains/子域名.smartforge.zenyozen.com/public_html/
— 生成 .htaccess（SPA 回退规则）
— 配置目录权限
— 预设 robots.txt
3
AI 生成页面
AI 按站点计划逐页生成 HTML（内含 CL 标签）：
— 导航栏、Hero 区、产品网格、联系表单、页脚
— 所有元素标注 data-ai-code 标签，使 AI 后续可精准操控
— 页面内容基于行业模板 + 用户描述定制
— 使用 CL 组件库中的预制模板（CL-1001 导航 / CL-1003 产品网格等）
4
生成样式主题
AI 生成完整的 CSS 文件（style.css），包含：
— CSS 变量系统（主色调按用户品牌色）
— 响应式断点（桌面/平板/手机三档）
— 组件样式（导航/Hero/产品卡/表单/页脚）
— 交互动画（悬浮效果、平滑滚动、淡入动画）
5
注入智能运行时
AI 生成 script.js（交互逻辑）和 ai-runtime.js（智能体运行时）：
— 移动端导航折叠、表单提交、滚动动画
— window.SmartForgeAI API 暴露，支持后续 AI 远程操控
— 事件系统：sf-ai-before-execute / sf-ai-after-execute / sf-ai-error
6
注册 & 上线
站点信息写入 wp_smartforge_sites 数据库表：
— 记录子域名、站点名称、模板类型、创建时间
— 激活该站点的 AI 子智能体实例
— 返回访问链接：https://子域名.smartforge.zenyozen.com
— 用户可随时通过自然语言指令继续管理站点
AI 营销 & SEO 引擎
SmartForge 内置 14 个 SEO 工具，覆盖从内容生成到技术优化的全链路。
自动内容生成
"帮我写3篇关于浴室装修的SEO文章"
AI 批量生成含标题、关键词、摘要、正文、标签的完整 SEO 文章。自动注入 FAQ Schema 结构化数据。
404 监控 & 智能重定向
实时记录所有 404 请求 → 按频率排序 → 推荐重定向目标
自动检测失效链接，根据 URL 相似度推荐最匹配的现有页面做 301 重定向。
内容审计 (9项检查)
扫描全站 → 标记"缺焦点词/描述过长/内容过薄/缺H2/缺图片/缺Alt/重复标题"
一键定位需要优化的页面，点击直达编辑页。
爬虫预算优化
robots.txt 自动追加规则 → 屏蔽 /cart /checkout /wp-admin
把 Google 抓取预算留给有价值的内容页，避免浪费在购物车/后台等页面。
Schema 结构化数据
自动注入 FAQ / Product / Organization / BreadcrumbList
帮助搜索引擎展示富结果（星标价格、FAQ折叠、面包屑路径），提升点击率。
AI 批量优化
勾选50个产品页 → AI批量生成 SEO标题/Meta描述/焦点关键词/图片Alt
任务进入队列自动分批处理，完成后可在 Task Queue 查看每页处理结果。
WooCommerce 守卫
自动 noindex 产品标签/属性归档 → 缺货产品 301 重定向到分类
解决 WooCommerce 常见 SEO 问题：低质归档、重复内容、缺货空页。
内链地图
扫描全站 → 找出所有"孤页面"（0条入站内链）
孤页面对 SEO 不利——Google 认为它不重要。一键定位这些问题页面并添加内链。