mirror of
https://github.com/zhw2590582/ArtPlayer.git
synced 2026-10-10 21:06:15 -08:00
docs(site): [SITE-01] inventory sources and reconcile demo coverage
This commit is contained in:
1 parent
d62ab13a35
commit
d74ecc43cc
21 files changed
+22389
-56
No files matched your search
@@ -0,0 +1,57 @@
|
||||
# SITE-01 文档/示例/生成链清点
|
||||
|
||||
起点 `d62ab13a35c756ea567c426d4fbe00d893dd7e2b`。本任务建立可重跑的当前清单、
|
||||
核实静态资产来源,并修复示例路径台账漂移。没有修改生产包 API、声明、DOM、
|
||||
播放器生命周期、静态资源内容、版本或发布入口。
|
||||
|
||||
## 实现与维护
|
||||
|
||||
- site-inventory.mjs 复用现有 demo 枚举,使用已安装 MarkdownIt 14.1.0 和
|
||||
TypeScript 5.9.3 枚举文档标题/声明成员;记录 22 包、27 Markdown、30 示例、
|
||||
36 HTML、963 声明成员和 204 资产。成员可能重载/继承/含 runtime 类型,
|
||||
标题候选不是语义通过证明;逐项保留 SITE-04 owner。
|
||||
- site-provenance.mjs 显式 --network 下载三个固定版本,验证 SHA-512/SHA-1,
|
||||
只读归档,按文件与本地比较。网络失败直接失败,不回退缓存或执行安装脚本。
|
||||
下载和读取复用现有 releases 工具;浏览器验证不是该脚本的职责。
|
||||
- 文档站新增 README,解释 VitePress/编辑器分工、源与生成目录、语言路由、
|
||||
生命周期、Yarn 命令、外部生成步骤和站点分发边界。
|
||||
- 无新依赖或锁变更;新增脚本是维护检查入口,不加入产品页面。
|
||||
- site-vendor 原始 notice 文本固定 LF,并仅对该取证目录允许上游末尾空行,
|
||||
防止 Windows checkout 改变冻结字节;不删改许可证原文来通过 whitespace 检查。
|
||||
|
||||
## 已复现问题
|
||||
|
||||
原 demos.test.mjs 因 asr.local.js 不在 BASE-04 中失败,错误是 Demo file coverage
|
||||
drift。该示例已由 PKG-ASR-05 提交引入。保留原 29 示例快照,增添有完整提交、
|
||||
路由和 owner 的 demo-additions.json。验证合并后的完整集合,仍拒绝未登记新增、
|
||||
旧路径丢失和菜单/包遗漏。额外反例拒绝重复登记、错误路由、未知 owner、越界路径、
|
||||
缺来源提交;没有通过删断言或全量重写历史快照解决。
|
||||
|
||||
触及旧脚本时修正 lint 指出的 process import 和 script src regex 的冗余零下界;
|
||||
后者仍要求 script 与 src 间至少一个属性分隔字符。脚本外部接口不变。
|
||||
一次 ESLint 写文件返回 UNKNOWN,确认文件完整后单独重试成功;测试文件的 node:test
|
||||
采用与仓库其它基线测试相同的定向规则说明,不引入 Vitest 或更换实际测试 runner。
|
||||
|
||||
## 来源与未完成事项
|
||||
|
||||
详见 [清单说明](../site-inventory.md) 与 [冻结证据](../baselines/site-provenance.json)。
|
||||
vConsole 3.15.0 字节一致;Monaco 0.30.1 的 98/99 字节一致,余下 CSS 仅换行差异。
|
||||
本次取得原始 LICENSE/ThirdPartyNotices,保存在 refactor 取证目录,分发装配归 SITE-07。
|
||||
console bundle 源码与组件完整版本、6 字体授权依据和样本来源仍开放。
|
||||
|
||||
thumbnail 示例与 npm 1.0.3 实际 VTT 实现/声明不一致,不能直接替换成 auto-thumbnail。
|
||||
EX-03 接续旧 URL 的修复与迁移解释。原 36 HTML 路径全部保留;文档站静态部署与
|
||||
缺 private 字段分开记录,REL-01 需显式发布分类,不能从缺字段推断 npm 发布意图。
|
||||
|
||||
新增 SITE-07 作为 SITE-05 前置,承接 notices/资产处置;加强 SITE-02 的坏代码块
|
||||
终止反例、SITE-03 的移动失败恢复/加载顺序/路由验证,以及 SITE-04 的双语成员覆盖。
|
||||
相关风险仍为 open,没有把清点视为发布接受或虚构免验。
|
||||
|
||||
## 验证与回退
|
||||
|
||||
最终命令和结果见 [验证记录](../baselines/site-inventory-validation.json)。定向检查包括
|
||||
真实当前清单、历史加增量的路径校验、错误输入反例、目标 lint、计划和风险登记。
|
||||
不需要重建生产 dist;没有运行播放器实播、完整文档构建、远端 CI/Pages/npm。
|
||||
|
||||
回退 SITE-01 提交恢复旧检查器和任务/清单;生产行为无需数据迁移。
|
||||
后续从 SITE-02 的声明/示例生成器开始,SITE-07 独立处置第三方分发来源。
|
||||
Reference in new issue
Block a user