comfyui-metastyle-T8

网站：https://ai.t8star.org

Online workflow overseas：

https://www.runninghub.ai/?inviteCode=rh-v1121

在线工作流国内版：

https://www.runninghub.cn/?inviteCode=rh-v1121

👋🏻 Welcome to Zhenzhen

网站价格和宗旨：

本站开设初衷是提供平价的API给粉丝朋友玩最新的海外模型，并非盈利目的，秉承这一理念，我们的价格毛利不到10%，去掉正常缴税和人工开发维护，服务器成本后几乎没有利润，所以并非盈利性质网站，没有任何议价空间，也不支持用于商业目的的二次开发，仅服务于粉丝朋友，望理解，每个月发票数量有限，需要自己承担所有税费5-25%

网站使用及Api调用教程：

网站使用教程：https://ai.t8star.org/about

API调用及开发教程：https://ai.t8star.org/api-set

贞贞的AI工坊新手无障碍整合包(windows版本)和教程：

整合包(更新至v4.5B)：https://pan.quark.cn/s/5e948ab145e1

youtube教程：https://www.youtube.com/watch?v=oitmGaRtYvc

MetaStyle T8 风格选择器 —— 把上万种艺术风格的代表图、示例提示词全部装进 ComfyUI 节点，支持中英拼音模糊搜索 + 实时大图预览。

✨ 特性

• 🎨 10000+ 风格：涵盖数字艺术、二次元、赛博朋克、文艺复兴、水彩水墨、印象派……一站式选择
• 🗂️ 30 个大类 + 数字艺术 6 个子类：自动归类、按大类筛选不再迷路
• 🔎 模糊搜索：支持中文 / 英文 / 拼音全拼 / 拼音首字母（如 cyberpunk / 赛博 / saibo / sb 都能命中）
• 🖼️ 实时大图预览：节点内嵌缩略图墙 + 高清预览，不需要运行工作流就能看到风格效果
• 📤 多端口输出：图像 / 风格名 / 大类 / 示例提示词 / 原始 ID / 完整元数据 JSON
• ⚡ 零卡顿：256px WebP 缩略图懒加载，倒排索引秒级搜索
• 📄 分页浏览：每页 120 张缩略图，支持上一页/下一页翻页，10000 张风格轻松浏览

🗺️ 更新日志

v1.1.0（2026-05-21）

• ✅ 修复缩略图显示问题：修复网格高度计算错误导致图片不显示的 bug
• ✅ 新增翻页功能：支持上一页/下一页翻页浏览，每页显示 120 张缩略图
• ✅ 优化网格布局：固定行高 72px，确保所有缩略图以正方形正确显示
• ✅ API 支持分页：/metastyle/search 新增 offset 参数支持

v1.0.0（2026-05-21）

• 🎉 首版发布：30 大类 + 模糊搜索 + 实时预览
• 内置 10,000 张风格原图 + 10,000 张缩略图
• ️ 30 个大类自动归类（数字艺术、插画、二次元、赛博朋克等）
• 🔎 支持中文 / 英文 / 拼音模糊搜索

📷 节点界面

┌────────────────────────────────────────────┐
│ MetaStyle T8 风格选择器                     │
├────────────────────────────────────────────┤
│ [赛博朋克 Cyberpunk (259) ▼] [搜索框]      │
├────────────────────────────────────────────┤
│  ▣ 缩略图网格（按需加载，悬停高亮）         │
│   ┌──┐┌──┐┌──┐┌──┐┌──┐┌──┐┌──┐┌──┐         │
│   │  ││  ││★ ││  ││  ││  ││  ││  │         │
│   └──┘└──┘└──┘└──┘└──┘└──┘└──┘└──┘         │
├────────────────────────────────────────────┤
│  [大图预览]  风格名: cyberpunk fantasy ...  │
│              大类: 赛博朋克                 │
│              示例提示词: Barbell on rack…   │
└────────────────────────────────────────────┘

输出: image | style_name | category | sample_prompt | sample_id | meta_json

🚀 安装

方法 1：git clone（推荐）

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/comfyui-metastyle-T8.git
cd comfyui-metastyle-T8
pip install -r requirements.txt

数据已包含在仓库中，无需额外下载或构建。

方法 2：ComfyUI Manager

未来发布到 Registry 后可一键安装。

