00 · 教程目录说明

多城市站群 CMS 教程目录，按安装、分站、内容、AI、SEO、模板、上线的顺序组织。

软件简介

本程序定位为「多城市站群 CMS」。

一个业务站点可以绑定多个域名，批量生成大量「城市分站」，并共享产品、新闻、案例等内容。

前台会按访问域名自动识别城市，再通过模板标签替换为对应城市的 SEO 与文案。

本目录共 8 个教程文件

序号	文件名
01	00-教程目录说明
02	01-环境搭建与安装登录
03	02-站群核心配置与生成分站
04	03-内容管理全功能
05	04-AI功能全套
06	05-SEO插件与站点设置
07	06-模板门户与系统管理
08	07-前台访问与完整上线流程

建议阅读顺序

先看 01，完成环境搭建和登录。
再看 02，做出城市分站。
然后按需查看 03～06，处理内容、AI、SEO 和模板相关操作。
最后看 07，完成前台访问与整体流程验收。

重要提醒

提示：操作前先确认站点和 Worker 状态

1. 多数运营操作前，先在后台顶部切换「当前站点」。

2. 生成分站、AI 写文、标题繁衍、每日新闻等功能，必须先启动 Worker，具体操作见 01。

常见问题与解决方案

Q1：不知道从哪一篇开始看？

A1：按顺序看。先 01 搭好并能登录，再 02 做出分站，内容、AI、SEO 按需看 03～06，最后用 07 验收。

Q2：打开后台很多菜单点进去都提示“请先选择站点”？

A2：先在后台顶部切换「当前站点」。多数运营功能都按站点隔离。

Q3：生成任务 / AI 写文一直没进度？

A3：先看 01 里的 Worker 是否已启动；服务器重启后需要重新开 Worker。

Q4：教程里的菜单名和我后台不完全一样？

A4：以你安装后的左侧菜单为准；如果角色权限不足，部分菜单会隐藏，可用超管账号对照。

01 · 环境搭建与安装登录

本篇包含环境准备、依赖安装、Web 安装向导、后台登录与站点切换、Worker 进程。

环境准备依赖安装 Web 安装后台登录 Worker 启动

一、环境要求

提示：先确认 PHP、数据库和 Web 根目录配置，再进入安装流程。

项目	要求
PHP	PHP >= 8.2，建议扩展：`json`、`pdo`、`pdo_mysql`、`mbstring`、`openssl`、`curl`、`fileinfo`
MySQL	MySQL >= 5.7，字符集使用 `utf8mb4`
依赖工具	`Composer`
Web 服务器	`Nginx` / `Apache`，网站根目录必须指向项目 `public` 目录
可选项	`Redis`，开启限流时需要

二、安装依赖与配置 `.env`

进入项目根目录，也就是包含 composer.json 的那一层。
执行 composer install。如果版本提示不匹配，可以使用 composer install --ignore-platform-reqs。
确认已经生成 vendor 目录。
复制 .example.env 为 .env，至少修改 DB_HOST、DB_NAME、DB_USER、DB_PASS、DB_PORT、DB_PREFIX。
后台路径可改，默认配置如下：

[EASYADMIN]

ADMIN=admin

访问地址即为：http://你的域名/admin

上线后建议将 APP_DEBUG=false。
Web 配置要点：运行目录指向 public，开启伪静态到 index.php，并确保 runtime/ 与 public/storage/ 可写。

说明：根目录不要直接指向项目目录，否则静态资源和入口路由都会出问题。

三、Web 安装向导

浏览器访问 http://你的域名/install。如果已经存在 config/install/lock/install.lock，说明系统已安装。
通过环境检测。
填写数据库信息和表前缀，默认前缀为 ea8_。
填写后台后缀、管理员用户名和密码。密码留空时多为默认 123456，安装完成后务必修改。
开始安装，等待 SQL 导入完成。
进入后台 http://你的域名/admin，或者你自定义的后缀地址。

四、后台登录与站点切换

输入用户名和密码登录，如果开启了 CAPTCHA，还需要填写验证码。
登录后，在顶部切换“当前站点”，这一步非常重要。
未选择站点时，生成规则、AI、内容等页面会提示“请先选择站点”。
不同角色看到的菜单不同，包括超管、代理、商户，具体由授权和角色权限决定。

五、启动 Worker（异步任务必备）

不启动 Worker，城市分站生成、标题繁衍、每日新闻、AI 内容生成等功能都会卡住。

Windows

进入项目根目录。
双击 worker.bat。
会弹出 BuildWorker、TitleFissionWorker、DailyNewsWorker、TaskWorker 窗口。
保持窗口不要关闭。

命令行 / Linux

php think build:worker
php think title_fission:worker
php think daily_news:worker
php think task:worker

也可以使用 worker.sh；生产环境建议交给 Supervisor 守护。

日志目录：runtime/log/。服务器重启后，需要重新启动 Worker。

检查方法：创建生成任务并启动后，进度应持续增加；如果一直不动，通常是 BuildWorker 没有启动。

常见问题与解决方案

Q1：页面 500、打不开，或提示找不到类、缺少 vendor？

A1：确认已执行 composer install 且存在 vendor 目录；检查 PHP 是否为 8.2 及以上，并确认 pdo_mysql 等扩展已启用；同时确认网站根目录指向 public。

Q2：样式丢失，CSS / JS 404？

A2：网站运行目录必须是 public，不要把项目根目录当成网站根；再检查 /static 是否可访问。

Q3：访问 /install 提示已安装或进不去安装页？

A3：如果已存在 config/install/lock/install.lock，就表示已经装过了。确需重装时再删除该文件，但会有数据风险，先备份数据库。

Q4：安装失败或数据库连接失败？

A4：核对 .env 和安装页里的 DB_HOST、库名、账号密码、端口；确认数据库已创建且字符集为 utf8mb4；再检查服务器是否能连上 MySQL。

Q5：登录后提示请先选择站点，很多功能不能用？

A5：先在后台顶部切换当前站点；如果还没有站点，就按教程 02 创建站点并绑定域名。

Q6：忘记管理员密码？

A6：使用有权限的账号在“用户管理”里重置；或者由运维在数据库中重置管理员密码，再重新登录并立刻改密。

