AI Station v0.5.1 中文使用手册
更新日期：2026-11-02

请先阅读：
本手册对应本安装包的“AI 单站后台”。示例中的 example.com、a.example.com、b.example.com 都是说明用域名，请替换为你自己已解析并由服务器接收的域名。示例 API 地址不是可用服务。后台保存配置不会替你操作域名 DNS、宝塔站点、HTTPS 证书或外部网站。
本包是源码部署包；本轮开发与验证仅在本地隔离数据环境完成，未访问或修改线上站点，未调用真实或付费 AI。真实生成速度由接口、模型、输出长度、网络和限流共同决定。

====================
一、安装与升级
====================
1. 运行环境：代码要求 PHP 8.1+；本轮验证基线为 PHP 8.2.35。需要 PDO SQLite、cURL、mbstring、OpenSSL 等相应扩展。并发生成需要 curl_multi 支持。不能把本包当作 PHP 5/7 程序安装。
2. 解压后把网站运行目录设为 public。项目根目录中的 lib、bin、data、storage 不应成为公开 Web 目录。
3. Nginx 参考 deploy/nginx.conf.example，修改实际根目录、PHP-FPM 地址和域名；Apache 使用 public/.htaccess，核对 rewrite 与 AllowOverride。网站运行目录必须为 public。
4. PHP 进程需要有权限在私有 data 和 storage 目录写入 SQLite 数据库、应用加密密钥和页面导出文件。运行时会创建所需目录。
5. 第一次打开 /console，按页面提示初始化管理员。账号 3–64 位；密码至少 10 字节。初始化成功后进入中文控制台。
6. 升级旧站之前请自行完整备份程序、data 和 storage。已有 data 中的 .app-key 是旧 AI 密钥解密所需文件，必须与对应数据库一起保留，不可用新生成的密钥代替。
7. 本 ZIP 不包含运行数据、数据库、.app-key、账号密码、AI 密钥或本地测试夹具。不要把测试生成的数据复制到正式环境。
8. 如需不依赖浏览器持续生成，由管理员根据部署路径配置 bin/worker.php 的计划任务。先在命令行查看 worker 参数及部署说明，使用正确 PHP CLI 环境和站点数据目录。浏览器生成与服务端 Worker 共享并发与任务租约，不要用重复创建批次来“加速”。
9. 新版静态资源带版本参数；升级后若仍看到旧界面，请强制刷新浏览器，并确认服务器/CDN 没有继续返回旧 JS/CSS。
10.nginx伪静态

location / {
    try_files $uri /index.php?$query_string;
}

====================
二、推荐的第一次操作顺序
====================
1. 多 AI 服务库：保存一个你实际可用的接口配置，再点击该配置的“测试连接”。
2. 自定义文本库：按需要保存品牌、卖点、地区等素材；没有需要可以跳过。
3. 模板与 TDK 转码：编辑预填的完整 HTML 示例并保存。若暂时不套模板，批量生成中可以选“不套模板”。
4. 批量 AI 生成：先用 1–3 个关键词、小批量运行；需要域名时选择对应模式。
5. 先“分块导入并创建批次”。勾选“导入完成后立即在本浏览器开始生成 AI 单页”才会在完整导入后自动启动；未勾选时，创建后点击“开始生成 AI 单页”。
6. 生成任务与耗时：查看状态、HTTP 错误、单项耗时，以及批次域名清单。
7. 页面管理：预览页面；需要统一 SEO 时勾选页面，一键应用模板的 TDK 或完整模板。
8. 页面域名绑定：查看成功页面的域名绑定。如采用模板动态路由，按本手册第九节设置。

