SuperAPI AI 工具集

tweet-style-importer

设计与创作

查看项目

更新于 10-16 15:13

技能介绍

用途

Tweet Style Importer(推文画风自动入库 Skill)用于将 X(Twitter)上的 AI 生图风格推文(如 Midjourney --sref 风格、艺术家作品图集等)一键自动抓取、处理并标准化入库到手绘风格库中。当用户提供一个推文链接并要求入库时,该技能按标准流程完成全部处理。

主要能力

技能执行以下 6 步标准流程:

  1. 抓取推文与高清原图
  2. 计算下一位顺延编号(如 #217)
  3. 生成双轨图像资源:生图参考图、风格单图、画廊展板
  4. 风格库元数据入库(styles_200_reorganized.md)
  5. 模型能力策略配置(model_capabilities.json),强制启用传图规则:name_activation=none、traits_activation=none
  6. 重建画廊并运行全量校验(build_library.py 与 validate_library.py)

在抓取环节,技能会先按 X/Twitter 状态 ID 检查 downloads/tweet_{id}/tweet.json;已抓取的推文直接停止,不下载图片、不分配新编号、不改动风格库或画廊。它会自动解析推文作者(名称与 Handle)、推文正文、Midjourney --sref 风格代码,并自动提取全部原图(强制替换为 ?name=orig 高清尺寸)。数据保存在 downloads/tweet_{id}/。成功入库后写入 import.json,记录状态 ID、原始链接、风格编号与导入时间;重复输入时返回已入库编号;没有 import.json 的历史下载仅提示“已抓取但未完成登记”,同样不会重复抓取。

使用方式

在工作区直接运行自动化脚本即可完成全流程:

# 标准一键执行
python scripts/import_tweet_style.py "https://x.com/username/status/..."

# 支持可选的自定义英文风格名与中文特征描述
python scripts/import_tweet_style.py "https://x.com/username/status/..." --name "Custom Style Name" --traits "核心特征描述"

图像与规格标准

生图出图参考图:有 2–4 张不同原图时,创建 images/individual/{bucket}/{number}_grid.webp,为 1024 × 1024 px JPG 的 2×2 四宫格;仅有 1 张原图时,不创建 _grid.webp,直接使用 images/individual/{bucket}/{number}.webp,不得复制成四格相同的图片。

风格单图(images/individual/{bucket}/{number}.webp):规格 512 × 512 px WebP,纯净画面,严禁压印任何数字编号、作者 Handle 或角标框,完整保留原画画面内容与构图细节。{bucket} 每 200 个编号递增:001-200、201-400、401-600。存在四宫格时,它与同编号单图位于同一个目录。

画廊展板(#217 起为 images/H_{number}.webp):规格 1254 × 1254 px WebP,标准 4×4(16 宫格)画板,按左到右、上到下续填,未满时不新建展板。命名反映已实际填入的编号范围,例如 H_217-218.webp;填满 16 格后,下一个编号才创建新展板。状态记录在 references/contact_sheet_state.json(活动展板、已填数量、下一格);单图以无角标纯净画面进入对应格。

风格库与模型策略入库

主风格表(styles_200_reorganized.md):更新总数标题并追加新行:

| {number} · {author} | {generation_name} | {traits} |

模型能力策略(references/model_capabilities.json):为该编号追加强制传图配置:

"{number}": { "name_activation": "none", "traits_activation": "none" }

确保调用 resolve_reference.py 时无论任何模型,均判定为 use_reference_image = True,并优先返回多图四宫格;单图导入则返回单图路径。

画廊与验证

调用 python handdraw-style-prompter/scripts/build_library.py 重建画廊与 JSON 索引;调用 python handdraw-style-prompter/scripts/validate_library.py 验证全库契约,确保无断号、无图片缺失。

交付与汇报格式

执行完成后输出标准化成果卡片,包含:入库信息(编号、作者、风格名、所属分组)、画廊链接(skills/handdraw-style-prompter/gallery/index.html)、双语提示词模板。

  • 中文:风格名称:#{编号} · {generation_name}。主题:[主题]。参考作者/风格名称:{author}。
  • 英文:Style name: #{number} · {generation_name}. Theme: [Theme]. Reference author/style name: {author}。

适用场景与限制

适用于需要批量维护 AI 生图手绘风格库、并希望从 X/Twitter 推文自动标准化入库的流程。限制方面:资料未提供收费、价格、平台支持范围、运行环境依赖与效果保证等信息,暂未提供。