Q7：生成任务或 AI 一直卡住不动？

A7：确认 worker.bat 或四条 Worker 命令正在运行；查看 runtime/log/ 的报错；Windows 下不要关闭对应的 CMD 窗口；服务器重启后需要重新启动 Worker。

Q8：worker.bat 一闪而过或提示找不到 php？

A8：把 PHP 加入系统 PATH，或者把 worker.bat 里的 PHP_BIN 改成 php.exe 的完整路径后再运行。

提示：安装完成后，先登录后台，确认当前站点和 Worker 状态，再继续后续教程。

02 · 站群核心流程

2.站群核心配置与生成分站

本篇按授权、权限、域名、站点、城市、关键词池、生成规则、站点模板、生成任务、城市分站、链接导出的顺序整理。按步骤完成后，即可进入批量出站流程。

授权与权限域名与站点城市数据关键词池规则与模板任务与导出

提示：这部分是批量出站的主流程。继续操作前，建议先确认当前站点、授权状态和 Worker 状态，避免任务创建后无法执行。

一授权管理

使用超管账号登录后台，打开「授权管理」。
按页面提示执行绑定、刷新或解绑操作；解绑会影响授权状态，操作前先确认。
授权决定套餐能力与配额，包括站点数、分站数、文章数等。
授权文件一般位于 runtime/license/，备份系统时建议一并保留。

二用户角色与权限

在「用户管理」中添加账号、分配角色，并设置配额，包括最大站点数、分站数和文章数。
在「角色管理」中勾选该角色可访问的菜单与操作节点。
菜单和节点安装后通常已经齐全，非开发场景不要随意删除。
至少保留一个可用超管账号，避免权限配置错误后无法恢复。

三域名管理

添加根域名，例如 meixiaozhu.cn，并设置 HTTPS、备案号等信息。
如需主域展示门户页，可开启「主域门户」并选择门户模板，相关配置见教程 06。
如果系统要求域名归属，按页面将域名分配给对应用户。
配合完成 DNS、Web 与 SSL 配置，确保域名可以被服务器正确接管。

DNS 解析

A / CNAME 解析到服务器；大规模分站建议做泛解析：*.meixiaozhu.cn → 服务器 IP。

Web 与 SSL

Web 配置和 SSL 证书需要同时覆盖主域名与泛域名，否则分站生成后也可能无法访问。

四站点列表

点击「添加」。
填写基础信息：站点名称、主关键词、描述、Logo、绑定域名。
填写企业信息：公司名称、联系人、电话、地址、邮箱等。
状态选择「启用」并保存，系统通常会部署默认整站模板。
保存后立刻到后台顶部切换为该站点，再继续后续配置。
站点数量受授权与用户配额限制。

五城市管理

安装时通常已预置大量省、市、区县、街道数据。
可按需搜索、增补或修正拼音；路由规则中可能会用到拼音字段。
不要随意删除已经被分站引用的城市，避免分站数据异常。

六关键词池

切换到当前站点后，再打开「关键词池」。
添加关键词，或按页面功能批量导入关键词。
确认关键词类型：substation 用于城市分站生成，news 用于新闻或标题繁衍。
创建生成任务前，先确认已有足够的 substation 关键词。

七生成规则

规则要求：每个站点通常配置一条生成规则，创建后必须保持「启用」。规则只影响之后新生成的分站，已有分站需要另行编辑或覆盖生成。

切换到目标站点后，打开本页。
填写生成规则，支持一行一条，生成时会随机取一行。
配置标题规则，例如 {城市}{随机关键词}厂家。
配置服务主题规则、关键词规则和描述规则。
配置路由规则。系统会固定保留 {site_id}-{short_id}.{root_domain}，建议只调整前缀。
设置随机串长度，默认值为 4。
参考页面「常用标签」填写变量，例如 {城市}、{省}、{市}、{随机关键词}、{站点名称}。
确认无误后点击保存。

八站点模板

母版目录：public/template/

在模板市场启用需要的模板，并设置默认模板与权重。
进入「模板配置」，开关导航和板块，并填写 slogan 等字段。
母版更新后，可使用「同步母版」同步到站点副本。
可使用「批量应用」把某个模板套到已有分站。
生成任务中可选择随机按权重、固定模板，或覆盖时保留原模板。

九生成任务（批量出站）

前置检查：已选站点、已绑域名、规则已启用、有关键词、BuildWorker 已启动、未超出配额。

点击「添加」。
填写基本信息：任务名称、类型选择「生成城市分站」、城市层级选择省 / 市 / 区县 / 街道、设置轮次，并查看预估数量。
设置城市范围：可按层级全部生成，也可指定城市 ID 后展开下级。
配置高级设置：生成间隔、是否覆盖、模板策略。
确认创建后，回到列表点击「启动」。
任务执行中可查看日志；需要时可执行「停止」或「重新开始」。
注意：任务写入的是分站数据，包括标题、TDK、route_url、模板，不是生成静态 HTML 文件。

十城市分站

在列表中查看、搜索或编辑单条分站数据，包括标题、关键词、描述、服务主题、route_url、模板和状态。
删除操作要谨慎；如果页面存在「清空」类操作，风险更高，执行前先备份。
访问方式仅支持主机名访问，例如 xxx.meixiaozhu.cn，不再支持 /城市/ 路径型访问。
同一内容库下，不同分站域名看到的城市文案不同，依靠模板标签替换实现。

十一链接导出

按关键词、时间等条件筛选，具体筛选项以页面实际功能为准。
导出 CSV 或下载链接清单。
抽查若干域名是否能正常打开，用于交付验收或提交搜索引擎。

常见问题与解决方案

Q1：无法新建站点，或提示超出配额？

A1：检查授权是否有效、套餐配额与用户「最大站点数」。超管可在用户管理中调整配额，或升级授权。

Q2：创建生成任务失败，或任务大量失败？

A2：逐项检查当前站点是否已绑域名、生成规则是否启用、关键词池是否有 substation 词、城市是否选中、分站配额是否用尽、BuildWorker 是否在运行。再到任务「查看日志」查看具体错误。

Q3：任务进度一直 0% 或待处理？

