更新Docker
This commit is contained in:
小蚂蚁云
@@ -33,7 +33,11 @@ EasyGoAdmin 文档站 SEO / GEO 更新标准
|
||||
b) 零运行时开销：全部在构建期（build）完成，不进客户端 bundle。
|
||||
c) 零新依赖：只用 Node 内置模块 + VitePress 内置能力，
|
||||
不新增 npm 包（llms.txt 脚本在 node_modules 缺失时也能跑）。
|
||||
d) 内容不改版：不改动 143 篇正文的结构，SEO 增强全部在配置层注入。
|
||||
d) 内容不改版：不改动正文的结构，SEO 增强全部在配置层注入。
|
||||
e) 文档缺失优先补文档：发现页面自身缺失（无 H1、无 :::tip 概述）
|
||||
时，优先按内容约定修复文档本身（这正是 SEO 的内容基础），
|
||||
而不是在代码里加回退逻辑绕过。配置层只处理"派生"类增强
|
||||
（编号剥离、摘要截取、结构化数据），不掩盖内容缺陷。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
第二部分：审计清单（先查后改，逐项打勾）
|
||||
@@ -65,6 +69,21 @@ EasyGoAdmin 文档站 SEO / GEO 更新标准
|
||||
twitter:image 404，改为实际存在的 /logo.png）
|
||||
[ ] 15. zh.ts 的 META_TITLE / META_DESCRIPTION 是否与项目技术栈一致？
|
||||
（Gin 项目误写 "GoFrame v2"，属元数据事实错误，一并修正）
|
||||
[ ] 16. H1 覆盖率（【围栏感知 + 首个 ## 前】规则，第18项起修正）：
|
||||
正则 ^# 会把代码块内 "# 注释" 误判为 H1——必须跳过 ``` 围栏、
|
||||
且真 H1 须出现在首个 ## 之前（rbac 类页有游离 # 行会漏判）。
|
||||
python 扫描脚本见第18项记录；缺失后果：<title>/headline
|
||||
降级或取到代码注释垃圾、llms 少条或链接文本为 .py 路径。
|
||||
[ ] 17. :::tip 覆盖率：grep -rL ":::tip" zh --include="*.md" 是否为空？
|
||||
（缺 tip 的页 description 只能回退首段，摘要质量下降；
|
||||
按 e) 原则逐页补 tip 概述，而不是改代码适配）
|
||||
[ ] 18. Gitee/editLink 仓库链接与项目身份是否一致？
|
||||
（FastAPI 系仓库名统一大写 FastAPI——DjangoAdmin_FastAPI_Xxx，
|
||||
DjangoAdmin 项目正文版本表引用亦须大写）
|
||||
（TP8_NaiveVue 项目 6 处链接全部指向 ThinkPhp6_NaiveVue——
|
||||
克隆自 TP6 项目未改，editLink/社交链接/开源协议入口全错；
|
||||
检查：grep -rn "gitee.com" .vitepress/config/ 对照项目名）
|
||||
修复后 seo.ts 的 Organization.sameAs 也必须用正确仓库。
|
||||
|
||||
审计结论示例（GoFrame_EleVue 基线，2026-10-25 实测）：
|
||||
robots/sitemap/llms/canonical/og:image/JSON-LD 全部缺失；
|
||||
@@ -117,7 +136,7 @@ EasyGoAdmin 文档站 SEO / GEO 更新标准
|
||||
页内 H1 和侧边栏编号保持原样不动。
|
||||
|
||||
4) extractDescription(md) —— meta description / llms.txt 摘要的唯一来源
|
||||
提取顺序：
|
||||
提取顺序（frontmatter 若声明 description 则直接采用，优先于以下各步）：
|
||||
a. 剥掉 frontmatter（/^---[\s\S]*?\n---\s*/）
|
||||
b. 首选 :::tip 容器内正文：/^:::\s*tip[^\n]*\n([\s\S]*?)\n:::/m
|
||||
（容器标签后缀不限定"概述"，兼容 "说明"、"欢迎贡献" 等变体）
|
||||
@@ -476,6 +495,16 @@ C. 提交前人工项（脚本做不了）
|
||||
[ ] robots.txt 的 Sitemap 行域名
|
||||
[ ] llms.txt 头部章节数 N 是脚本自动统计，无需手改
|
||||
[ ] 404.md 内的示例链接指向目标项目实际存在的首页/入门页
|
||||
[ ] 站点 title（shared.ts）可能是公司名而非产品名——titleTemplate
|
||||
用产品名承载（如"小蚂蚁云" + "RXThinkCMF 开发文档"）
|
||||
[ ] zh.ts 的 META_URL 指向的必须是【文档站】而非产品官网
|
||||
[ ] 文档覆盖率先查后改：H1 与 :::tip 缺失页逐个补文档（原则 e)）
|
||||
[ ] opener 检查：逐文件断言 lines[0]=H1 且 lines[1]=:::tip
|
||||
（Laravel 系有 6 页 tip 存在但不在 H1 后——description 会取到
|
||||
页中导航 tip 而非页面概述，必须补 opener）
|
||||
python -c "import glob,io;[print(f) for f in glob.glob('zh/**/*.md',recursive=True)
|
||||
if not (lambda L: L and L[0].startswith('# ') and L[1].startswith(':::tip'))(
|
||||
[l for l in io.open(f,encoding='utf-8').read().splitlines() if l.strip()])]"
|
||||
[ ] zh.ts 若有静态 og/twitter meta，确认与 transformHead 输出
|
||||
key 一致会被覆盖（一般无需删；不放心可删掉静态项）
|
||||
|
||||
@@ -515,6 +544,336 @@ C. 提交前人工项（脚本做不了）
|
||||
llms.txt 153 条 == zh 下 md 数、FAQPage 11 问
|
||||
- 首次构建暴露 transformItems 相对路径坑（见 2.5），修复后复验通过
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp6_EleVue，位于 xampp htdocs 路径）：
|
||||
- 与前两个项目的差异面更大：产品名/域名/仓库全不同（rxthink.cn 域），
|
||||
站点 title 是公司名"小蚂蚁云"（titleTemplate 承载产品名），
|
||||
META_URL 原指向产品官网而非文档站（已改），
|
||||
META_IMAGE 同样指向不存在的 social.png（已改 logo.png）
|
||||
- 文档缺失（按原则 e) 修文档，不改代码绕过）：
|
||||
introduction.md 无 H1 无 tip（HTML 布局页）→ 补 H1+tip 后
|
||||
llms 139→140、title/headline/breadcrumb 全部正常；
|
||||
另 9 页缺 tip 概述 → 逐页补齐，tip 覆盖率达 140/140
|
||||
- 共享层同步升级：extractDescription 增加 frontmatter description
|
||||
显式优先（三个项目已同步，作为无 H1 页的兜底声明手段）
|
||||
- FAQ 双格式实测：### Q 式 7 页 → FAQPage 正常；表格式
|
||||
（appendix/faq、zh/faq）→ 正确不产出 FAQPage
|
||||
- yarn install（5s 缓存）+ docs:build（40s）完整验收：
|
||||
sitemap 141 条过滤 404/README、lastmod 140/141、
|
||||
llms 140 == md 数、404 noindex 不入 sitemap、
|
||||
首页 WebSite+Organization、introduction 页 title/desc 全恢复
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp8_EleVue，第 4 个项目）：
|
||||
- 与 ThinkPHP6 项目几乎同构（同 140 页、同 10 页缺 tip、同
|
||||
introduction 无 H1、同 social.png 缺失、同 META_URL 指产品官网）
|
||||
——审计 17 项全部命中标准已记录的模式，实施零新问题，
|
||||
验证标准已可直接照做
|
||||
- 差异点仅 6 处：SITE_URL（docs.thinkphp8.elevue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE（ThinkPHP8 文案，本就正确）、
|
||||
Gitee ThinkPhp8 仓库、llms 标题行、robots Sitemap 行、
|
||||
（复核）SECTIONS 映射无需改
|
||||
- 文档修复同 TP6：introduction 补 H1+tip（ThinkPHP 8 文案）、
|
||||
9 页补 tip → 覆盖率 140/140
|
||||
- yarn install（4s）+ docs:build（39s）完整验收全绿：
|
||||
sitemap 141 条过滤 404/README、lastmod 140/141、
|
||||
llms 140 == md 数、introduction 页 title/desc/headline 恢复、
|
||||
FAQ 双格式正确（Q 式出 FAQPage、表格式不出）、
|
||||
404 noindex 不入 sitemap、首页 WebSite+Organization
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp6_AntdVue，第 5 个项目）：
|
||||
- 再次零新问题：审计 17 项全部命中已知模式（同 140 页、同 10 页
|
||||
缺 tip、同 introduction 无 H1、同 social.png/META_URL 问题）
|
||||
- 差异点仅 5 处：SITE_URL（docs.thinkphp6.antdvue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE（AntDesign 文案，本就正确）、
|
||||
Gitee ThinkPhp6_AntdVue 仓库、llms 标题行、robots Sitemap 行
|
||||
- 文档修复同前：introduction 补 H1+tip（ThinkPHP 6.1 + AntDesign
|
||||
文案）、9 页补 tip → 覆盖率 140/140
|
||||
- yarn install（4s）+ docs:build（38s）完整验收全绿（全项同 TP8）
|
||||
- 至此 5 个项目验证：标准执行耗时逐次递减，第 3 个项目起
|
||||
审计→落地→验收全流程可由清单直接驱动，无需人工判断
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp8_AntdVue，第 6 个项目）：
|
||||
- 第三次零新问题：审计 17 项全部命中已知模式（同 140 页、同 10 页
|
||||
缺 tip、同 introduction 无 H1、同 social.png/META_URL 问题、
|
||||
HTTPS 证书不匹配）
|
||||
- 差异点仅 5 处：SITE_URL（docs.thinkphp8.antdvue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE（本就正确）、Gitee ThinkPhp8_AntdVue
|
||||
仓库、llms 标题行、robots Sitemap 行
|
||||
- 文档修复同前：introduction 补 H1+tip（ThinkPHP 8 + AntDesign 文案）、
|
||||
9 页补 tip → 覆盖率 140/140
|
||||
- yarn install（4s）+ docs:build（38s）完整验收全绿（全项同前）
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp6_NaiveVue，第 7 个项目）：
|
||||
- 第四次零新问题：审计 17 项全部命中已知模式（同 140 页、同 10 页
|
||||
缺 tip、同 introduction 无 H1、同 social.png/META_URL 问题、
|
||||
HTTPS 证书不匹配）
|
||||
- 差异点仅 5 处：SITE_URL（docs.thinkphp6.naivevue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE（本就正确）、Gitee ThinkPhp6_NaiveVue
|
||||
仓库、llms 标题行、robots Sitemap 行
|
||||
- 文档修复同前：introduction 补 H1+tip（ThinkPHP 6.1 + NaiveUI 文案）、
|
||||
9 页补 tip → 覆盖率 140/140
|
||||
- yarn install（4s）+ docs:build（42s）完整验收全绿（全项同前）
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_ThinkPhp8_NaiveVue，第 8 个项目）：
|
||||
- 新发现 1 项（已入审计清单第 18 项）：6 处 Gitee 链接全部指向
|
||||
ThinkPhp6_NaiveVue（克隆自 TP6 项目未改）——editLink、社交链接、
|
||||
开源协议入口均指向错误仓库，已全部修复为 ThinkPhp8_NaiveVue，
|
||||
dist 产物验证无残留
|
||||
- 其余全部命中已知模式：140 页、同 10 页缺 tip、introduction 无 H1、
|
||||
social.png/META_URL/HTTPS 问题；META_TITLE/DESCRIPTION 本就正确
|
||||
- 差异点 5 处：SITE_URL（docs.thinkphp8.naivevue.rxthink.cn）、
|
||||
Gitee ThinkPhp8_NaiveVue 仓库（修复后）、SITE_DESCRIPTION、
|
||||
llms 标题行、robots Sitemap 行
|
||||
- 文档修复同前 10 页 → 覆盖率 140/140
|
||||
- yarn install（5s）+ docs:build（44s）完整验收全绿，
|
||||
额外验证 Gitee 修复进 dist 无残留
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_Laravel13_EleVue，第 9 个项目，首个 Laravel 系）：
|
||||
- 与 ThinkPHP 系的结构差异（审计需重新核对页数/清单，勿套用旧数字）：
|
||||
139 页（无根级 zh/faq.md）、仅 8 页完全无 tip
|
||||
（tech-stack/why 有页中导航 tip 但无 opener）、
|
||||
附录多 K. Artisan 命令速查（字母到 O）、FAQ 编号 2.9、
|
||||
intro 文案为 Laravel 13 + PHP 8.3
|
||||
- 新增发现并修复：en.ts 注释行 Gitee 仓库指 ThinkPhp6_EleVue
|
||||
（审计项 18 的注释变体，一并修正）
|
||||
- opener 补齐 16 页：8 页完全无 tip + tech-stack/why 补 opener
|
||||
（保留页中导航 tip）+ 6 页 opener 缺位（course/directory/
|
||||
config-reference/backup/backend-start/deletion——tip 存在但不在
|
||||
H1 之后，用 opener 检查脚本发现）
|
||||
- 新增 opener 检查（审计可复用）：
|
||||
python 逐文件断言 lines[0]=H1 且 lines[1]=:::tip
|
||||
本项目最终 139/139 全满
|
||||
- SITE_URL=docs.laravel13.elevue.rxthink.cn（https 同样 000）；
|
||||
Gitee 活跃链接本就正确（Laravel13_EleVue）
|
||||
- yarn install（4s）+ docs:build（35s+复建 34s）完整验收全绿：
|
||||
sitemap 140 条（139 md + 首页）、lastmod 139/140、
|
||||
llms 139 == md 数、course 等补页 description=新 opener 首句、
|
||||
Gitee 修复进 dist 无 ThinkPhp6 残留
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_Laravel13_AntdVue，第 10 个项目）：
|
||||
- 与 Laravel13_EleVue 完全同构（Laravel 系模板固化）：139 页、
|
||||
8 无 tip、16 页缺 opener（8 无 tip + tech-stack/why +
|
||||
course/directory/config-reference/backup/backend-start/deletion）、
|
||||
en.ts 注释仓库指 ThinkPhp6_EleVue（已修）
|
||||
- 差异点 5 处：SITE_URL（docs.laravel13.antdvue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE（本就正确）、Gitee Laravel13_AntdVue
|
||||
（活跃链接正确）、llms 标题行、robots Sitemap 行
|
||||
- 文档修复 16 页 → opener 139/139、tip 139/139、H1 139/139
|
||||
- yarn install（4s）+ docs:build（41s）完整验收全绿
|
||||
（含 Gitee 无 ThinkPhp6 残留、course desc=新 opener 首句）
|
||||
- Laravel 系 2 个项目均已带 opener 检查一次通过——
|
||||
该检查应作为审计固定项（见 opener 检查脚本）
|
||||
|
||||
移植实测（2026-10-25，RXThinkCMF_Laravel13_NaiveVue，第 11 个项目）：
|
||||
- Laravel 系模板第 3 次命中，全流程照做零偏差：139 页、8 无 tip、
|
||||
16 页缺 opener、en.ts 注释仓库指 ThinkPhp6_EleVue（已修）、
|
||||
META/Gitee 活跃链接本就正确
|
||||
- 差异点 5 处：SITE_URL（docs.laravel13.naivevue.rxthink.cn）、
|
||||
SITE_DESCRIPTION/META_TITLE、Gitee Laravel13_NaiveVue、
|
||||
llms 标题行、robots Sitemap 行
|
||||
- 文档修复 16 页 → opener/tip/H1 全部 139/139
|
||||
- yarn install（4s）+ docs:build（41s）完整验收全绿
|
||||
（含 Gitee 无 ThinkPhp6 残留、course desc=新 opener 首句）
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Django_EleVue，第 12 个项目，首个 DjangoAdmin 品牌线）：
|
||||
- 全新结构（不能套用 RXThinkCMF/EasyGoAdmin 模板）：
|
||||
135 页、volume1-7 分卷目录、H1 无编号（如"# 环境准备"）、
|
||||
部分页 tip 在 H1 之前（volume5/6 "本章概要" 横幅式）、
|
||||
无 Q/A 型 FAQ（FAQPage 全站不产出属正确行为）、
|
||||
侧边栏 8 章 + 附录（与 llms SECTIONS 必须重写对应）
|
||||
- 审计方法升级：结构检查（NO-H1/opener）在异构站点上误报多
|
||||
（tip 在 H1 前 ≠ 缺 H1；head -1 检查漏判），改用
|
||||
**extractDescription 全量摘要质量审计**（空/过短/导航腔）作为
|
||||
真实判据——135 页仅 6 页真实有问题，逐页修复后 0 问题
|
||||
- 文档修复 27 处：introduction 补 H1+tip（唯一真缺 H1 页）、
|
||||
25 页补 tip opener（volume2×12、volume3×10、根级 3 页）、
|
||||
contributing tip 首句由问候语改写为描述句
|
||||
- llms SECTIONS 按本项目重写：volume1-7→章 2-8、other→附录、
|
||||
根级 faq.md 文件级例外→附录（侧边栏归属）；
|
||||
头部样板文案按品牌实情改（去多租户/声明式 CRUD 等非本项目特性）
|
||||
- 差异点：SITE_URL=docs.django.elevue.djangoadmin.cn（https 同 000）、
|
||||
品牌 DjangoAdmin/djangoadmin.cn/Gitee djangoadmin 组、
|
||||
META 本就正确、活跃 Gitee 正确（en.ts 注释指 Fastapi 已修）、
|
||||
titleTemplate="DjangoAdmin 开发文档"
|
||||
- yarn install（13s）+ docs:build（53s）完整验收全绿：
|
||||
sitemap 136 条、lastmod 136/136（全量 git 覆盖）、
|
||||
llms 135==md、intro 恢复、面包屑"首页 > 2. 快速入门 > 2.1 ..."、
|
||||
FAQPage 全站无（无 Q/A 页，正确）、Gitee 无 Fastapi 残留
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Django_AntdVue，第 13 个项目，DjangoAdmin 系第 2 个）：
|
||||
- DjangoAdmin 模板完全命中：135 页、volume1-7、同 26 无 tip、
|
||||
同 introduction 无 H1、无 Q/A FAQ、en.ts 注释指 Fastapi（已修）、
|
||||
META/活跃 Gitee 本就正确（Django_AntdVue）
|
||||
- llms 脚本直接复用 Django_EleVue 已适配版（SECTIONS/faq 例外/
|
||||
样板文案），仅改标题行——同系列脚本可直接沿用
|
||||
- 描述质量审计：3 个真实问题（introduction 空、contributing 问候语、
|
||||
why 首句过短）与上项完全一致；修复 27 处（25 tip + H1/tip + 改写）
|
||||
→ bad desc 0、no-tip 0、no-H1 0
|
||||
- 差异点 5 处：SITE_URL（docs.django.antdvue.djangoadmin.cn）、
|
||||
AntDesign 文案（introduction/fe-view tip 同步改）、
|
||||
Gitee Django_AntdVue、llms 标题行、robots Sitemap 行
|
||||
- yarn install（8s）+ docs:build（49s）完整验收全绿
|
||||
（含 lastmod 136/136、FAQPage 全站无、Gitee 无 Fastapi 残留）
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Django_NaiveVue，第 14 个项目，DjangoAdmin 系第 3 个）：
|
||||
- 模板第 3 次命中，全流程零偏差照做：135 页、26 无 tip、
|
||||
introduction 无 H1、3 个真实摘要问题与前两项完全一致、
|
||||
en.ts 注释指 Fastapi（已修）、META/活跃 Gitee 本就正确
|
||||
- llms 脚本复用 Django_EleVue 已适配版仅改标题行；
|
||||
文档修复 27 处（NaiveUI 文案）→ bad desc/no-tip/no-H1 全 0
|
||||
- 差异点 5 处：SITE_URL（docs.django.naivevue.djangoadmin.cn）、
|
||||
Gitee Django_NaiveVue、NaiveUI 文案、llms 标题行、robots Sitemap 行
|
||||
- yarn install（7s）+ docs:build（46s）完整验收全绿
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_FastAPI_EleVue，第 15 个项目，DjangoAdmin 系首个非 Django 后端）：
|
||||
- 结构差异（DjangoAdmin 系内变体，勿套 135/26 数字）：
|
||||
129 页、12 无 tip（volume3 全有 tip）、4 无 H1（introduction、
|
||||
struct 起于 ## 无 H1、volume4/core idempotent+operation-log
|
||||
tip 横幅式且全文件无 H1）、volume2 模块页为 FastAPI 分层
|
||||
（Endpoint/Router/Schema/Repository/Service，案例=Position）
|
||||
- 新发现并修复：
|
||||
① Gitee 仓库大小写冲突——shared.ts 用 FastAPI、zh.ts/en.ts 用
|
||||
Fastapi → 【已更正】FastAPI 系仓库名应统一大写 FastAPI
|
||||
（用户确认），第15/16项当时按正文推断改小写属误判，
|
||||
已连同第17项一并全局改回 DjangoAdmin_FastAPI_*（配置+seo+
|
||||
正文版本表，各5文件，三项目复验零残留）
|
||||
② META_TITLE/META_DESCRIPTION 缺品牌与技术栈（仅"企业级中台
|
||||
解决方案"）→ 补 DjangoAdmin FastAPI 文案（审计项 15）
|
||||
- 文档修复 17 处：4 无 H1（introduction 补 H1+tip、struct 补
|
||||
H1+opener、idempotent/operation-log 补 H1 置于既有 tip 前）、
|
||||
12 无 tip 补 opener（FastAPI 分层文案）、why tip 首句 14 字
|
||||
过短改写（阈值 15 实测抓出）
|
||||
- llms 脚本复用 Django_EleVue 适配版仅改标题行
|
||||
- SITE_URL=docs.fastapi.elevue.djangoadmin.cn（https 同 000）
|
||||
- yarn install（7s）+ docs:build（2 轮共 80s）完整验收全绿：
|
||||
sitemap 130 条、lastmod 130/130、llms 129==md、
|
||||
3 原缺陷页 title/desc/headline 全恢复、Gitee 无大写残留
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_FastAPI_AntdVue，第 16 个项目，FastAPI 系第 2 个）：
|
||||
- FastAPI 模板命中（129 页、12 无 tip、4 无 H1、无 Q/A FAQ），
|
||||
特有点与 FastAPI_EleVue 一致：META 裸文案（审计项 15 已补
|
||||
FastAPI+AntDesign 文案）、why tip 首句 14 字（已改写）
|
||||
- Gitee 大小写冲突再现：配置 3 处 FastAPI_AntdVue vs 正文
|
||||
Fastapi_AntdVue → 以正文为准 sed 全局统一，另 en.ts 注释误指
|
||||
EleVue 改本项目；首验 5 处全 Fastapi 无残留
|
||||
（沿用上项经验：多处相同字符串必须全局替换 + 复验）
|
||||
- 文档修复 16 处：4 无 H1（introduction 补 H1+tip AntdVue 文案、
|
||||
struct 补 H1+opener、idempotent/operation-log 补 H1 置于 tip 前）、
|
||||
11 无 tip 补 opener（fe-view 用本项目正文的 AntDesign Vue 措辞）、
|
||||
why tip 首句改写 → bad desc/no-tip/no-H1 全 0
|
||||
- SITE_URL=docs.fastapi.antdvue.djangoadmin.cn（https 同 000）
|
||||
- yarn install（9s）+ docs:build（53s）一轮通过完整验收全绿：
|
||||
sitemap 130、lastmod 130/130、llms 129==md、
|
||||
3 原缺陷页 title/desc/headline 恢复、Gitee 无大写残留
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_FastAPI_NaiveVue，第 17 个项目，FastAPI 系第 3 个）：
|
||||
- FastAPI 模板命中（129 页、12 无 tip、4 无 H1、无 Q/A FAQ、
|
||||
META 裸文案、why 首句 14 字），配置曾含 FastAPI_EleVue 误指
|
||||
- Gitee 大小写最终裁定：用户确认应大写 FastAPI——本项目与前两个
|
||||
FastAPI 项目（EleVue/AntdVue）三地同步改正：配置 4 文件 +
|
||||
seo.ts ORG + 正文 introduction 版本表，各 5 文件，复验零残留
|
||||
- 文档修复 16 处（NaiveUI 文案）→ bad desc/no-tip/no-H1 全 0
|
||||
- SITE_URL=docs.fastapi.naivevue.djangoadmin.cn（https 同 000）
|
||||
- yarn install（8s）+ docs:build（45s）完整验收全绿：
|
||||
sitemap 130、lastmod 130/130、llms 129==md、
|
||||
3 原缺陷页 title/desc/headline 恢复、dist 无小写残留
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Flask_EleVue，第 18 个项目，DjangoAdmin 系首个 Flask 后端）：
|
||||
- 【重大方法修正】发现围栏内 "# 注释" 被 ^# 正则误判为 H1——
|
||||
围栏感知+首个##前 规则重扫：本项目真缺 H1 达 25 页
|
||||
（volume4/business×11 + core×11 + course/introduction/struct），
|
||||
另 rbac.md 有游离 # 行二次漏判（加固规则后补齐）
|
||||
- 共享工具加固：llms 脚本 h1Of 与 seo.ts h1OfMd 均改为围栏感知
|
||||
（split("
|
||||
") 逐行 + 围栏开关），根治 llms 链接文本取到
|
||||
.py/.ts 代码注释垃圾的问题
|
||||
- 结构：139 页、17 无 tip（含 Flask 特有 blueprint/model/
|
||||
transaction×2/generator）、META 本就正确、Gitee 活跃链接正确
|
||||
- 文档修复 44 处：26 补 H1（25+rbac）+17 补 tip（Flask 文案）+
|
||||
why 首句改写 → 围栏感知 no-H1 0、no-tip 0、bad desc 0
|
||||
- SITE_URL=docs.flask.elevue.djangoadmin.cn（https 同 000）
|
||||
- 验收全绿：sitemap 140、lastmod 140/140、llms 139==md、
|
||||
垃圾链接文本 0、rbac/user 等页 title/headline 恢复
|
||||
|
||||
【存量回修】同日对 6 个已验收 DjangoAdmin 项目（Django×3、
|
||||
FastAPI×3）执行围栏感知重扫：各发现 21-24 页真缺 H1（同 volume4
|
||||
banner 式页面+course 的系统性缺陷）→ 批量补 H1 共 135 页
|
||||
（标题取自各自侧边栏去编号）+ 同步加固 h1Of/h1OfMd +
|
||||
重新生成 llms + 全部重建 dist，6 项目复验：垃圾 0、
|
||||
user 页 title/headline=用户管理、sitemap 正常
|
||||
（教训：结构扫描规则必须与真实解析器同构——围栏感知，
|
||||
否则会产生"验收通过但产物含垃圾"的假阳性）
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Flask_AntdVue，第 19 个项目，Flask 系第 2 个）：
|
||||
- Flask 模板完全命中（139 页、26 真缺 H1 含 rbac、17 无 tip、
|
||||
META 本就正确、Gitee 活跃链接正确、en.ts 注释指错已修）
|
||||
- 复制源升级为【已加固版】：seo.ts/llms 脚本直接取自 Flask_EleVue
|
||||
（围栏感知 h1OfMd/h1Of 已含），仅改 ORG 仓库与标题行——
|
||||
同系列后续项目一律从已加固项目复制共享层
|
||||
- 文档修复 44 处：26 H1（侧边栏自动映射脚本，0 未匹配）+17 tip
|
||||
（AntdVue 文案：fe-view/introduction 用 AntDesign Vue）+why 首句
|
||||
→ 围栏感知 no-H1 0、no-tip 0、bad desc 0
|
||||
- SITE_URL=docs.flask.antdvue.djangoadmin.cn（https 同 000）
|
||||
- yarn install（8s）+ docs:build（68s）一轮通过完整验收全绿：
|
||||
sitemap 140、lastmod 140/140、llms 139==md、垃圾链接 0、
|
||||
intro/user/rbac 三页 title/desc/headline 全恢复
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Flask_NaiveVue，第 20 个项目，Flask 系第 3 个）：
|
||||
- Flask 模板完全命中：139 页、26 真缺 H1、17 无 tip、META 正确、
|
||||
Gitee 活跃链接正确、en.ts 注释指错（Fastapi_EleVue）已修
|
||||
- 共享层复制自 Flask_AntdVue 已加固版（seo.ts/llms 仅改
|
||||
ORG 仓库/标题行/SITE_URL/描述），全程照做零偏差
|
||||
- 文档修复 44 处（侧边栏自动映射 26 H1 + NaiveUI 文案 17 tip
|
||||
+why 首句）→ 围栏感知三指标全 0
|
||||
- SITE_URL=docs.flask.naivevue.djangoadmin.cn（http 200）
|
||||
- yarn install（8s）+ docs:build（78s）一轮通过完整验收全绿：
|
||||
sitemap 140、lastmod 140/140、llms 139==md、垃圾链接 0、
|
||||
intro/user/rbac 三页 title/desc/headline 全恢复
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Tornado_EleVue，第 21 个项目，DjangoAdmin 系首个 Tornado 后端）：
|
||||
- Tornado 变体（数字勿套旧模板）：138 页、22 真缺 H1、
|
||||
11 无 tip（Tornado 特有 volume2/handler 页 + volume3/overview
|
||||
也缺；案例模块=友链 Link 而非 Position；validator 标题为
|
||||
参数验证（Pydantic））、无 Q/A FAQ
|
||||
- META 裸文案（审计项 15 已补 Tornado+ElementPlus 文案）、
|
||||
en.ts 注释指 Fastapi_EleVue（已修）、Gitee 活跃链接正确、
|
||||
why 首句 14 字（已改写）
|
||||
- 共享层复制自 Flask_NaiveVue 已加固版（改 ORG/标题/SITE_URL/描述）
|
||||
- 文档修复 35 处：22 H1（侧边栏自动映射含 Pydantic 标题）+
|
||||
12 tip（Tornado 文案：handler/schema Pydantic、volume3/overview
|
||||
架构总览；model 顺带补 opener）+why 首句
|
||||
→ 围栏感知 no-H1 0、no-tip 0、bad desc 0
|
||||
- SITE_URL=docs.tornado.elevue.djangoadmin.cn（http 200/https 000）
|
||||
- yarn install（9s）+ docs:build（47s）一轮通过完整验收全绿：
|
||||
sitemap 139、lastmod 139/139、llms 138==md、垃圾链接 0、
|
||||
intro/handler/rbac/arch 四页 title/desc/headline 全恢复
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Tornado_AntdVue，第 22 个项目，Tornado 系第 2 个）：
|
||||
- Tornado 模板完全命中：138 页、22 真缺 H1、11 无 tip、
|
||||
en.ts 注释本就正确（无需修）、Gitee 活跃链接正确、
|
||||
META 裸文案（审计项 15 已补 Tornado+AntDesign）、
|
||||
fe-view/introduction 用 AntDesign 措辞
|
||||
- 共享层复制自 Tornado_EleVue 已加固版（改 ORG/标题/SITE_URL/描述）
|
||||
- 文档修复 34 处：22 H1（侧边栏自动映射，validator=参数验证
|
||||
（Pydantic）正确落地）+11 tip +why 首句
|
||||
→ 围栏感知 no-H1 0、no-tip 0、bad desc 0
|
||||
- SITE_URL=docs.tornado.antdvue.djangoadmin.cn（http 200）
|
||||
- yarn install（5s）+ docs:build（60s）一轮通过完整验收全绿：
|
||||
sitemap 139、lastmod 139/139、llms 138==md、垃圾链接 0、
|
||||
intro/handler/rbac 三页 title/desc/headline 全恢复
|
||||
|
||||
移植实测（2026-10-25，DjangoAdmin_Tornado_NaiveVue，第 23 个项目，Tornado 系第 3 个）：
|
||||
- Tornado 模板完全命中：138 页、22 真缺 H1、11 无 tip、
|
||||
META 裸文案（审计项 15 已补 Tornado+NaiveUI）、
|
||||
en.ts 注释指 Fastapi_EleVue（已修）、Gitee 活跃链接正确
|
||||
- 共享层复制自 Tornado_AntdVue 已加固版（改 ORG/标题/SITE_URL/描述）
|
||||
- 文档修复 34 处：22 H1（侧边栏自动映射）+11 tip（NaiveUI 文案：
|
||||
fe-view/introduction 用 NaiveUI）+why 首句
|
||||
→ 围栏感知 no-H1 0、no-tip 0、bad desc 0
|
||||
- SITE_URL=docs.tornado.naivevue.djangoadmin.cn（http 200）
|
||||
- yarn install（9s）+ docs:build（51s）一轮通过完整验收全绿：
|
||||
sitemap 139、lastmod 139/139、llms 138==md、垃圾链接 0、
|
||||
intro/handler/rbac 三页 title/desc/headline 全恢复
|
||||
|
||||
已知限制：
|
||||
1. HTTPS：docs 子域 443 返回腾讯 CDN 默认证书（*.cdn.myqcloud.com），
|
||||
curl 校验失败，全站暂用 http。修复后按步骤⑦-C3 单点切换。
|
||||
|
||||
Reference in New Issue
Block a user