sync update from LAN repo (source master @ ca48c4ec)

This commit is contained in:
gozeros committed 2026-11-05 10:53:54 +08:00
1 parent 8bc8b0e082
commit ea9dcff9c0
873 files changed
+107866 -14011

No files matched your search

@@ -0,0 +1,51 @@
# YouTube 页面 JSON 契约
源文件必须是 JSON 对象,并包含以下七个顶层模块。字段可增加,但不能删除顶层模块。
## `site`
- `brand`、`pageTitle`、`description`、`searchPlaceholder`、`createLabel`:非空字符串。
- `currentUser`:当前账号,包含 `name`、`handle`、`initial`、`colors` 和非负 `notifications`。
## `navigation`
- `primary`、`library`:桌面导航数组,每项 `{label, icon, href}`,各最多 12 项。
- `mobile`:移动端导航数组,每项 `{label, icon}`,最多 6 项。
- `footer`:侧栏页脚文字。
- 可用图标:`i-home`、`i-shorts`、`i-subscriptions`、`i-history`、`i-playlist`、`i-clock`、`i-like`、`i-user`。
## `categories`
- `items`:1–20 个非空字符串;第一项默认激活。
## `videos`
- `sectionTitle`:视频区标题。
- `items`:1–30 条,`id` 唯一。
- 每项包含 `title`、`channel`、`channelInitial`、`channelColors`、`category`、`views`、`time`、`visual`、`verified`、`description`。
- 不填写 `duration`;页面不展示 JSON 预设时长,旧 JSON 中的该字段会被兼容忽略。
- `visual` 仅使用 `city`、`studio`、`food`、`mountain`、`code`、`science`、`music`、`travel`。
- 可选 `media` 会替换缩略图和观看区:图片 `{type:"image", mediaUrl, alt?, pageUrl?}`;视频 `{type:"video", mediaUrl, posterUrl?, alt?, pageUrl?}`;网页 `{type:"webpage", pageUrl, title, description?, mediaUrl?, embed?}`。URL 只接受 `http(s)`;图片和视频也允许对应的 `data:` URL。横屏和竖屏视频在观看区内均按原比例居中完整显示。
- `metrics` 为 `{likes, comments}`,均为非负数字。
## `shorts`
- `sectionTitle`:Shorts 区标题。
- `items`:0–20 条,每项包含唯一 `id`、`title`、`views`、`visual`。
- `visual` 使用与视频相同的预制视觉类型。
- Shorts 同样可设置上述可选 `media`。
## `subscriptions`
- `title`:侧栏标题。
- `items`:0–20 项,每项 `{name, handle, initial, colors}`。
## `comments`
- `titleSuffix`、`inputPlaceholder`:非空字符串。
- `items`:0–40 项,每项包含唯一 `id`、`name`、`initial`、`colors`、`text`、`time`、非负 `likes`。
## 示例边界
- `assets/default-data.json` 只提供结构和演示内容,不是事实来源。
- JSON 使用双引号,不允许注释、Markdown 围栏或尾逗号。