A3：通常是 BuildWorker 未启动。按教程 01 运行 worker.bat 或 php think build:worker。

Q4：分站 route_url 已生成，浏览器打不开？

A4：这是 DNS 或 Web 配置问题，不是生成失败。重点检查泛解析 *.域名 → 服务器 IP、Nginx server_name 是否包含泛域名、SSL 证书是否覆盖、站点是否已绑定该根域。

Q5：生成出来的标题或域名不符合预期？

A5：到「生成规则」调整标题规则与路由前缀后重新生成。已有分站需要开启覆盖，或手工编辑；同时确认关键词池词库是否合适。

Q6：所有分站皮肤都一样，想随机换模板？

A6：在「站点模板」启用多套模板并设置权重；生成任务高级设置选择「随机（权重+定向）」。已有分站可使用批量应用，或编辑单条 template_key。

Q7：链接导出是空的？

A7：当前站点还没有分站，或筛选条件过严。先确认城市分站列表中已有数据，再执行导出。

Q8：换服务器后授权失效？

A8：到授权管理点击「刷新」；如果仍失败，按厂商流程重新绑定，并确认 runtime/license/ 文件仍然存在。

03 · 内容管理全功能

本篇覆盖后台「内容管理」下的全部模块。操作顺序保持一致即可：先切换当前站点，再维护内容，最后回到前台检查缓存和展示结果。

共同规则

先切换当前站点；内容在全站分站共享，标题和正文可写 {城市} 等标签。

更新检查

改完如果前台没有变化，到「站点设置」清理前台缓存，再刷新页面。

内容范围

分类、产品、新闻、案例、单页、合作伙伴、FAQ、优势、场景、企业实力、核心产品与服务、可信资料。

共同规则

提示：内容全站分站共享，标题或正文中可以写 {城市} 这类标签，前台会按分站自动替换。

规则项	说明
当前站点	所有内容维护前，先切换到正确的站点。
标签替换	标题、正文可使用 {城市} 等占位标签，前台按分站替换。
缓存刷新	修改后若前台未更新，到「站点设置」清理前台缓存。

一、分类管理

添加分类时填写名称、上级、排序和状态。
如果表单区分产品、新闻等类型，先选对分类类型。
分类支持 SEO 配置；删除前先把该分类下的内容处理完。

二、产品管理

添加产品时填写标题、分类、封面、简介、详情、排序、推荐、状态和 SEO。
前台在分站域名下的 /product/ 路径验证展示效果。
图片统一走系统上传，避免外链失效。

三、新闻管理

手工添加时填写标题、分类、封面、摘要、正文、发布时间、状态和 SEO。
也可以使用 AI 内容生成、标题繁衍或每日新闻自动写入，具体见 04。
标题写入 {城市} 后，各分站打开会显示对应城市名。
AI 文章量大时，建议定期人工抽检。

四、案例管理

添加案例标题、分类、封面、项目信息、详情、排序、状态和 SEO。
标题可写成 {城市}+项目类型，配真实图片更有说服力。

五、单页管理

用于维护独立单页，例如服务说明、隐私政策等。
填写标题、标识/别名、正文、SEO 和状态。
标识不要随意修改，它通常要和模板或路由约定保持一致。
关于、联系等页面在部分模板里可能走固定路由 about、contact。

六、合作伙伴

添加名称、Logo、链接、排序和状态。
需要在「站点模板 → 模板配置」开启对应板块后才会显示。

七、FAQ 常见问题

添加问题、答案、分类（如果有）、排序和状态。
问答中可使用 {城市}；问题尽量写成用户真实搜索句式。
前台可在 /faq/ 验证，部分模板首页也会展示 FAQ 片段。

八、企业优势

添加标题、简介、图标/图片、排序和状态。
每条只表达一个卖点，建议控制在 4 到 8 条。
确认模板里的优势板块已经开启。

九、应用场景

添加场景名、说明、配图、排序和状态。
场景名尽量具体，例如“学校操场”，不要只写空泛概念。

十、企业实力

添加标题、数值/说明、图片、排序和状态。
数据必须真实可核对。

十一、核心产品与服务

添加名称、简介、图标、链接，链接可直接指向产品详情页，再设置排序和状态。
它和「产品管理」不同，这里是首页核心服务摘要卡，适合少而精的展示。

十二、可信资料

添加资料名、说明、证书或检测报告图片、排序和状态。
敏感信息要打码，模板里的信任板块也需要开启。

常见问题与解决方案

Q1：后台已添加内容，前台看不到？

A1：先确认是否选对当前站点，再检查内容状态是否为“启用/发布”，然后看站点模板里对应板块或导航是否开启，最后到站点设置里清理前台缓存并刷新。

Q2：标题里的 {城市} 没有变成城市名，还是原文？

A2：必须用分站域名访问才会替换。主域名或不匹配的主机名不会按分站规则替换，同时要确认写法是半角花括号 {城市}。

Q3：上传图片失败？

A3：检查 public/storage/ 是否可写、上传大小限制是否满足要求、文件类型是否在允许列表内；如果开启了 OSS，再核对云存储密钥和 Bucket 配置。

Q4：删了分类后相关内容异常？

A4：删除分类前，应先把内容改挂到其他分类。若已经误删，可以从备份恢复，或者重新建立分类后再关联内容。

Q5：合作伙伴 / 优势 / 场景等有数据但不显示？

A5：这类内容依赖模板板块开关。到「站点模板 → 模板配置」开启对应 section，保存后清缓存。

Q6：关于我们、联系我们找不到单页？

A6：部分模板走固定路由 /about、/contact，不一定走单页管理。先确认模板导航链接指向哪里，再决定修改单页还是修改站点企业信息。

Q7：AI 生成的新闻在哪里？

A7：在「新闻管理」里查找；如果生成时选的是“仅预览”，内容不会入库，需要重新生成并选择写入内容库。

完成本篇后，先检查当前站点、前台缓存和模板板块开关，再继续后续内容维护。

04 · AI 功能全套

本篇覆盖后台 AI 相关功能，包括 AI 配置、内容生成、标题池、标题繁衍、AI 生图和调用日志。操作前先确认当前站点、密钥和 Worker 状态，避免任务提交后无响应。

