CITY CLUSTER SYSTEM · 城市站群系统

城市站群系统

一台服务器、一套后台，即可统一管理全国城市站群。当传统方式仍在逐个建站、修改模板、发布文章时，这套系统已经进入批量生成、集中运营和队列化执行阶段。

系统定位：面向规模化建站与内容生产，将“一个行业 × 多个城市”的业务需求，转化为可批量生成、统一管理、持续运行的分站生产流程。

这套系统能做什么？

它可以将“一个行业 × 几百个城市”的需求，批量生成几百甚至上千个独立落地页，不再按城市逐个手工制作。系统内置能力如下。

▦

全国城市库

系统内置省、市、区县、街道四级行政区划数据。需要覆盖到哪个层级，直接在生成规则中选择并向下展开即可。

↗

批量生成

后台点击“提交入队”后，任务进入执行队列，由底层 Worker 进程持续处理，无需反复刷新页面，也不需要人工盯守。

◫

双模式生成

支持公共模板模式与 AI 分站内容模式，既能快速开站，也能为每个分站生成独立正文，降低内容重复度。

公共模板模式

适合新手。配置一套模板后即可快速开站，所有分站共用版式，生成速度快。

AI 分站内容模式

支持“一站一文”。配合标题池自动分配标题，为每个分站生成独立正文。

◇

内容素材体系

后台内置关键词池、标题池、媒体库、产品服务和标签管理等模块。素材准备越完整，生成页面的结构和展示效果越自然。

⧉

代理与商户体系

支持开设代理账号，再由代理创建商户账号。权限、配额和域名可按层级分配，便于扩展为代理分销业务。

◆

贴牌（OEM）

后台支持替换 Logo、品牌名称和页脚文案。贴牌完成后，客户登录看到的是自己的品牌后台，更适合产品化交付。

⌁

域名统一管理

在后台添加根域名并绑定站点后，系统会自动处理分站 URL 拼接。访问协议可统一配置为 HTTP 或 HTTPS。

AI 内容与图片生成

接入大模型 API 后，可生成首页模板 HTML、分站正文和图片。系统负责生成，运营侧主要负责检查、调整和验收。

◎

任务看板与推送队列

生成、推送和导出流程均有对应任务页面。任务执行进度、报错信息和待处理项，都可以集中查看与处理。

预期结果：当别人还在 WordPress 中复制页面、逐个修改城市名称时，你已经可以执行“计算页面数量 → 小范围试跑 → 全量生成”的标准流程。

核心优势

这不只是一套建站程序，更像是一条城市流量内容生产线。优势主要集中在覆盖效率、内容生产和自动化运行三个方面。

多层级批量覆盖

一个商户、一套生成规则和一批词库配置完成后，即可批量生成城市分站，快速扩大业务覆盖范围。

覆盖颗粒度更细

除了市级页面，还能继续覆盖区县和街道层级，为更多本地化长尾搜索词提供对应入口。

独立内容生产线

在 AI 分站模式下，标题池负责分配标题，提示词负责约束内容，可实现每城一页、每页内容不同。

代理业务形成闭环

支持“总后台 → 代理 → 商户”的管理层级，可分别控制模块权限、使用配额和可用域名，方便开展授权和分销业务。

更完整的品牌交付

开启贴牌后，客户看到的是自己的品牌名称、Logo 和后台信息，交付的不再只是通用系统。

支持无人值守运行

底层采用 Swoole 与 Worker 常驻进程处理异步任务和推送队列。大批量任务入队后，可持续在后台执行。

核心总结：手工建站解决的是单个页面；这套系统解决的是批量生产、统一管理和持续运行。

适合哪些用户？

如果业务需要快速覆盖多个地区，或者希望将建站能力产品化交付，这套系统更适合以下几类用户。

SEO

多城市 SEO 与本地服务团队

需要快速铺设本地化落地页，扩大区域搜索流量覆盖范围。

OEM

代理分销与贴牌交付团队

手中已有客户资源，希望销售自己的建站产品，并以独立品牌完成交付。

BUILD

需要快速铺站的业务操盘者

希望在同一行业中缩短建站周期，用较短时间建立大量城市分站。

OPS

重视自动化效率的运营人员

不想逐个城市修改模板，希望通过规则、词库和任务队列减少重复劳动，同时保持页面内容和结构完整。

CITY CLUSTER SYSTEM · 城市站群后台

1. 城市站群后台 · 上手顺序总结

本节用于确定后台首次配置的操作顺序。核心原则是：先把系统运行基础打稳，再配置内容素材，最后再提交批量生成任务。

危险操作

不要一进入后台就点击「批量生成」。环境、授权、域名、站点、规则、模板等前置配置缺失时，后续容易出现提交失败、任务报错或生成空结果。

一、建议总顺序

先基础 · 后内容 · 再生成

确认环境和授权由总后台或管理员完成，先排除扩展、权限、Worker、数据库等底层问题。

配置 AI需要 AI 生成时提前配置；若只走公共模板，可稍后处理。

准备域名在域名管理中添加可用根域名，正式环境建议使用 HTTPS。

开账号并分配资源创建代理或商户账号，分配权限、配额和可用域名。

建立站点并绑定域名站点必须绑定域名，否则无法正常提交批量生成。

配置生成规则和关键词池保证标题、关键词、描述和 URL 能按规则生成。

准备素材配置按模板需要维护媒体库、标签、产品服务等内容素材。

配置首页模板完成提示词、公共模板和站点模板绑定。

配置标题池仅 AI 分站内容模式需要，标题库存必须充足。

调整运行间隔按服务器资源和任务规模设置站点运行参数。

提交批量生成先计算页面数量，再小范围提交测试任务。

验收结果并回改配置查看分站结果、AI 页面任务和推送队列，异常回对应配置页处理。

二、分角色操作指南

按账号职责分工

超级管理员 / 管理员

环境检测：检查扩展、目录权限、Worker 和数据库状态。
授权管理：绑定授权码，并确认授权状态正常。
域名管理：添加可用根域名，建议启用 HTTPS。
AI配置：填写 Key，选择文本模型和图片模型，检测通过后保存。
代理 / 商户管理：开户、勾选权限、设置配额、分配域名。
日常运维：按需清缓存，查看推送队列和各类任务页。

代理

贴牌设置：配置品牌名、Logo、官网和页脚，商户登录后会继承。
商户管理：为客户开通商户账号，分配配额、权限和域名。
AI配置：若账号独立，配置自己的 Key 和模型。
建站协助：其余建站流程与商户类似，也可协助商户完成配置。

商户 / 实际建站人员

账号资料：修改密码，完善联系方式。
站点管理：新建站点，并绑定可用域名。
规则与词库：配置生成规则和关键词池。
素材准备：按模板需要配置媒体库、标签和产品服务。
首页模板：配置并绑定首页模板。
标题池：仅 AI 分站内容模式需要。
生成与验收：批量生成后进入分站结果验收。

三、最小可跑通路径

先跑通闭环

只想先验证流程，可先完成以下最小配置集：

授权状态正常，环境检测无严重失败项。
域名已添加，并处于启用状态。
站点已创建，并成功绑定域名。
生成规则至少保存一份可用配置，包含标题、关键词、描述和路由。
关键词池至少导入一批有效业务词。
首页模板至少存在一个公共模板，并已绑定到站点。
选择「公共模板」模式时，到这里即可进入批量生成。
选择「AI分站内容」模式时，还需配置 AI、分站提示词和标题池库存。
批量生成前先点击「计算页面数量」，再用少城市、低层级小范围试跑。
进入「分站结果」验收效果，确认无误后再放大生成规模。

四、操作先后对照表

避免顺序反置

先完成	再执行
环境检测、授权绑定	开户、建站
域名添加并启用	站点绑定域名，或分配给代理 / 商户
站点创建并绑定域名	提交批量生成，否则提交按钮不可用
AI Key + 模型	首页模板 AI 生成、媒体库生图、AI 分站任务
生成规则 + 关键词池	生成有意义的标题、关键词和 URL
首页模板绑定	公共模板模式正式发布
标题池有库存 + 分站提示词包含 {assigned_title}	AI 分站内容模式批量生成
站点运行参数（间隔）	大批量任务开跑，遵循先小后大
批量生成入队	到分站结果、AI 页面任务、推送队列中验收

五、两套生成模式选择

新手优先公共模板

公共模板模式（推荐新手）

配置链路更短，不强制要求标题池，适合先跑通系统闭环。

站点规则关键词首页模板绑定批量生成

特点：生成稳定、配置更少，适合首次部署和交付前测试。

AI 分站内容模式

适合需要“一站一文”的场景，但配置项更多，必须持续关注 AI 页面任务。

AI 配置必须可用。
首页模板中分站 AI 开关需开启。
分站提示词必须包含 {assigned_title}。
标题池需要有足够库存，可开启自动繁衍和企业微信预警。

六、常见问题排查指南

问题回源处理

排查原则

出现异常时，请回到对应配置页修改参数，不要在结果页反复重试同一个错误任务。

现象	回哪里改
提交不了批量生成	检查站点是否已绑定域名
标题 / 描述怪异	生成规则、关键词池
URL 域名或协议不对	域名管理、站点绑定
页面版式不对	首页模板、标签、产品服务
AI 正文没标题或标题对不上	标题池、分站提示词 {assigned_title}
AI 一直失败	AI配置（Key / 模型）、AI页面任务
生成太猛或太慢	批量生成本次间隔、站点运行参数
推送队列堆积	环境检测 / Worker、推送队列运维
商户看不到菜单	代理 / 商户管理中的权限勾选
后台品牌还是旧的	贴牌设置保存后，刷新浏览器缓存

七、核心叮嘱

上线前必看

顺序不能反

正确顺序是：域名 → 站点绑定 → 规则 / 模板 → 批量生成。

先小后大

先用少量城市、低层级试跑，确认结果正常后再全量生成。

参数只影响新任务

修改间隔或规则后，通常只影响之后新入队的任务；已入队任务仍按提交时的参数执行。

常见问题

FAQ

为什么点击「批量生成」就提交不了或报错？

先检查站点是否已经绑定域名。系统要求站点绑定域名后才能提交批量生成任务。同时确认环境授权正常、域名已启用、生成规则和关键词池已配置完成。

新手刚开始用，应该选「公共模板模式」还是「AI分站内容模式」？

建议先使用「公共模板模式」。该模式不强制要求标题池，流程更短：站点 → 规则 → 关键词 → 首页模板绑定 → 批量生成。熟悉流程后，再切换到配置项更多的「AI分站内容模式」。

AI 分站内容模式下，正文没有标题或标题对不上怎么办？

