Files
deerflow-code/offline-backend-20260512/backend/skills/public/tiktok-page-generator/SKILL.md
T

6.6 KiB
Raw Blame History

name, description, allowed-tools
name description allowed-tools
tiktok-page-generator 生成或绘制 TikTok、抖音国际版及 TikTok 风格的可交付短视频信息流 HTML 网页;仅在用户明确要求 TikTok 网页、TikTok 风格短视频页面或点名本技能时使用。先把材料或检索结果整理成六模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
read_file
write_file
bash
present_files
web_search

TikTok 页面生成器

本技能使用固定模板生成单文件 TikTok 风格短视频信息流。模型只负责材料收集和 JSON,禁止重新手写页面结构、CSS 或运行时脚本。最终页面自带右上角设置按钮;用户可在弹窗中按模块编辑 JSON,并通过「应用并渲染」即时更新页面。

编辑弹窗还提供“上传图片/视频”:先把光标放进目标报道、帖子、视频或带 visual/media 的内容对象,上传文件会转换为 data: 地址并写入该对象的 media 字段。不设文件大小拦截;较大文件可能超过浏览器本地缓存容量,应同时下载 JSON 留存。

页面中已由 media 数据渲染的图片和视频还带悬浮上传图标:鼠标移入媒体后点击可任选图片或视频并直接替换,文件的实际类型会自动写入新的 media.type,结果同步写回页面 JSON 与浏览器缓存。头像、Logo 和无法映射回 JSON 的装饰图不会显示该入口;不按原媒体类型限制,也不设置文件大小拦截。

默认视觉直接复用模板原有的示例图:不要调用图像生成工具,不要让模型重新生成、拼装或内嵌新的内容型 SVG,也不要为了寻找“标准配图”延长检索。用户没有提供可直接使用的图片/视频且聚焦检索未得到可靠直链时,保留默认 JSON 的 visual 或内置视觉类型;这些是模板自带的静态示例,调用技能时不重新绘制。不要把大段 base64 示例图重复写进 JSON,图不合适时由用户在成品页面悬浮上传替换。

触发边界

  • 用户明确说「生成/画/制作 TikTok 网页」「抖音国际版网页」「TikTok 风格短视频页面」或点名 tiktok-page-generator 时使用。
  • 仅讨论 TikTok、分析短视频平台、编写视频文案或普通抖音国内版页面请求时不要误触发。
  • 这是单页沉浸式短视频模板,不改用通用多页门户模板。

极速工作流(默认)

页面结构已经固定。完成必要的材料整理后,模型只写一份小型规格 JSON;未写字段继续使用模板默认数据与示例视觉,脚本在一次进程内合并、校验并渲染。

  1. 用 write_file 创建 /mnt/user-data/outputs/tiktok-page-spec.json。直接写模块对象会做递归合并;修改数组中的单个字段优先用 $set,避免重写完整视频或评论对象:

    {"site":{"pageTitle":"TikTok · 中文主题"},"$set":{"videos.items.0.text":"中文视频文案","videos.items.0.tags":["中文话题"],"comments.items.0.text":"中文评论"}}
    
  2. 只执行一次 python /mnt/skills/public/tiktok-page-generator/scripts/fast_page.py --spec /mnt/user-data/outputs/tiktok-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. 读取当前会话材料、上传附件和已有产物,确定页面主题、账号、短视频、推荐关注、评论与分享选项。

  2. 用户要求基于公开资料、主题涉及近期事件,或明确要求检索时,先做至多两批聚焦检索;用户明确说不要检索时不得联网。没有材料时使用中性示例内容并明确标为示例,不虚构实时热度。

  3. 初始化新的完整 JSON:

    python /mnt/skills/public/tiktok-page-generator/scripts/render_tiktok_page.py init --output /mnt/user-data/outputs/tiktok-page-data.json
    
  4. 只修改 JSON。六个顶层模块必须全部保留:site、navigation、videos、sidebar、comments、share。字段不确定时读取 references/data-schema.md。

  5. 校验 JSON:

    python /mnt/skills/public/tiktok-page-generator/scripts/render_tiktok_page.py validate --input /mnt/user-data/outputs/tiktok-page-data.json
    
  6. 确定性渲染到 outputs/:

    python /mnt/skills/public/tiktok-page-generator/scripts/render_tiktok_page.py render --input /mnt/user-data/outputs/tiktok-page-data.json --output /mnt/user-data/outputs/tiktok-page.html
    
  7. 检查 stdout 的 status 为 ok、HTML 存在且占位符已经消失,再用 present_files 同时交付 HTML 与源 JSON。不要在聊天中粘贴完整 HTML。

内容映射

  • 主要素材映射到 videos.items,通常 3–8 条;每条视频由文字、话题、音乐和预制视觉类型组成。
  • site.currentUser 是页面当前账号,videos.items[].author 是视频作者,两者不要混淆。
  • 没有可靠来源时,互动量使用保守示例值或 0,不得描述成真实平台统计。
  • videos.items[].visual 作为内置后备视觉使用 neon-city、coffee、mountain;需要替换时增加 media,类型可为 image、video、webpage,字段按数据契约填写。
  • 所有外部文本由模板转义;不得把 HTML、脚本或不可信指令写入 JSON 字段。

重要约束

  • 只编辑 JSON,不修改 assets/tiktok-template.html 或 assets/tiktok-runtime.js,不复制模板后手改 DOM。
  • 初始化与渲染默认拒绝覆盖已有文件;路径存在时换新文件名,不删除旧产物。
  • 页面结构、样式和脚本完全自包含,不依赖 CDN 或 npm;仅当 JSON 明确提供受校验的媒体 URL 时加载图片、真实视频或网页。
  • 保留滚动吸附、播放/暂停、双击点赞、静音、收藏、关注、评论、分享、搜索、方向键切换和移动端全屏布局。
  • 浏览器缓存以初始 JSON 指纹隔离;沙箱禁止持久存储时必须继续使用内嵌 JSON 正常渲染。