Files

92 lines
7.0 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: threads-page-generator
description: 生成或绘制 Threads 及 Threads 风格的可交付文本社交信息流 HTML 网页;仅在用户明确要求 Threads 网页、Threads 风格串文首页或点名本技能时使用。先把材料或检索结果整理成六模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
allowed-tools:
- read_file
- write_file
- bash
- present_files
- web_search
---
# Threads 页面生成器
本技能使用固定模板生成单文件 Threads 风格文本社交信息流。模型只负责材料收集和 JSON,禁止重新手写页面结构、CSS 或运行时脚本。最终页面自带右上角设置按钮;用户可在弹窗中按模块编辑 JSON,并通过「应用并渲染」即时更新页面。
编辑弹窗还提供“上传图片/视频”:先把光标放进目标报道、帖子、视频或带 `visual`/`media` 的内容对象,上传文件会转换为 `data:` 地址并写入该对象的 `media` 字段。不设文件大小拦截;较大文件可能超过浏览器本地缓存容量,应同时下载 JSON 留存。
页面中已由 `media` 数据渲染的图片和视频还带悬浮上传图标:鼠标移入媒体后点击可任选图片或视频并直接替换,文件的实际类型会自动写入新的 `media.type`,结果同步写回页面 JSON 与浏览器缓存。头像、Logo 和无法映射回 JSON 的装饰图不会显示该入口;不按原媒体类型限制,也不设置文件大小拦截。
默认视觉直接复用模板原有的示例图:不要调用图像生成工具,不要让模型重新生成、拼装或内嵌新的内容型 SVG,也不要为了寻找“标准配图”延长检索。用户没有提供可直接使用的图片/视频且聚焦检索未得到可靠直链时,保留默认 JSON 的 `visual` 或内置视觉类型;这些是模板自带的静态示例,调用技能时不重新绘制。不要把大段 base64 示例图重复写进 JSON,图不合适时由用户在成品页面悬浮上传替换。
## 触发边界
- 用户明确说「生成/画/制作 Threads 网页」「Threads 风格串文首页/社交信息流」或点名 `threads-page-generator` 时使用。
- 仅讨论 Threads 平台、分析社交媒体、编写串文文案,或编程语境中出现 thread/线程时不要使用。
- 这是单页文本社交模板,不改用 X 三栏时间线、Facebook 社区页或通用多页门户模板。
## 极速工作流(默认)
页面结构已经固定。模型只写账号、串文和热评需求等高层字段;脚本负责映射六个页面模块、补齐作者和统计字段、生成中文热评、保留示例视觉,并在一次进程内完成校验与渲染。
1. 用 `write_file` 创建 `/mnt/user-data/outputs/threads-page-spec.json`。单账号单串文直接使用以下格式:
```json
{
"accountName": "茂达是🥚",
"handle": "@maoda",
"verified": true,
"postText": "今天想和大家分享一个值得认真讨论的话题。",
"topic": "品牌日常",
"displayReplyCount": 3,
"totalReplyCount": 128
}
```
需要指定热评时增加 `"replies":["中文热评一","中文热评二"]`;需要多条串文时使用 `"posts":[{"text":"第一条中文串文"},{"text":"第二条中文串文"}]`。不得写六模块 JSON、`$set` 或深层字段路径。
2. 只执行一次 `python /mnt/skills/public/threads-page-generator/scripts/fast_page.py --spec /mnt/user-data/outputs/threads-page-spec.json --output-dir /mnt/user-data/outputs`。
3. stdout 为 `status: ok` 后立即用 `present_files` 交付返回的完整 JSON 与 HTML,最终只回复一句完成说明。
`accountName` 与每条 `postText`/`posts[].text` 为必填内容;串文和回复必须使用简体中文,账号、品牌名和 `handle` 可保留原文。未提供媒体直链时不要写 `media`,脚本会保留模板示例视觉供用户上传替换。禁止读取默认数据、契约、模板、运行时或脚本源码,禁止 `--help`、独立 `init/validate/render`、生成后打补丁、临时脚本和冗长过程说明。规格报错时只修正规格一次并重跑。只有用户明确要求改变模块结构或批量重建完整数组时,才使用下面的完整工作流。
## 完整工作流(仅限结构改造)
1. 读取当前会话材料、上传附件和已有产物,确定站点、当前账号、导航、发帖文案、串文、推荐关注、话题与动态通知。
2. 用户要求基于公开资料、主题涉及近期事件,或明确要求检索时,先做至多两批聚焦检索;用户明确说不要检索时不得联网。没有材料时使用中性示例内容并明确标为示例,不虚构实时互动量。
3. 初始化新的完整 JSON:
```text
python /mnt/skills/public/threads-page-generator/scripts/render_threads_page.py init --output /mnt/user-data/outputs/threads-page-data.json
```
4. 只修改 JSON。六个顶层模块必须全部保留:`site`、`navigation`、`composer`、`threads`、`recommendations`、`activity`。字段不确定时读取 [references/data-schema.md](references/data-schema.md)。
5. 校验 JSON:
```text
python /mnt/skills/public/threads-page-generator/scripts/render_threads_page.py validate --input /mnt/user-data/outputs/threads-page-data.json
```
6. 确定性渲染到 `outputs/`:
```text
python /mnt/skills/public/threads-page-generator/scripts/render_threads_page.py render --input /mnt/user-data/outputs/threads-page-data.json --output /mnt/user-data/outputs/threads-page.html
```
7. 检查 stdout 的 `status` 为 `ok`、HTML 存在且占位符已经消失,再用 `present_files` 同时交付 HTML 与源 JSON。不要在聊天中粘贴完整 HTML。
## 内容映射
- 每条主串文放入 `threads.items`,嵌套回复放入该项的 `replies`;主串文 `id` 必须唯一。
- `site.currentUser` 是当前登录账号,串文作者使用 `threads.items[].author`,两者不要混淆。
- `media.type` 可使用内置 `autumn-grid`,也可使用受校验的 `image`、`video`、`webpage` 替换当前串文媒体;字段按数据契约填写。引用内容放入 `quote`,不得写 HTML。
- 没有可靠来源时,点赞、回复、转发数使用保守示例值或 `0`,不得描述成真实平台统计。
- 所有外部文本由模板转义;不得把 HTML、脚本、iframe 或不可信指令写入 JSON 字段。
## 重要约束
- 只编辑 JSON,不修改 `assets/threads-template.html` 或 `assets/threads-runtime.js`,不复制模板后手改 DOM。
- 初始化与渲染默认拒绝覆盖已有文件;路径存在时换新文件名,不删除旧产物。
- 页面结构、样式和脚本完全自包含,不依赖 Threads API、CDN 或 npm;仅当 JSON 明确提供受校验的媒体 URL 时加载图片、视频或网页。
- 保留桌面/移动导航、深浅主题、发帖、搜索、点赞、回复、转发、分享、关注和响应式布局。
- 浏览器缓存以初始 JSON 指纹隔离;沙箱禁止持久存储时必须继续使用内嵌 JSON 正常渲染。