回到「首页模板」配置页，检查分站 AI 提示词是否包含 {assigned_title}。系统通过该变量把标题池标题传给 AI，缺失后容易出现正文无标题或文不对题。

修改生成规则和站点运行间隔后，为什么正在跑的任务没有变化？

这是正常机制。间隔、规则等参数通常只对之后新入队的任务生效；已进入队列的任务，会继续按入队时的参数执行。

批量生成太慢，或太猛导致服务器压力大，怎么调整？

可在提交批量生成时调整「本次间隔」，也可在站点设置中修改「站点运行参数（间隔）」。建议先用少量城市或低层级试跑，观察任务和推送队列状态后再放大规模。

商户登录后台后看不到某些功能菜单，是系统 Bug 吗？

通常不是 Bug，而是权限未分配。请代理或超级管理员进入「代理管理 / 商户管理」，检查该商户是否勾选了对应模块权限，保存后让商户重新登录或刷新页面。

代理修改 Logo 和品牌名后，商户看到的还是旧后台怎么办？

确认代理「贴牌设置」已保存成功，然后让商户强制刷新浏览器缓存。常用快捷键为 Ctrl+F5 或 Cmd+Shift+R。

AI 生成任务一直失败，去哪里排查？

依次检查「AI配置」中的 Key 是否正确、平台是否欠费或过期、文本 / 图片模型是否支持；再进入「AI页面任务」查看具体报错日志。保存 AI 配置前建议先点击「检测」。

推送队列大量堆积，页面一直不更新怎么办？

请超级管理员进入「环境检测」页面，检查 Worker 进程是否正常、数据库连接是否稳定。若 Worker 停止，需要重启相关服务；若任务量过大，建议调大生成间隔并分批处理。

部署教程

2.搭建教程 · 从零装到能进后台

本节只处理三件事：服务器环境如何准备、程序如何安装、安装完成后必须补齐哪些配置。完成安装并成功进入后台后，业务配置顺序请继续参考同目录的《上手顺序总结》。

宝塔面板部署 PHP 7.4 / 8.0 Swoole 必装 Worker 常驻进程 utf8mb4 数据库

一环境准备：安装前核对

本教程默认使用宝塔面板部署。开始安装前，建议先把以下检查项一次性确认到位，避免安装过程中被环境检测拦截。

服务器基础

准备一台可安装宝塔面板的 Linux 服务器。
准备已解析完成的域名，用于安装访问和后台登录。
建议预先安装 Nginx、MySQL、PHP、Redis；Redis 建议安装，但不强制启用。

PHP 版本与扩展

PHP 版本要求为 7.4 及以上，推荐使用已验证的 PHP 7.4 或 PHP 8.0。
网站运行 PHP 与 Worker 使用的 CLI PHP，尽量保持同一大版本，避免长期混用 php74 / php80。
必装扩展：Swoole、OpenSSL、cURL，或开启 allow_url_fopen。
建议安装：redis、apcu；可选安装：opcache、imagick。

数据库要求

MySQL 版本要求为 5.7 及以上。
字符集必须使用 utf8mb4。
可提前创建空数据库，也可按安装页填写方式由程序自动创建。

关键提醒：PHP 版本、CLI 版本和扩展环境是程序能否正常运行的基础。只要安装程序被拦截，优先检查这三项，不要先判断为程序异常。

二上传程序与建站

上传并解压程序

将程序上传到网站目录，例如：

/www/wwwroot/你的站点目录/

解压后确认目录中包含 public、app、cli、install.sql 等关键文件。

宝塔新建网站

绑定你的域名，PHP 版本选择已安装 Swoole 扩展的对应版本。网站的运行目录必须设置为 public，否则路由会异常，后台也无法进入。

配置 Nginx 伪静态

打开网站伪静态设置，填入安装包内 nginx-rewrite.conf 的内容，保存后重载 Nginx。

测试伪静态

在浏览器手动访问：

https://你的域名/admin/login

若能显示登录页或安装相关页面，说明伪静态已生效。若出现 404、下载文件或空白页，优先检查运行目录是否为 public，伪静态规则是否已保存，Nginx 是否已重载。

三执行安装引导

进入安装页

浏览器打开站点域名。系统未安装时，通常会自动跳转到安装引导页。

填写配置信息

填写数据库地址、端口、库名、用户名和密码。
设置超级管理员账号和密码，并妥善保存。
Redis 有则填写；未安装或暂不启用时，直接关闭即可。
授权码有则填写；也可以先完成安装，之后在后台「授权管理」中绑定。

执行安装

点击安装后，程序会创建或准备数据库，导入根目录中的 install.sql，写入数据库配置，更新 Redis 相关配置，并创建或更新超级管理员账号。

安装结果：安装成功后，页面会显示后台入口地址，并生成锁文件 data/install.lock。使用刚设置的超级管理员账号登录后台即可。

四安装完成后必做的 4 件事

注意：以下 4 项未完成时，后续任务很容易卡住，或者只能进入后台但无法正常运行。

1. 设置目录权限

确保网站运行用户，宝塔环境通常为 www，对以下目录拥有可读写权限：

storage
public/uploads
日志相关目录

权限配置错误通常会导致上传失败、页面生成失败、缓存无法写入等问题。

2. 配置常驻 Worker

异步生成与队列消费依赖 Worker 进程。至少需要启动 city-build-worker，否则批量生成任务会堆积无法消费。

建议在宝塔「进程守护管理器 / Supervisor」中添加守护进程，PHP 命令需与站点 CLI 版本保持一致，启动用户建议为 www，不要随意使用 root。

必开进程示例：

php80 /www/wwwroot/你自己的站点目录/cli/swoole-build-worker.php

进程目录：

/www/wwwroot/你自己的站点目录/cli/

请将 php80 和站点目录替换为服务器上的真实版本与路径。更完整的命令清单请查阅项目根目录的 进程守护管理器.txt。

3. 后台环境自检

登录后台，进入「系统设置 → 环境检测」。查看是否存在失败项，警告项按页面提示处理。

Worker 在线状态在网页端可能只显示警告，最终状态以进程守护管理器中的“运行中”为准。

4. 绑定授权

进入「系统设置 → 授权管理」，复制服务器 IP 并绑定授权码。完成后刷新页面，确认授权状态正常。

建议按需启动的 Worker：city-page-work、city-title-work、city-title-fission-work、city-export-url、city-indexnow-worker、city-async-task-worker。典型用途包括分站页面任务、标题库存监控、标题裂变、路由导出、IndexNow 推送、附件生图和首页模板生成等异步任务。

五安装完成后的业务开启顺序

搭建完成只代表基础环境可用。正式开站建议按下面顺序继续配置：

确认授权与环境状态正常配置 AI，如需使用 AI 功能在域名管理中添加根域名开通代理或商户并分配域名权限建立站点并绑定域名配置生成规则与关键词配置首页模板 AI 模式下配置标题池提交批量生成验收分站结果

更详细的业务顺序请参考 00-上手顺序总结.txt，各菜单字段说明请查阅同目录下的其他 TXT 文件。

六系统重装指南

重装入口

程序安装成功后会生成锁文件 data/install.lock。若需重新进入安装引导，请先删除该锁文件，然后再次访问站点域名或安装入口。

重装注意事项

重装可能覆盖数据库和配置文件。生产环境操作前，必须先备份数据库和站点目录。

FAQ常见问题

安装时提示缺少 PHP 扩展被拦截怎么办？

先检查宝塔 PHP 设置中的扩展安装情况。本程序必装扩展包括 Swoole、OpenSSL、cURL，或者开启 allow_url_fopen。建议同时安装 redis 和 apcu 以提升性能。排查时，进入宝塔软件商店，找到对应 PHP 版本，在设置中确认上述扩展已安装并启用。

访问域名或 /admin/login 出现 404、下载文件或空白页？

这通常由 Nginx 伪静态或网站运行目录配置错误导致。请依次检查：运行目录是否为 public，伪静态是否已写入安装包中的 nginx-rewrite.conf，以及 Nginx 是否已重载配置。

网站能打开，但批量生成任务一直堆积不执行？

异步生成与队列消费依赖常驻 Worker 进程。如果未启动 city-build-worker，任务会堆积无法消费。请进入宝塔进程守护管理器添加守护进程，启动用户选择 www，进程数量设为 1，并填写正确的 CLI PHP 路径与 Worker 脚本路径。

后台环境自检显示 Worker 不在线，但进程守护管理器显示运行中？

后台网页端环境检测可能存在延迟，或仅显示警告。Worker 的最终运行状态请以宝塔进程守护管理器中的“运行中”为准。如果守护管理器中也是停止状态，请检查启动命令中的 PHP 版本、路径是否正确，以及 CLI 环境下是否已安装 Swoole 等所需扩展。

后台上传文件、生成页面或写入缓存时报错失败？

多半是目录权限问题。请确保网站运行用户，宝塔环境通常为 www，对 storage、public/uploads 和日志相关目录拥有可读写权限。可在宝塔文件管理器中将目录权限设置为 755，所有者改为 www。

网站运行 PHP 和命令行 CLI PHP 版本可以不一样吗？

不建议长期混用，例如网站使用 PHP 7.4、Worker 使用 PHP 8.0。除非两边扩展都已装齐并测试通过，否则尽量保持网站运行 PHP 与 Worker 使用的 CLI PHP 处于同一个大版本，避免兼容性报错或进程异常退出。

想重新走一遍安装引导，但访问域名直接进入首页怎么办？

程序安装成功后会生成锁文件 data/install.lock。若需重新安装，请先删除网站根目录 data 文件夹下的该文件，再次访问站点域名或安装入口即可重新进入安装引导。注意：重装可能覆盖数据库和配置文件，操作前先备份。

安装引导页面需要填写 Redis 配置，但服务器没装 Redis 怎么办？

如果服务器未安装 Redis，或者暂时不想启用，安装页面里的 Redis 配置项直接选择关闭或不启用即可，不影响基础安装。Redis 属于建议安装项，后续需要提升性能时再补装，并在后台修改配置。

03 · 系统设置

3.环境检测 · 设置与配置教程

环境检测页主要面向超级管理员与管理员，用于查看系统运行健康状态。该页面可直接执行的维护动作以「一键清缓存」为主，其余内容多为检测报告、运行建议和 php.ini 配置示例。

一、进页先看什么

进入页面后，先根据顶部摘要判断系统当前健康状态，再按失败、警告、通过的优先级逐项处理。

注意事项

顶部摘要会展示当前系统的健康状态，包括「通过 / 警告 / 失败」的数量。优先查看是否存在失败项；如有失败项，应先处理失败原因。警告项不一定代表系统不可用，但需要结合实际业务和服务器配置判断是否需要调整。