AI 配置

内容生成

标题池

标题繁衍

AI 生图

调用日志

总前置

提示：AI 功能依赖站点、密钥和 Worker。任何生成类任务无结果时，优先检查这三项。

当前站点 后台顶部已切换到需要操作的站点。

密钥状态 AI 配置里的 API Key 已填写，并且密钥检测通过。

Worker 状态 按功能启动对应 Worker，具体启动方式见 01。

TaskWorker：用于内容生成等异步任务。
TitleFissionWorker：用于标题繁衍任务。
DailyNewsWorker：用于每日新闻自动产文。

一、AI 配置

隔离规则：提示词、模型、开关按站点隔离；API Key 按账号隔离，同一账号下的多个站点共用。

打开 AI 配置，确认页面顶部的站点和当前账号正确。
在「基础配置」中开启 AI 开关，并将状态设为启用；按需调整温度、最大 Token、超时时间等参数。
在「模型选择」中选择文本模型和生图模型。
在「账号密钥」中填写 API Key，然后点击「检测密钥」。
在「场景提示词」中分别配置内容生成、标题繁衍、每日新闻等提示词。
变量按页面说明填写，例如 {keyword}、{site_name}、{count}；不要把全套前台城市标签都塞进提示词。
如需使用「每日新闻」，开启后设置每日配额和目标分类。
保存配置后，可查看今日、本月和总调用统计。

二、内容生成

填写主题关键词；如果留空，系统会从标题池取未使用标题。
选择目标分类和生成条数，通常建议一次生成 1～5 篇。
选择写入方式：「是」表示入库，「仅预览」表示不写入内容库。
点击「开始生成文章」，等待异步任务完成。
文章入库后，到「新闻管理」检查内容并按需微调。

常见卡点：一直无结果时，优先检查 TaskWorker 是否启动、密钥是否有效、额度是否充足。

三、标题池

可以手工添加标题，也可以由标题繁衍任务自动写入。
定期查看未使用和已使用状态，清理低质、重复标题。
内容生成未填写主题关键词时，会消耗标题池中的未使用标题。
建议保持一定数量的「未使用」标题，避免生成任务无主题可取。

四、标题繁衍

前置条件：AI 已配置；关键词池中已有 news 类型关键词；TitleFissionWorker 已启动。

添加任务，设置目标数量、分类和是否自动发布。
在任务列表中点击「启动」，需要时可执行停止或重新开始。
任务完成后，到标题池或新闻管理中核对结果。
建议先小批量试跑，确认标题质量后再放大数量；提示词统一在 AI 配置中调整。

五、AI 生图

在线生成时，填写画面描述，并按页面选项选择尺寸和风格。
生成后可入库，也可复制图片地址到新闻或产品编辑页使用。
图库中可删除无用图片。
生成失败时，先检测密钥，再到调用日志查看失败原因。

六、AI 调用日志

按时间、站点、场景和状态筛选调用记录。
查看失败原因，例如鉴权失败、超时、内容风控等。
对照 AI 配置页的调用统计；如果发现异常调用量，及时停止相关任务并排查来源。

常见问题与解决方案

Q1：密钥检测失败，或调用日志显示鉴权失败？

A1：核对 API Key 是否复制完整、是否过期；确认 AI 开关与状态为开启/启用；切换到正确账号登录，Key 按账号隔离。

Q2：点击「开始生成文章」后一直转圈或无结果？

A2：确认 TaskWorker 已启动；到调用日志查看错误；检查额度、网络出站和超时时间是否过短。

Q3：标题繁衍任务不跑？

A3：启动 TitleFissionWorker；确认关键词池有 news 类型词；AI 配置和提示词已保存；任务列表中已点击「启动」。

Q4：每日新闻没有自动产文？

A4：确认 AI 配置里的「每日新闻」已开启，并已设置配额和分类；DailyNewsWorker 正在运行；未超文章配额；调用日志无失败记录。

Q5：生成质量差、文不对题？

A5：把主题词写具体；在「场景提示词」中明确行业、语气和结构要求；温度不要过高；批量放大前先人工抽检。

Q6：生图失败或没有封面？

A6：确认已选择生图模型，且密钥支持生图；检查是否开启自动配图；到调用日志查看风控或额度错误；提示词避免违禁内容。

Q7：标题池空了，内容生成提示无主题？

A7：手工往标题池添加标题，或先运行标题繁衍；内容生成时也可以直接填写「主题关键词」。

Q8：调用量突然暴涨、费用异常？

A8：立刻停止标题繁衍、生成任务和相关 Worker；查看调用日志定位来源；检查目标数量是否过大，或任务是否重复启动。

完成本篇配置后，建议按「配置页统计 → 调用日志 → 新闻管理或标题池」的顺序复查一次，确认任务真实完成、内容已入库、调用量符合预期。

05 · SEO、插件与站点设置

本篇包含页面 SEO、蜘蛛日志、插件管理、站点设置和运行时配置。操作顺序保持一致：先切站点，再改配置，最后清缓存并验证前台结果。

页面 SEO 蜘蛛日志插件管理站点设置运行时配置

提示： 这几项大多是站点级操作。先确认当前站点，再保存配置；如果前台没有变化，优先清理前台缓存。

模块	菜单位置	核心作用
页面 SEO	运营管理 → 页面 SEO	按页面类型配置 title、keywords、description、extra_head。
蜘蛛日志	运营管理 → 蜘蛛日志	查看抓取记录，辅助判断站点是否被蜘蛛访问。
插件管理	运营管理 → 插件管理	统一控制客服、返回顶部、公告条、侧边广告条、阅读进度条。
站点设置	运营管理 → 站点设置	配置统计代码、页脚 HTML、维护模式、水印等。
运行时配置	系统管理 → 运行时配置	调整缓存、CDN、生成间隔和批次大小等运行参数。

一、页面 SEO

菜单位置： 运营管理 → 页面 SEO

切换到当前站点后再打开页面 SEO。
按页面类型填写 title、keywords、description 和 extra_head。
可使用标签 {城市}、{分站标题}、{站点名称}、{主关键词} 等。
保存后到前台查看源代码，确认字段已经生效。
优先级大致为：内容自身 SEO > 分站字段 > 分站/全站 SiteTdk > 站点名称等。
如果页面有缓存，先清理前台缓存再验证。

