Files

83 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: tiktok-page-generator
description: 生成或绘制 TikTok、抖音国际版及 TikTok 风格的可交付短视频信息流 HTML 网页;仅在用户明确要求 TikTok 网页、TikTok 风格短视频页面或点名本技能时使用。先把材料或检索结果整理成六模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
allowed-tools:
- 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`,避免重写完整视频或评论对象:
```json
{"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:
```text
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](references/data-schema.md)。
5. 校验 JSON:
```text
python /mnt/skills/public/tiktok-page-generator/scripts/render_tiktok_page.py validate --input /mnt/user-data/outputs/tiktok-page-data.json
```
6. 确定性渲染到 `outputs/`:
```text
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 正常渲染。