====================
三、站点概览与自动同步
====================
概览显示页面、域名、访问和蜘蛛统计、运行状态、最近生成批次。
后台会自动查询进度：有排队或生成任务时约每 2 秒，空闲约每 6 秒。这里是定时读取服务器结果，不是 AI 逐字输出流。网络或服务器繁忙时实际间隔会增加。
顶栏“自动同步正常 / 同步中 / 暂停 / 异常”显示同步状态与最近成功时间；时间按北京时间显示。
AI 的 work 请求尚未返回时，仍允许读取任务、统计、页面与域名这些进度信息。一般配置保存或批次上传期间暂缓读取，防止旧响应覆盖新数据。普通表单的未保存草稿不会被轮询覆盖。
切到浏览器后台会暂停轮询；回到本页或网络恢复后立即安排一次同步。不会因此自动重放超时的生成请求。
“刷新数据”仍保留，可主动拉取当前结果；它只读取数据，不会重新生成内容。
单条任务的“执行中”表示服务端已领取，成功数要等结果校验、页面保存和域名绑定完成才增加。AI 响应尚未完成时，成功数暂时不增加是正常现象。

====================
四、多 AI 服务库
====================
每个 AI 库是独立的一套接口、模型、提示词、并发和超时配置。可以保存多个库，在批量生成时选择本次使用哪个库。
字段示例：
- 库名称：企业内容接口（只是后台识别名称）。
- API 地址：https://api.example.com/v1。请使用服务商提供的兼容 OpenAI Chat Completions 接口根地址；程序根据兼容格式发送请求。
- API Key：填写你自己服务的密钥。编辑已有库时留空表示保持旧密钥，不会回显保存值。
- 模型名称：填写服务商实际支持的模型标识，例如其文档列出的模型名，不能只填一个自定义显示名称。
- 并发数：1–8。表示服务端可同时处理的请求数；实际还受全局 8 路限制、在途任务和上游限流约束。
- 请求超时：10–600 秒。应结合上游响应速度和服务器超时配置调整。
- 输出 token 上限：可填写 64–88888888，88888888 是允许的最大整数值；新配置参考值为 6144。保存的值会作为生成请求 max_tokens 传递，不会把 88888888 偷改为 8192 等较小值。已有记录不会因新版默认值改变而自动改写。
- 连接测试固定只请求很少内容（max_tokens=64），以检查接口可达性；它不会按生成的长文上限进行整页生成。
注意：把输出上限设成 88888888 不等于接口提速。服务商可能限制、拒绝或调整该值；更长输出通常需要更多时间。请根据服务商允许范围和实际页面长度设置。

提示词完整示例：
请围绕关键词“{title}”生成完整响应式 HTML 页面。目标人群：企业客户。品牌卖点：{brand_words}。地区：{city_words}。仅返回 HTML，不要 Markdown 围栏。

{title} 和 {keyword} 都表示本条关键词；{brand_words}、{city_words} 必须先创建同名标签的文本库，并在本批次勾选。模板中的 {content}、{domain}、{path}、{friend_links} 不是 AI 提示词系统变量。
创建批次时会保存 AI 配置和所选模板/文本库的快照；之后修改或删除库不会重写旧批次。新配置用于之后新建的批次。

====================
五、自定义文本库
====================
用途：把反复使用的品牌卖点、地区、服务内容保存为候选素材，让提示词按条随机取用。
一套可照填的示例：
名称：品牌卖点库
占位标签：brand_words
文本内容（每行一条）：
高端定制
快速交付
售后无忧

名称只是给后台使用者看。占位标签填写不带花括号的变量名，长度 2–32 位，以小写字母开头，后续只用小写字母、数字或下划线；不得使用系统保留标签。
使用时：保存文本库 → AI 库提示词写“围绕 {title} 写网页，突出 {brand_words}” → 批量生成时勾选“品牌卖点库” → 创建批次 → 开始生成。
程序在创建批次时冻结所选库全文；每条任务实际生成时从每个库随机抽一行，再替换相应 {标签}。不是把整个库一股脑塞进提示词，也不是创建批次时只抽一次供所有页面共用。
单库最多 2 MB；单批次最多选择 16 个库，快照总量最多 4 MB。不要把说明性文字（例如“下面每行一条”）当作素材行一起保存，否则也会被随机抽中。

====================
六、批量 AI 生成与域名模式
====================
每批支持 1–20000 个有效关键词。UTF-8 TXT 每行一个关键词；空行会忽略，行首尾空白会清理，保留有效行顺序和重复关键词。
选择 AI 库、可选模板、可选文本库；粘贴关键词或导入完整 TXT。上传块大小 1–500 行，默认 500；它是传输分块大小，不是 AI 并发数。