二、蜘蛛日志

菜单位置： 运营管理 → 蜘蛛日志

按时间、蜘蛛类型、URL 等条件筛选抓取记录。
结合链接导出，抽查重要分站是否已经被抓取。
相关前台地址包括 /sitemap.xml、/robots.txt 和 /llms.txt。
日志会持续增长，建议定期清理历史数据。

三、插件管理

菜单位置： 运营管理 → 插件管理。这里是站点级配置，全部分站共享。

客服组件

配置入口、联系方式和展示位置。

返回顶部

设置按钮样式和显示方式。

公告条

配置文案与开关状态。

侧边广告条

填写广告图和跳转链接。

阅读进度条

显示文章阅读进度。

逐个开启需要的组件，并把对应内容填完整。
保存后分别在 PC 和手机端验证一次。
不要让组件过度遮挡正文内容。

四、站点设置

菜单位置： 运营管理 → 站点设置

配置统计代码、页脚补充 HTML、维护模式、水印等内容。
保存设置。
如果内容或模板刚改完，前台还是旧效果，点击“清理前台缓存”。
统计代码只使用官方脚本；维护模式不要误开。

五、运行时配置

菜单位置： 系统管理 → 运行时配置（以实际菜单为准）

可调整项	说明
前台缓存 TTL	控制前台缓存保留时长。
CDN	配置静态资源加速地址。
生成间隔 / 批次大小	影响生成任务的速度和资源占用。

批次过大可能打满 CPU 或内存。
CDN 配错会直接导致静态资源 404。
修改前先记下原值，便于回滚。

常见问题与解决方案

Q1：改了页面 SEO，前台 title 没变？

先到“站点设置”里清理前台缓存，再用分站域名打开查看源代码。如果内容自身也填写了 SEO，可能会被更高优先级覆盖。

Q2：{城市} 写在 TDK 里不替换？

请使用城市分站域名访问，主域门户页不一定走分站替换逻辑。标签写法要使用半角 {城市}。

Q3：客服/公告插件后台开了，前台没有？

先确认当前站点正确、插件已保存开启；再换浏览器强刷，清前台缓存，并检查手机端是否被底部遮挡或未适配。

Q4：整站打不开或提示维护？

到站点设置里检查是否误开“维护模式”，关闭后保存并清缓存。

Q5：统计代码不生效？

确认保存成功且代码完整；用无痕窗口打开前台再检查统计后台；广告拦截插件也可能拦截统计脚本。

Q6：开了 CDN 后样式或图片 404？

检查运行时配置里的 CDN 域名是否正确，是否已回源到本站 static 或 storage；不对就先关闭 CDN 恢复访问。

Q7：蜘蛛日志一直是空的？

可能是蜘蛛还没访问，或者域名未对外可访问。先保证分站可公网访问，提交 sitemap 后再观察；日志过多时可定期清理历史。

Q8：生成任务变得很慢或服务器卡死？

把运行时配置里的生成批次调小、间隔调大，并确认没有重复启动 BuildWorker。

06 · 模板、门户与系统管理

本篇用于处理系统母版、门户模板、主域门户、贴牌设置，以及系统配置、上传文件和日志审计。操作重点是先确认目录与后台菜单对应关系，再执行扫描、启用、同步或配置变更。

模板管理门户模板主域门户贴牌设置系统配置上传与日志

一、模板管理

菜单位置

系统管理 → 模板管理

模板目录

public/template/{模板标识}/

进入模板管理后，先执行扫描或刷新，确认 default、apple、geo 等母版已经被系统识别。
需要自定义模板时，复制一个现有模板目录，再修改 config.json 和对应 HTML 文件，修改完成后重新扫描。
模板识别成功后，到「站点模板」（见 02）中给业务站启用该模板。
直接修改母版会影响后续执行「同步母版」的站点副本；删除正在使用的模板可能导致前台异常，操作前先确认引用关系。

二、门户模板与主域门户

门户模板菜单

系统管理 → 门户模板

域名侧配置

运营管理 → 域名管理

门户目录

public/portal_template/

适用场景

主域名展示公司总门户、地区聚合或专题页；城市分站继续使用整站模板。

在门户模板页执行扫描，确认可用模板已识别，例如 default、air、atlas。
进入域名管理，编辑根域名，开启「主域门户」，选择门户模板，并填写门户 SEO、Banner 等信息。
保存后用根域访问验证：https://meixiaozhu.cn 应显示门户页面。
再访问分站二级域，确认分站仍显示城市站皮肤，没有被门户模板覆盖。

常见门户路径

以下路径以实际路由为准，部署后按当前系统配置验证。

/company /area /topic /login /register /products /articles

三、贴牌设置

菜单位置

系统管理 → 贴牌设置

使用条件

需要代理权限，并且当前授权支持贴牌功能。

填写品牌名称、Logo、品牌链接和页脚文案。
保存后退出并重新登录，检查登录页和后台顶栏是否已经切换为新品牌。
注意：贴牌只影响品牌展示，不等于授权转让。

四、系统配置、上传与日志

配置管理

系统管理 → 配置管理

上传管理

系统管理 → 上传管理

日志管理

系统管理 → 日志管理

本地上传目录

public/storage/

在配置管理中维护站点名、上传限制等系统参数。
在上传管理中查看或删除已上传文件；如需云存储，可按页面配置 OSS、COS 或七牛。
在日志管理中按管理员、时间、操作节点审计记录，用于确认「谁改了什么」。
生产环境关闭 APP_DEBUG；.env 文件和密钥不要公开。

提示：涉及系统配置、上传目录和密钥的操作，建议先确认备份和权限，再在生产环境执行。

常见问题与解决方案

Q1：前台白屏 / 模板报错？

A1：检查分站使用的 template_key 对应目录是否存在，HTML 是否有语法错误；可到站点模板改回默认模板，并查看 runtime/log/ 报错信息。

Q2：改了母版，站点前台没变化？

A2：站点使用的是副本。到「站点模板」执行「同步母版」，再清理前台缓存。

Q3：主域名还是城市站皮肤，不是门户？