通过基础环境满足检测条件。

警告存在需人工确认的风险项。

失败需优先修复后再继续配置。

二、检测分组概览

本页检测报告通常分为 5 个组别，用于覆盖程序运行所需的关键环境。

PHP

运行环境

检查 PHP 版本、swoole、pdo_mysql、mbstring、curl 等基础扩展。

缓存与加速

检查 APCu、Redis、缓存驱动等加速组件是否可用。

常驻 Worker

检查构建/推送脚本、worker_num、batch_size、IndexNow 开关等状态。

目录与权限

检查 storage、uploads、session 等目录是否具备写入权限。

数据库结构

检查数据库连接是否正常，以及关键数据表是否存在。

三、缓存维护（本页关键操作）

「一键清缓存」通常仅开放给超级管理员，用于清理 APCu、Redis 前缀缓存、路由文件缓存等内容。

点击页面中的「一键清缓存」按钮。

在弹出的确认框中核对并确认操作。

清理完成后刷新页面，观察相关检测项是否恢复正常。

注意：请勿在访问高峰期随意清理缓存。除非明确是在修复缓存不一致问题，否则建议避开高峰时段执行。

四、推荐 php.ini 示例

页面会提供 APCu、Redis、opcache 等推荐配置片段，可按服务器实际情况复制后调整。

复制页面提供的推荐配置片段。

粘贴并修改服务器上的 php.ini 文件。

重启 Web 服务 / PHP-FPM 及相关常驻 Worker，使配置真正生效。

五、常见踩坑与注意事项

环境检测通过只说明底层运行条件基本满足，不能替代业务配置验收。

Worker 警告不一定是故障

Web 请求通常无法直接探测后台进程是否在线，最终状态应以宝塔面板或 Supervisor 中的运行状态为准。

清缓存受角色权限限制

普通管理员或 lower 角色可能没有清理缓存权限，因此页面可能不会显示「一键清缓存」按钮。

检测通过不等于配置完成

AI、授权、站点、域名、模板等业务配置仍需到对应页面单独完成。

常见问题

以下问题用于处理环境检测页中最常见的失败、警告、权限和缓存相关情况。

FAQ

环境检测页面出现“失败”项，应该优先怎么处理？

顶部摘要会统计「通过 / 警告 / 失败」的数量。遇到失败项时，应先展开对应检测分组，查看具体失败原因，例如缺少 PHP 扩展、目录无写权限等。按提示安装扩展或修复权限后，刷新环境检测页面重新检查，直到失败数量为 0。

为什么“常驻 Worker”检测一直显示“警告”？是程序出错了吗？

这通常不是程序故障。Web 请求无法直接确认服务器后台进程是否在线，因此系统会给出警告提示。请前往宝塔面板的「进程管理」或 Supervisor，查看相关构建、推送脚本进程是否处于正常运行状态。

为什么页面上找不到“一键清缓存”按钮？

「一键清缓存」功能通常仅对超级管理员开放。若当前登录账号是普通管理员或更低权限角色，系统可能会隐藏该操作按钮。请使用超级管理员账号登录，或联系超级管理员分配相应权限。

修改推荐的 php.ini 配置后为什么没有生效？

修改 php.ini 后，必须重启相关服务才能加载新配置。请先重启 Web 服务或 PHP-FPM 进程，再重启系统相关的常驻 Worker 进程。如果使用 Swoole，通常还需要重启底层常驻服务进程。

环境检测全部通过，是不是意味着系统已经配置好了？

不是。环境检测仅代表服务器底层环境满足系统运行要求，例如 PHP 版本、扩展、目录权限、数据库连接等。AI 接口配置、软件授权、站点参数等业务层面的设置仍需前往对应页面单独完成。

目录与权限检测失败，提示 storage 或 uploads 不可写怎么办？

这是因为 Web 运行用户（如 www 或 nginx）对相关目录没有写入权限。可通过 SSH 连接服务器执行权限修复命令。以下示例假设 Web 运行用户为 www，项目路径为 /www/wwwroot/your-project：

chown -R www:www /www/wwwroot/your-project/storage
chown -R www:www /www/wwwroot/your-project/uploads
chmod -R 755 /www/wwwroot/your-project/storage

能在访问高峰期点击“一键清缓存”吗？

强烈不建议。清理缓存后，系统会产生大量缓存重建请求，短时间内增加服务器和数据库负载，可能导致网站响应变慢甚至超时。除非正在修复缓存不一致故障，否则应避开访问高峰期操作。

缓存与加速检测报错提示 Redis 未连接，如何排查？

优先检查 Redis 服务是否已启动，再核对系统配置中的 Redis 地址、端口和密码是否正确。同时确认服务器防火墙或安全组未拦截 Redis 端口；若使用宝塔面板，请在软件管理中确认 Redis 处于正常运行状态。

系统设置 · 授权管理

4. 授权管理 · 设置与配置教程

本页面用于超级管理员或管理员查看系统授权状态，并执行授权码绑定、解绑等操作。系统未完成授权时，后台登录校验可能无法通过，请优先确认授权状态正常。

关键提醒：授权管理属于系统级配置。绑定会覆盖本地授权码；解绑会清空本地授权码，操作前务必确认当前业务不会受到影响。

01一、只读信息说明

进入授权管理页面后，先查看页面展示的只读信息，用于判断当前服务器与授权码的绑定关系。

✓

当前授权状态用于确认系统是否已经完成授权，以及授权是否处于可用状态。

服务器 IP（机器码）购买授权或提交绑定时通常需要复制该信息。

KEY

本地授权码页面会进行脱敏显示，仅用于核对本机是否已有授权码。

↔

解绑说明、授权 IP用于确认当前授权绑定信息及解绑后的影响范围。

MODE

授权方式常见为 IP 授权，以页面实际显示为准。

02二、常用操作指南

授权管理页的常用操作集中在复制机器码、刷新状态、绑定授权码和解绑授权上。执行前请先确认当前账号具备操作权限。

复制服务器 IP

购买授权或提交绑定时常用，复制后按授权方要求提交即可。

刷新授权状态

用于获取最新授权结果。演示模式下，该操作可能被系统禁用。

立即绑定

输入新的授权码并提交后，会覆盖本地授权码，并立即用于后台登录验证。

解绑授权

仅在存在本地授权码时显示。执行后会清空本地授权码，需要二次确认。

授权码购买

若系统配置了购买外链，可点击页面入口跳转购买。

03三、授权绑定流程

标准授权绑定流程如下，建议按顺序操作，避免授权码与服务器 IP 不匹配。

复制服务器 IP。
获取与该服务器 IP 对应的授权码。
将授权码粘贴至授权码输入框。
点击「立即绑定」提交授权码。
刷新授权状态，确认页面显示绑定成功。

04四、注意事项

谨慎解绑：解绑属于重大操作，请避免误触。解绑后必须重新绑定授权码，系统才能恢复正常使用。

演示模式限制：演示模式下通常无法刷新或更改授权状态，这是系统保护机制。

异常处理：若绑定成功后系统仍显示异常，请先退出后台重新登录，再返回授权管理页面查看状态。

CITY CLUSTER SYSTEM · ADMIN CONSOLE

5. 控制台 · 设置与配置教程

控制台是后台首页仪表盘，用于查看系统概况、近期动态和常用入口。具体参数配置需要进入左侧菜单对应的功能页面完成。

一、功能概览

进入控制台后，可以先通过概览数据和快捷入口了解当前系统状态，再进入实际配置页面继续操作。

▦ 查看核心数据

快速了解站点、域名、城市库、分站、标签、媒体等核心资源的数量概览。

↗ 查看近期动态

浏览最近的站点与分站记录，便于快速定位近期操作并继续处理。

⌁ 使用快捷入口

一键跳转到常用配置页面，例如环境检测、账号资料等功能模块。

二、操作建议

打开后台后，建议先停留在控制台页面，按以下顺序快速确认当前运行情况。

确认站点状态：检查站点是否已经成功建立。
检查任务堆积：观察是否存在异常任务堆积。如果最近创建的分站一直没有进展，请前往「批量生成」或「AI页面任务」页面进一步排查。
核对账号信息：如需修改密码或联系人信息，请点击「账号资料」。
检查环境与缓存：如需查询服务器环境或清理缓存，请点击「环境检查」。

三、设置注意事项

危险操作

控制台页面没有系统参数的保存按钮，请勿在此页面寻找或填写 AI Key、运行间隔、授权码等配置。

在进行系统配置时，请注意以下事项：

控制台主要用于查看状态和跳转页面，不负责保存系统参数。
AI Key、运行间隔、授权码等核心参数，均位于左侧菜单的「系统设置」分组中。
配置完成后，可返回控制台查看站点数量、分站记录和任务状态变化。

刚安装完成后的建议顺序

进入「环境检测」，确认服务器环境和运行状态。
进入「授权管理」，完成授权状态确认。
进入「AI配置」，按实际需求配置 AI 功能。
建立站点，并绑定可用域名。
配置生成规则和首页模板。

四、常见问题

控制台显示的数字不对怎么办？

请先前往「环境检测」页面，检查缓存与数据库状态是否正常。清理缓存后，再刷新控制台页面查看数据是否恢复。

演示模式提示“写入禁用”怎么办？

这是演示账号的使用限制，配置类操作会被系统拦截。请更换为正式账号后再进行修改。

6. AI 配置

AI 配置是系统设置中的核心页面，用于统一管理 API Key、文本模型、图片模型、启用状态、模型缓存和密钥检测。涉及首页模板生成、分站内容生成、媒体库 AI 生图等功能时，都需要先确认本页配置可用。

API Key 管理

文本模型

图片模型

密钥检测

温馨提示

首页提示词已迁移至「首页模板」中配置。本页只负责 AI 接口、模型和启用状态，不再维护首页提示词内容。

一、配置范围说明

进入页面后，先根据当前账号身份和系统模式确认配置范围，避免把个人配置、全局配置或平台默认配置混淆。

常见情况 账号独立配置

当前登录账号各自维护一份独立的 AI 配置，保存后主要影响当前账号下的 AI 功能。

未开启隔离 全局共用配置

未开启账号隔离时，系统可能共用同一份 AI 配置，修改前需确认影响范围。

超级管理员 平台默认配置

隔离模式下，超级管理员除维护自身配置外，还可维护平台默认配置，即 user_id=0。

操作前确认

保存前请看清页面标题是「AI 配置工作台」还是「全局 AI 配置」，再决定是否继续修改。

接下来：二、必配字段

二、必配字段

在配置页面中，按顺序补齐以下核心字段。字段缺失或状态未启用时，相关 AI 功能可能无法正常执行。

API Key（多行）