1. none：不绑定域名。
示例关键词：网站建设、网站维护。成功后生成页面，可用独立预览查看，也可之后手动绑定域名。

2. custom：按有效关键词与有效域名的较少数量，依序配对。
关键词：
网站建设
网站维护
域名：
a.example.com
b.example.com
含义：第一条成功后绑定 a.example.com，第二条成功后绑定 b.example.com。填写纯域名，不填 https://、路径、端口。创建数量为 min(有效关键词数, 有效域名数)：多余关键词跳过、多余域名未用，界面显示相应数量。所有输入仍会完整校验，续传摘要覆盖全量输入、顺序及重复项；不能把多余行随意删除后恢复旧导入。

3. random：纯小写字母 a–z 随机子域名。
根域名/字母泛格式填 3.example.com，表示三位字母，例如 abc.example.com；位数为 1–12。每页绑定数量在另一个字段独立填写 1–50，例如填 2 就为每页规划两个域名。3 不是“生成三个域名”。需要事先把相应泛域名解析并接入站点。新任务使用此格式；旧版已保存的裸根域名或字母数字计划仅按原计划兼容续传，不会在恢复时重新随机规划。

4. numeric：数字泛域名。
根域名/数字泛格式填 3.example.com，表示三位数字子域名，例如 007.example.com、111.example.com；3 不是“生成三个域名”。每页绑定数量由另一个字段决定。允许前导零和重复数字。有限空间耗尽会拒绝新任务，不会保证无限生成。

单批最多 20000 个域名绑定；random/numeric 的每页数量独立填写 1–50。有限空间不足会拒绝，不能无限分配。同域名已有页面、模板路由或其他任务预留时会报冲突，不会静默覆盖。直接创建时完成计划并预留；分块导入在 finish 分步物化中逐步预留，未完成物化的未来域名不代表已全部占用。
“分块导入并创建批次”主要负责上传输入并建立任务；若未勾立即生成，之后点击“开始生成 AI 单页”执行整个现有批次。这个按钮不是只生成一条，也不是再次新建批次。
勾选立即生成后，只有输入完整、导入完成且游标与任务编号核对通过才会启动。恢复旧导入不会顺带自动生成，请核对批次后明确点击开始。
关闭浏览器或“仅停止本浏览器驱动”会停止后续浏览器领任务；已经发送的请求仍可能在服务端完成，服务端 Worker 也不会因此暂停。
“暂停生成 AI 单页”提交服务端暂停，允许在途请求结算，但不再领取新项；继续后仍需要浏览器驱动或服务端 Worker。

导入中断时：重新提供完整原始关键词及完整原始域名，选择对应导入恢复。程序按顺序与重复项计算摘要核对，不要只提供“剩下没传的部分”。退出登录会清除本浏览器续传摘要；无法核对时不能盲目恢复。

====================
七、生成任务、耗时和域名清单
====================
任务列表保留最近 100 个批次。每个批次显示成功、失败、剩余、实际绑定与预留域名数，以及最多两个域名预览。
点击“查看详情”后：
- 进度条显示成功 + 失败的已处理量；待处理和在途另列。
- 顺序/关键词/域名列显示每条任务原先规划的域名，成功保存后才成为实际绑定。
- 单项耗时为已记录的处理耗时；HTTP 状态和错误原因帮助定位接口问题。
- 批次墙钟耗时从创建到结束，包含排队、暂停和等待，不等于纯 AI 请求耗时。
- 详情按服务端分页，100/250/500 条可选；“仅看失败”由服务端筛选。

新增“本批次域名清单”：
1. 全部计划域名自动保存在任务数据里。切换详情页、刷新浏览器或只看失败不会丢失。
2. 文本框显示全部计划域名，每行一个；“复制全部计划域名”可用于你的域名表整理。浏览器禁止剪贴板时会选中清单，可手动复制。
3. “导出全部计划 TXT”：包含成功、待处理和失败项的原计划，适合完整留档。计划不表示网站已生成成功。
4. “导出当前绑定 TXT”：导出前重新读取服务器，只包含本批次成功页面当前仍有效的域名绑定；解绑或删页后不再算有效绑定。
5. “刷新清单”：重新读取本批次域名与绑定情况。
域名导出不受详情当前页、每页条数或失败筛选影响。生成失败仍保留域名预留，方便同项重试；不要靠创建另一个批次抢同一个域名。

