docs: 重写 README(徽章 / 目录 / Mermaid 架构图 / GitHub 提示块)

结构改成开源社区通行的形态:徽章区(PowerShell 双版本、Windows、7-Zip、零运行时依赖、
89 个对外函数、Pester 条数、UTF-8 BOM)、目录、带 emoji 的章节标题、13 处
> [!NOTE] / [!TIP] / [!WARNING] / [!CAUTION] 提示块,以及 3 张 Mermaid 图
(备份数据流 / 恢复数据流 / 产物布局,含"两个都叫 persist 的目录为何不冲突")。

3 张图不是"看着像能渲染"就交:用 headless Edge + CDP 在真实浏览器里以 Mermaid 11 渲染
验证过(能解析 != 能读,所以看的是渲染结果),截图留在 .scratch/_verify/mermaid.png。

顺带修正两处事实错误 —— 都是本次 CI/CD 流水线的文档核对暴露出来的:
  * 零依赖套件条数 111 -> 128(实跑 Run-Tests.ps1 得到)
  * Pester 条数 183 -> 192(本轮补测后)

校验:Prettier 3.9.9 通过;markdownlint 只剩 10 条 MD051,那是假阳性 —— markdownlint
的锚点生成器不做 emoji 剥离,而 GitHub 会(`## 🚀 快速开始` -> `#-快速开始`)。用独立
脚本按 GitHub 规则复算,63 个标题锚点全部可解析,故保留 emoji 标题。外部链接 11/11 返回
200,内部相对链接全部存在。
This commit is contained in:
Shuery committed 2026-10-02 01:16:39 +08:00
1 parent 7149ea691e
commit f4729baca7
1 file changed
+672 -156
+672 -156
View File
File diff suppressed because it is too large. Load diff