一行填写一个 Key，支持多 Key 轮换使用。

首页模型（多行文本模型）

运行时系统会从已配置的文本模型中随机抽取 1 个使用。

图片模型（多行）

媒体库执行 AI 生图时，会从已配置的图片模型中随机抽取 1 个使用。

状态

支持设置为「启用 / 禁用」，默认通常为启用。正式跑任务前务必确认状态为「启用」。

接下来：三、模型选择与缓存

三、模型选择与缓存

模型配置完成后，可通过页面提供的搜索、选择和缓存摘要功能，检查文本模型与图片模型是否已正常加载。

模型选择 搜索选择 / 清空

可使用「搜索选择」挑选所需的文本或图片模型，也可使用「清空」移除已选模型。

缓存摘要 实时查看模型缓存

页面会展示文本 / 图片模型缓存摘要，包括状态、来源、拉取时间和数量。

缓存清理 按权限执行

清空模型缓存通常仅超级管理员有权限操作，普通账号可能无法看到相关按钮。

接下来：四、密钥检测

四、密钥检测

API Key 填写完成后，建议先执行检测，再保存配置。这样可以提前发现无效 Key、余额异常或到期问题。

逐 Key 检测：填好 Key 后执行检测，可查看尾号、余额、到期等信息，并支持关键字过滤。
保存前检查：建议在保存前先进行一轮检测，避免后续 AI 任务反复失败。
无效 Key 拦截：保存时若系统判定 Key 无效，可能会直接拦截，并提示对应尾号。

接下来：五、演示模式

五、演示模式

在演示账号环境下，API Key 通常处于只读脱敏状态，并且无法保存修改。这是系统的正常保护机制，不属于故障。

识别方式

如果页面提示写入被禁用、Key 被脱敏显示，或保存按钮无法提交，请先确认当前是否为演示账号。

接下来：六、配完去哪

六、配完去哪

AI 配置保存并检测通过后，再进入对应业务页面继续操作。不同功能对应的后续页面如下：

生成首页 / 分站内容提示词：前往「首页模板」进行配置。
AI 生成图片：前往「媒体库」操作，生图模型需提前在本页选好。
正式运行任务：跑任务前，请返回本页确认状态已设为「启用」。

SYSTEM SETTINGS · DOMAIN

7. 域名管理

本页面主要供总后台（超级管理员 / 管理员）维护“可分配的根域名”。代理侧账号通常以使用已分配域名为主，一般无法在此页面进行大范围修改。

总后台维护根域名配置 HTTP / HTTPS IndexNow 关联

一域名的系统角色

系统中的分站 URL 以及 IndexNow 推送地址，都会调用此处配置的根域名及其访问协议。这里配置错误，后续站点绑定、页面生成和推送地址都会受到影响。

作用说明

域名管理不是单纯记录域名列表，而是为站点分配、分站 URL 拼接和 IndexNow keyLocation 提供基础配置。

二新建与编辑字段说明

新建或编辑域名时，需要重点确认以下核心字段。正式保存前，建议逐项核对，避免后续站点绑定时再返工。

主域名 / 根域名

新建时，总后台支持多行批量添加；编辑时，通常只针对单个域名进行修改。

访问协议

支持 HTTPS 与 HTTP。HTTPS 为默认推荐项，正式环境优先使用 HTTPS。

HTTPS 推荐 HTTP 可选

备注

用于自定义标注域名用途，例如填写“客户A专用”，方便后续分配和排查。

状态

支持设置为「启用」或「禁用」。被禁用的域名不建议继续用于运行新站点。

注意事项

访问协议会决定系统生成访问地址时使用 HTTP 还是 HTTPS，同时也会影响 IndexNow 的 keyLocation。域名被禁用后，站点绑定处会出现相应标注，请尽量避免将已禁用域名用于新站点。

三配置建议

为保障系统稳定运行，建议按以下原则配置域名，尤其是在正式环境和批量导入场景中。

正式环境优先选择 HTTPS 协议，减少后续访问和推送兼容问题。
批量导入域名时，确保一行一个域名；导入完成后，立即检查状态是否为「启用」。
操作顺序必须保持一致：先在本页添加域名，再前往「代理 / 商户管理」分配域名，最后到「站点管理」完成绑定。

在「域名管理」添加根域名，并确认协议与状态。

前往「代理 / 商户管理」分配可用域名。

进入「站点管理」绑定域名后，再继续后续建站流程。

四常见踩坑与注意事项

权限限制

非超级管理员账号可能无法进行批量新增操作。如果页面没有相关按钮或保存受限，先确认当前账号角色和菜单权限。

代理权限

代理账号有时只有查看权限，无法直接修改域名池。实际的域名分配动作，通常需要前往「商户 / 代理管理」中完成。

状态冲突

如果域名已被禁用但仍绑定在站点上，容易导致页面生成失败或访问异常。发现异常时，应先回到域名管理和站点绑定处核对状态。

SYSTEM SETTINGS · AGENT MANAGEMENT

8. 代理管理

本页面供超级管理员 / 管理员使用，主要用于开设代理账号、控制权限与配额。部分情况下，也可在创建或编辑代理时预填贴牌信息，便于后续交付。

代理开户

权限控制

配额限制

域名分配

贴牌预填

一、访问权限说明

进入「代理管理」前，先确认当前账号角色与系统授权状态。若权限或授权条件不满足，菜单可能不会显示。

角色要求

仅超级管理员、管理员账号可在菜单中看到「代理管理」。

授权要求

系统必须开启代理模式授权功能，否则该菜单可能直接隐藏。

使用场景

用于开通代理、分配资源、控制菜单权限，并按需预填贴牌资料。

二、新建与编辑代理配置

新建或编辑代理时，建议按页面模块从上到下依次配置。基础资料、配额、权限、域名、贴牌与状态都会影响代理后续能否正常使用系统。

1. 基础资料

用户名：必填，用于代理登录后台。
密码：新建代理时必填；编辑代理时留空表示不修改原密码。
公司/商户名称、联系人、电话：按客户实际信息填写，便于后续识别与沟通。

2. 配额设置

配置项	填写规则	说明
站点数量上限	填 0 表示不限	用于限制代理可创建或管理的站点数量。
分站数量上限	填 0 表示不限	用于限制代理名下可生成的分站规模。

温馨提示

若需要限制客户随意开站，请将对应数量设置为明确的小数值，不要填写 0。

3. 权限分配（关键）

权限决定代理端后台能看到哪些菜单，以及能对相关模块执行哪些操作。配置时需要同时关注「允许模块」和「动作权限」。

允许模块：勾选哪些模块，代理端左侧菜单就显示哪些模块。
动作权限：支持配置查看、编辑、删除、执行等操作权限。
移动端操作：手机端可直接点选权限项，无需长按多选。

三、域名、贴牌与状态配置

完成基础资料、配额和权限后，继续配置代理可用域名、贴牌字段和账号状态。这三项会直接影响代理后续开户、建站与登录。

4. 域名分配

为代理分配可用的根域名。后续代理或商户建站时，只有已分配的域名才可用于绑定。

支持全选操作，适合一次性分配多个域名。
支持清空操作，适合重新整理代理可用域名范围。

5. 贴牌字段

贴牌字段包含品牌名称、Logo、官网和页脚。管理员可在此预填代理品牌信息；代理自行登录后，也可前往「贴牌设置」继续修改。

6. 状态设置

账号状态支持启用 / 禁用。禁用后，该代理将无法进入系统执行操作。

四、保存操作

代理配置完成后，按以下顺序保存并核对结果。

点击页面中的「保存代理」按钮。
返回代理列表，核对代理状态是否正确。
检查站点配额、分站配额是否按预期生效。

五、踩坑提醒

权限兼容

若系统尚未升级“动作级权限”字段，页面会提示仍按“允许模块”兼容生效。操作前请先查看页面提示。

模块与动作联动

未勾选某模块时，其对应的动作权限会变灰，这是正常现象，不属于页面故障。

配额含义

配额填 0 代表“不限”，不是“一个都不能建”。需要限制数量时，请填写明确的上限值。

操作顺序建议：先确认访问权限，再填写基础资料，随后设置配额、权限和域名，最后按需预填贴牌信息并启用账号。

09 Merchant Account Management

9.商户管理

商户是实际建立站点、运行生成任务的核心业务账号。超级管理员、管理员及代理均可进行商户管理，具体可操作范围取决于当前登录角色的权限。

一与代理管理的异同

表单结构相近

商户管理与代理管理的表单结构高度相似，通常都包含基础资料、配额、权限及域名分配等核心模块。

业务定位不同

代理侧更偏向账号分发与品牌配置，商户侧则更偏向实际建站、生成和日常运营。

差异项	说明
上级代理字段	编辑商户时会显示「上级代理」信息。该字段为只读状态，通常无法在此页面修改商户的归属关系。
贴牌设置	商户页面通常不直接修改贴牌信息。贴牌配置由代理在专属的「贴牌设置」页面完成，商户登录后会自动继承并展示对应品牌信息。

二新建商户配置指南

配置前提醒

建议按顺序配置新的商户账号。权限、配额和域名一旦漏配，后续建站或绑定域名时容易被卡住。

1

确认上级代理

若您以总后台身份开户，需要先为该商户指定所属的上级代理。
2

填写基础资料

录入商户的用户名、密码及联系信息，确保后续登录和沟通信息完整。
3

设置配额

合理设置站点或分站数量上限。若需要防止超量开通，请勿填写 0，0 通常代表不限。
4
分配权限模块

根据商户日常业务需求勾选对应模块。常规必备模块包括：
- 站点管理、域名相关能力（视角色而定）
- 生成规则、关键词、城市库、批量生成、运行参数
- 首页模板、标签、产品服务、媒体库
- AI配置、标题池
注意：系统级菜单，如环境检测、授权管理等，无需向商户开放。
5

分配可用域名

为商户分配可绑定的根域名，避免后续创建站点时无法完成域名绑定。
6

保存并启用

将账号状态设为“启用”，点击保存，即可完成商户创建。

三注意事项

菜单可见性

商户能否看到特定功能菜单，完全取决于此处的权限勾选情况。

域名分配必要性

若未提前分配域名，后续在站点绑定域名环节会受阻，影响业务流程。

密码修改规则

编辑商户资料时，密码框留空表示不修改原密码。

Brand Console · OEM

10. 贴牌设置

通过贴牌设置替换后台品牌信息。配置完成后，您名下的商户登录后台时，也会同步显示对应的品牌内容。

温馨提示

本页面仅对代理账号开放，主要用于配置后台品牌名称、Logo、官网和页脚文案。

一、进入页面