重试失败项只会把失败项重新入队，不会自动启动浏览器生成；必要时先继续批次，再点击开始。超时/网络中断后先核对任务记录，程序不会自动重放可能已经到达服务端的 work 请求。

AI 返回可为兼容完整 JSON 或 SSE 流。SSE 必须按协议结束并提供合法完成信号；断流、错误 finish、length、未结束的事件、非 HTML 或截断 HTML 会判失败，不发布半页或空页。合法 CR/LF 换行与分片会处理，缺少事件边界的残段不会强行当成成功。失败保留原域名计划和预留，核对原因后重试同项即可。此完整性检查不等同于浏览器标准 HTML 校验，也不保证内容质量。

====================
八、页面管理、模板与 TDK 转码
====================
页面管理中的独立预览用于查看已保存 HTML。预览不等同于域名根路径，也不参与普通访客跳转统计。
新建/编辑页面可以填写正文、标题和 SEO 三项。草稿安全预览禁脚本、表单和外部资源，只看草稿结构，不代表最终服务端渲染。

模板表单已预填完整的可编辑示例，安装包另有 examples/template-starter.html。可以直接复制该文件到模板 HTML 框，填写模板名后保存；保存模板不会自动覆盖已有页面。
模板占位符：
{title}：生成关键词/页面标题/路由标题。
{keyword}：与上述标题相同。
{content}：插入正文 HTML；若 AI 返回完整 HTML，套模板时提取 body 片段，避免把整份 HTML 再嵌进 HTML。
{domain}：动态模板路由的当前访问域名。
{path}：动态路由当前路径，例如 / 或 /news。
{friend_links}：动态路由根据当前访问域名与友链关系生成的链接 HTML。

适用范围要分清：生成或批量套用的静态页面没有当前请求域名上下文，此时 {domain} 为空、{path} 为 /，{friend_links} 不注入动态友链。需要按访问域名动态友链，请使用“模板路由与友链”。正文插入不是递归解析器；把 {content} 或 {friend_links} 再塞到正文中不会二次展开。
不存在 {description} 这个模板 HTML 变量。描述应填写 Description 模式，程序用它生成 SEO description 元标签。

TDK 三个模式示例：
Title：{title} - 企业服务
Keywords：{keyword},网站建设,企业服务
Description：了解 {title} 的服务内容、实施流程和常见问题。
模式支持 {title}、{keyword}；动态路由还提供 {domain}、{path}。
转码选择“不转码 / 十进制数字实体 / 十六进制数字实体”，只处理文档 head 中的页面 Title、Keywords、Description。SVG/MathML 的标题和可访问名称、template 内元数据、正文均保留。查看源代码时可能看到 &#...; 或 &#x...;，浏览器正常显示文字。

批量应用：
1. 页面管理中勾选 1–500 个页面。
2. 选择已保存模板。
3. “仅 TDK 和转码”：更新 SEO 三项和转码方式，保留正文。
4. “完整套用模板”：用模板重新包裹正文并更新 SEO，会修改正文，提交前需确认。
5. 保存后预览核对。若提示数据库已保存但导出缓存失败，先修复 storage 权限，再使用后台缓存重建，不要把已经提交的数据库操作误认为回滚。

新版完整套用会保存源正文和对应渲染结果。再次完整套用同模板或切换模板，使用保存的源正文重新渲染，避免不断嵌套外壳；仅 TDK 不改变正文。手动编辑正文后，旧源记录清除，下一次以修改后的内容为新基准。历史页面若从未保存源正文，只能以首次套用时的存储内容为基准，不能自动还原旧版已经覆盖的正文。

====================
九、模板路由：让域名首页直接使用模板
====================
模板路由是请求时按域名、路径渲染的页面，不调用 AI，不额外创建页面管理记录。适合固定首页/模板站。实体 AI 页面和模板路由是不同的显示入口。
已绑定实体页面在实际页面入口优先；同域名冲突时系统要求先解绑，不会自动覆盖。
“/”就是域名首页，例如 https://blog.example.com/ 最后那个 /。域名框只填 blog.example.com。

