edu-site-builder 教培机构官网与 SEO 建站器
功能概述
让没有技术人员的教培小机构，通过一次对话在当天拥有一个"能被搜到、能带来试听预约、
合规不踩雷"的静态官网。零代码、零年费、源码零锁定（纯 HTML/CSS/JS，可部署到任意静态主机）。
内置技术 SEO 全套资产（TDK/OG/JSON-LD/sitemap/robots/llms.txt）、地域关键词着陆页、
广告法违禁词发布闸门与线索台账，替代 SaaS 建站年费（约 2000-4000 元/年）与外包改版费。
使用前提
- 运行环境：Python 3.8+（所有脚本零第三方依赖，跨平台，无需安装任何包）
- 无需 API Key、无需外部连接器即可完成建站全流程
- 云端演示部署：使用 WorkBuddy 内置的 CloudStudio 部署能力（可选，也可仅本地生成整包自行托管）
- 正式运营：需要机构自有域名（备案分流指引内置；校外培训类需教育部门前置审批）
- 线索接收：需要一个机构邮箱（V1 表单线索经 mailto 通道发送）
快速开始（3 步完成首次建站）
- 对话输入「帮我给机构建个官网」，或直接发送一段机构介绍文本（名称/城市/课程/联系方式）
- 回答简短访谈补齐缺失信息，确认关键词矩阵
- 等待自动完成：构建 → 违禁词合规扫描 → 云端部署，返回官网访问链接
使用手册
功能 1：一句话建站（全新官网生成）
- 触发方式：用户说"帮我建官网""想要个网站""给机构做个官网"等
- 操作示例：
> 用户：我在朝阳区开了一家少儿美术工作室，想做个能收家长咨询的官网
> 技能：先进行学科类红线预检（美术属素质类，可建站）→ 访谈补齐课程/师资/联系方式 → 生成关键词矩阵（如"北京少儿美术培训""朝阳区美术班"）→ 构建官网（首页/课程/师资/案例/FAQ/联系 + 朝阳区/望京 2 个地域着陆页）→ 违禁词扫描通过 → 部署云端返回链接 - 注意事项：面向中小学生的学科类培训（学科辅导/提分）一律拒绝生成（双减红线）；师资资质、案例成绩等信息必须真实，技能不会代为编造
功能 2：关键词矩阵与地域着陆页
- 触发方式："家长搜什么词能找到我""做关键词布局""想要落地页"
- 操作示例：
> 用户：我想让附近家长搜"少儿美术"能找到我
> 技能：按品牌词/核心词/地域词/长尾词四层规则生成 ≥20 个关键词（联网抽查地域词搜索量），交你确认后写入 keywords.csv，并为重点地域词各生成一个着陆页（含 H1 命中、区域课程表、附近校区导航、本地 FAQ） - 注意事项：核心课程名须含品类词（如"少儿美术启蒙班"而非"启蒙班"），它将成为全站核心关键词
功能 3：广告法违禁词发布闸门（强制，不可跳过）
- 触发方式：每次构建后自动执行；也可说"扫一下违禁词"
- 操作示例：
> 用户：首页文案写"北京最专业的少儿美术，考级通过率100%"行吗
> 技能：扫描命中 2 处违禁——【绝对化用语】"最专业"、【保证性承诺】"通过率100%"，阻断发布并给出合规替换建议："北京专注少儿美术教学的工作室""历届学员考级通过情况可到店查看真实记录" - 注意事项：命中违禁词时退出码为 1，必须改写后重扫通过才能部署；即使你要求保留违禁表述，技能也会拒绝发布
功能 4：对话式改版迭代与版本回滚
- 触发方式："加一门课""改价格""换个主题色""回滚到上一版"
- 操作示例：
> 用户：新开了陶艺课，加到官网上，主题色换成暖橙
> 技能：更新 courses.json 与品牌色 → 重新构建 → 重扫合规 → 重新部署 → 版本号 +1 并快照到 snapshots/v2/，返回新链接 - 注意事项：每次迭代自动快照，可随时回滚到任意历史版本重新部署
功能 5：线索台账与导出
- 触发方式："看线索""这个月有多少预约""导出线索"
- 操作示例：
> 用户：看看这个月的试听预约
> 技能：读取 leads.json，按状态（新线索/已联系/已到访/已成交/无效/流失）汇总，列出明细（姓名/联系方式/意向课程/来源页面/utm 归因/时间） - 注意事项：表单线索 V1 为双轨——邮件通道送达机构邮箱 + 台账补录；导出 CSV 自带 UTF-8 BOM，Excel 打开不乱码
功能 6：备案与百度收录指引
- 触发方式："怎么备案""用什么域名""怎么让百度收录"
- 操作示例：
> 用户：官网做好了，怎么让百度搜到我？
> 技能：输出备案分流表（个人/企业/校外培训类对应路径与前置审批要求）+ 百度收录清单（站长平台提交、sitemap 推送、搜一搜适配、GEO/llms.txt 要点），并演示验证 sitemap.xml/robots.txt 已生成 - 注意事项：云端演示链接仅作过渡展示，正式运营必须切换到机构自有备案域名
数据说明
站点项目统一存放在工作区 sites/<slug>/ 目录：
| 文件 | 说明 |
|---|---|
| site.config.json | 机构信息（名称/城市/品类/联系方式/主题色/部署记录/版本号） |
| content/org.json | 机构介绍、优势卖点、营业时间、校区地址 |
| content/courses.json | 课程列表（名称/适合年龄/课时/价格/亮点），名称含品类词 |
| content/teachers.json | 师资（姓名/教龄/专长/资质，须真实） |
| content/cases.json | 学员案例（须脱敏且获授权，禁止编造成绩） |
| content/faq.json / articles.json | 常见问题、长尾问答文章 |
| content/keywords.csv | 四层关键词矩阵（品牌/核心/地域/长尾） |
| leads.json | 线索台账（状态机：新线索→已联系→已到访→已成交/无效/流失） |
| site/ | 构建产物：静态页面 + assets + sitemap.xml + robots.txt + llms.txt |
| snapshots/v<N>/ | 历史版本快照，用于回滚 |
常见问题
Q: 完全不懂技术能用吗？
A: 可以。全程对话完成，不需要写任何代码；产物为纯 HTML/CSS/JS 静态文件，想迁移时整包拷走即可，无任何锁定。
Q: 建好的网站放在哪？访问链接是什么？
A: 默认部署到 WorkBuddy 内置的云端静态托管，立即获得可访问链接用于演示和过渡；正式运营建议绑定机构自有备案域名，技能会给出操作指引。
Q: 需要备案吗？
A: 正式运营需要。个人/企业备案路径不同；校外培训类（面向中小学生）还需教育部门前置审批——技能内置分流表会根据你的机构类型给出对应路径。面向中小学生的学科类培训推广会被直接拒绝生成。
Q: 家长提交的试听预约我怎么收到？
A: V1 双轨：预约表单通过邮件通道发送到机构邮箱，同时可补录进线索台账；后续版本将提供更实时的通知方式。
Q: 违禁词扫描误报了怎么办？
A: 词库已对常见序数词（如"第一步"）做了豁免；若仍误报，可在 data/forbidden-words.json 中调整对应模式后重扫，但四大类（绝对化用语/保证承诺/命题关联/受益者背书）的核心规则不可关闭。
Q: 不满意能回滚吗？
A: 每次迭代自动快照，说"回滚到上一版"即可恢复任意历史版本并重新部署。
Q: 支持多语言或海外市场吗？
A: V1 面向国内市场（中文 + 百度/微信生态）。海外多语言站点在能力边界之外，暂不支持。
技能指令（AI 执行参考）
能力边界
- 做：建站、技术 SEO 资产、关键词矩阵与地域着陆页、长尾内容、转化组件、违禁词闸门、
云部署与迭代、线索台账、备案/收录指引。 - 不做：在线支付、CRM 跟进流转、排名监控看板、多语言站、代办公安/ICP 备案手续。
- 红线：面向中小学生的学科类培训推广一律拒绝（见 references/compliance.md 第 2 节）。
工作流（完整分步见 references/workflow.md，务必按序执行）
- 意图分流：新站 → 访谈；已有项目（
sites/<slug>/）→ 按意图进入迭代/线索/内容环节。 - 采集访谈（≤15 问，9 大项）+ 学科类红线预检 + 信息真实性确认。
用户给出自由文本机构介绍时先解析再只追问缺失必填项。 - 脚手架：
python scripts/init_project.py <slug> --city <城市> --category <quality|career|hobby>，
将访谈结果覆盖 REPLACEME 占位。核心课程名须含品类词（成为全站核心关键词）。 - 关键词矩阵：按 references/wordbanks.md 四层规则（品牌/核心/地域/长尾）生成
≥20 词写入 content/keywords.csv，WebSearch 抽查地域词后交用户确认。 - 构建：
python scripts/build_site.py <project_dir> [--base-url URL]→
生成页面 + sitemap.xml/robots.txt/llms.txt + 主题 CSS + 表单 JS。 - 合规闸门（强制，不可跳过）：
python scripts/scan_compliance.py <project>/site
退出码 0 才允许部署；违禁项改写后重扫；用户要求保留违禁表述时拒绝。 - 部署交付：调用 cloudstudio-deploy 技能部署
<project>/site/，链接写入
site.config.json 的 deploy 字段，present_files 打开首页；打dist-v<N>.tar.gz；
输出备案分流指引（compliance.md 第 3 节）与百度收录清单（seo-playbook.md 第 4 节）。 - 迭代：改 content/*.json → 重跑 build → 重扫合规 → 重新部署 → version+1 →
快照到 snapshots/v<N>/。 - 线索：查/录 leads.json（status：新线索/已联系/已到访/已成交/无效/流失），
导出 CSV 必须带 UTF-8 BOM。
意图 → 动作映射
| 用户说 | 动作 |
|---|---|
| 帮我建官网 / 想要个网站 | 阶段 1-7 全流程 |
| 加一门课 / 改价格 / 换个颜色 | 改 content 或 config.brand → build → scan → 部署 |
| 家长搜什么词能找到我 | 关键词矩阵（wordbanks.md） |
| 这个月写什么文章 | 内容日历 + 长尾文章（seo-playbook.md） |
| 看线索 / 有多少预约 | 阶段 9 线索台账 |
| 怎么备案 / 用什么域名 | compliance.md 第 3 节分流表 |
| 回滚到上一版 | 恢复 snapshots/v<N>/ 重新部署 |
资源清单
scripts/init_project.py— 站点项目脚手架（site.config.json + content/* 占位）scripts/build_site.py— JSON 数据 → 静态站点 + 全套 SEO 资产渲染器scripts/scan_compliance.py— 广告法违禁词发布闸门（退出码 1 = 阻断）assets/site-template/— 页面模板 template.html、base.css（主题色占位）、form.js（utm 归因 + mailto 线索通道 + 企微弹层）data/forbidden-words.json— 四类违禁词库（绝对化/保证承诺/命题关联/受益者背书，含替换建议）references/workflow.md— 9 阶段详细工作流（访谈问题清单、迭代与快照命令）references/compliance.md— 广告法四大类对照表、双减拦截规则、ICP 备案前置审批分流表references/seo-playbook.md— 关键词矩阵方法、着陆页配方、百度收录清单、搜一搜适配、GEO 要点references/wordbanks.md— 三品类关键词词库（quality/career/hobby）
关键约束
- 所有脚本零第三方依赖，Python 3.8+，跨平台；
- 禁止编造师资资质编号、案例成绩、录取结果；案例必须脱敏且获授权；
- 表单线索 V1 通道 = mailto 至机构邮箱（form.js 中 LEAD_MAIL 由 build 注入），
提醒用户线索双轨：邮件 + 台账补录； - CloudStudio 链接仅作演示/过渡，正式运营需用户自有备案域名（校外培训类需教育部门前置审批）。