请使用代理账号登录系统后台，然后按照以下路径进入功能页面：

账号与客户 → 贴牌设置

二、四个核心字段

进入贴牌设置页面后，依次配置以下四个核心字段。

品牌名称

客户在后台侧边栏看到的系统名称。

建议：填写对外使用的正式产品名，确保品牌展示统一。

品牌 Logo

填写附件地址或完整的图片 URL。

建议：使用透明底 PNG 图片，并尽量选择接近正方形的比例，以便在侧边栏缩略图中保持良好显示效果。

品牌官网

填写后，侧边栏品牌区与页头按钮将支持点击，并跳转至对应官网。

页脚文案

如果留空，系统将按默认策略显示，通常为品牌名称或系统默认标题。

三、保存与验证

完成四个字段配置后，点击页面底部的「保存贴牌信息」按钮。
系统会自动刷新当前会话中的品牌字段。若侧边栏仍显示旧品牌信息，请刷新浏览器。
如果填写了品牌官网，请点击「打开官网」按钮，确认跳转链接准确无误。

四、注意事项与权限区分

请根据账号角色选择正确的操作位置

代理日常修改品牌：直接使用「贴牌设置」页面进行修改。
总后台预填代理品牌：超级管理员在「代理管理」的新建或编辑表单中，也可能使用贴牌字段预填品牌信息。
商户品牌继承：商户端一般没有本菜单权限，会自动继承其上级代理的贴牌配置。

ACCOUNT PROFILE · 控制台

11. 账号资料

本页面仅用于管理“当前登录账号”自身的资料与密码。这里不会修改代理资料，也不会修改商户资料，操作前请先确认当前登录身份。

使用边界：账号资料页只影响当前登录账号本身，请勿与「代理管理」「商户管理」混淆。

一

进页路径

从后台左侧菜单进入账号资料页面，按以下路径操作即可。

左侧菜单 → 控制台 → 账号资料

二

可修改字段说明

进入页面后，按字段逐项核对。需要修改的内容直接填写，不需要修改的字段保持原状即可。

用户名

通常不可修改，仅超级管理员具备修改自身用户名的权限。

公司/商户名称、联系人、联系电话

用于后台展示和业务联系，请按真实情况填写。

新密码 + 确认新密码

无需修改密码时，两项都留空；需要修改密码时，两处必须填写一致的新密码。

三

保存与生效

资料填写完成后，点击页面底部的「保存账号资料」按钮提交修改。

保存资料

确认字段无误后，点击「保存账号资料」。

密码生效

如果成功修改密码，系统会自动刷新当前会话。

页面刷新

若页面仍显示旧状态，手动刷新浏览器即可生效。

四

注意事项

影响范围：本页操作仅影响当前登录账号，不会变动名下代理或商户信息。

异常状态：若当前账号不在后台用户表中，页面可能提示不可编辑，这通常属于异常登录态。

密码留空机制：密码留空代表“不修改”，这是系统正常设计，并非 Bug。

五

操作流程总结

按下面顺序操作，可完成账号资料核对、修改与生效确认。

进入账号资料页面 从左侧菜单进入「控制台 → 账号资料」。
核对当前角色信息是否正确 确认当前页面显示的是正在登录的账号信息。
按需修改联系方式等基础资料 补全公司/商户名称、联系人、联系电话等信息。
如需更新密码，填写并确认新密码 新密码和确认新密码必须保持一致；不改密码则两项留空。
点击「保存账号资料」 提交后等待系统保存结果。
刷新浏览器确认修改生效 若页面仍显示旧内容，手动刷新浏览器后再核对。

操作口诀：先确认账号，再修改资料；密码不改就留空，保存后刷新确认。

CITY CLUSTER SYSTEM · SITE MANAGEMENT

12 · 站点管理

站点是后续大多数配置的归属容器，包括规则、关键词、模板、标题池、产品服务等。多数操作都需要先选定站点；如果本页配置不完整，后续生成、绑定和素材调用流程都会受到影响。

一、列表页先确认站点

查看已有站点

进入站点管理页面后，系统会先展示站点列表。可在这里快速核对当前已经创建的站点。

新建站点

需要新增业务站点时，从列表页进入新建流程，按页面字段依次补齐配置。

编辑站点

已有站点需要调整信息、域名、状态或归属时，进入编辑页面处理。

二、新建或编辑时重点配置

基础信息

字段	填写说明	关联变量 / 用途
站点名称	按内部识别习惯命名，方便后续管理。	用于后台识别站点。
公司名称	填写该站点对应的公司或业务主体名称。	对应模板变量 `{公司名称}`。
关于我们 / 首页默认文案	填写站点默认介绍内容。	对应模板变量 `{关于我们}`。
关于我们封面、Logo	通过媒体库点击「选择」上传或挑选。	用于页面展示和品牌识别。
联系人、电话、邮箱、地址	按真实业务信息填写，尽量一次补全。	对应模板中的同名变量。

标签组

标签组容易被忽略，但模板经常会调用。建议在建站阶段一并配置，避免后续页面展示过于通用。

标签组	模板变量	调用方式
基础身份标签组	`{基础身份标签}`	运行时随机抽取一行。
营销标签组	`{营销标签}`	运行时随机抽取一行。
站点描述简介标签	`{站点描述简介}`	运行时随机抽取一块；多段内容用空行分隔。

提示

标签留空并不等于没有内容，系统会调用内置默认值，例如厂家、供货商等默认描述。如需个性化展示，请自行修改配置。

域名与状态

配置项	说明	注意事项
主域名	支持多选绑定。	若无可用域名，请先到「域名管理」添加，或联系上级分配。
状态	可设置为「启用」或「禁用」。	正式生成前应确认站点处于启用状态。
归属账号	上级账号可见时可修改。	该项会影响站点、域名及媒体库的归属范围。

三、保存前必须核对

基础联系信息填全

模板经常调用联系人、电话、邮箱、地址等字段。信息缺失时，页面展示容易不完整。

至少绑定 1 个启用中的主域名

未绑定可用主域名时，批量生成提交按钮会失效，后续生成流程无法正常推进。

归属账号选择正确

归属账号选错后，媒体库作用域容易混乱，影响素材选择、上传和管理。

四、操作流程总结

新建站点
填写公司及联系方式
选择 Logo
调整标签组
绑定域名
设为启用
保存站点
前往配置生成规则和首页模板

CITY CLUSTER SYSTEM · RULES

13. 生成规则

生成规则决定分站标题、关键词、描述和 URL 的生成方式。规则按站点独立配置，操作前必须先选站点，再修改对应规则。

配置原则

先确定站点上下文，再填写标题、关键词、描述和路由规则。未选站点时，保存按钮通常为灰色不可点击状态。

一、进页后先选站点

进入页面后，首先选择需要配置的站点。所有生成规则都依赖当前站点，未选择站点时不要继续填写字段。

在页面顶部选择对应站点。
确认当前站点名称无误。
站点选定后，再进入规则字段配置。

注意

未选择站点时，保存按钮通常不可用。即使页面允许输入，也应先完成站点选择，避免规则写入错误站点。

二、核心字段怎么填

危险操作

路由规则会影响分站 URL 结构，修改时只建议调整前缀部分，不要破坏系统强制保留的尾缀结构。

标题规则

支持多行配置，生成时系统会随机抽取其中一行。

示例：{省市}{区县}{随机关键词}

建议至少填写 2～3 行，轮换效果更自然。

关键词规则

支持多行配置，生成时随机抽取一行。

示例：{省市},{区县},{随机关键词}

描述规则

建议把站点名、地区和服务卖点串起来，避免描述内容过于虚假或水化。

路由规则（URL 前缀）

可以修改前半段，但系统会强制保留尾缀：

{site_id}-{short_id}.{root_domain}

{rand} 也会被替换成 {short_id}。

随机串长度

默认值为 4，主要用于给短链补位。

状态

支持设置为「启用」或「禁用」。正式使用前应确认规则处于启用状态。

自定义入库格式

页面上通常是只读展示的 JSON 结构。除非明确知道下游如何读取，否则不要随意修改。

填写顺序

建议按「标题规则 → 关键词规则 → 描述规则 → 路由规则 → 随机串长度 → 状态」的顺序逐项核对。

三、区域标签速查（强烈建议配合看）

页面中提供「查看区域标签速查」功能。这是只读说明书，用于确认地区变量的写法和可用范围。

基础标签

常用标签包括 {省}、{市}、{区县}、{街道}，以及对应的完整名称版。

链路拼接

用于输出组合区域路径，例如 {当前省市区(/)}。

列表标签

用于输出指定数量的区域列表，例如 {区县列表完整名称(、,5)}。

提示

同一个分站内，相同的列表标签加数量会复用结果。编写规则时要提前考虑复用逻辑，避免误以为每处都会重新随机。

四、保存

确认站点已选择。
核对标题、关键词、描述和路由规则。
确认状态为「启用」或按业务需要设置为「禁用」。
点击「保存规则」按钮。

操作成功

保存成功后，规则缓存会自动刷新。后续生成任务会按新的规则配置执行。

五、操作口诀

先选站点 → 标题关键词描述多写几行 → 路由只动前缀 → 去速查页核对标签 → 保存。

选站点填规则查标签核路由保存

CITY CLUSTER SYSTEM · CONTENT ASSETS

14.关键词池

关键词池用于为生成规则中的 {随机关键词} 及拼音类变量提供数据支持。进行任何操作前，请先选定目标站点。

一、列表页

01 · 选择站点 在页面顶部选择目标站点。

02 · 查看词库 查看当前站点下已经录入的关键词列表。

03 · 管理词条 根据当前账号权限，对已有词库执行删除操作。

内容整理 确认目标站点后，再进行关键词查看或管理，避免误操作其他站点的词库。

二、批量新增怎么配

进入新建或批量录入页面后，按以下字段进行配置：

关键词列表 一行填写一个关键词。

默认拼音 可留空。部分场景下系统可自动推导，具体以实际实现为准。

默认首字母 可留空。

三、配置建议

关键词应尽量贴近实际业务词汇，避免堆砌无意义的词。
提交前先在本地整理文本，去除多余空行，避免导入脏数据。
如果生成规则或标题繁衍提示词中使用了 {随机关键词} 变量，请确保关键词池中有充足数据。词池为空时，生成效果会明显下降。

四、注意事项

未选站点不能保存 所有关键词池操作均依赖当前选定的站点上下文。

删词需谨慎 随意删除关键词可能影响后续的随机生成效果。

CITY DATA LIBRARY · 基础数据模块

15. 城市库

城市库在后台为只读数据，没有“编辑保存配置”的入口。它主要作为生成规则、区域标签和批量生成核对时的基础数据来源，用于确认城市层级、名称、拼音和城市 ID 是否符合预期。

