6.9 KiB
name, description, allowed-tools
| name | description | allowed-tools | |||||
|---|---|---|---|---|---|---|---|
| youtube-page-generator | 生成或绘制 YouTube 及 YouTube 风格的可交付视频门户 HTML 网页;仅在用户明确要求 YouTube 网页、YouTube 风格视频首页或点名本技能时使用。先把材料或检索结果整理成七模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。 |
|
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;未写字段继续使用模板默认数据与示例视觉,脚本在一次进程内合并、校验并渲染。
-
用
write_file创建/mnt/user-data/outputs/youtube-page-spec.json。直接写模块对象会做递归合并;修改数组中的单个字段优先用$set,避免重写完整视频或评论对象:{"site":{"pageTitle":"YouTube · 中文主题"},"$set":{"videos.items.0.title":"中文视频标题","videos.items.0.description":"中文视频简介","comments.items.0.text":"中文评论"}} -
只执行一次
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。 -
stdout 为
status: ok后立即用present_files交付返回的完整 JSON 与 HTML,最终只回复一句完成说明。
规格只允许本技能七个模块和 $set;$set 路径必须指向默认 JSON 中已存在的字段。读者可见内容使用简体中文。未提供媒体直链时不要写 visual/media,保留示例视觉供用户上传替换。禁止读取默认数据、契约、模板、运行时或脚本源码,禁止 --help、独立 init/validate/render、生成后打补丁、临时脚本和冗长过程说明。规格报错时只修正规格一次并重跑。只有用户明确要求改变模块结构或批量重建完整数组时,才使用下面的完整工作流。
完整工作流(仅限结构改造)
-
读取当前会话材料、上传附件和已有产物,确定页面主题、当前账号、分类、长视频、Shorts、订阅频道和评论。
-
用户要求基于公开资料、主题涉及近期事件,或明确要求检索时,先做至多两批聚焦检索;用户明确说不要检索时不得联网。没有材料时使用中性示例内容并明确标为示例,不虚构实时播放量。
-
初始化新的完整 JSON:
python /mnt/skills/public/youtube-page-generator/scripts/render_youtube_page.py init --output /mnt/user-data/outputs/youtube-page-data.json -
只修改 JSON。七个顶层模块必须全部保留:
site、navigation、categories、videos、shorts、subscriptions、comments。字段不确定时读取 references/data-schema.md。 -
校验 JSON:
python /mnt/skills/public/youtube-page-generator/scripts/render_youtube_page.py validate --input /mnt/user-data/outputs/youtube-page-data.json -
确定性渲染到
outputs/: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 -
检查 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 正常渲染。