A3：在域名管理中确认已开启「主域门户」并选择门户模板；使用根域访问，不要使用分站二级域；清缓存后再验证。

Q4：主域门户开了，分站也变成门户了？

A4：分站应走二级域或独立主机名。检查分站 route_url 是否误写成根域，并核对 DNS 与绑定配置。

Q5：自定义模板扫描不出来？

A5：确认目录位于 public/template/ 下，并且包含 config.json；模板标识目录名不要使用中文或空格，修正后回到模板管理重新扫描。

Q6：贴牌改了不生效？

A6：确认当前账号具备代理权限，且授权支持贴牌；保存后退出重新登录，并强刷浏览器缓存。

Q7：上传到一半失败或图片无法访问？

A7：检查 storage 目录权限；确认本地或 OSS 配置一致；如果使用 OSS，核对域名和公共读权限。

Q8：误删菜单导致后台进不去某些功能？

A8：使用仍可登录的超管恢复菜单，或从安装 SQL / 备份中恢复 ea_system_menu 相关数据；不要轻易删除系统节点。

07 · 前台访问与完整上线流程

本篇整理前台访问方式、常用模板标签、从搭建到上线的主流程，以及上线前必须完成的验收清单。按本篇检查一遍，可确认站群前台是否具备正式访问条件。

一、前台如何访问

城市分站

打开城市分站的完整域名，也就是「城市分站」列表中的 route_url。

主域门户

打开根域名访问主域门户。前提是已开启主域门户功能，相关配置见教程 06。

分站域名下常见路径

路径	页面说明
`/`	首页
`/product/`	产品
`/news/`	新闻
`/case/`	案例
`/faq/`	问答
`/about`	关于
`/contact`	联系
`/area-sites`	地区站点，是否可用取决于当前模板

访问规则提示

SEO 辅助文件可通过 /sitemap.xml、/robots.txt、/llms.txt 验证。当前系统仅支持主机名分站，不再支持 /城市/... 这类路径型城市 URL。

二、常用标签

以下标签可用于标题、正文、SEO 和模板文件。使用时保持半角花括号格式，不要加入多余空格。

站点与联系

{站点名称} {公司名称} {网站logo} {联系人} {联系电话} {联系地址} {联系邮箱} {备案号}

城市 / 分站

{城市} {城市全} {城市拼} {省} {市} {区县} {分站标题} {分站关键词} {服务主题} {主关键词} {分站描述} {route_url}

TDK

{tdk:title} {tdk:keywords} {tdk:description} {tdk:extra_head}

模板常用

{nav:home} {nav:product:link} {navitem:product}...{/navitem:product} {section:product}...{/section:product} {field:slogan} {list:product limit=8}...{/list:product}

快速验证

在新闻标题中写入「{城市}装修材料厂家」，再分别用两个分站域名打开。如果标题显示为不同城市名，说明分站识别和标签替换正常。

更完整的标签清单见项目文件：docs/tags.md。

三、完整上线总流程

A. 搭建

准备运行环境，安装 composer 依赖，配置 .env，并将 public 设为网站根目录（教程 01）。
访问 /install 完成安装，并及时修改管理员密码（教程 01）。
启动 Worker，确保异步任务可以正常执行（教程 01）。
完成系统授权（教程 02）。

B. 站群核心

将域名入库，并配置 DNS 泛解析（教程 02）。
创建站点、绑定域名，然后在后台顶部切换到该站点（教程 02）。
依次配置关键词池、生成规则和站点模板（教程 02）。
创建并启动生成任务，抽查城市分站，再通过链接导出做交付验收（教程 02）。

C. 内容与转化

维护分类、产品、新闻、案例、FAQ 等内容（教程 03）。
配置页面 SEO 和客服等插件组件（教程 05）。
在站点设置中填写统计代码，并按需清理前台缓存（教程 05）。

D. AI 可选

配置 AI，再按需使用标题繁衍、标题池和内容生成（教程 04）。
每日新闻和 AI 生图按业务需要开启；出现问题时优先查看调用日志（教程 04）。

E. 门户与品牌可选

配置主域门户（教程 06）。
按授权能力配置代理贴牌（教程 06）。

四、上线检查清单

APP_DEBUG=false 已配置。
HTTPS 正常，泛域名证书覆盖分站域名。
Worker 已守护，服务器重启后可自动拉起。
随机打开 5～10 个分站，检查城市替换、联系方式和客服组件。
sitemap.xml 与 robots.txt 可正常访问。
已备份数据库、.env、runtime/license/。

上线结论

以上项目全部通过后，即可完成从环境搭建到日常运营的主路径。细节问题回看教程 01～06 对应章节。

常见问题与解决方案

Q1：访问 meixiaozhu.cn/杭州/ 这类路径打不开？

A1：本系统分站采用「主机名」模式，请使用分站完整域名访问，不再支持路径型城市 URL。

Q2：打开分站显示的不是预期城市，或出现串站？

A2：核对当前访问的主机名是否对应城市分站里的 route_url；同时检查 DNS 是否指向正确服务器，以及是否存在错误的站点绑定。

Q3：标签替换后，城市名旁边仍残留 {城市}？

A3：检查是否使用了全角括号、多余空格或中文花括号；清理缓存后再看，并确认当前是通过分站域名访问。

Q4：sitemap.xml 或 robots.txt 返回 404？

A4：确认伪静态配置正常，请求能够落到 public/index.php；再使用已绑定且能打开首页的域名访问这些路径。

Q5：上线后抽查分站，部分 404、部分正常？

A5：多数情况是泛解析未覆盖或证书问题。可在服务器上 ping 或解析对应主机名，再检查 Nginx 泛域名配置与 SSL。

Q6：总流程做完，生成任务成功，但外网不能访问？

A6：生成任务只写入数据库。外网访问还需要公网 IP、防火墙放行 80/443、域名解析、Web 虚拟主机和 HTTPS。相关步骤回看教程 01、02。

Q7：不知道问题应该回看哪一篇教程？

A7：装不上或登不上看 01；出不了分站看 02；内容不显示看 03；AI 不执行看 04；TDK、插件、缓存问题看 05；皮肤和门户问题看 06；访问方式与标签问题看本篇。