一你能做什么

搜索查询

按城市名称或拼音搜索目标城市，快速确认后台是否存在对应数据。

层级筛选

按省、市、区县、街道层级进行筛选，检查行政区划层级是否符合当前生成需求。

数据核对

核对城市是否存在、拼音是否符合预期，以及后续批量生成需要使用的城市 ID。

二与配置的关系

城市库本身不可直接修改，但在多个配置流程中会被系统调用。实际配置时，通常需要先在本页确认城市数据，再回到对应功能页继续操作。

生成规则

配置地区标签时会调用城市库数据，用于输出省、市、区县、街道等区域信息。

批量生成

设置生成层级、指定城市 ID、向下展开区域时，需要参考城市库中的层级与 ID。

首页模板

预览默认城市、检查区域变量展示效果等场景，也会使用城市库作为基础数据。

三操作建议

发现数据异常时，不要在本页尝试修改
城市库页面没有前台编辑入口。若发现城市数据不对，应走数据维护或导入流程处理，避免误改基础库。
需要精确生成时，先查城市 ID
在城市库中确认目标城市 ID 后，再回到「批量生成」页面精确指定，减少选错区域或生成范围过大的风险。

提示：城市库是系统级基础数据，主要用于查询、筛选和核对。日常建站时，把它当作“区域数据参考表”使用即可。

WordPress Admin · Media Library

16. 媒体库

媒体库不仅用于上传和管理图片，还提供 AI 生图参数配置。图片模型需要在「AI配置」页面维护；本页面主要负责媒体目录、图片上传，以及生图参数默认值的管理。

一、选择正确的归属范围

!操作前确认

未选定具体账号或站点 Scope（作用域）时，媒体库通常仅支持浏览，无法执行上传或生图操作。

进入媒体库页面，在页面右上角或顶部找到归属选择项。
将归属范围切换至当前需要操作的账号或站点。

二、目录与上传配置

完成归属范围选择后，即可创建目录并上传图片。

创建文件夹

选择上级目录，并输入新建文件夹名称，例如 bannerproduct。

本地上传

支持 jpg、png、gif、webp、bmp 格式，可多选文件，并指定目标存放目录。

外链配置

如有业务需要，也可以填写外部链接访问地址，例如 CDN 链接。

内容整理

上传前先确定目录用途，便于后续在站点 Logo、产品封面和其他素材选择场景中快速定位。

三、AI 生图参数配置

媒体库支持将以下参数保存为默认配置，用于后续 AI 生图操作。

配置项	填写说明
提示词	支持使用 {input_tag} 等标签变量。
反向提示词	用于指定不希望出现在生成图片中的元素。
尺寸	常见尺寸包括 1024×1024（默认）、1536×1024、1024×1536、2048×1152。
格式	支持 png（默认）或 jpeg。
生成张数	单次生成数量范围为 1～4 张。
目录路径	用于指定生成图片结果的存放目录。

四、区分两个核心按钮

!注意事项

按钮	功能说明
保存生图参数	将当前填写的参数写入数据库，作为下次进入页面时的默认值。
开始生图	仅按照当前填写的参数临时执行一次生图任务，系统不会自动持久化这些参数。

✓操作建议

如果需要固定一套生图参数，请先点击「保存生图参数」，再点击「开始生图」。

五、与其他页面的关联关系

媒体库与系统内其他功能模块存在联动关系，配置时需要注意以下对应项。

图片模型配置

需要前往「AI配置」页面维护图片模型。

站点素材选择

站点 Logo、产品封面、关于我们封面等素材，均从媒体库中调用。

标签管理联动

在标签管理中配置图片标签时，目录路径需与媒体库中的实际目录保持对应。

CITY CLUSTER SYSTEM · CONTENT ASSETS

17. 标签管理

标签是模板、提示词和生图流程中的“可复用零件”。本页面主要用于维护四类自定义标签，同时展示站点级内置标签的说明信息，便于在生成内容时统一调用。

一、总览页

进入「标签管理」页面后，先查看四类自定义标签的入口卡片，再核对内置标签说明。内置标签通常用于模板变量调用，不需要每次重复手动填写。

内置标签示例

{基础身份标签}{营销标签}

默认值来源

这些内置标签的默认值通常继承自「站点管理」中的配置。

二、四类标签配置指南

自定义标签按用途分为图片、输入、段落和随机四类。配置时先确认标签类型，再填写标签名和对应内容。

1. 图片标签 {image_tag:名称}

标签名：自定义该图片标签的名称。
输出模式：支持选择“单图”或“多图列表”。
抽取范围：设置抽取的最小到最大数量，取值范围为 1～50。
多图格式：支持换行、逗号或自定义分隔符。
目录路径：必须对应媒体库中的真实目录路径。

2. 输入标签 {input_tag:名称}

标签名：自定义该输入标签的名称。
候选内容：一行一个，填写供系统抽取的候选词。

3. 段落标签 {textarea_tag:名称}

标签名：自定义该段落标签的名称。
段落内容：段与段之间需要空一行，便于系统按段落抽取和输出。

4. 随机标签 {rand_tag:名称}

标签名：自定义该随机标签的名称。
抽取范围：设置每次抽取的数量范围。
候选内容：一行一个，填写供随机抽取的词库。

三、保存与预览

标签配置完成后，建议先预览抽取结果，再统一保存，避免配置错误影响模板或提示词调用效果。

批量保存
页面底部固定有「保存标签配置」按钮，可一次性保存所有标签修改。
随机预览
点击「随机预览」，查看当前标签配置抽取出来的实际效果。
卡片管理
可根据业务需求新增或删除标签卡片，保持标签配置与模板调用场景一致。

四、注意事项

标签管理会影响模板、提示词和生图结果。正式保存前，重点检查作用域、保存状态和图片目录路径。

注意

Scope 选择：操作前必须先选定对应的站点或账号 Scope（作用域）。
保存限制：在演示模式下，或系统表结构未就绪时，保存功能可能会被禁用。
目录真实性：图片标签中配置的目录路径必须真实存在于媒体库中，否则会导致抽取结果为空。

18. 产品服务

本模块用于为首页模板中的 {product_list} / {service_list} 标签提供内容数据。数据按站点独立维护，操作前请务必先选定目标站点。

页面结构

页面顶部支持切换“产品”或“服务”类型，中间区域展示对应的数据列表。新增与编辑操作均在弹窗中完成。

弹窗字段说明

在新增或编辑弹窗中，需配置以下字段：

类型填写 product 或 service，随页面顶部切换自动匹配。

标题必填项，用于展示内容名称。

副标题 必填项，用于展示卖点摘要。

封面图片 必填项，需从媒体库中选择。

描述填写完整说明内容。

系列 / 分类 例如填写“热销系列”，模板端可按此分类进行筛选展示。

排序值 数值越大越靠前展示，默认为 0。

状态支持设置为“启用”或“禁用”。

配置建议

素材准备 提前将所需的封面图片上传至媒体库，以便在配置时直接选择。

建议使用“系列 / 分类”对产品进行分组，便于首页模板按分类调用与调整。
暂时不需要展示的内容，建议先设为“禁用”，无需急于删除。
本页面的数据仅影响当前选定的站点。切换站点后列表为空，属于正常现象。

操作说明

操作范围 系统支持常规的新增、编辑、删除以及批量删除操作，批量删除采用 AJAX 无刷新方式执行。

完成产品或服务配置后，检查字段内容、封面图片、分类和状态。
根据需要执行新增、编辑、删除或批量删除操作。
配置修改完成后，前往首页模板预览，确认列表数据是否已正常调用并展示。

19 · 首页模板

19.首页模板

首页模板是内容侧最核心的配置页之一。提示词、分站 AI 开关、公共模板池、站点模板绑定都在这里维护；AI 模型和 API Key 则在「AI配置」中管理。

提示词配置公共模板池站点绑定分站 AI 开关

01先选站点

内容整理

所有首页模板配置都按站点隔离。进入页面后，先选择目标站点；未选择站点时，大部分操作按钮会处于不可用状态。

02区块 1：提示词配置

该区块用于维护首页生成提示词，以及分站 AI 页面相关配置。建议先确认业务行业，再根据模板变量调整提示词内容。

页面生成系统提示词

可从 prompt/system 模板插入，再按行业需求修改。

公共模板提示词

用于生成首页 HTML，支持 {input_tag} 等标签。

分站 AI 页面开关

支持设置为「关闭」或「启用」。是否开启取决于当前生成模式。

分站 AI 页面提示词

走 ai_content 模式时使用，必须包含 {assigned_title}，否则标题池分配的标题无法接入文章。

03区块 2：生成目标

生成目标决定 AI 生成后的首页 HTML 写入到哪一个公共模板中。执行生成前，务必确认目标模板和备份策略。

配置项	说明	建议
选择目标模板	选择要生成到哪一个公共模板。	生成前确认模板名称，避免写入错误模板。
覆盖前备份	生成内容覆盖旧配置前是否自动备份。	建议选择「自动备份」，避免直接覆盖导致数据丢失。

04区块 3：站点模板绑定

内容整理

可为当前站点勾选多个公共模板。正式发布时，系统会从已绑定模板中随机选择一个使用。

如果希望页面表现更稳定，绑定的公共模板数量可以少一些。
如果希望页面样式轮换更多，绑定的公共模板数量可以多一些。

05区块 4：公共模板池

公共模板池用于维护可复用的首页模板。可以新建模板，也可以编辑已有模板，并通过预览确认效果。

选公共模板

输入 0 表示新建公共模板。

模板名称

按业务或版式用途自定义命名，方便后续识别。

HTML

支持代码编辑，也可以使用可视化 DIY 调整模板内容。

可用操作

支持保存公共模板、预览公共模板、预览正式页和删除；删除操作会有确认提示。

06推荐操作顺序

选择站点先确认当前配置要写入哪个站点。
保存提示词保存系统提示词和页面提示词。
预览变量替换先点击「预览替换后提示词」，确认变量替换正常。
选择目标模板选定目标公共模板，并开启自动备份。
生成模板内容执行「生成到当前公共模板」。
预览并保存绑定预览满意后，保存站点配置与模板绑定。

07踩坑与注意事项

上线前重点检查

模板、变量和预览参数都可能影响最终页面效果，正式生成前建议逐项核对。

模板示例里的产品或服务列表，需要按自己的行业调整，不要直接照搬。
预览链接默认可能带固定城市参数，检查时不要和正式站访问结果混淆。
分站 AI 页面提示词必须包含 {assigned_title}；缺少该变量时，标题池分配的标题会对不上正文。

AI CONTENT MODULE · 标题库存配置

