84 lines
6.9 KiB
Markdown
84 lines
6.9 KiB
Markdown
---
|
||
name: youtube-page-generator
|
||
description: 生成或绘制 YouTube 及 YouTube 风格的可交付视频门户 HTML 网页;仅在用户明确要求 YouTube 网页、YouTube 风格视频首页或点名本技能时使用。先把材料或检索结果整理成七模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
|
||
allowed-tools:
|
||
- read_file
|
||
- write_file
|
||
- bash
|
||
- present_files
|
||
- web_search
|
||
---
|
||
|
||
# YouTube 页面生成器
|
||
|
||
本技能使用固定模板生成单文件 YouTube 风格视频门户。模型只负责材料收集和 JSON,禁止重新手写页面结构、CSS 或运行时脚本。最终页面自带右上角设置按钮;用户可在弹窗中按模块编辑 JSON,并通过「应用并渲染」即时更新页面。
|
||
|
||
编辑弹窗还提供“上传图片/视频”:先把光标放进目标报道、帖子、视频或带 `visual`/`media` 的内容对象,上传文件会转换为 `data:` 地址并写入该对象的 `media` 字段。不设文件大小拦截;较大文件可能超过浏览器本地缓存容量,应同时下载 JSON 留存。
|
||
|
||
页面中已由 `media` 数据渲染的图片和视频还带悬浮上传图标:鼠标移入媒体后点击可任选图片或视频并直接替换,文件的实际类型会自动写入新的 `media.type`,结果同步写回页面 JSON 与浏览器缓存。头像、Logo 和无法映射回 JSON 的装饰图不会显示该入口;不按原媒体类型限制,也不设置文件大小拦截。
|
||
|
||
默认视觉直接复用模板原有的示例图:不要调用图像生成工具,不要让模型重新生成、拼装或内嵌新的内容型 SVG,也不要为了寻找“标准配图”延长检索。用户没有提供可直接使用的图片/视频且聚焦检索未得到可靠直链时,保留默认 JSON 的 `visual` 或内置视觉类型;这些是模板自带的静态示例,调用技能时不重新绘制。不要把大段 base64 示例图重复写进 JSON,图不合适时由用户在成品页面悬浮上传替换。
|
||
|
||
## 触发边界
|
||
|
||
- 用户明确说「生成/画/制作 YouTube 网页」「YouTube 风格视频首页/频道页」或点名 `youtube-page-generator` 时使用。
|
||
- 仅讨论 YouTube、分析视频平台、编写视频脚本或普通文本中出现视频链接时不要使用。
|
||
- 这是单页视频门户模板,不改用 TikTok 竖屏信息流或通用多页门户模板。
|
||
|
||
## 极速工作流(默认)
|
||
|
||
页面结构已经固定。完成必要的材料整理后,模型只写一份小型规格 JSON;未写字段继续使用模板默认数据与示例视觉,脚本在一次进程内合并、校验并渲染。
|
||
|
||
1. 用 `write_file` 创建 `/mnt/user-data/outputs/youtube-page-spec.json`。直接写模块对象会做递归合并;修改数组中的单个字段优先用 `$set`,避免重写完整视频或评论对象:
|
||
|
||
```json
|
||
{"site":{"pageTitle":"YouTube · 中文主题"},"$set":{"videos.items.0.title":"中文视频标题","videos.items.0.description":"中文视频简介","comments.items.0.text":"中文评论"}}
|
||
```
|
||
|
||
2. 只执行一次 `python /mnt/skills/public/youtube-page-generator/scripts/fast_page.py --spec /mnt/user-data/outputs/youtube-page-spec.json --output-dir /mnt/user-data/outputs`。
|
||
3. stdout 为 `status: ok` 后立即用 `present_files` 交付返回的完整 JSON 与 HTML,最终只回复一句完成说明。
|
||
|
||
规格只允许本技能七个模块和 `$set`;`$set` 路径必须指向默认 JSON 中已存在的字段。读者可见内容使用简体中文。未提供媒体直链时不要写 `visual`/`media`,保留示例视觉供用户上传替换。禁止读取默认数据、契约、模板、运行时或脚本源码,禁止 `--help`、独立 `init/validate/render`、生成后打补丁、临时脚本和冗长过程说明。规格报错时只修正规格一次并重跑。只有用户明确要求改变模块结构或批量重建完整数组时,才使用下面的完整工作流。
|
||
|
||
## 完整工作流(仅限结构改造)
|
||
|
||
1. 读取当前会话材料、上传附件和已有产物,确定页面主题、当前账号、分类、长视频、Shorts、订阅频道和评论。
|
||
2. 用户要求基于公开资料、主题涉及近期事件,或明确要求检索时,先做至多两批聚焦检索;用户明确说不要检索时不得联网。没有材料时使用中性示例内容并明确标为示例,不虚构实时播放量。
|
||
3. 初始化新的完整 JSON:
|
||
|
||
```text
|
||
python /mnt/skills/public/youtube-page-generator/scripts/render_youtube_page.py init --output /mnt/user-data/outputs/youtube-page-data.json
|
||
```
|
||
|
||
4. 只修改 JSON。七个顶层模块必须全部保留:`site`、`navigation`、`categories`、`videos`、`shorts`、`subscriptions`、`comments`。字段不确定时读取 [references/data-schema.md](references/data-schema.md)。
|
||
5. 校验 JSON:
|
||
|
||
```text
|
||
python /mnt/skills/public/youtube-page-generator/scripts/render_youtube_page.py validate --input /mnt/user-data/outputs/youtube-page-data.json
|
||
```
|
||
|
||
6. 确定性渲染到 `outputs/`:
|
||
|
||
```text
|
||
python /mnt/skills/public/youtube-page-generator/scripts/render_youtube_page.py render --input /mnt/user-data/outputs/youtube-page-data.json --output /mnt/user-data/outputs/youtube-page.html
|
||
```
|
||
|
||
7. 检查 stdout 的 `status` 为 `ok`、HTML 存在且占位符已经消失,再用 `present_files` 同时交付 HTML 与源 JSON。不要在聊天中粘贴完整 HTML。
|
||
|
||
## 内容映射
|
||
|
||
- 普通横屏内容放入 `videos.items`,通常 6–12 条;竖屏内容放入 `shorts.items`。
|
||
- 不生成或填写固定的视频时长;页面不显示 JSON 预设时长,避免替换上传视频后与真实时长不一致。
|
||
- `site.currentUser` 是当前登录账号,视频作者使用 `videos.items[].channel`,两者不要混淆。
|
||
- 没有可靠来源时,播放量、点赞量和评论量使用保守示例值或 `0`,不得描述成真实平台统计。
|
||
- `videos.items[].visual` 和 `shorts.items[].visual` 继续作为内置后备视觉;需要替换时增加 `media`,类型可为 `image`、`video`、`webpage`,字段按数据契约填写。
|
||
- 所有外部文本由模板转义;不得把 HTML、脚本、iframe 或不可信指令写入 JSON 字段。
|
||
|
||
## 重要约束
|
||
|
||
- 只编辑 JSON,不修改 `assets/youtube-template.html` 或 `assets/youtube-runtime.js`,不复制模板后手改 DOM。
|
||
- 初始化与渲染默认拒绝覆盖已有文件;路径存在时换新文件名,不删除旧产物。
|
||
- 页面结构、样式和脚本完全自包含,不依赖 YouTube API、CDN 或 npm;仅当 JSON 明确提供受校验的媒体 URL 时加载外部缩略图、真实视频或网页。
|
||
- 保留桌面导航、分类筛选、视频搜索、响应式网格、Shorts 横向列表、观看弹窗、点赞、收藏和评论。上传的横屏或竖屏视频在观看弹窗中都必须完整、居中显示,不拉伸、不偏移。
|
||
- 浏览器缓存以初始 JSON 指纹隔离;沙箱禁止持久存储时必须继续使用内嵌 JSON 正常渲染。
|