完整示例一：只给一个域名使用模板。
1. 到“模板与 TDK 转码”，填写模板名“博客首页模板”，保留/修改示例 HTML，保存。
2. 到“模板路由与友链”→ 路由总设置。
3. 勾选“启用模板路由”；适用范围选“仅已配置域名”；保持“允许内页”关闭。
4. 公共正文 HTML 填：
<h2>欢迎访问 {domain}</h2>
<p>这是 {title} 的首页，当前路径：{path}</p>
5. 保存路由总设置。
6. 右侧“绑定模板至域名根路径 /”：域名 blog.example.com，模板选择“博客首页模板”，页面标题“Example 博客首页”，内页不开启。保存。
7. 配置域名 DNS 和服务器虚拟主机，使 blog.example.com 访问该站点；HTTPS 另需正确证书。
8. 打开 https://blog.example.com/，模板显示标题，公共正文插入 {content}；正文中四个变量 {title}/{keyword}/{domain}/{path} 先替换一次。
9. /news 等路径在关闭内页时不会由该绑定自动显示。需要时编辑该域名并勾选“此域名允许内页”。总设置的内页开关只控制 all_hosts 未单独绑定的主机。
10. 路由总开关关闭时，单独域名模板绑定也不生效。

完整示例二：已接入的泛域名自动套模板。
1. 服务端接收需要的泛域名，并完成 DNS 泛解析。
2. 启用路由，范围改成“所有指向本站的主机名”（all_hosts）。
3. 选择自动模板候选；不选表示使用全部已保存模板。
4. 自动路由标题模式填“{domain} - 网站首页”，正文填写上面的片段。
5. 未单独绑定的有效域名会根据“域名 + 路径”的固定算法选择模板。同一域名路径刷新后不会重新随机换模板。
6. 单独域名绑定使用自己的模板/标题，不受自动候选与标题模式替换。
7. 静态资源、后台、预览、私有目录和 robots.txt 等受保留路径规则限制，不会被当成普通自动内页。

====================
十、泛页 HTML 拼接（首页 / 内页独立）
====================
这是单独的后台模块“泛页 HTML 拼接”。首页和内页各有自己的开关、Title/Keywords/Description 三组候选池，以及 HTML 第1/第2/第3组候选池；两个页面类型互不借用内容池。无需先生成 AI 页面，不调用 AI，也不向页面管理新增记录。

完整示例：
1. 先到“模板与 TDK 转码”保存一个含 {content} 的完整模板，推荐直接使用预填示例。没有 {content} 时，拼接正文没有插入位置。
2. 打开“泛页 HTML 拼接”，选择适用范围。“仅已配置域名”只处理“模板路由与友链”中已保存的模板域名；“所有指向本站的主机名”还处理服务器接收到的其他有效域名。DNS、虚拟主机与证书由你配置。
3. 按需要选择本模块的模板候选。已单独绑定的域名始终使用自身模板；未绑定主机按本模块候选→模板路由候选→全部已保存模板的顺序回退。自动模板按域名+路径固定选择，同一路径刷新不会每次换外层模板。
4. 勾选“启用首页拼接”。首页 Title 池填下面内容，独占一行的 --- 用来分隔候选；普通换行仍属于同一候选：
{domain} - 企业服务首页
---
欢迎来到 {domain}
5. 首页 Keywords 池可以填：
{title},企业服务
---
{domain},网站服务
6. 首页 Description 池可以填：
了解 {title} 的服务内容和常见问题。
---
欢迎访问 {domain}，查看企业服务与联系方式。
7. 首页 HTML 第1组填：
<section><h1>{title}</h1><p>欢迎访问 {domain}</p></section>
---
<section><h1>{title}</h1><p>为您提供企业网站服务。</p></section>
8. 首页 HTML 第2组填：
<section><h2>服务介绍</h2><p>当前路径：{path}</p></section>
---
<section><h2>服务流程</h2><p>沟通需求、确认方案、交付上线。</p></section>
9. 首页 HTML 第3组填：
<section><h2>联系与咨询</h2><p>欢迎了解 {keyword}。</p></section>
---
<section><h2>常见问题</h2><p>请通过站点公布的方式咨询。</p></section>
10. 内页需要单独勾选“启用内页拼接”，并单独填写六组候选；不要以为首页内容会自动复制。示例内页 Title 为“{domain} - {path}”，第1组为“<article><h1>{title}</h1></article>”，第2组为“<section>当前栏目：{path}</section>”，第3组为“<footer>欢迎阅读本站内容。</footer>”；Keywords/Description 同样单独设置。
11. 点击本模块保存按钮，提示“泛页拼接配置已独立保存”。此保存不代替“模板路由与友链”的总设置保存；本模块只使用首页/内页两个开关，不受模板路由总开关替代控制。
12. 通过实际域名访问 / 和 /news 等内页核对。已绑定模板域名要显示内页，仍须在该域名绑定上允许内页；服务器接收到的未绑定主机由本模块范围决定。