20. 标题池

AI 分站内容模式强依赖标题池。标题库存监控、自动繁衍、企业微信预警等核心功能，均在本页面完成配置。

库存监控自动繁衍企业微信预警按站点隔离

一、先选站点

标题池数据按站点隔离。进入页面后，请先选定目标站点，再进行后续配置。

数据标识

标题池的存储标识一般为 title_pool:site_{站点ID}。不同站点之间的标题库存相互独立，避免跨站误用。

进入标题池页面。
在页面顶部选择目标站点。
确认站点无误后，再维护标题库存、繁衍规则和预警配置。

二、区块 A：标题池管理

此区块用于维护当前站点的标题库存。标题数量、备注说明和编辑限制都需要在这里确认。

说明文案

支持自定义编辑，可用于备注当前标题池的用途、规则或维护说明。

标题列表

录入时保持一行一个标题。系统保存时会自动去除空行，并执行去重处理。

编辑限制

当标题数量超过 2000 条时，页面会禁止直接编辑。此时需先缩减标题数量，再进行修改。

三、区块 B：标题繁衍设置

通过配置繁衍规则，系统可在标题库存不足时自动补充标题。

配置项	填写规则	说明
库存预警阈值	最低为 1，表单常见默认值为 100。	用于判断标题库存是否进入预警范围。
单次繁衍数量	取值范围为 1～1000，常见默认值为 200。	控制每次自动补充的标题数量。
自动繁衍模式	支持「关闭」或「开启自动入库」。	开启后，系统可按库存规则自动补充标题。
自动触发比例	取值范围为 0.01～1，常见默认值为 0.3。	与库存预警阈值共同决定触发线。
繁衍提示词	可留空使用系统默认提示词。	支持填入站点、库存、批次、已有标题样本、随机关键词等变量。

触发线计算

触发线 ≈ 阈值 × 比例。配置时应结合站点实际消耗速度，避免触发过早或过晚。

四、区块 C：预警通知

配置库存预警通知后，当标题不足时可及时收到提醒，便于提前补充库存。

启用企业微信机器人

开启后，系统会通过企业微信推送标题库存预警消息。

Webhook 地址

填写企业微信机器人的 Webhook 接口地址。

@手机号列表

一行一个手机号。支持填写 @all 提醒全员；留空时仅发送群消息。

推送规则

系统会在首次触发预警，或预警级别升级时推送消息。

五、待审核与手动触发

针对繁衍结果与任务执行，系统提供待审核入库、手动触发和任务清理等管理操作。

待审核入库：繁衍结果可能进入待审核状态，需要人工确认后点击「审核后入库」。
手动触发：可点击「触发标题繁衍」，立即生成一批标题。
任务清理：支持清理非处理中的繁衍任务，避免历史任务长期堆积。

六、消费规则

理解标题池的消费机制，有助于规划库存数量，避免 AI 分站任务因标题不足而中断。

顺序消费

标题会按顺序被分配使用。

失败重试机制

任务失败重试时会复用已分配的标题，不会二次扣除库存。

单任务消耗

同一分站的 AI 任务通常只消费一个标题。

七、踩坑与注意事项

配置和使用标题池时，请重点留意数据库、阈值和空池运行风险。

空池运行风险

若标题池已空，但仍在运行 ai_content 任务，任务很容易因标题耗尽而失败。

问题	处理方式
数据库表缺失	若系统提示缺少 `sys_configs` 表，请先执行升级 SQL。
阈值设置不当	自动繁衍仅依靠库存逻辑触发，请根据实际消耗合理设置阈值，避免频繁触发或无法触发。
标题池库存不足	正式运行 AI 分站内容任务前，先确认标题池有足够库存，并按需开启自动繁衍和预警通知。

21. 站点运行参数

本页用于配置站点的“单条分站生成间隔”。通过控制生成节奏，可以降低服务器或接口在高频任务下的负载压力。

单条生成间隔

站点级默认值

队列任务参数

负载控制

一、配置方法

进入页面后，先确认目标站点，再填写该站点默认使用的单条分站生成间隔。

选择目标站点
在站点选择项中选中需要调整运行参数的站点。
填写生成间隔
填写「站点默认单条分站生成间隔（秒）」。
确认参数含义
填写 0 表示回退到 app.php 中的全局默认间隔；填写正整数表示该站点后续新任务默认使用此间隔。
保存运行参数
点击保存后，该站点后续新入队任务将按新的默认间隔执行。

内容整理

二、优先级说明

间隔参数存在多级来源。系统执行任务时，会按优先级从高到低读取可用配置。

1
批量生成提交页手动填写的间隔
提交任务时临时填写的间隔优先级最高。
2
本页设置的站点默认间隔
未在批量生成提交页手动指定时，系统使用当前站点的默认间隔。
3
全局默认间隔（app.php）
当站点默认间隔填写为 0 时，系统回退到全局默认间隔。

三、并发机制（只读理解）

worker_num 可配置为 3 或 5 等数值。系统通过 site_runtime_lock 控制站点任务的执行方式。

同一站点

同一站点的任务保持串行执行，避免同站点任务互相抢占。

不同站点

不同站点的任务可以并行执行，提升整体队列处理效率。

Worker 数量

Worker 数量通常在服务器进程配置中修改，本页面不直接调整。

注意

本页面主要用于调整生成间隔，并非直接修改 Worker 数量。需要修改 Worker 数量时，应到服务器进程配置中处理。

四、生效范围

运行参数修改后，只影响之后新入队的任务。

新任务

保存后的新入队任务，会按当前页面的最新参数执行。

已入队任务

已经进入队列的任务，会继续使用入队时固化的间隔参数。

参数变更

当前页面的修改不会反向改变已入队任务的执行间隔。

五、配置建议

不推荐

临时加速：如果只是临时加速某个特定任务，请前往批量生成页单独填写更小的间隔，避免直接修改全局参数或站点默认参数。

CITY CLUSTER SYSTEM · TASK QUEUE

22. 批量生成

批量生成页面用于配置“提交任务时的运行参数”，不是长期系统设置页。每次提交任务时，都可以单独覆盖生成间隔等参数，是批量建站流程中的核心操作页。

温馨提示

本页参数只影响本次提交的任务。长期默认参数应在站点运行参数或全局配置中维护；提交任务前，请先完成域名、规则、模板和 AI 相关配置检查。

一、提交前检查清单

提交批量生成任务前，先确认以下前置配置已经就绪。任意关键项缺失，都可能导致提交按钮不可用、任务失败或生成结果异常。

站点已绑定域名

若站点未绑定可用域名，批量生成提交按钮将被禁用。

生成规则已配置

确认当前站点的标题、关键词、描述和路由规则已正确配置并保存。

模式选择已确认

公共模板模式和 AI 分站内容模式的前置要求不同，提交前需核对当前使用模式。

AI 分站内容模式专属检查

标题池有充足库存。
首页模板中的分站提示词包含 {assigned_title} 变量。
AI 配置可用，且当前状态正常。

二、本次可配参数

提交任务时，可针对本次执行单独设置以下参数。这里填写的值只作用于本次入队任务。

配置项	填写说明	执行影响
生成模式	可选择公共模板 `normal` 或 AI 分站内容 `ai_content`。	决定本次任务使用公共模板生成，还是为分站生成独立 AI 内容。
默认生成层级	支持选择省、市、区县、街道。	决定系统按哪个行政层级生成分站内容。
指定城市 ID	选填。留空时，系统将按所选层级全量生成。	用于指定从某个城市节点开始生成。
向下展开到	`0` 表示仅生成所填 ID 对应内容；`1～4` 表示展开到对应行政层级。	用于控制从指定节点继续向下生成的范围。
执行轮次	需填写大于等于 `1` 的整数。	每一轮都会作为独立任务执行。
本次单条间隔（秒）	可留空、填 `0`，或填写具体秒数。	决定本次任务每条生成之间的等待时间。

本次单条间隔填写规则

留空：回退到站点运行参数；若站点未设置，则继续回退到全局 app.php。
填 0：不额外等待，连续生成。
填数字：本次任务优先使用填写的间隔时间。

三、间隔优先级

系统执行任务时，间隔时间会按优先级逐层取值。优先级从高到低如下：

任务页手动填写的间隔

本次提交时填写的间隔优先级最高，会覆盖其他默认设置。

站点运行参数中的间隔

任务页未填写时，系统会读取当前站点的运行参数。

全局默认间隔

站点运行参数也未设置时，最终回退到全局 app.php 配置。

四、操作按钮

页面提供两个核心操作按钮。建议先计算规模，再提交入队，避免一次性提交超出预期的任务量。

①

计算页面数量

正式开跑前，先预估本次生成规模，用于判断任务量是否符合服务器承载能力。

②

提交入队任务

确认配置无误后，将本次生成任务加入执行队列，由 Worker 后台处理。

注意

若站点绑定了多个域名，提交任务时系统可能会随机选择一个主域名。正式生成前，请提前确认站点域名绑定情况。

五、相关跳转

如果提交前发现配置缺失，可通过页面快捷链接进入对应模块补齐配置。

站点运行参数标题池首页模板 AI页面任务

CITY CLUSTER SYSTEM · 分站验收

23. 分站结果

本页面用于查看分站生成结果，并按需执行数据清理。它通常不保存长期业务参数，但与配置验收强相关：生成规则、首页模板、域名等配置是否正确，最终都需要在这里查看结果并确认。

页面定位

查看筛选生成结果

导出进入导出任务

清理删除无效数据

一、核心操作说明

在本页面中，主要围绕结果查看、URL 导出和收尾清理三类操作展开。建议先完成筛选与核对，再执行导出或删除动作。

查看结果 按条件筛选并查看分站生成结果，用于确认页面标题、内容、URL 和站点绑定是否正常。
导出 URL 导出路由 URL。提交后，系统会自动转入导出任务流程。
数据清理 执行删除、批量删除或清空操作。该类操作会影响结果数据，请谨慎处理。

二、配置验收对照指南

查看结果时如果发现异常，不要直接在结果页反复重试。应根据异常现象回到对应配置页面排查并修改。

异常现象	回到哪里检查
标题怪异	前往「生成规则」「关键词池」检查标题规则、关键词数据是否合理。
页面内容不对	前往「首页模板」「产品服务」「标签管理」检查模板调用与素材配置。
URL 协议或域名不对	前往「域名管理」「站点绑定」检查根域名、访问协议和绑定关系。
AI 正文不对	前往「标题池」「AI配置」「分站提示词」检查标题分配、模型配置和提示词内容。

三、操作注意事项

危险操作