数据集

v1.0.0 起，数据已内置在仓库中，无需手动构建。

仓库包含 10,000 张风格原图 + 10,000 张缩略图 + 元数据索引，总计 ~410 MB。

git clone 后开箱即用。

如需重新生成数据（开发者）

适合你已经持有 train-00000.parquet 源数据集，想自行构建或更新风格库的情况：

cd custom_nodes/comfyui-metastyle-T8

# 1. 提取每个风格的代表图
python ../../extract_styles.py --out E:\parquet\styles

# 2. 拷贝/链接图片 + 反查 content/id
python scripts/build_dataset.py --src E:\parquet --mode link

# 3. 自动归类 30 大类
python scripts/auto_classify.py

# 4. 生成 256px WebP 缩略图（多进程加速）
python scripts/build_thumbnails.py

# 5. 构建模糊搜索倒排索引
python scripts/build_index.py

完成后 data/ 目录会得到：

data/
├── styles/                10000 张原图
├── thumbs/                10000 张 256px WebP
├── styles_meta.json       完整元数据 (~8 MB)
├── catalog.json           大类目录 (~1 MB)
├── styles_lite.json       前端轻量列表
└── search_index.json      倒排索引 (6000+ tokens)

🎬 使用

1. 重启 ComfyUI，控制台应出现：

   [MetaStyle-T8] 节点已加载: MetaStyleT8Picker
   [MetaStyle-T8] 已注册 HTTP 路由 /metastyle/*
   

2. 画布右键：Add Node → T8 → Style → MetaStyle T8 风格选择器
3. 节点上：
   • 顶部下拉选择大类（"全部"=不限）
   • 搜索框输入任意关键字（中文/英文/拼音都行）
   • 点击网格中的缩略图即选中，下方实时显示大图与示例提示词
4. 把节点输出连到下游：
   • image → PreviewImage / IPAdapter / ControlNet 等
   • sample_prompt → CLIPTextEncode（直接用作 prompt 起手式）
   • style_name / category → Show Text 调试

🧠 节点 IO

Inputs

Outputs

🛠️ 后端 HTTP 路由

注册前缀 /metastyle/，全部由 ComfyUI 内置 aiohttp server 提供：

可在浏览器直接访问，便于调试。

🗂️ 项目结构

comfyui-metastyle-T8/
├── __init__.py              # ComfyUI 加载入口
├── nodes.py                 # 节点核心逻辑
├── api.py                   # HTTP 路由
├── pyproject.toml           # ComfyUI Registry 元数据
├── requirements.txt
├── scripts/                 # 数据构建脚本（可重复运行）
│   ├── build_dataset.py
│   ├── auto_classify.py
│   ├── build_thumbnails.py
│   └── build_index.py
├── web/                     # 前端 UI
│   ├── metastyle.js
│   └── metastyle.css
├── data/                    # 数据（git 忽略）
└── examples/                # 示例工作流

❓ 常见问题

Q1：节点加载失败 / 画布上找不到节点

• 确认依赖已安装：pip install -r requirements.txt
• 查看 ComfyUI 启动日志中是否有 [MetaStyle-T8] 节点已加载 字样
• 确保 data/styles_meta.json 存在（运行过 build_dataset.py）

Q2：缩略图全 404 / 显示横条

• 缩略图未生成：运行 python scripts/build_thumbnails.py
• 浏览器有旧 CSS 缓存：按 Ctrl + F5 强制刷新

Q3：搜索没结果

• 索引未生成：运行 python scripts/build_index.py
• 中文搜索不命中：确认安装了 pypinyin，重新生成索引

Q4：想自定义大类 / 关键字规则

编辑 scripts/auto_classify.py 中的 PRIMARY_RULES， 重新跑 auto_classify.py + build_index.py 即可。

📜 License

MIT © T8mars

🙏 致谢

• 基于 ComfyUI 自定义节点机制
• 拼音支持来自 pypinyin
• 训练数据集来源：用户私有 parquet 数据集（不在仓库中）

🗺️ Roadmap

• 多张候选图随机/手动切换
• 收藏夹（标记常用风格）
• 拖拽风格图导出 LoRA 训练用 zip
• 数据包 CDN 镜像
• ComfyUI Registry 一键安装

欢迎 PR / Issue！