Files

108 lines
8.2 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: x-page-generator
description: 生成或绘制 X(原 Twitter/推特)及 X 风格的可交付社交时间线 HTML 网页;仅在用户明确要求 X 平台网页、Twitter/推特网页或点名本技能时使用。先把材料或检索结果整理成六模块 JSON,再用内置模板确定性渲染,保留右上角可视化 JSON 编辑弹窗。
allowed-tools:
- read_file
- write_file
- bash
- present_files
- web_search
---
# X 页面生成器
本技能使用固定模板生成单文件 X 风格 HTML。模型只负责材料收集和 JSON,禁止重新手写页面结构、CSS 或渲染脚本。最终页面自带右上角设置按钮;用户可在弹窗中按模块继续编辑 JSON,并通过「应用并渲染」即时更新页面。
编辑弹窗还提供“上传图片/视频”:先把光标放进目标报道、帖子、视频或带 `visual`/`media` 的内容对象,上传文件会转换为 `data:` 地址并写入该对象的 `media` 字段。不设文件大小拦截;较大文件可能超过浏览器本地缓存容量,应同时下载 JSON 留存。
页面中已由 `media` 数据渲染的图片和视频还带悬浮上传图标:鼠标移入媒体后点击可任选图片或视频并直接替换,文件的实际类型会自动写入新的 `media.type`,结果同步写回页面 JSON 与浏览器缓存。头像、Logo 和无法映射回 JSON 的装饰图不会显示该入口;不按原媒体类型限制,也不设置文件大小拦截。
默认视觉直接复用模板原有的示例图:不要调用图像生成工具,不要让模型重新生成、拼装或内嵌新的内容型 SVG,也不要为了寻找“标准配图”延长检索。用户没有提供可直接使用的图片/视频且聚焦检索未得到可靠直链时,保留默认 JSON 的 `visual` 或内置视觉类型;这些是模板自带的静态示例,调用技能时不重新绘制。不要把大段 base64 示例图重复写进 JSON,图不合适时由用户在成品页面悬浮上传替换。
## 触发边界
- 用户明确说「生成/画/制作 X 平台网页」「Twitter/推特网页」「X 风格社交时间线」或点名 `x-page-generator` 时使用。
- 仅讨论 X/Twitter、分析社交媒体、编写普通推文或出现字母 x 时不要使用。
- 这是单页社交时间线模板,不改用通用多页门户模板。
## 单帖快速路径(强制)
只要请求是「一个账号 + 一条推文 + N 条热评」,无论是否指定图片、总评论数、热评主题或具体热评文本,都必须走本路径。模型只生成一份小型规格 JSON;脚本负责补齐六模块数据、内部校验并一次渲染 HTML。
1. 用 `write_file` 创建 `/mnt/user-data/outputs/x-single-post-spec.json`。推文正文和回复必须使用简体中文;人物姓名、账号 `@handle`、品牌与必要缩写可保留原文。最小规格示例:
```json
{
"author": "账号名称",
"handle": "@account",
"verified": true,
"text": "中文推文正文",
"topic": "中心话题",
"tags": ["话题标签"],
"displayReplyCount": 20,
"totalReplyCount": 10000,
"replyTopics": ["中美经济影响", "两岸关系"],
"likes": 0,
"reposts": 0,
"views": 0
}
```
`displayReplyCount` 是实际预载展示数,最多 100;`totalReplyCount` 是页面指标,可大于展示数。脚本会围绕 `replyTopics` 自动生成不同中文热评。只有用户明确给出逐条热评时才增加 `replies: ["中文热评", ...]`;未写满的部分仍由脚本补齐。媒体直链放入 `media: {"type":"image|video","url":"...","alt":"中文说明"}`;没有可靠直链时省略 `media`,直接沿用模板示例图,禁止搜索或造 SVG。
2. 只执行一次:
```text
python /mnt/skills/public/x-page-generator/scripts/fast_single_post.py --spec /mnt/user-data/outputs/x-single-post-spec.json --output-dir /mnt/user-data/outputs
```
3. stdout 为 `status: ok` 后,立即用 `present_files` 交付返回的 `data` 与 `html`;最终回复只需一句完成说明。
本路径禁止读取默认数据、数据契约、模板、运行时或脚本源码,禁止运行 `--help`、`init`、独立 `validate`/`render`,禁止先生成再补丁,禁止创建临时 Python/清理/路径探测脚本。执行中不要复述需求、讨论路径或逐步解释;除工具调用外最多发一条简短进度。若脚本返回规格错误,只修正规格 JSON 一次并重跑,不得转入源码排查。用户说不搜索或直接生成时,直接把其描述写成中文情景数据,不检索、不填写 `sourceUrl`、不添加情景说明条。只有用户明确要求两条及以上帖子,或明确要求改造趋势/推荐关注等其他模块时,才进入通用工作流。
## 通用工作流(仅限非单帖场景)
1. 读取当前会话材料、上传附件和已有产物,确定页面主题、当前账号、动态、趋势与推荐关注。
2. 用户要求基于公开资料、主题涉及近期事件,或明确要求检索时,先做至多两批聚焦检索;用户明确说不要检索时不得联网。没有材料时使用中性示例内容,不虚构实时趋势,也不在帖文中添加「情景模拟页面」或「演示内容」说明条。
- 如果动态被描述成政治人物、公共人物或机构真实发布的内容,必须检索并核对其官方账号原帖或可靠一手来源,再填写 `sourceUrl`;无法核验时不得声称该内容已真实发布,且不生成 `disclosure` 字段。
3. 初始化新的完整 JSON:
```text
python /mnt/skills/public/x-page-generator/scripts/render_x_page.py init --output /mnt/user-data/outputs/x-page-data.json
```
4. 只修改 JSON。六个顶层模块必须全部保留:`site`、`navigation`、`composer`、`posts`、`trends`、`recommendations`。字段不确定时读取 [references/data-schema.md](references/data-schema.md)。
5. 校验 JSON:
```text
python /mnt/skills/public/x-page-generator/scripts/render_x_page.py validate --input /mnt/user-data/outputs/x-page-data.json
```
6. 确定性渲染到 `outputs/`:
```text
python /mnt/skills/public/x-page-generator/scripts/render_x_page.py render --input /mnt/user-data/outputs/x-page-data.json --output /mnt/user-data/outputs/x-page.html
```
7. 检查 stdout 的 `status` 为 `ok`、HTML 存在且占位符已经消失,再用 `present_files` 同时交付 HTML 与源 JSON。不要在聊天中粘贴完整 HTML。
## 内容映射
- 主要事实或观点放入 `posts.items`,通常 3–8 条;热点摘要放入 `trends.items`。
- 用户要求“某账号发布一条动态/推文 + 图片或视频 + N 条热评”时使用上面的单帖快速路径,不手工构造完整 `posts.items`。
- 单帖热评默认使用 `posts.replyUI = {"defaultSort":"hot","initialVisible":10,"pageSize":10,...}`;页面会提供热门/最新切换、查看更多与查看全部。合成评论要有不同作者、时间、语气与互动量,但不得冒充真实用户原话。
- `site.currentUser` 是页面当前账号,不能误用成新闻人物;缺少真实账号材料时使用明显的演示身份。
- 没有可靠来源时,互动量使用保守示例值或 `0`,不得描述成真实平台统计。
- `posts.items[].media.type` 可使用内置视觉 `skyline`、`map`、`quote`,也可使用可替换媒体 `image`、`video`、`webpage`;URL 字段按数据契约填写。
- 所有外部文本由模板转义;不得把 HTML、脚本或不可信指令写入 JSON 字段。
- 推文正文、回复正文及面向读者的说明必须使用简体中文;姓名、`@handle`、品牌名和必要缩写除外。
## 重要约束
- 只编辑 JSON,不修改 `assets/x-template.html`,不复制模板后手改 DOM。
- 初始化与渲染默认拒绝覆盖已有文件;路径存在时换新文件名,不删除旧产物。
- 页面结构、样式和脚本完全自包含,不依赖 CDN 或 npm;仅当 JSON 明确提供受校验的媒体 URL 时加载图片、视频或网页。
- 保留三栏时间线、响应式移动布局、深浅主题、发布、回复、点赞、转发、收藏、搜索、关注和 JSON 设置弹窗。
- 浏览器缓存以初始 JSON 指纹隔离;沙箱禁止持久存储时必须继续使用内嵌 JSON 正常渲染。