本页面仅用于查看结果、导出数据及收尾清理，请勿将其当作设置页频繁点击「清空」。如需调整业务参数，请前往对应配置页面修改，完成后再回到本页面验收结果。

AI QUEUE OPS · 分站任务运维

24. AI页面任务

本页面是 AI 分站页面任务的队列运维页，主要用于处理任务卡住、任务失败、任务推进以及数据清理等情况。

请注意：业务参数不在本页面修改。提示词、标题池、模型、提交间隔等配置，需要回到对应功能页调整。

页面定位 这里负责运维队列，不负责修改业务配置。先看任务状态，再按异常类型处理。

任务状态

失败重置

中断回收

数据清理

一、常见操作

操作成功

在日常运维中，可以在本页面执行以下队列处理动作。

查看任务状态与异常信息 先确认任务当前状态、失败原因和异常提示，再决定后续处理方式。

处理 / 推进任务 对可继续执行的任务进行推进，避免队列长时间停留在处理中。

回收中断任务 用于处理执行过程中被中断、未正常结束的任务。

重置失败任务 适用于已确认配置问题修复后的失败任务，不建议盲目反复重置。

恢复标题耗尽类任务 标题池补充完成后，可在本页继续处理因标题耗尽导致的任务异常。

清理已完成任务 用于清理已经完成的历史任务记录，保持队列页面更清爽。

内容整理：如果页面出现“清理历史标题库引用”按钮，仅在确实需要处理对应历史引用时点击。

二、任务老失败时，去哪改“配置”

危险操作：如果任务频繁失败，请勿只在本页面反复重置或推进。应先回到对应配置页修正参数，再回来处理任务。

异常方向	处理位置
AI Key / 模型问题	前往「AI配置」页面检查 Key、模型、启用状态和检测结果。
分站提示词或开关问题	前往「首页模板」页面调整分站提示词、AI 开关及模板绑定。
标题库存或繁衍问题	前往「标题池」页面补充标题库存，或修改标题繁衍相关设置。
间隔过密导致异常	前往「站点运行参数」或「批量生成」页面调整提交间隔。

三、注意事项

1 区分运维与配置：请勿将本页的运维按钮当作业务开关配置使用。业务参数应回到对应配置页修改。

2 谨慎执行批量操作：点击“重置”或“清理”前，务必先核对筛选条件，避免误伤其他站点的正常任务。

IndexNow · Operations

25. 推送队列

本页面用于维护 IndexNow 主动推送队列，主要处理队列筛选、异常任务回收和历史记录清理。是否推送以及使用 HTTP 还是 HTTPS，主要取决于站点与域名配置，本页不负责调整这些业务配置。

队列筛选 快速定位指定状态或关键词的任务。

异常处理 回收中断任务，恢复失败任务执行。

记录维护 清理已完成和处于冷却状态的记录。

一、筛选与工具

进入推送队列页面后，可根据实际运维需要使用以下功能：

01 数据筛选 按任务状态、关键词等条件筛选队列记录。
02 重置失败 将推送失败的任务重置，使其可以重新执行。
03 回收中断 回收因异常中断的任务，避免队列持续卡住。
04 清理已完成 清除已经成功完成的推送记录，释放队列空间。
05 清空冷却 清空处于冷却状态的任务记录。

操作提示 执行清理或重置操作前，请先通过筛选条件确认目标任务范围，避免误处理其他队列记录。

二、与配置的关系

推送队列中的任务结果与以下系统配置密切相关。遇到地址错误、任务无响应等问题时，应优先回到对应配置页面检查。

排查项目	处理位置	检查重点
域名协议与根域名	「域名管理」	检查域名是否正确，以及访问协议是否为 HTTPS 或 HTTP。
分站 URL 生成	「生成规则」与「站点管理」	检查路由规则，以及站点绑定的域名是否正确。
Worker 运行状态	「环境检测」或服务器进程守护工具	检查负责处理队列任务的 Worker 是否正常运行。

三、运维建议

队列堆积排查

如果发现队列大量堆积，请优先检查 Worker 进程是否正常运行，并确认服务器进程守护工具中的运行状态。不要只在本页频繁点击“重置”处理表面现象。

谨慎清空冷却

执行“清空冷却”操作前，请确认确实需要重新处理这些任务。短时间内重复触发推送，可能会对远端接口造成高频请求压力。

推荐处理顺序 先检查 Worker，再确认域名、站点和生成规则配置，最后根据任务状态选择重置、回收或清理操作。

CITY CLUSTER SYSTEM · EXPORT TASK

26. 导出任务

路由 URL 导出的任务中心。本页面几乎没有业务表单配置，重点用于跟进导出任务状态、检查导出文件可用性，并清理已完成或已过期的导出文件。

一、核心功能概览

操作成功

在本页面中，主要围绕导出任务状态和文件清理进行处理。

查看导出任务列表与文件状态。

处理或推进正在执行的导出任务。

回收执行异常或状态不一致的任务。

清理已经完成的导出任务记录。

清理已过期、无法继续下载的导出文件。

内容整理

二、与上游模块的关系

导出入口通常位于「分站结果」页面。导出任务提交后，会进入本页面进行状态跟踪。

在「分站结果」页面发起路由 URL 导出。
进入「导出任务」页面查看任务是否执行完成。
任务完成后，检查导出文件是否仍在有效期内，确认是否可以正常下载。

三、操作建议与注意事项

不推荐

功能边界：当前版本以任务执行和文件清理为主。请勿在本页面寻找“导出格式设置”相关配置项。

CITY CLUSTER SYSTEM · Supervisor

进程守护管理器

本节用于配置站群系统所需的常驻 Worker 进程。Worker 负责持续消费构建、分站页面、标题裂变、路由导出、IndexNow 推送和异步任务队列。配置时重点核对 PHP CLI 版本、启动用户、进程目录和脚本路径。

总建议

PHP

PHP 版本统一

优先使用与站点 Web 相同的 CLI PHP 版本。如果 php80 已安装 swoole、redis、openssl 等扩展，建议所有 Worker 统一使用 php80。

USR

启动用户统一

启动用户建议使用站点运行用户，宝塔环境通常填写 www。非必要不要使用 root，并确保该用户对站点目录、storage、日志目录和上传目录具备读写权限。

RUN

至少启动构建 Worker

至少需要启动 city-build-worker。其他 Worker 按功能是否启用决定，不需要的功能可以暂不添加对应守护进程。

版本提醒：如果服务器只有 php74 已安装 Swoole，也可以把所有 Worker 统一改为 php74。不建议长期混用 php74 和 php80，除非两边扩展、ini 配置和业务兼容性都已经验证通过。

配置前检查

确认 CLI PHP 可用

在服务器中确认实际可用命令是 php80、php74，还是完整 PHP 路径。

确认扩展已安装

Worker 使用的 CLI PHP 必须具备业务所需扩展，重点检查 swoole、redis、openssl。

确认启动用户权限

www 用户需要能读写站点目录、storage、日志目录和上传目录。

替换真实站点路径

示例中的 /www/wwwroot/你自己的站点目录/ 必须替换为服务器上的真实项目目录。

Worker 配置清单

下面的名称仅作为示例，实际可按自己的命名习惯填写。备注字段用于说明脚本用途，可按后台管理习惯自行调整。

名称	启动用户	进程数量	优先级	启动命令	进程目录	用途备注	PHP 版本建议	是否必须启动
`city-build-worker`	`www`	1	999	`php80 /www/wwwroot/你自己的站点目录/cli/swoole-build-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	构建任务常驻 Worker，持续处理站点生成与构建队列。	建议优先统一用 `php80`；如果服务器当前实际运行环境只有 `php74+swoole`，也可统一改成 `php74`。	必须站点构建、生成、队列消费都依赖它。
`city-page-work`	`www`	1	999	`php74 /www/wwwroot/你自己的站点目录/cli/swoole-substation-page-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	分站页面生成 Worker，持续消费分站页面任务并写入页面数据。	建议与主站其他 Worker 保持同版本，优先统一为 `php80`。	按需只有启用分站页面 AI 生成与分站页面任务时才需要启动。
`city-title-work`	`www`	1	999	`php74 /www/wwwroot/你自己的站点目录/cli/swoole-title-monitor-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	标题监控 Worker，扫描并派发标题裂变自动任务。	建议与标题裂变 Worker、分站页面 Worker 保持同版本，优先统一为 `php80`。	按需只有启用标题库存监控和自动裂变补量时才需要启动。
`city-title-fission-work`	`www`	1	999	`php74 /www/wwwroot/你自己的站点目录/cli/swoole-title-fission-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	标题裂变 Worker，持续处理标题裂变任务队列。	建议与标题监控 Worker、分站页面 Worker 保持同版本，优先统一为 `php80`。	按需只有启用标题裂变任务时才需要启动。
`city-export-url`	`www`	1	999	`php80 /www/wwwroot/你自己的站点目录/cli/swoole-route-url-export-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	路由导出 Worker，持续处理分站路由 URL 导出任务。	建议与主站其他 Worker 保持同版本，优先统一为 `php80`。	按需只有需要后台导出分站路由 URL 时才需要启动。
`city-indexnow-worker`	`www`	1	999	`php80 /www/wwwroot/你自己的站点目录/cli/swoole-indexnow-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	IndexNow 提交 Worker，持续消费 IndexNow 队列并批量推送。	建议与主站其他 Worker 保持同版本，优先统一为 `php80`。	按需只有 `app/Config/app.php` 中 `indexnow.enabled=true` 时建议启动。
`city-async-task-worker`	`www`	1	999	`php74 /www/wwwroot/你自己的站点目录/cli/swoole-async-task-worker.php`	`/www/wwwroot/你自己的站点目录/cli/`	异步任务 Worker，持续处理附件生成和模板生成等异步任务。	建议与主站其他 Worker 保持同版本，优先统一为 `php80`。	按需只有启用异步任务、附件生成、首页模板生成等功能时才需要启动。

配置顺序

先确认服务器中可用的 CLI PHP 版本，并检查该版本是否已安装 Swoole 等必要扩展。
在进程守护管理器中新增进程，启动用户统一填写 www。
将启动命令中的 php80 或 php74 替换为服务器真实可用的 PHP 命令。
将 /www/wwwroot/你自己的站点目录/ 替换为真实站点目录。
先启动 city-build-worker，确认运行中后，再按功能启用其他 Worker。
保存后观察进程状态，如进程反复退出，优先检查 PHP 版本、脚本路径、扩展和目录权限。

关键结论：city-build-worker 是基础必开进程；其他 Worker 按功能启用。正式环境建议统一 PHP CLI 版本、统一启动用户，并确保 Worker 进程目录指向项目的 cli/ 目录。

内容已加密

你的前景，远超我们想象