抽取与优先级：
- 每个适用请求分别从每个池随机抽一个候选，HTML 按第1→第2→第3组拼接，再放入外层模板 {content}；随机抽取可能连续命中同一项，不承诺每次刷新必定不同。
- 某组 HTML 为空就不追加该组；TDK 池为空时保留模板/绑定的相应默认值。Title 候选非空时作为页面标题，不再追加模板 Title 模式；Keywords/Description 非空则覆盖对应模式结果。
- HTML 内容支持 {title}/{keyword}/{domain}/{path}，动态值经 HTML 转义，适合放在文字或带引号属性中；不进行递归占位替换。{friend_links} 由外层模板输出，关系在“模板路由与友链”中维护。
- 已绑定实体页面的根路径优先于拼接；拼接未命中时再尝试普通模板路由。所有普通入口先执行蜘蛛/访客/IP/跳转控制，拼接不会绕过屏蔽，也不按蜘蛛与访客切换两套内容。
- 只处理 GET/HEAD；HEAD 不输出正文。后台、静态资源、独立预览、私有目录、robots.txt 等保留路径不参与拼接。独立页面预览不等于动态拼接预览。
- 每组候选最多 500 项；每组 HTML 最多 2 MB，每组 TDK 最多 8000 字节；配置内容总量最多 5 MB，接口请求体上限 6 MB。服务端反向代理的请求体限制也应足够。

====================
十一、友链站点与域名互链
====================
“友链站点”是可链接网站的通讯录；它不是 DNS 配置，也不是服务器绑定、更不是访问跳转。只登记通讯录不会立即输出链接，必须再建立源站→目标站关系，并使用支持友链的动态路由模板。

A、B 两个站都由本系统模板路由显示时的完整互链例子：
1. 确认模板 HTML 中有独立的 {friend_links}。示例模板页脚已包含。
2. 路由总设置启用；将 a.example.com、b.example.com 都绑定到这个模板，标题分别“A站首页”“B站首页”。
3. 在友链站点添加第一条：站点域名 a.example.com，标题 A站，URL https://a.example.com/，保存。
4. 添加第二条：站点域名 b.example.com，标题 B站，URL https://b.example.com/，保存。
5. 配置友链关系：源站选 A站，目标勾 B站。勾“同时追加反向链接（互链）”，保存。
6. 打开 A站首页，应有指向 B站的链接；打开 B站首页，应有指向 A站的链接。系统根据访问域名找源站，大小写和规范化应一致。
7. URL 中的域名必须与登记的站点域名一致；可使用同域 HTTP/HTTPS 地址，协议请按你实际证书情况填写。

外部合作站：可以登记 partner.example.com 为目标，让本站路由输出指向它的链接；勾互链只会在本系统保存反向关系。系统不会登录外部网站替对方加链接，对方须自行添加本站反链。
修改关系时，“保存”会替换当前源站的全部出链，未勾的目标从当前源站移除。互链选项是“追加反向”而非持续同步；后来取消互链勾选，不会自动删除之前保存的反向链接。要删除 B→A，切换源站到 B，再取消 A 并保存。
每站最多 200 个目标，不能自链。静态 AI 页面中已渲染的正文不会因友链关系改变而自动更新；请用模板路由实现动态关系。