菜单：系统管理 → 用户管理 / 贴牌设置 / 授权管理

代理版与商户版（用户管理 + 贴牌）

这一部分只看三个点：授权包决定是否开放代理模式和商户模式，角色决定谁能看到哪些菜单，配额决定站点、分站、文章和模板能用到多少。配额在用户管理里设置，0 表示不限。

授权包角色权限配额管理贴牌设置域名分配

授权包

控制是否开启「代理模式 / 商户模式」，不负责限制能建多少站。

角色

区分超管、代理、商户，决定菜单显示范围，以及能管理哪些下级账号。

配额

站点、分站、文章、模板上限都在用户管理里设，填 0 表示不限制。

权限对照

角色	权限范围	限制说明
超管	可开代理和商户、分配任意域名、设置配额、绑定授权	不受配额限制
代理	只能开商户；域名只能从自己的池里再分；可设置商户配额；可贴牌	代理配额按“自己 + 全部下级”合计
商户	不能开户、不能贴牌；只使用分到的域名建站	受自己配额限制

超管准备

提示：先把授权和域名准备好，再创建代理账号。域名管理里的根域名要先录入，DNS 泛解析按教程 02 处理。

授权管理：绑定「代理 + 商户」包，确认代理模式和商户模式都已开启。
域名管理：录入根域名，后续分配域名时直接从这里出。

超管开代理

基本信息：进入用户管理添加账号，填写账号、密码，角色选「代理」，状态设为启用。
归属信息：上级一般选「无」，并勾选域名分配。
配额与有效期：有效期留空表示永久；站点、分站、文章、模板上限按需填写。
贴牌设置：只有代理会出现这一项，可填写品牌名、Logo、官网和页脚，也可以让代理后续自行修改。
保存交付：保存后把账号交给代理，并及时改密。

日常操作包括编辑配额、续期、调整域名和重置密码；删除代理前，先把下级商户处理完。

代理开商户

基本信息：代理登录后进入用户管理添加账号，角色只选「商户」，状态保持启用。
归属信息：上级会自动指向当前代理，从自己的域名池里勾选分给商户。
配额与有效期：单独给商户设置，商户占用的额度会计入代理总额。
保存交付：保存后把账号交给商户，并要求首次登录后改密。

代理只能看到自己的下级；可以继续改配额、续期、域名、禁用账号和重置密码。取消商户域名勾选时，可能会清掉站点绑域，操作要谨慎。

贴牌（白标）

谁能改：仅代理，或者超管在编辑该代理账号时填写。商户不能改，默认继承上级代理品牌。

菜单位置：系统管理 → 贴牌设置；也可以从用户管理里编辑代理账号，进入「贴牌设置」Tab。
填写内容：品牌名称、品牌 Logo、品牌官网、品牌页脚。
保存效果：代理和下级商户重新登录后，登录页和后台顶栏会显示新品牌。

注意：贴牌不等于授权转让。Logo 建议使用透明底 PNG。

商户怎么用

登录后先改密码，正常情况下不会看到用户管理、贴牌和授权菜单。
按照教程 02 到 05 完成建站、内容和 SEO 配置。
如果超出配额或已经过期，直接找代理或超管调整配额、续期。

开户顺序

按这个顺序走，基本不会乱：

超管：授权 → 录域名 → 开代理（域名 + 配额 + 可贴牌）→ 交账号。
代理：贴牌设置 → 开商户（再分域名 + 配额）→ 交账号。
商户：登录 → 建站运营。

常见问题

Q1：代理 / 商户登不上？

A1：先检查授权是否开了对应模式，再看账号是否启用、是否过期。

Q2：代理只能开商户，开不了代理？

A2：这是正常的，开代理需要超管操作。

Q3：给商户分域名时是空的？

A3：先由超管给该代理勾选域名，代理才能继续下分。

Q4：提示超出站点 / 分站 / 文章上限？

A4：提高商户配额，并检查代理总额是否已经满了。

Q5：取消域名后站点异常？

A5：会级联回收并可能清绑域，先通知后再操作，必要时重新分配域名。

Q6：贴牌不生效 / 商户仍显示总品牌？

A6：确认改的是代理贴牌，保存后双方重新登录，并强刷缓存。

Q7：配额填 0？

A7：表示不限制。

Q8：商户想再开子账号？

A8：商户不能开下级。可以再开一个商户号分同域，也可以共用账号。

TEMPLATE DEVELOPMENT

自定义模板开发与标签手册

本篇用于说明分站模板、门户模板与站点副本的目录关系，并整理模板创建流程、配置文件、模板语法、常用变量及排错方法。

分站模板 public/template/{key}/

门户模板 public/portal_template/{key}/

站点副本 public/site/{站点ID}/template/{key}/

分站前台优先读取此目录。

模板管理 / 门户模板：扫描 → 站点模板：启用 → 域名管理：选择门户

一、新建模板

复制默认模板目录 将 default 目录复制一份，并改为英文模板标识，例如 mybrand。目录名不要使用中文或空格。
修改配置与页面文件 编辑 config.json，确保其中的 key 与模板目录名完全一致，然后再修改所需的 HTML 和 CSS。
扫描并启用模板 在后台重新扫描模板，再到「站点模板」中启用。门户模板需要在「域名管理」中开启主域门户并选择对应模板。

必须包含的文件

config.json index.html public/head.html public/foot.html

分站常用页面

news_*、product_*、case_*、faq_*、about、contact、area_sites、single

门户常用页面

company_*、news_*、product_*、area_*、topic_*、contact、member_*

二、config.json 配置要点

配置项	作用	使用要求
`key`	模板唯一标识	必须与模板目录名一致
`pages`	定义页面与模板文件的映射关系	对应页面文件必须存在
`nav`	控制导航开关、文案和链接	常用项包括 `home`、`product`、`news`、`case`、`about`、`contact`、`faq`
`sections`	控制首页板块开关	常用项包括 `banner`、`product`、`news`、`case` 等
`fields`	定义后台可填写的模板字段	例如 `theme`、`slogan`、`banner_images`，前台通过 `{$tplFields.xxx}` 读取

三、模板语法

ThinkPHP 模板语法

