# 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 围栏或尾逗号。