Initial commit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
谢宇宁
2026-09-29 11:47:47 +07:00
co-authored by Claude Opus 5.5
commit 0fbdba5ccf
622 changed files with 72105 additions and 0 deletions
@@ -0,0 +1,187 @@
# 黄果短剧全页面索引策略分析
## 输入信息与假设
- 分析范围:当前本地 Go 项目的全部页面路由、模板 `meta robots`、公共渲染层、`robots.txt` 和 sitemap 路由。
- 未提供线上域名,无法验证生产环境最终 HTML、HTTP 状态、真实 canonical 和 sitemap 内容;以下结论以代码为准。
- “需要索引”表示页面有独立搜索意图、稳定公开内容和唯一 canonical,建议输出 `index,follow` 并进入 sitemap。
- “不需要索引”表示登录/用户私有页、站内搜索、操作页、接口、重复 URL、错误页或低价值工具页,建议输出 `noindex` 或返回正确的 3xx/4xx。
- 分页页只要内容真实存在、URL 唯一并使用自引用 canonical,建议保持可索引。Google 官方也明确建议分页 URL 各自使用 canonical,而不是全部 canonical 到第一页。
## 总体判断
当前索引方向属于 **Mixed(基本方向正确,但存在明显一致性问题)**:
- 公开内容页基本为 `index,follow`。
- 搜索、账户、反馈、404 基本为 `noindex`。
- 但全站模板普遍输出两条 `meta robots`;登录/注册页更同时输出 `noindex,follow` 和 `index,follow`。
- `robots.txt` 又禁止抓取登录、搜索和账户页面,搜索引擎可能无法读取页面里的 `noindex`。Google 官方说明:被 `robots.txt` 阻止的页面,爬虫看不到 `noindex`,URL 仍可能只凭外链被索引。
- 空标签、空分类、无效专题、应用空列表和上游接口失败时,多个页面仍会返回 `200 + index,follow`,存在 soft 404 和索引膨胀风险。
## 一、明确需要索引的页面
以下页面有明确、稳定的搜索价值,建议 `index,follow`,只把 canonical URL 放入 sitemap。
| 页面类型 | 路由 | 建议 | 当前代码 | 条件与说明 |
|---|---|---|---|---|
| 首页 | `/` | 索引 | `index,follow` | 核心入口,必须索引 |
| 短剧主列表 | `/list/ai-short-play/` 及合法筛选页 | 索引 | `index,follow` | 合法的有限筛选页可索引;任意 slug 会被 canonical 重定向 |
| AI 成人剧集 | `/series/`、合法筛选及分页 | 索引 | `index,follow` | 内容真实存在时索引 |
| 标签聚合页 | `/tag/` | 索引 | `index,follow` | 应展示标签导航或有价值的聚合内容 |
| 有效标签详情 | `/tag/:slug/` 及有效分页 | 索引 | `index,follow` | 标签存在、列表非空、TDK/正文可区分时索引 |
| 排行榜 | `/rank/`、合法榜单类型及分页 | 索引 | `index,follow` | 有独立榜单意图;分页使用自引用 canonical |
| 今日更新 | `/today-update/` 及有效分页 | 索引 | `index,follow` | 有稳定的“今日更新/最新短剧”搜索意图 |
| 有效分类详情 | `/category/:slug/` 及有效分页 | 索引 | `index,follow` | 分类必须真实存在且有内容 |
| 专题总览 | `/topic/` 及有效分页 | 索引 | `index,follow` | 作为专题导航入口 |
| 有效专题详情 | `/topic/:slug/` 及有效分页 | 索引 | `index,follow` | 专题必须存在,具有独立介绍与内容集合 |
| 下载 APP | `/download-app/` | 索引 | `index,follow` | 官方下载意图明确;仅保留一个官方 canonical URL |
| 福利应用 | `/application/` | 索引 | `index,follow` | 当前有分类介绍和应用说明;空列表时不应索引 |
| 短剧详情 | `/detail/:slug/` | 索引 | `index,follow` | 最重要的内容承接页;不存在时已经返回 404 |
| 关于我们 | `/about-us/` | 索引 | `index,follow` | 品牌实体与可信度页面 |
| 帮助中心 | `/help-center/` | 索引 | `index,follow` | FAQ/帮助内容真实且公开时有搜索价值 |
路由证据见 `app/router/gin.go:127-255`;公开页面模板 robots 见 `app/templates/page/*.html`。
## 二、需要条件判断后再索引的页面
这些页面不应无条件 `index,follow`,需要 handler 根据内容状态设置 `noindex`、404、410 或 503。
| 页面类型 | 路由 | 推荐规则 | 当前风险 |
|---|---|---|---|
| 播放/章节页 | `/play/:slug/`、`/play/:slug/:chapterId/` | 章节真实存在、页面有唯一标题、可播放视频和足够正文时索引;无效章节返回 404;只有付费壳、无视频或与详情页高度重复时 `noindex,follow` | 当前只验证短剧存在,章节请求失败时仍可能用短剧数据渲染 `200 + index,follow`;所有章节描述还复用短剧简介 |
| 回家的路 | `/home-road/` | 若它是唯一官方最新地址发布页且内容长期维护,可索引;多个镜像域名只索引一个 canonical,其余 canonical/noindex | 多域名/导航站场景容易形成重复或 doorway 页面 |
| 官方导航 | `/nav/`;导航独立服务的 `/`、`/nav/`、`/dh/` | 只索引一个官方导航 URL;内容站副本和独立导航站副本之间必须明确 canonical,其余 noindex 或 301 | 当前各入口都可能输出 `index,follow`,代码未体现跨域唯一索引版本 |
| 通用富文本 | `/richtext/:title/` | 仅白名单中的公开、唯一、完整内容索引;协议、内部说明、重复帮助内容等 noindex 或 301 到固定语义路由 | 当前 `IsIndexablePath` 将全部 `/richtext/*` 视为可索引,容易暴露任意 CMS 内容和重复页 |
| 用户协议 | `/user-agreement/` | 一般不需要搜索流量,建议 `noindex,follow`;若业务要求公开检索也可保留索引 | 当前 `index,follow` |
| 隐私政策 | `/privacy-policy/` | 一般建议 `noindex,follow`,保留用户访问但不占索引配额 | 当前 `index,follow` |
| 标签/分类/专题第 1 页 | `/tag/:slug/`、`/category/:slug/`、`/topic/:slug/` | 不存在必须 404;存在但内容过少可 `noindex,follow`;达到内容阈值再 index | 当前只对“分页越界”处理 404,第 1 页空结果仍可能 200 可索引 |
| 所有公开列表空状态 | list/series/rank/today-update/topic/application | 合法但暂时为空可 noindex;上游故障应优先返回 503,不能把接口异常伪装成长期 `200` 空页面 | 多个 `Fetch...OrEmpty` 吞掉上游错误并继续输出可索引页面 |
## 三、明确不需要索引的 HTML 页面
| 页面类型 | 路由 | 建议 | 当前代码 |
|---|---|---|---|
| 登录 | `/login/`、`/login/return/*` | `noindex,follow`,不进 sitemap | handler 设置 `noindex=true`,但 `index.html` 又固定输出 `index,follow`;且 robots.txt 禁止抓取 |
| 注册 | `/register/` | `noindex,follow`,不进 sitemap | 同登录页,存在冲突 robots 标签 |
| 个人中心 | `/user-center/` | `noindex,nofollow`,不进 sitemap | 已输出 `noindex,nofollow`,但 robots.txt 同时禁止抓取 |
| 充值 | `/deposit/`、`/deposit/:tab/` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 收藏 | `/collect/...` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 观看历史 | `/history/...` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 账号设置 | `/setting/` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 编辑资料 | `/edit-profile/` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 修改密码 | `/edit-password/` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 站内搜索 | `/search/`、`/search/:keyword/...` | `noindex,follow` | 模板已 noindex,但 robots.txt 禁止抓取,爬虫可能看不到 noindex |
| 问题反馈 | `/feedback/` | `noindex,nofollow` | 已 noindex;robots.txt 同时禁止抓取 |
| 404/无效页面 | 未匹配路由、无效详情/分页 | 正确返回 HTTP 404/410,并 `noindex,follow` | 统一 404 模板已 noindex;部分无效聚合页仍可能返回 200 |
| 空富文本入口 | `/richtext/` | 返回 404 并禁止索引 | 当前因标题为空而进入统一 404,方向正确 |
| UI 弹窗片段 | `/ui/dialog/:name` | 不索引;建议响应头 `X-Robots-Tag: noindex`,并从 robots.txt 禁止抓取 | 当前未设置索引响应头,robots.txt 也没有 `/ui/` 规则 |
| 健康检查 | `/healthz` | 不索引;建议 `X-Robots-Tag: noindex` | 当前只是 200 JSON,无索引响应头,也未在 robots.txt 禁止 |
## 四、重复 URL:自身不索引,只让目标 URL 索引
| 重复/历史路由 | 当前行为 | 建议 |
|---|---|---|
| `/tag-list/...` | handler 301 到 `/tag/...` | 正确;不要进入 sitemap |
| `/more/...` | handler 301 到 `/topic/...` | 正确;不要进入 sitemap |
| `/list/ai-series/...` | 301 到 `/series/...` | 正确;不要进入 sitemap |
| 查询参数版分页/筛选 URL | 多数 handler 会重定向到路径式 canonical | 保持 301,只提交最终 canonical |
| 非规范 slug/ID URL | detail/category/topic 等尝试跳转规范 slug | 保持 301;旧 URL 不进入 sitemap |
## 五、非 HTML 路由和资源的索引策略
| 路由/资源 | 是否需要搜索索引 | 推荐控制方式 |
|---|---|---|
| `/api/*` | 不需要 | 保持 robots.txt 限制抓取;对可直接访问的 JSON 响应统一增加 `X-Robots-Tag: noindex` |
| `/h5/*`、`/enkey`、`/newenkey` | 不需要 | 保持 robots.txt 禁止;视频/密钥响应可加 `X-Robots-Tag: noindex` |
| `/robots.txt`、`/sitemap.xml`、`/sitemaps/*.xml` | 需要允许抓取,但不作为普通网页参与排名 | 返回正确状态和 Content-Type;无需放进 sitemap |
| Google/百度/Bing/IndexNow 验证文件 | 需要允许验证爬虫访问,不需要普通搜索索引 | 保持可访问;可选 `X-Robots-Tag: noindex`,不得放入 sitemap |
| `/favicon.*`、`/static/*` | 允许抓取以支持页面渲染和搜索展示,不作为 HTML 页面索引 | 不要整体 Disallow 静态 CSS/JS/图片 |
## 六、分页页是否索引
建议有效分页页继续 `index,follow`,包括:
- `/list/.../page/:page/`
- `/series/.../page/:page/`
- `/tag/.../page/:page/`
- `/rank/.../page/:page/`
- `/today-update/page/:page/`
- `/category/.../page/:page/`
- `/topic/.../page/:page/`
必须满足:
1. 每一页有唯一 URL。
2. 每一页使用自引用 canonical,不能全部 canonical 到第 1 页。
3. 分页越界返回 404。
4. 上一页/下一页使用真实 `<a href>`,保证爬虫发现深层内容。
5. 不需要为了分页强制写完全不同的 title/description;Google 可以识别分页序列,但加“第 N 页”更利于人工排查和结果辨识。
## 七、当前实现的优先级问题
### 高优先级
1. **robots.txt 与 noindex 冲突**
- 范围:登录、注册、搜索、账户、反馈页面。
- 证据:`app/templates/page/robots.txt:14-25` 同时禁止这些路径,而页面模板又输出 `noindex`。
- 影响:爬虫被挡住后无法读取 `noindex`,URL 仍可能以无摘要形式出现在结果中。
- 修复:若目标是“绝不进入搜索结果”,允许抓取这些 HTML URL并保留 `noindex`;私密内容本身必须通过鉴权保护,不能依赖 robots.txt。
2. **登录/注册页存在相反 robots 指令**
- 范围:`/login/*`、`/register/`。
- 证据:`app/api/web/index.go:35-36` 设置 `noindex`,`seoCommon.html:12` 输出 `noindex,follow`,但 `index.html:10` 又输出 `index,follow`。
- 影响:虽然 Google通常采用更严格规则,但重复冲突不利于跨搜索引擎一致性和测试。
- 修复:全站只保留一个由公共模板控制的 robots 标签。
3. **空内容和接口故障页仍可索引**
- 范围:标签、分类、专题、榜单、今日更新、应用等聚合页。
- 影响:soft 404、低质量索引、抓取预算浪费。
- 修复:区分“不存在”“合法为空”“上游故障”;分别返回 404、`200 + noindex`、503。
### 中优先级
4. **播放页无条件索引**:应按章节存在性、可播放性和内容唯一性控制。
5. **任意富文本均可索引**:应建立可索引白名单或后台 `indexable` 字段。
6. **导航页可能多域重复**:主站 `/nav/` 与独立导航站需确定唯一 canonical。
7. **法律页面默认索引**:若无自然搜索目标,用户协议和隐私政策改为 `noindex,follow`。
### 低优先级
8. **全站重复 meta robots**:`seoCommon.html` 与每个页面模板各输出一条,应统一到公共模板。
9. **本地未发现 sitemap XML 文件**:路由读取 `./templates/page/sitemaps`,当前仓库扫描未找到生成产物;需确认部署流程会生成并正确挂载,否则 `/sitemap.xml` 可能 404。
## 八、建议的最终索引矩阵
| 策略 | 页面 |
|---|---|
| `index,follow` | 首页、有效短剧/剧集列表、有效标签、排行榜、今日更新、有效分类、专题总览与有效专题、下载 APP、非空福利应用、短剧详情、关于我们、帮助中心、有效分页 |
| 条件 `index` | 播放章节、回家的路、官方导航、通用富文本、稀疏标签/分类/专题 |
| `noindex,follow` | 登录、注册、站内搜索、用户协议、隐私政策、合法但暂时空的公开聚合页 |
| `noindex,nofollow` | 个人中心、充值、收藏、历史、设置、编辑资料、修改密码、反馈 |
| 301 | `/tag-list/*`、`/more/*`、`/list/ai-series/*`、查询参数和旧 slug 变体 |
| 404/410 | 不存在的内容、无效 slug、越界分页 |
| 503 | 上游故障导致无法生成正常内容的公开页面 |
| `X-Robots-Tag: noindex` | `/ui/dialog/*`、`/healthz`、可直接访问的 API/非 HTML 工具响应 |
## 参考依据
- [Google:使用 noindex 阻止编入索引](https://developers.google.com/search/docs/crawling-indexing/block-indexing)
- [Google:robots meta 与 X-Robots-Tag 规范](https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag)
- [Google:robots.txt 不是阻止网页进入索引的机制](https://developers.google.com/search/docs/crawling-indexing/robots/intro)
- [Google:分页与增量加载最佳实践](https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading)
## 实施结果(2026-09-08)
已按上述矩阵完成以下代码调整:
- 全站 robots meta 收口到 `seoCommon.html`,每个 HTML 页面只输出一条规则。
- 登录、注册、搜索、账户、充值、收藏、历史、设置、编辑资料、修改密码、反馈和 404 已明确设置 noindex。
- 用户协议、隐私政策和任意通用富文本默认 `noindex,follow`;关于我们、帮助中心继续索引。
- `/richtext/关于我们/` 等重复地址会 301 到固定语义路由;页脚也直接生成语义路由。
- 空短剧列表、空剧集、空标签、空分类、空榜单、空今日更新、空专题和空福利应用自动 `noindex,follow`。
- 明确请求但不存在的播放章节返回 404;无法取得默认章节的播放页设置 noindex。
- `/api/*`、`/ui/*`、`/healthz`、媒体代理与密钥响应增加 `X-Robots-Tag: noindex, nofollow`。
- `robots.txt` 不再阻止登录、搜索和账户 HTML,使爬虫能够读取页面的 noindex;继续限制非 HTML 接口与媒体工具路由。
- `robots.txt` 合并为一个 `User-agent: *` 规则组,避免原先的 Disallow 只落在最后一个特定爬虫分组下。
仍需由部署配置决定的事项:主站 `/nav/`、独立导航站首页和 `/home-road/` 跨域时,哪一个域名作为唯一 canonical;代码无法在没有目标域名配置的情况下安全替用户做这个选择。
@@ -0,0 +1,98 @@
# 黄果短剧页面 TDK 来源分析
## 分析范围与口径
- 分析对象:当前本地 Go 项目的页面路由、SSR handler、公共渲染层和页面模板。
- 未提供线上域名,因此结论代表代码的运行逻辑,不代表某一线上环境当前接口里一定配置了 TDK。
- “动态获取”指 TDK 至少可从上游接口返回的 `seoInfo`、公共配置、导航 SEO 或内容字段生成。
- “写死”指模板内直接写固定文本,或 handler 传入固定常量;列表数据虽然动态,但未用于 TDK 的页面仍算写死。
- “混合”指部分字段动态、部分字段写死,或接口失败后回退到模板常量。
## 总体结论
项目不是简单的“动态 / 写死”两类,而是四种实现:
1. **后台 TDK 动态优先,模板常量兜底**:首页、标签、排行榜、今日更新、分类详情、专题详情等。
2. **依赖公共导航 SEO,页面业务接口本身不返回 TDK**:短剧列表、AI 剧集、福利应用、回家的路。
3. **根据内容或路由参数动态拼装**:短剧详情、播放、搜索、富文本。
4. **模板固定写死**:账户相关页、反馈页、下载页默认配置、404 的 D/K 等。
公共渲染层会读取 `/api/app/translation/category/list` 的导航项 `seoInfo`,按当前路径或 `navActive` 覆盖页面原有 `seoInfo`;字段级优先级是“导航 SEO > 页面 SEO > 模板兜底”。证据见 `app/api/web/render.go:25-54`、`app/service/translationser/list.go:13-55` 和 `app/service/translationser/view.go:154-185`。
## 一、完整 TDK 可动态获取的页面
这些页面的 T、D、K 都存在动态来源;动态字段为空或接口失败时,模板会回退到固定文案。
| 页面 / 路由 | T 来源 | D 来源 | K 来源 | 主要接口与说明 |
|---|---|---|---|---|
| 首页 `/` | 首页 `seoInfo.title`,导航 SEO 可覆盖;再回退公共配置和固定标题 | 首页 `seoInfo.description`,导航 SEO可覆盖;再回退公共配置/固定文案 | 首页 `seoInfo.keywords`,导航 SEO 可覆盖;再回退公共配置/固定词 | `/api/app/playlet/home`;`/api/app/config/info`;`/api/app/translation/category/list`。见 `app/api/web/index.go:20-38`、`app/templates/page/index.html:7-9` |
| 登录 `/login/`、注册 `/register/` | 与首页相同 | 与首页相同 | 与首页相同 | 两者复用 `index.html` 和首页接口,并没有登录/注册专属 TDK。handler 虽设置内部 `noindex` 标志,但模板的 robots 仍固定输出 `index,follow`。见 `app/api/web/index.go:15-38`、`app/templates/page/index.html:10` |
| 标签列表/详情 `/tag/...` | 标签接口 SEO 标题或标签名 + 分页 | 标签接口 SEO 描述;否则用标签名拼装 | 标签接口 SEO 关键词;否则标签名 + 固定词 | `/api/app/playlet/tag/list`;导航 SEO 仍可覆盖。见 `app/api/web/tag_list.go`、`app/templates/page/tagList.html:7-9` |
| 排行榜 `/rank/...` | 排行榜接口 SEO + 榜单筛选值 | 排行榜接口 SEO + 榜单筛选值 | 排行榜接口 SEO + 榜单筛选值 | `/api/app/playlet/rank`;导航 SEO 优先。见 `app/api/web/rank.go`、`app/templates/page/rank.html:7-9` |
| 今日更新 `/today-update/...` | 接口 SEO 或固定标题 | 接口 SEO 或固定文案 | 接口 SEO 或固定词 | `/api/app/playlet/today-update`;导航 SEO 优先。见 `app/api/web/today_update.go`、`app/templates/page/todayUpdate.html:7-9` |
| 分类详情 `/category/:slug/...` | 分类接口 SEO;否则分类名 + 分页 | 分类接口 SEO;否则 handler 固定分类介绍 | 分类接口 SEO;否则分类名 + 固定词 | `/api/app/playlet/recommend/list`;导航 SEO 可覆盖。见 `app/api/web/category_detail.go`、`app/templates/page/categoryDetail.html:7-9` |
| 专题详情 `/topic/:slug/...` | 专题列表接口 SEO;否则专题名称 | 专题列表接口 SEO;否则固定专题介绍 | 专题列表接口 SEO;否则专题名 + 固定词 | `/api/app/playlet/list` 提供 `seoInfo`,`/api/app/theme/list` 提供专题名;导航 SEO 可覆盖。见 `app/api/web/more.go`、`app/templates/page/more.html:7-18` |
| 官方导航 `/nav/`;导航独立服务的 `/`、`/nav/`、`/dh/` | `seoNavInfo.dhTitle` / `dhSiteName` | `seoNavInfo.dhDescription` | `seoNavInfo.dhKeyworld` | `/api/app/config/info`;失败时固定文案。见 `app/templates/page/nav.html:7-9`、`app/service/configser/types.go:118-124` |
## 二、条件动态:只依赖导航 SEO 的页面
这些页面不是从自身内容接口取得 TDK,而是依靠公共导航接口中与当前路由匹配的 `seoInfo`。如果后台导航没有配置 SEO,最终就是模板固定文案。
| 页面 / 路由 | 实际情况 | 动态来源 | 固定兜底 |
|---|---|---|---|
| 短剧列表 `/list/...` | 三个字段都支持动态;筛选项还会追加到 T/D/K | `/api/app/translation/category/list` 的导航 SEO | `短剧` 标题及模板内固定描述、关键词。业务接口 `/api/app/playlet/operate/list` 的响应结构没有 `seoInfo`,handler 也显式传入空 `SeoInfo`。见 `app/api/web/list.go:34-53`、`app/service/playletser/types.go:168-176` |
| AI 成人剧集 `/series/...` | 三个字段都支持动态;筛选项会追加到 T/D/K | 导航 SEO | 业务接口同样没有页面级 `seoInfo`,handler 没有传 `seoInfo`。见 `app/api/web/series.go:20-39`、`app/templates/page/series.html:7-9` |
| 福利应用 `/application/` | 三个字段都支持动态,但应用列表接口不参与 TDK | 导航 SEO | `福利应用` + 模板固定 D/K。见 `app/api/web/application.go`、`app/templates/page/application.html:7-14` |
| 回家的路 `/home-road/` | 三个字段都支持动态,但 `config/info.seoInfo` 并未传给模板的 `.seoInfo` | 导航 SEO | handler 固定标题,模板固定 D/K。见 `app/api/web/home_road.go`、`app/templates/page/homeRoad.html:7-9` |
| 下载 APP `/download-app/` | 模板具备 `.seoInfo` 动态入口,但 handler 不传;默认导航项被标记为下载项,会被导航 SEO 匹配逻辑跳过 | 仅当后台把它配置成可匹配的普通站内导航 URL 时才可能动态 | 通常落到模板固定的下载 APP TDK。见 `app/router/gin.go:202-207`、`app/templates/page/downloadApp.html:7-12`、`app/service/translationser/view.go:159-166` |
## 三、内容字段或路由规则动态拼装的页面
这些页面会变化,但不一定使用后台专门配置的完整 TDK。
| 页面 / 路由 | T | D | K | 判定 |
|---|---|---|---|---|
| 短剧详情 `/detail/:slug/` | 优先 `detail.SeoInfo.Title`,否则短剧名;站点名也可由接口 SEO/公共配置动态取得 | **不读取 `detail.SeoInfo.Description`**;只要 `detail` 存在,就使用短剧 `Desc`,为空则按短剧名拼固定句式 | **不读取 `detail.SeoInfo.Keywords`**;由短剧名、题材名、标签名和固定词拼装 | 内容动态拼装,不是完整后台 TDK。见 `app/api/web/detail.go:17-30`、`app/templates/page/detail.html:7-11` |
| 播放 `/play/:slug/:chapterId?/` | 优先章节 SEO 标题,其次短剧 SEO 标题/短剧名,并拼集数 | **不读取已经合并好的 `.seoInfo.Description`**;只要 `playlet` 存在,就使用短剧 `Desc` 或固定播放句式 | **不读取已经合并好的 `.seoInfo.Keywords`**;由短剧名、题材、标签和固定词拼装 | 标题动态取 SEO,D/K 是内容字段拼装。见 `app/api/web/play.go:37-60`、`app/service/playletser/seo.go:252-277`、`app/templates/page/play.html:7-17` |
| 搜索 `/search/:keyword/...` | 搜索词拼装 | 搜索词拼装固定句式 | 搜索词 + 固定词 | 路由参数动态,不读搜索接口的 SEO;页面为 `noindex,follow`。见 `app/api/web/search.go`、`app/templates/page/search.html:7-19` |
| 通用富文本 `/richtext/:title/` | 上游富文本 `desc/title` | 用动态标题套固定句式 | 动态标题 + 固定词 | `/api/app/config/richtext/list` 只映射 `id/title/desc/content`,没有映射 `seoInfo`,所以不是后台独立 TDK。见 `app/service/configser/types.go:133-145`、`app/service/configser/richtext.go:48-82`、`app/templates/page/richtext.html:7-18` |
| 专题列表 `/topic/`、分页 | handler 固定基础标题并按页码追加;公共导航 SEO 命中时也可覆盖标题 | 固定 | 固定 | T 动态/规则生成,D/K 写死。见 `app/api/web/theme_index.go`、`app/templates/page/themeIndex.html:7-9` |
| 404 / 未找到页面 | handler 的错误标题可变化 | 固定 | 固定 | 只有 T 动态,D/K 写死;`noindex,follow`。见 `app/api/web/notfound.go`、`app/templates/page/404.html:7-13` |
## 四、路由层“动态富文本优先、静态模板兜底”的页面
以下四个固定路由会先请求 `/api/app/config/richtext/list`:有内容时使用 `richtext.html`,按上一节的规则动态拼装;接口失败或找不到内容时,改用各自的静态模板,TDK 全部写死。
| 路由 | 动态成功时 | 接口失败时静态模板 |
|---|---|---|
| `/about-us/` | 富文本标题驱动的规则 TDK | `aboutUs.html`:TDK 写死 |
| `/user-agreement/` | 富文本标题驱动的规则 TDK | `userAgreement.html`:TDK 写死 |
| `/privacy-policy/` | 富文本标题驱动的规则 TDK | `privacyPolicy.html`:TDK 写死 |
| `/help-center/` | 富文本标题驱动的规则 TDK | `helpCenter.html`:TDK 写死 |
路由切换逻辑见 `app/api/web/richtext.go:26-50`。
## 五、TDK 写死的页面
这些模板不读取 `.seoInfo`,即使公共渲染层取得导航 SEO,也不会改变最终 TDK。
| 页面 / 路由 | TDK 情况 | 模板 |
|---|---|---|
| 个人中心 `/user-center/` | 全部写死 | `app/templates/page/userCenter.html:7-12` |
| 金币/会员充值 `/deposit/...` | T 由 handler 固定传入,D/K 写死;整体仍属固定 TDK | `app/templates/page/deposit.html:7-9` |
| 我的收藏 `/collect/...` | T 由 handler 固定传入,D/K 写死 | `app/templates/page/collect.html:7-9` |
| 观看历史 `/history/...` | 全部写死 | `app/templates/page/history.html:7-9` |
| 账号设置 `/setting/` | 全部写死 | `app/templates/page/setting.html:7-12` |
| 编辑资料 `/edit-profile/` | 全部写死 | `app/templates/page/editProfile.html:7-12` |
| 修改密码 `/edit-password/` | 全部写死 | `app/templates/page/editPassword.html:7-12` |
| 问题反馈 `/feedback/` | 全部写死 | `app/templates/page/feedback.html:7-12` |
以上账户页多数设置了 `noindex,nofollow`,固定 TDK 对自然搜索影响较小。
## 关键风险与建议
1. **详情页和播放页丢弃后台 D/K**:handler 已经拿到 `seoInfo.description/keywords`,模板在存在 `detail/playlet` 时却绕过它们。若后台运营会配置详情和章节 SEO,这部分配置当前不会生效。
2. **短剧列表和剧集列表没有页面接口 SEO**:二者完全依赖导航 SEO;导航未配置时所有筛选/分页页面主要使用相同兜底内容,仅筛选值可能由公共层追加。
3. **富文本 `seoInfo` 未映射**:数据模型中虽然服务端领域模型可见 `SeoInfo`,Web 上游响应结构 `AppRichTextItemResp` 没有该字段,当前只能用标题套固定句式。
4. **专题列表 D/K 固定**:分页页标题会变化,但 description 和 keywords 始终一致。
5. **登录/注册复用首页 TDK,且 robots 标志不一致**:handler 设置了 `noindex=true`,但 `index.html` 固定输出 `index,follow`。这两个页面不仅 TDK 与页面功能不一致,还可能被搜索引擎索引。