页面结构、变量输出、条件判断、列表循环和公共文件引入，优先使用 ThinkPHP 模板语法。

{$site.site_name}
{$tdk.title|default=$site.site_name}

{$vo.content|raw}
{$vo.create_time|date='Y-m-d'}

{if $substation}...{/if}

{volist name="hotProducts" id="vo"}...{/volist}

{include file="public/head" /}

{$list->render()|raw}

中文标签语法

城市词、站点信息、导航开关和首页板块开关，可使用中文标签。

站点与联系信息

{站点名称}{公司名称}{联系人}{联系电话}{联系地址}{联系邮箱}{备案号}

城市信息

{省}{市}{区县}{城市}{城市全}{城市拼}

分站与 SEO 信息

{分站标题}{分站关键词}{服务主题}{主关键词}{分站描述}{route_url}{tdk:title}{tdk:keywords}{tdk:description}

导航、板块与字段

{nav:product}{nav:product:link}{field:slogan}

{navitem:product}
...
{/navitem:product}

{section:product}
...
{/section:product}

开关规则：{navitem:product}...{/navitem:product} 用于包裹导航内容，关闭导航后整块删除；{section:product}...{/section:product} 用于包裹首页板块，关闭板块后整块删除。

列表可以直接使用 {volist}。旧写法 {循环:新闻 limit="8"}...{/循环:新闻} 仍然兼容。

四、常用变量与链接

使用范围	常用变量
全局变量	`$site`、`$substation`、`$company`、`$tdk`、`$tplFields`、`$sections`、`$portal`
分站首页	`$hotProducts`、`$hotNews`、`$hotCases`、`$partners`、`$advantages`、`$scenes`、`$faqs`、`$relatedAreaSites`、`$siteChainLinks`
列表与详情页	`$list`（分页）、`$detail`、`$prev`、`$next`、`$related`、`$cateTree`
门户首页	`$portal.banner_*`、`$newsList`、`$productList`、`$companyList`、`$substationList`、`$keywordCloud`、`$regionStats`

门户常用链接

/articles/ /products/ /company/ /area/ /topic/

分站常用链接

/news/ /product/ /cases/ /faq/ /about /contact /area-sites.html

五、可直接使用的模板片段

<title>{$tdk.title|default=$site.site_name}</title>

<body class="{$tplFields.theme|default='default-theme-1'}">

{navitem:product}
<a href="{nav:product:link}">{nav:product}</a>
{/navitem:product}

{section:product}

{volist name="hotProducts" id="vo"}
<a href="/product/{$vo.id}">{$vo.title}</a>
{/volist}

{/section:product}

SEO 文案

建议使用 {城市全}{主关键词} 组合，不要在模板中写死城市名称。

页脚插件

在页脚模板中加入 {$pluginWidgets|raw}，用于输出已启用的插件组件。

常见问题与解决方案

Q1：自定义模板扫描不到？

确认目录名为英文且不含空格，目录内存在合法的 config.json，并确保 key 与目录名一致，然后重新扫描。

Q2：修改母版后，前台没有变化？

分站需要在「站点模板」中执行「同步母版」；门户模板修改后清理前台缓存。

Q3：同步母版后，自定义样式丢失？

同步操作会覆盖站点副本。需要长期保留的样式应修改母版，不要只修改站点副本。

Q4：导航或首页板块无法关闭？

使用 {navitem:} 或 {section:} 包裹完整内容，不要在模板中写死链接或板块结构。

Q5：切换模板后前台白屏？

检查对应 HTML 文件是否存在、模板标签是否写错，并查看 runtime/log/ 中的错误信息。需要先恢复访问时，可切回 default 模板。

AI 指令分享与模型推荐

AI WORKFLOW · PROMPT LIBRARY 整理适用于文案生成、标题创作、AI 生图和内容运营的提示词模板，并列出当前使用的模型建议。提示词应结合具体业务场景调整，模型选择则应根据任务类…

后续内容已加密

购买本产品后，请联系客服获取解锁密码

00 · 教程目录说明

软件简介

本目录共 8 个教程文件

建议阅读顺序

重要提醒

常见问题与解决方案

01 · 环境搭建与安装登录

一、环境要求

二、安装依赖与配置 .env

三、Web 安装向导

四、后台登录与站点切换

五、启动 Worker（异步任务必备）

Windows

命令行 / Linux

常见问题与解决方案

一授权管理

二用户角色与权限

三域名管理

DNS 解析

Web 与 SSL

四站点列表

五城市管理

六关键词池

七生成规则

八站点模板

九生成任务（批量出站）

十城市分站

十一链接导出

常见问题与解决方案

Q1：无法新建站点，或提示超出配额？

Q2：创建生成任务失败，或任务大量失败？

Q3：任务进度一直 0% 或待处理？

Q4：分站 route_url 已生成，浏览器打不开？

Q5：生成出来的标题或域名不符合预期？

Q6：所有分站皮肤都一样，想随机换模板？

Q7：链接导出是空的？

Q8：换服务器后授权失效？

03 · 内容管理全功能

共同规则

一、分类管理

二、产品管理

三、新闻管理

四、案例管理

五、单页管理

六、合作伙伴

七、FAQ 常见问题

八、企业优势

九、应用场景

十、企业实力

十一、核心产品与服务

十二、可信资料

常见问题与解决方案

04 · AI 功能全套

总前置

一、AI 配置

二、内容生成

三、标题池

四、标题繁衍

五、AI 生图

六、AI 调用日志

常见问题与解决方案

Q1：密钥检测失败，或调用日志显示鉴权失败？

Q2：点击「开始生成文章」后一直转圈或无结果？

Q3：标题繁衍任务不跑？

Q4：每日新闻没有自动产文？

Q5：生成质量差、文不对题？

Q6：生图失败或没有封面？

Q7：标题池空了，内容生成提示无主题？

Q8：调用量突然暴涨、费用异常？

05 · SEO、插件与站点设置

一、页面 SEO

二、蜘蛛日志

三、插件管理

客服组件

返回顶部

公告条

侧边广告条

阅读进度条

四、站点设置

五、运行时配置

二、安装依赖与配置 `.env`

内容已加密

你的前景，远超我们想象