====================
十二、页面域名绑定
====================
用于把已保存的实体页面绑定至纯域名根路径，与上一节“模板绑定”不同。
示例：先生成页面“企业网站建设”，在这里选择该页面，域名填 www.example.com，点击“绑定页面到域名根路径”。访问 www.example.com/ 时显示该页面。
不要填写协议、端口或路径；请先让 DNS 和服务器虚拟主机接收该域名。多个域名可以绑定同页；已有其他页面/模板绑定/任务预留会阻止冲突写入。
解绑只移除该域名绑定，不会删除页面。HTTP 与 HTTPS 链接只是便捷入口；系统不会因此自动签发证书。

====================
十三、蜘蛛管理与屏蔽
====================
蜘蛛名称与 UA 规则负责分类，分类不等于身份可信。别人可以伪造 UA，不能仅凭 Googlebot、Baiduspider 等字符串就认定官方来源。
规则可保存多个爬虫分类；新增时填写唯一引擎标识、显示名称、UA 关键字和 IP 规则。示例标识 mycrawler，名称 自用采集器，UA 规则 MyCrawler。IP 示例 192.0.2.0/24 仅用于格式说明，请填写你核实的来源。
“填充基线”使用随安装包保存的 UA/IP 数据，不是联网实时更新。官方共享快照与历史未确认网段会区分标注；历史数据不自动当作可信官方网段。
“允许蜘蛛”控制对应类别能否访问；总屏蔽模块、未知蜘蛛策略、人工 IP 黑名单等共同决定最终处理。
“记录假蜘蛛”只决定未验证/疑似蜘蛛是否记入相应记录，不会让其自动通过身份验证。
统计和最近访问中查看：分类、匹配依据、是否验证、处理动作和时间。官方 IP、管理员规则、双向 DNS、历史 IP、UA 匹配的含义不同。

====================
十四、访客屏蔽自定义 HTML
====================
在蜘蛛访问控制中开启普通访客屏蔽，可分别填写电脑和手机 HTML。示例：
<!doctype html><html lang="zh-CN"><meta charset="utf-8"><title>访问提示</title><body><h1>页面维护中</h1><p>请稍后访问。</p></body></html>
先保存，再用对应桌面/手机 UA 核对实际返回。可信蜘蛛和普通访客依据识别规则区分；不要用“能看到自己的网页”来推断所有蜘蛛都能访问。
管理员后台和独立预览具有专用入口行为；测试前先确认当前查看的是普通访问页面还是后台预览。

====================
十五、访问跳转与来源语义
====================
跳转设置填写完整 http/https 目标 URL。示例：https://target.example.com/landing。需要给访客返回自定义 HTML 时，请到“蜘蛛管理与屏蔽”的访客屏蔽设置中填写。
“直访/搜索”包含没有 Referer 的直访、识别的搜索来源及同站继续访问；“仅搜索”只在识别为搜索来源时触发；旧 all 配置表示包括外链在内的全部适用访问。
来自普通外站文章的点击与搜索来源不同，例如 news.example.com 不应被当作搜索引擎。google.com.evil.example 也不属于 google.com。
来源基于请求信息进行判断，浏览器可能不发送 Referer。不能把来源规则当作强身份认证。系统有防自跳规则；不要把目标设置成当前域名首页期待它反复跳转。
联调顺序：先确认源站能直接打开 → 检查触发范围 → 保存目标 → 用不同 Referer 核对 → 看访客日志中的处理结果。

====================
十六、IP、可信代理与 CC 防护
====================
黑白名单每行一条，可使用 IP、CIDR、IPv4 通配符或支持的范围。例：192.0.2.10、192.0.2.0/24 都是文档示例，应替换为你实际需要控制的地址。
手动黑名单优先于白名单；明确拒绝的爬虫策略也不会被 IP 白名单绕过。白名单、可信蜘蛛免 CC、普通访客屏蔽分别有自己的处理范围，不要把“免 CC”理解成绕过所有规则。
可信代理只填写你明确控制或核实的代理 IP/CIDR。只有连接对端可信时，程序才采纳配置的真实 IP 请求头及可选地理头。不得信任所有公网；/0、范围和通配符不能作为可信代理。
CC 请求阈值以每 IP 每秒计；超过阈值触发限流/自动封禁。封禁时长单位秒。先结合正常流量小范围测试，避免阈值过低。
关闭 CC 不等于关闭手动黑名单。后台的解除自动封禁不会删除手动黑名单条目。

