Skip to content

Commit 399a910

Browse files
Azek431Azek431
committed
发布一下新版文档站优化和最终巡检报告
这次主要发布 Azek创游世界文档 的新版站点优化内容，并同步更新发布前最终巡检生成的侧边栏、自动目录、健康巡检报告、文档语法与真实性审计报告、无用与废弃文档清理报告等维护资料。 主要调整： - 更新自动生成侧边栏和文档目录 - 同步发布前仓库健康巡检报告 - 同步文档语法与真实性审计报告和 CSV 明细 - 同步无用与废弃文档清理报告和清理清单 - 确认 quality:check、docs:check:light、docs:search-index:check 全部通过 - 确认 VitePress 构建成功并生成 sitemap - 确认构建产物搜索收录检查通过，sitemap 覆盖 210 个页面 - 确认正式域名首页、sitemap.xml 和 robots.txt 均可正常访问 - 保留 CSS 体积、important 数量、内容审计和历史链接 WARN 作为后续优化项
1 parent c402e16 commit 399a910

7 files changed

Lines changed: 96 additions & 18 deletions

‎docs/.vitepress/sidebar.generated.ts‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -916,6 +916,10 @@ export const generatedSidebar = [
916916
"text": "文档状态分级规则",
917917
"link": "/维护与报告/文档状态分级规则"
918918
},
919+
{
920+
"text": "无用与废弃文档清理报告",
921+
"link": "/维护与报告/无用与废弃文档清理报告"
922+
},
919923
{
920924
"text": "站点部署与运维方案",
921925
"link": "/维护与报告/站点部署与运维方案"

‎docs/总索引与导航/自动生成文档目录.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -261,6 +261,7 @@ search: false
261261
- [文档内容质量审计报告](/维护与报告/文档内容质量审计报告)
262262
- [文档语法与真实性审计报告](/维护与报告/文档语法与真实性审计报告)
263263
- [文档状态分级规则](/维护与报告/文档状态分级规则)
264+
- [无用与废弃文档清理报告](/维护与报告/无用与废弃文档清理报告)
264265
- [站点部署与运维方案](/维护与报告/站点部署与运维方案)
265266
- [知识库结构与维护指南](/维护与报告/知识库结构与维护指南)
266267
- [知识库扩展复盘与完善路线图](/维护与报告/知识库扩展复盘与完善路线图)

‎docs/维护与报告/仓库健康巡检报告.md‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,17 @@ search: false
88

99
# 仓库健康巡检报告
1010

11-
> 生成时间：2026-06-09T12:47:30.048Z
11+
> 生成时间：2026-06-09T13:24:18.781Z
1212
1313
> 当前模式：轻量模式。高风险问题只生成报告和警告，不阻塞日常小改提交。
1414
1515
## 巡检摘要
1616

17-
- 文本文件数量：281
18-
- Markdown 文件数量：210
19-
- docs 文档数量：207
20-
- 高风险问题：10
21-
- 中风险问题：99
17+
- 文本文件数量：285
18+
- Markdown 文件数量：212
19+
- docs 文档数量：209
20+
- 高风险问题：11
21+
- 中风险问题：104
2222
- 低风险问题：24
2323

2424
## 高风险问题
@@ -33,6 +33,7 @@ search: false
3333
- `docs/.vitepress/theme/styles/cysj-ultimate.css`：冲突文件痕迹
3434
- `scripts/audit-dist-size.mjs`：冲突文件痕迹
3535
- `scripts/clean-sync-temp.mjs`：冲突文件痕迹
36+
- `scripts/prune-unused-docs.mjs`：冲突文件痕迹
3637

3738
## 中风险问题
3839

@@ -107,15 +108,15 @@ search: false
107108
- `docs/维护与报告/OCR专项建设报告_V3.md`：疑似临时标记
108109
- `docs/维护与报告/内容质量审计清单.md`：疑似临时标记
109110
- `docs/维护与报告/文档内容质量审计报告.md`：疑似临时标记
111+
- `docs/维护与报告/文档语法与真实性审计报告.md`：疑似临时标记
112+
- `docs/维护与报告/无用与废弃文档清理报告.md`：疑似临时标记
110113
- `docs/维护与报告/知识库内容深度审计报告.md`：疑似临时标记
111114
- `docs/维护与报告/知识库扩展复盘与完善路线图.md`：疑似临时标记
112115
- `docs/维护与报告/轻量检查与维护流程.md`：疑似临时标记
113116
- `docs/脚本系统/专题研究/创游世界 API 整理.md`：疑似临时标记
114117
- `docs/脚本系统/专题研究/创游世界存档与云变量设计入门.md`：疑似临时标记
115118
- `docs/脚本系统/专题研究/创游世界广播驱动项目结构实战.md`：疑似临时标记
116119
- `docs/脚本系统/专题研究/创游世界新手常见卡点与避坑清单.md`：疑似临时标记
117-
- `docs/脚本系统/专题研究/创游世界脚本实战架构入门.md`：疑似临时标记
118-
- `docs/脚本系统/专题研究/创游世界项目结构模板.md`：疑似临时标记
119120

120121
## 低风险问题
121122

‎docs/维护与报告/文档语法与真实性审计报告.md‎

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ search: false
88

99
# 文档语法与真实性审计报告
1010

11-
> 生成时间：2026/6/9 21:09:21
11+
> 生成时间：2026/6/9 21:26:07
1212
1313
## 审计边界
1414

@@ -23,10 +23,10 @@ search: false
2323

2424
## 汇总
2525

26-
- 扫描 Markdown 文件：196
27-
- 问题总数：984
26+
- 扫描 Markdown 文件：197
27+
- 问题总数：987
2828
- ERROR：2
29-
- WARN：513
29+
- WARN：516
3030
- INFO：469
3131
- 潜在正反描述术语：21
3232

@@ -1432,6 +1432,14 @@ search: false
14321432
- 建议：建议补充 OCR、截图、官方教程、引擎更新、实测或待验证标记；没有证据时降低语气。
14331433
### docs/维护与报告/轻量检查与维护流程.md
14341434

1435+
- **WARN / frontmatter / L1**：frontmatter 建议补充 category。
1436+
- 建议：建议统一分类、标签和状态，方便后续大规模维护。
1437+
- **WARN / frontmatter / L1**：frontmatter 建议补充 tags。
1438+
- 建议：建议统一分类、标签和状态，方便后续大规模维护。
1439+
- **WARN / frontmatter / L1**：frontmatter 建议补充 status。
1440+
- 建议：建议统一分类、标签和状态，方便后续大规模维护。
1441+
### docs/维护与报告/无用与废弃文档清理报告.md
1442+
14351443
- **WARN / frontmatter / L1**：frontmatter 建议补充 category。
14361444
- 建议：建议统一分类、标签和状态，方便后续大规模维护。
14371445
- **WARN / frontmatter / L1**：frontmatter 建议补充 tags。

‎docs/维护与报告/文档语法与真实性审计明细.csv‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -404,6 +404,9 @@ WARN,truth-risk,docs/维护与报告/创游世界知识库文档格式规范.md,
404404
WARN,frontmatter,docs/维护与报告/轻量检查与维护流程.md,1,frontmatter 建议补充 category。,建议统一分类、标签和状态，方便后续大规模维护。
405405
WARN,frontmatter,docs/维护与报告/轻量检查与维护流程.md,1,frontmatter 建议补充 tags。,建议统一分类、标签和状态，方便后续大规模维护。
406406
WARN,frontmatter,docs/维护与报告/轻量检查与维护流程.md,1,frontmatter 建议补充 status。,建议统一分类、标签和状态，方便后续大规模维护。
407+
WARN,frontmatter,docs/维护与报告/无用与废弃文档清理报告.md,1,frontmatter 建议补充 category。,建议统一分类、标签和状态，方便后续大规模维护。
408+
WARN,frontmatter,docs/维护与报告/无用与废弃文档清理报告.md,1,frontmatter 建议补充 tags。,建议统一分类、标签和状态，方便后续大规模维护。
409+
WARN,frontmatter,docs/维护与报告/无用与废弃文档清理报告.md,1,frontmatter 建议补充 status。,建议统一分类、标签和状态，方便后续大规模维护。
407410
WARN,truth-risk,docs/维护与报告/知识库结构与维护指南.md,73,强结论缺少附近证据提示：- [创游世界广播命名规范与最佳实践](./创游世界广播命名规范与最佳实践.md) - 广播命名规范,建议补充 OCR、截图、官方教程、引擎更新、实测或待验证标记；没有证据时降低语气。
408411
WARN,truth-risk,docs/维护与报告/知识库结构与维护指南.md,78,强结论缺少附近证据提示：- [创游世界脚本入门完全指南](./专题研究/创游世界脚本入门完全指南.md) - 脚本入门完全指南,建议补充 OCR、截图、官方教程、引擎更新、实测或待验证标记；没有证据时降低语气。
409412
WARN,truth-risk,docs/维护与报告/知识库结构与维护指南.md,268,强结论缺少附近证据提示：5. **统一格式**：使用 `-` 分隔多词，例如 `创游世界脚本入门完全指南.md`,建议补充 OCR、截图、官方教程、引擎更新、实测或待验证标记；没有证据时降低语气。

‎docs/维护与报告/无用与废弃文档清理报告.md‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ search: false
88

99
# 无用与废弃文档清理报告
1010

11-
> 生成时间：2026/6/9 21:13:18
11+
> 生成时间：2026/6/9 21:26:13
1212
1313
> 当前模式：仅审计，不删除。
1414
@@ -21,10 +21,10 @@ search: false
2121

2222
## 汇总
2323

24-
- 扫描 Markdown 文件：209
25-
- 候选文件：2
24+
- 扫描 Markdown 文件：210
25+
- 候选文件：6
2626
- 高置信可删除：0
27-
- 需要人工复核：2
27+
- 需要人工复核：6
2828

2929
## 高置信可删除文件
3030

@@ -35,7 +35,11 @@ search: false
3535
| 文件 | 标题 | 引用数 | 建议 | 原因 |
3636
| --- | --- | ---: | --- | --- |
3737
| `docs/教程资料/创游世界游戏测试与质量保障指南.md` | 创游世界游戏测试与质量保障指南 | 5 | 有废弃信号但仍被引用，建议先改链接再删 | 正文或 frontmatter 明确出现废弃/过期/归档/草稿信号 |
38+
| `docs/维护与报告/仓库健康巡检报告.md` | 仓库健康巡检报告 | 2 | 有废弃信号但仍被引用，建议先改链接再删 | 正文或 frontmatter 明确出现废弃/过期/归档/草稿信号 |
39+
| `docs/维护与报告/文档语法与真实性审计报告.md` | 文档语法与真实性审计报告 | 2 | 有废弃信号但仍被引用，建议先改链接再删 | 正文或 frontmatter 明确出现废弃/过期/归档/草稿信号 |
40+
| `docs/维护与报告/无用与废弃文档清理报告.md` | 无用与废弃文档清理报告 | 3 | 有废弃信号但仍被引用，建议先改链接再删 | 文件名疑似临时/备份/废弃/冲突文件；正文或 frontmatter 明确出现废弃/过期/归档/草稿信号；受保护目录或入口文件，不自动删除 |
3841
| `docs/元信息/页面模板.md` | 页面模板与标准化文档结构 | 5 | 有废弃信号但仍被引用，建议先改链接再删 | 正文或 frontmatter 明确出现废弃/过期/归档/草稿信号 |
42+
| `docs/总索引与导航/自动生成文档目录.md` | 自动生成文档目录 | 31 | 有废弃信号但仍被引用，建议先改链接再删 | 正文或 frontmatter 明确出现废弃/过期/归档/草稿信号；受保护目录或入口文件，不自动删除 |
3943

4044
## 删除后的恢复方式
4145

‎docs/维护与报告/无用与废弃文档清理清单.json‎

Lines changed: 59 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
2-
"generatedAt": "2026-06-09T13:13:19.099Z",
2+
"generatedAt": "2026-06-09T13:26:13.910Z",
33
"mode": "audit",
44
"aggressive": false,
5-
"scanned": 209,
5+
"scanned": 210,
66
"candidates": [
77
{
88
"file": "docs/教程资料/创游世界游戏测试与质量保障指南.md",
@@ -17,6 +17,48 @@
1717
"warnings": [],
1818
"keep": ""
1919
},
20+
{
21+
"file": "docs/维护与报告/仓库健康巡检报告.md",
22+
"title": "仓库健康巡检报告",
23+
"level": "REVIEW",
24+
"action": "有废弃信号但仍被引用，建议先改链接再删",
25+
"referenced": true,
26+
"sourceCount": 2,
27+
"reasons": [
28+
"正文或 frontmatter 明确出现废弃/过期/归档/草稿信号"
29+
],
30+
"warnings": [],
31+
"keep": ""
32+
},
33+
{
34+
"file": "docs/维护与报告/文档语法与真实性审计报告.md",
35+
"title": "文档语法与真实性审计报告",
36+
"level": "REVIEW",
37+
"action": "有废弃信号但仍被引用，建议先改链接再删",
38+
"referenced": true,
39+
"sourceCount": 2,
40+
"reasons": [
41+
"正文或 frontmatter 明确出现废弃/过期/归档/草稿信号"
42+
],
43+
"warnings": [],
44+
"keep": ""
45+
},
46+
{
47+
"file": "docs/维护与报告/无用与废弃文档清理报告.md",
48+
"title": "无用与废弃文档清理报告",
49+
"level": "REVIEW",
50+
"action": "有废弃信号但仍被引用，建议先改链接再删",
51+
"referenced": true,
52+
"sourceCount": 3,
53+
"reasons": [
54+
"文件名疑似临时/备份/废弃/冲突文件",
55+
"正文或 frontmatter 明确出现废弃/过期/归档/草稿信号"
56+
],
57+
"warnings": [
58+
"受保护目录或入口文件，不自动删除"
59+
],
60+
"keep": ""
61+
},
2062
{
2163
"file": "docs/元信息/页面模板.md",
2264
"title": "页面模板与标准化文档结构",
@@ -29,6 +71,21 @@
2971
],
3072
"warnings": [],
3173
"keep": ""
74+
},
75+
{
76+
"file": "docs/总索引与导航/自动生成文档目录.md",
77+
"title": "自动生成文档目录",
78+
"level": "REVIEW",
79+
"action": "有废弃信号但仍被引用，建议先改链接再删",
80+
"referenced": true,
81+
"sourceCount": 31,
82+
"reasons": [
83+
"正文或 frontmatter 明确出现废弃/过期/归档/草稿信号"
84+
],
85+
"warnings": [
86+
"受保护目录或入口文件，不自动删除"
87+
],
88+
"keep": ""
3289
}
3390
],
3491
"deleteList": []

0 commit comments

Comments
 (0)