10 KiB
文档站、示例与生成链清单
SITE-07检查点已将Monaco LICENSE/ThirdPartyNotices和vConsole上游LICENSE原文加入 站点分发，并建立固定文件清单/指纹及只读检查。进一步检查发现vConsole上游文件 只有许可声明，缺其声称附带的MIT全文；不能把“已取得LICENSE”当成完整许可闭环。 Monaco真实TS worker三引擎通过；vConsole销毁在WebKit出现未处理回调错误，继续登记。 原始SITE-01清单及下面的历史未分发描述保留，当前入口见scripts/site-vendor/README.md。
SITE-SMOKE-01 后续已将 build:test 拆为 TS 解析、生成和浏览器运行模块，新增
确定性 examples.json 和 readonly check，替换 100ms done 为实例 ready/错误/清理。
以下 SITE-01 的旧生成器问题属于历史发现；当前维护入口见
docs-smoke README。SITE-02 后续已将声明生成
迁到 scripts/editor-declarations/：全部 22 份加载声明整组验证，Chapter/VAST
不再走删除 import 的文本回退。见模块说明。
以下 SITE-01 对这些旧生成问题的描述是历史发现，站点/编辑器交互仍需后续验收。
SITE-LOAD-01 后续修复并抽取共享 loader、移动入口和 Run Code/语言导航，TS 来源及生成规则见浏览器模块。 SITE-AI-DOCS-01/SITE-BUILD-01 已落实生成、翻译草稿和暂存构建；SITE-03 完成 桌面 UI 的 TS 模块拆分、实际 TS emit 与资源管理。完整内容/页面验收仍给 SITE-04/05。
SITE-01 在 d62ab13a35c756ea567c426d4fbe00d893dd7e2b 后核对当前源码。
可重跑清单见 site-inventory.json；它登记
22 包、27 Markdown、30 示例、36 HTML、963 条声明成员和 204 个资产指纹。
成员统计包括继承接口、重载和 runtime 声明，不能当作 963 个不同公开 API。
标题匹配只是人工核对的候选位置；所有成员均明确交由 SITE-04 检查语义和中英文说明。
页面与内容责任
- 中文 14 页、英文 13 页；核心安装、选项、i18n、四类组件、六类高级说明有对应页面。
- Danmuku 有中文独立页，缺英文页；其余 15 插件使用包 README 和编辑器链接，缺独立双语指南。
- 2 proxy、2 tool 有包 README 和示例。包内维护文档不等于站点双语使用文档。
- 清单逐包列出 README、ARCHITECTURE、菜单引用和示例；SITE-04 负责补充双语入口及缺失说明， 不要求为了统一形式机械复制 20 份 README。SITE-05 验证实际生成页面和链接。
- 本次补齐文档站自己的 维护地图。
VitePress 导航仍显示
5.3.x，目标版本文案由 REL-09/SITE-04 同候选同步。
清单用 Markdown parser 读取真正的标题，用 TypeScript AST 枚举声明成员；
不会把代码块中的 ## 当作标题，也不把同名标题自动判定为该接口已经有文档。
声明文件/符号/成员/行号和候选页面可追溯。接口语义、锚点可达性与运行正确性仍需人工和浏览器验证。
六类执行 HTML 与其它路径
| 入口 | 当前加载行为 | 后续责任 |
|---|---|---|
/ |
console.js → 按 localStorage.prod 选核心 → Monaco AMD loader → common.js |
SITE-03 / EX-03 |
/mobile.html |
vConsole、uncompiled 核心、独立 mobile.js loader | SITE-03 / EX-03 |
/esm.html |
import map 指向 compiled ESM，含 Danmuku、Document PiP、印尼语 | EX-03 |
/i18n.html |
script 载入 compiled 核心及语言，读取旧语言 global 别名 | SITE-03 / EX-03 |
/iframe.html |
uncompiled 核心和 iframe tool，调用 inject | PKG-IFRAME-05 / EX-03 |
/test/ |
Mocha/Chai、compiled 包及远程 SDK、生成 test.js | SITE-02 / EX-03 |
另外 28 个 docs/document/**/*.html 是现存生成站点路径（包含 404）；Google
验证页保持原路径/内容；/upscaler/ 是独立工具入口，不能按 VitePress 重建范围删除。
共 36 HTML，与 BASE-04 路径集合一致。现有生成 HTML 不证明来自当前源码的成功构建。
原 29 个示例路径全部保留；第 30 个 asr.local.js 来自提交
2cede66933e92b253bab4b3b2502f0268b22b087，无菜单链接，使用 ASR 插件的显式 libs URL。
它采集本地音频并显示模拟字幕，不是远程识别演示。原 BASE-04 保持原样；新增路径见
demo-additions.json。demos.mjs --check 将两者合并验证完整集合，
未知新增、遗漏旧路径、重复登记、错误路由或未知 owner 均不能通过。
查询参数、状态和编辑器声明
prod 是 localStorage 键/勾选项，不是已实现的查询参数；只选择核心产物，
不会重写 libs 中的插件路径。libs URI 解码后按换行分隔，依扩展名加载 JS/CSS，
当前 loader 串行加载并缓存成功 URL，失败允许重试，保留列表依赖顺序。
example 优先于 code；均不存在时桌面取 index.js，移动取 mobile.js。
桌面移动重定向保留 location.search。桌面 Run 先发送 artplayer:example:cleanup，
销毁已有实例后在独立经典函数作用域运行；重启将 libs/code 写入 URL。
TS 模式先通过实际 Monaco worker 发射 JavaScript，语法错误保留当前实例；
语义诊断可见但不作为 Run 的阻断条件，不等于发布级严格类型验收。
当前编辑器注入 22 个 d.ts（20 个生态包、核心、i18n），逐个 fetch 后 addExtraLib/createModel。 来源是核心 public 经 build:types/build:ts，以及各生态包 types 经 build:ts。 URL 列表生成在 browser/editor-libraries.ts，build:ts 同步生成 common.js。 仅存在性检查不证明请求成功或 Monaco 诊断有效，真实编辑器验收归 EX-03。 loadScript 暂时覆盖 window.define 后在成功/失败/取消时恢复。桌面先等待 Monaco 实际语言模块就绪，避免其 AMD 加载与外部脚本的临时 define 覆盖竞态。
生成流程和分发
| 命令/脚本 | 输入 → 输出 | 当前边界/责任 |
|---|---|---|
| build:types | 核心 public → types | 已有严格生成检查，不手改输出 |
| build:ts | 核心及插件声明 → assets/ts、editor-libraries.ts、生成 UI | 两代编译器整组校验；保持原声明 URL 与选包命令 |
| build:test | 中文 Run Code → docs/test/test.js、examples.json | TS 解析生成；按真实 ready/error 清理，覆盖范围见 SITE-SMOKE-01 |
| build:i18n | 核心语言源 → dist/i18n、compiled/i18n | SITE-BUILD-01 暂存全套 UMD/ESM 后替换；保留内置语言/辅助排除 |
| build:docs | VitePress 源 → docs/document | SITE-BUILD-01 固定 Yarn 子进程、暂存构建、失败回退 |
| build:llm | 英文文档、实际编辑器声明、示例、声明 notices → docs/llms.txt + manifest | SITE-AI-DOCS-01 离线可复现；check:llm 只读检查 |
| trans-docs.js | 中文 Markdown → 草稿 → 经检查应用英文 Markdown | 默认只显示计划；显式 --remote 请求，--validate / --apply 分步处理 |
build:test 的 malformed 分支在 continue 前不推进 regexp，存在同一坏块重复扫描的源码路径； SITE-02 必须加入可终止的坏文档反例。未运行该路径或把它计作已修复。 build:all/ci:build 不调用远程翻译；SITE-AI-DOCS-01 将离线 build:llm 纳入 ci:build，将只读 check:llm 纳入 ci:check。远程草稿与英文质量复核仍单独执行。
scripts/projects.js 明确排除 VitePress 的库构建；配置 base=/document/，输出到仓库 docs/document。
Pages 工作流消费已验证的 docs artifact，部署与检查分离。manifest 未设 private，且没有
库入口；这不足以推断作者希望发布 npm。REL-01/CI-03 必须显式区分 21 库与 1 静态站点，
站点 1.1.0→2.0.0 的版本要求保留。本次没有改 private、版本、发布列表或执行远端部署。
第三方与媒体来源
冻结 registry/SHA-512 tarball 对照见 site-provenance.json。 抓取脚本只下载、校验和读取归档，不执行包脚本；原始包缓存保留，报告记录确切 URL 和哈希。
| 对象 | 本次取证 | 未完成部分 |
|---|---|---|
| Monaco | npm 0.30.1 的 99 个对应文件：98 字节一致，editor.main.css 仅 5 处 CRLF/LF 差异；取得 LICENSE/ThirdPartyNotices | 站点 notices 装配、真实编辑器与 worker；SITE-07 / SITE-05 |
| vConsole | npm 3.15.0 dist 与本地逐字节一致，取得 LICENSE | 站点完整 notice 与移动使用验收；SITE-07 / EX-03 |
| console.js | Parcel bundle 含 react/react-dom/console-feed/styled-components，暴露 consoleLog；末尾指向不存在的 /index.js.map | 无冻结构建源/锁/完整组件版本；SITE-07 复原来源或可复现替换，不能直接认作自有 TS |
| JASSUB 字体 | 沿用既有 11 字体上游逐字节证据和内嵌元数据 | 6 字体授权依据、其它字体 notice 仍开放；PKG-JASSUB-06 / SITE-07 |
| 样本媒体 | 当前 sample 目录逐文件指纹；已有 URL/样本绑定可追溯 | 托管位置不证明授权，BASE-MEDIA-01 与 EX-03 保留 |
上游 notices 原文保留在 baselines/site-vendor/ 作为取证材料，尚未复制到发布站点。
没有更新 VENDOR-05/06/07/08 为 closed，也没有下载媒体来替代缺失的使用依据。
旧 thumbnail.js 在 a33df191a4216897d4fd4526927a822fd8b543a1 从工具示例改成
artplayerPluginThumbnail({width, number, scale})。官方 registry 列出的 1.0.0–1.0.3
manifest 均指向 VTT 包入口；实际验证的 1.0.3 tarball 源码导出 artplayerPluginVttThumbnail，
读取 option.vtt，声明却使用 artplayerPluginThumbnail 名称。不能把 npm 包名当成此示例的
可用依赖，也不能直接别名到 auto-thumbnail。EX-03 要保留旧 URL 并给出明确修复/迁移解释；
BASE-DEMO-01 保持开放。本次没有改变示例运行行为。
重跑与限制
node refactor/scripts/site-inventory.mjs --check
node refactor/scripts/demos.mjs --check
node --test refactor/scripts/demos.test.mjs refactor/scripts/site-inventory.test.mjs
node refactor/scripts/site-provenance.mjs --network
清单变化先检查差异，再 site-inventory.mjs --write，不能把重生成当作消除内容问题。
本任务是入口/来源和生成链清点，没有执行完整文档构建、公开页面请求、播放器实播、搜索、
真机或远端 CI。SITE-02/03/04/05/07 与 EX-03 的验收继续独立推进。