92 lines
7.0 KiB
Markdown
92 lines
7.0 KiB
Markdown
---
|
||
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 正常渲染。
|