Files

7.0 KiB
Raw Permalink Blame History

name, description, allowed-tools
name description allowed-tools
threads-page-generator 生成或绘制 Threads 及 Threads 风格的可交付文本社交信息流 HTML 网页;仅在用户明确要求 Threads 网页、Threads 风格串文首页或点名本技能时使用。先把材料或检索结果整理成六模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
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。单账号单串文直接使用以下格式:

    {
      "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:

    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。

  5. 校验 JSON:

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

    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 正常渲染。