====================
十七、日志与后台入口
====================
访客日志：支持按 IP/域名/路径、蜘蛛类别和跳转状态筛选，返回最近 N 条及汇总，保留 90 天；它没有 OFFSET 翻页。地区缺失表示没有可信地理信息，不可据此猜测位置。
操作日志：最近 200 条管理动作，按文字搜索；不提供访客 IP 列。用于确认保存、绑定、任务操作时间。
后台入口设置：填写 /console 或其他符合要求的独立路径，以 / 开头，后跟 3–64 位字母、数字、下划线或短横线。保存后跳转新入口，请记好并更新书签。

====================
十八、常见问题
====================
Q：点击开始后没有马上增加成功数？
A：先看顶栏同步时间和任务在途数。AI 正在返回时不会逐 token 算进度，只有保存成功后才计数。查看单项超时、HTTP 状态和错误原因；不要重复创建批次。

Q：为什么按钮显示“开始生成 AI 单页”，却是一批页面？
A：AI 单页指每个关键词产出一个页面；按钮驱动当前整个批次，直到完成、暂停、停止或发生需核对的请求异常。

Q：为什么 88888888 没有让 AI 更快？
A：它是最大输出长度参数。程序接受并传递该值，但上游仍有模型限制。用同一关键词比较响应时间时还应固定模型、内容长度、并发与网络。

Q：导出的域名还打不开？
A：全部计划 TXT 包含尚未成功项；先看当前绑定 TXT，再检查 DNS、站点接入、HTTPS、路由开关和 IP/访客规则。

Q：模板正文中出现 {domain} 原样？
A：模板路由公共正文仅支持明确的四个变量替换。外层模板支持完整模板变量；静态 AI 生成没有动态域名上下文。确认没有把外层模板变量当作自定义文本库或任意递归变量。

Q：友链登记了但页面没显示？
A：按顺序核对：通讯录同时登记源站与目标 → 保存关系 → 当前访问域名匹配源站 → 通过本系统动态模板路由显示 → 模板有 {friend_links} → 路由总开关开启。外部对方站需自行加反链。

Q：安全预览里占位符没有变？
A：安全预览只看草稿结构，服务端变量替换与 TDK 渲染在实际生成、套模板或模板路由时执行。保存后用页面预览/域名入口检查最终结果。

Q：出现校验失效或请求超时？
A：按页面提示重新获取会话，先核对服务端是否已完成操作。程序不会自动重放可能已经成功的写请求。

Q：数据库已保存，但缓存导出失败？
A：数据库提交成功和缓存文件导出是两件事。修复存储目录权限后重建缓存；不要误以为页面没有保存而反复新增。

====================
十九、随包文件说明
====================
README.md：安装入口与文档索引。
使用手册-中文.txt：本文件，含各功能填写方法、步骤和例子。
examples/template-starter.html：可复制到后台 HTML 模板框的完整参考模板。
CHANGELOG.md：本版修改说明。
UPGRADE-CN.md：升级步骤、数据库迁移、旧计划兼容和回退。
VERIFICATION.md：本地验证范围、实测结果及限制。
verification-final/acceptance-summary.json：脱敏验收摘要。
PACKAGE.json：发布清单与运行文件哈希。
SHA256SUMS.txt：包内文件 SHA-256 校验和；ZIP 旁的 .sha256 是压缩包整体校验值。

本版验收：自动回归 164 项通过/0 失败，真实 Chrome 13 项通过/0 失败（含关闭），PHP/JS 语法检查 17/17。详细范围和边界见 VERIFICATION.md。

手册中的流程是操作指导。正式站点启用前请在你自己的隔离站点确认接口、域名、证书、PHP 扩展、反向代理、计划任务和读写权限；本地合成 AI 回归不能替代真实环境联调。
