ArtPlayer/refactor/site-inventory.md

# 文档站、示例与生成链清单

2026-09-15 Monaco 后续：CSS/HTML/JSON 完整 worker 已由固定源码和压缩配方复现，
七个依赖的九份原始许可、两个格式器署名和补充说明已实际交付。全站 81 份
notice 的 HTTP 字节、链接及三引擎功能检查通过，见
[记录](changes/2026-09-15-SITE-07-monaco-language-notices.md)。Monaco core/mode/
语言定义及其余来源细节仍开放，不能按本检查点认为整个站点已可发布。

console.js 后续已冻结 102 个模块和实际 React/ReactDOM/Parcel/返回组件契约；
三个浏览器复现卸载回调、多容器丢日志和 Error 消息丢失。源码尚未替换，依赖许可
仍开放；下一实现任务为 SITE-CONSOLE-01，见[迁移边界](console-modernization.md)。

2026-09-15后续：vConsole 3.15.0 已由固定源码/锁文件精确重建，补原始声明所引用的
MIT 正文和九个运行时组件的完整通知；VENDOR-07 关闭。三引擎真实播放/日志/销毁及
全部 HTTP 通知 3/3 通过。见[当前记录](changes/2026-09-15-SITE-07-vconsole-notices.md)。
下面的许可缺口描述属于先前检查点；其他站点来源/字体/媒体门槛继续保留。

SITE-07检查点已将Monaco LICENSE/ThirdPartyNotices和vConsole上游LICENSE原文加入
站点分发，并建立固定文件清单/指纹及只读检查。进一步检查发现vConsole上游文件
只有许可声明，缺其声称附带的MIT全文；不能把“已取得LICENSE”当成完整许可闭环。
Monaco真实TS worker三引擎通过；旧vConsole销毁错误已由SITE-VCONSOLE-01修复。
2026-09-15：Codicons字体精确匹配npm0.0.26，其历史许可、README和署名已随站点分发；
真实三引擎6/6包含编辑器、播放、销毁及HTTP原文/字体指纹。详见
[Codicons记录](changes/2026-09-15-SITE-07-codicons.md)。其余组件和字体媒体仍须复核。
原始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](../scripts/docs-smoke/README.md)。SITE-02 后续已将声明生成
迁到 `scripts/editor-declarations/`：全部 22 份加载声明整组验证，Chapter/VAST
不再走删除 import 的文本回退。见[模块说明](../scripts/editor-declarations/README.md)。
以下 SITE-01 对这些旧生成问题的描述是历史发现，站点/编辑器交互仍需后续验收。

SITE-LOAD-01 后续修复并抽取共享 loader、移动入口和 Run Code/语言导航，TS
来源及生成规则见[浏览器模块](../packages/artplayer-vitepress/browser/README.md)。
SITE-AI-DOCS-01/SITE-BUILD-01 已落实生成、翻译草稿和暂存构建；SITE-03 完成
桌面 UI 的 TS 模块拆分、实际 TS emit 与资源管理。完整内容/页面验收仍给 SITE-04/05。

SITE-01 在 `d62ab13a35c756ea567c426d4fbe00d893dd7e2b` 后核对当前源码。
可重跑清单见 [site-inventory.json](baselines/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 验证实际生成页面和链接。
- 本次补齐文档站自己的 [维护地图](../packages/artplayer-vitepress/README.md)。
  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](baselines/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](baselines/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 保持开放。本次没有改变示例运行行为。

## 重跑与限制

```sh
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 的验收继续独立推进。