chore: import upstream snapshot with attribution

.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# 大数据集（已在 v1.0.0 推送，保留默认入库）
+# data/styles/
+# data/thumbs/
+# data/styles_meta.json
+# data/styles_lite.json
+# data/search_index.json
+# data/catalog.json
+
+# 临时文件
+*.log
+*.tmp
+*.bak

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 T8mars
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,272 @@
+# comfyui-metastyle-T8
+
+# 网站：[https://ai.t8star.org](https://ai.t8star.org/register?aff=cbff0534884)
+# Online workflow overseas：
+https://www.runninghub.ai/?inviteCode=rh-v1121
+# 在线工作流国内版：
+https://www.runninghub.cn/?inviteCode=rh-v1121
+# 👋🏻 Welcome to Zhenzhen
+
+<img src="https://github.com/T8mars/Comfyui-zhenzhen/blob/main/pic/1.png" width="30%" alt="My favorite girl">
+My favorite girl Go YounJung
+
+# 网站价格和宗旨：
+
+本站开设初衷是提供平价的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 节点，支持中英拼音模糊搜索 + 实时大图预览。
+
+![version](https://img.shields.io/badge/version-1.1.0-blue) ![ComfyUI](https://img.shields.io/badge/ComfyUI-custom--node-orange) ![python](https://img.shields.io/badge/python-3.10%2B-green) ![license](https://img.shields.io/badge/license-MIT-lightgrey)
+
+---
+
+## ✨ 特性
+
+- 🎨 **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（推荐）
+
+```bash
+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` 源数据集，想自行构建或更新风格库的情况：
+
+```bash
+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
+| 名称 | 类型 | 说明 |
+|---|---|---|
+| `style_key` | STRING | 选中的风格 key（由前端 widget 自动维护） |
+| `output_size` | COMBO | `original` / `512` / `768` / `1024` |
+| `seed` | INT (可选) | 预留，用于将来多张候选随机切换 |
+
+### Outputs
+| 名称 | 类型 | 说明 |
+|---|---|---|
+| `image` | IMAGE | 风格代表图（BHWC float32 0~1） |
+| `style_name` | STRING | 风格全名 |
+| `category` | STRING | 大类（中文） |
+| `sample_prompt` | STRING | 示例提示词，可直接接 CLIPTextEncode |
+| `sample_id` | STRING | 数据集中的原始 id（便于溯源） |
+| `meta_json` | STRING | 该风格全量元数据 JSON 字符串 |
+
+---
+
+## 🛠️ 后端 HTTP 路由
+
+注册前缀 `/metastyle/`，全部由 ComfyUI 内置 aiohttp server 提供：
+
+| 路由 | 作用 |
+|---|---|
+| `GET /metastyle/catalog` | 大类 + 子类 + 数量统计 |
+| `GET /metastyle/lite` | 全量轻量风格列表（首屏） |
+| `GET /metastyle/search?q=&cat=&sub=&limit=` | 模糊搜索 |
+| `GET /metastyle/thumb/<key>` | 256px 缩略图 |
+| `GET /metastyle/preview/<key>` | 原图大图 |
+| `GET /metastyle/meta/<key>` | 单条完整元数据 |
+
+可在浏览器直接访问，便于调试。
+
+---
+
+## 🗂️ 项目结构
+
+```
+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](scripts/auto_classify.py) 中的 `PRIMARY_RULES`，
+重新跑 `auto_classify.py` + `build_index.py` 即可。
+
+---
+
+## 📜 License
+
+MIT © T8mars
+
+---
+
+## 🙏 致谢
+
+- 基于 [ComfyUI](https://github.com/comfyanonymous/ComfyUI) 自定义节点机制
+- 拼音支持来自 [pypinyin](https://github.com/mozillazg/python-pinyin)
+- 训练数据集来源：用户私有 parquet 数据集（不在仓库中）
+
+---
+
+## 🗺️ Roadmap
+
+- [ ] 多张候选图随机/手动切换
+- [ ] 收藏夹（标记常用风格）
+- [ ] 拖拽风格图导出 LoRA 训练用 zip
+- [ ] 数据包 CDN 镜像
+- [ ] ComfyUI Registry 一键安装
+
+欢迎 PR / Issue！

README.wehub.md

@@ -0,0 +1,7 @@
+# WeHub 来源说明
+
+- 原始项目：`T8mars/comfyui-megastyle-T8`
+- 原始仓库：https://github.com/T8mars/comfyui-megastyle-T8
+- 导入方式：上游默认分支的最新快照
+- 原作者、版权和许可证信息以原始仓库及本仓库 LICENSE 为准
+- 本文件仅用于记录来源，不代表 WeHub 是原项目作者

__init__.py

@@ -0,0 +1,19 @@
+"""ComfyUI 入口：注册节点、注册前端目录、注册自定义 HTTP 路由。"""
+from .nodes import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
+
+# 让 ComfyUI 把 web/ 目录暴露为静态资源 /extensions/comfyui-metastyle-T8/*
+WEB_DIRECTORY = "./web"
+
+# 注册自定义 HTTP API 路由
+try:
+    from . import api  # noqa: F401  导入即注册
+except Exception as e:
+    print(f"[MetaStyle-T8] api 路由注册失败: {e}")
+
+__all__ = [
+    "NODE_CLASS_MAPPINGS",
+    "NODE_DISPLAY_NAME_MAPPINGS",
+    "WEB_DIRECTORY",
+]
+
+print("[MetaStyle-T8] 节点已加载: MetaStyleT8Picker")

api.py

@@ -0,0 +1,217 @@
+"""注册自定义 HTTP 路由到 ComfyUI 的 aiohttp server。
+
+路由 (前缀 /metastyle):
+  GET /metastyle/catalog            -> 大类 + 子类 + 计数
+  GET /metastyle/lite               -> 轻量 styles 列表（首屏使用）
+  GET /metastyle/search?q=&cat=&sub=&limit=  -> 搜索结果
+  GET /metastyle/thumb/<key>        -> 缩略图
+  GET /metastyle/preview/<key>      -> 原图（大图预览）
+  GET /metastyle/meta/<key>         -> 单条完整元数据
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+from pathlib import Path
+
+from aiohttp import web
+
+try:
+    from server import PromptServer  # ComfyUI 内置
+except Exception:
+    PromptServer = None  # 允许独立测试
+
+from .nodes import (
+    DATA, ROOT, load_catalog, load_lite, load_meta,
+)
+
+WORD_RE = re.compile(r"[a-z0-9]+")
+CN_CHAR_RE = re.compile(r"[\u4e00-\u9fff]")
+
+_index_cache = None
+
+
+def load_index() -> dict:
+    global _index_cache
+    if _index_cache is None:
+        p = DATA / "search_index.json"
+        _index_cache = json.loads(p.read_text(encoding="utf-8")) if p.exists() else {
+            "tokens": {}, "styles": []
+        }
+    return _index_cache
+
+
+def query_tokens(q: str) -> list[str]:
+    """把搜索词拆为 token 列表（与 build_index 同口径）。"""
+    if not q:
+        return []
+    q = q.strip().lower()
+    toks = WORD_RE.findall(q)
+    cn = "".join(CN_CHAR_RE.findall(q))
+    if cn:
+        toks.extend(list(cn))
+    return [t for t in toks if t]
+
+
+def _safe_join(base: Path, rel: str) -> Path | None:
+    """防穿越的安全拼接。"""
+    p = (base / rel).resolve()
+    base_r = base.resolve()
+    if str(p).startswith(str(base_r)):
+        return p
+    return None
+
+
+# ---------------- 路由实现 ----------------
+
+routes = web.RouteTableDef()
+
+
+@routes.get("/metastyle/catalog")
+async def r_catalog(request: web.Request):
+    cat = load_catalog()
+    # 精简：去掉 items 列表，只保留计数
+    light = {}
+    for cn, info in cat.items():
+        light[cn] = {
+            "name_cn": info.get("name_cn", cn),
+            "name_en": info.get("name_en", ""),
+            "count": info.get("count", 0),
+            "subs": {
+                scn: {"name_cn": s["name_cn"],
+                      "name_en": s["name_en"],
+                      "count": s["count"]}
+                for scn, s in info.get("subs", {}).items()
+            },
+        }
+    return web.json_response(light)
+
+
+@routes.get("/metastyle/lite")
+async def r_lite(request: web.Request):
+    return web.json_response(load_lite())
+
+
+@routes.get("/metastyle/search")
+async def r_search(request: web.Request):
+    q = request.query.get("q", "").strip()
+    cat = request.query.get("cat", "").strip()
+    sub = request.query.get("sub", "").strip()
+    try:
+        limit = max(1, min(int(request.query.get("limit", "120")), 500))
+    except ValueError:
+        limit = 120
+    try:
+        offset = max(0, int(request.query.get("offset", "0")))
+    except ValueError:
+        offset = 0
+
+    idx = load_index()
+    styles = idx["styles"]
+
+    # 1. 关键字命中（按 token 求交集，并以 token 命中数作为分数）
+    if q:
+        toks = query_tokens(q)
+        scores: dict[int, int] = {}
+        for t in toks:
+            # 完全匹配
+            for i in idx["tokens"].get(t, []):
+                scores[i] = scores.get(i, 0) + 2
+            # 前缀匹配（最多展开 50 个 token，避免 token 表全扫）
+            if len(t) >= 2:
+                cnt = 0
+                for tk, ids in idx["tokens"].items():
+                    if cnt > 50:
+                        break
+                    if tk != t and tk.startswith(t):
+                        for i in ids:
+                            scores[i] = scores.get(i, 0) + 1
+                        cnt += 1
+        candidates = sorted(scores.items(), key=lambda x: -x[1])
+        ordered = [styles[i] for i, _ in candidates]
+    else:
+        ordered = list(styles)
+
+    # 2. 大类/子类过滤
+    if cat:
+        ordered = [s for s in ordered if s.get("c") == cat or s.get("ce") == cat]
+    if sub:
+        ordered = [s for s in ordered if s.get("s") == sub or s.get("se") == sub]
+
+    return web.json_response({
+        "q": q, "cat": cat, "sub": sub,
+        "total": len(ordered),
+        "offset": offset,
+        "limit": limit,
+        "items": ordered[offset:offset + limit],
+    })
+
+
+def _send_image(key: str, sub: str, content_type_hint: str = ""):
+    """通用：返回 data/<sub>/ 下与 key 对应的图片文件。"""
+    meta = load_meta()
+    info = meta.get(key)
+    if not info:
+        return web.json_response({"error": "key not found"}, status=404)
+
+    if sub == "thumb":
+        rel = f"thumbs/{key}.webp"
+    else:
+        rel = info["image"]
+
+    fp = _safe_join(DATA, rel)
+    if not fp or not fp.exists():
+        # thumb 缺失时回退到原图
+        if sub == "thumb":
+            fp = _safe_join(DATA, info["image"])
+            if not fp or not fp.exists():
+                return web.json_response({"error": "file missing"}, status=404)
+        else:
+            return web.json_response({"error": "file missing"}, status=404)
+
+    ext = fp.suffix.lower()
+    mime = {
+        ".jpg": "image/jpeg", ".jpeg": "image/jpeg",
+        ".png": "image/png", ".webp": "image/webp",
+        ".gif": "image/gif", ".bmp": "image/bmp",
+    }.get(ext, "application/octet-stream")
+    return web.FileResponse(fp, headers={
+        "Content-Type": mime,
+        "Cache-Control": "public, max-age=86400",
+    })
+
+
+@routes.get("/metastyle/thumb/{key}")
+async def r_thumb(request: web.Request):
+    key = request.match_info["key"]
+    return _send_image(key, "thumb")
+
+
+@routes.get("/metastyle/preview/{key}")
+async def r_preview(request: web.Request):
+    key = request.match_info["key"]
+    return _send_image(key, "preview")
+
+
+@routes.get("/metastyle/meta/{key}")
+async def r_meta(request: web.Request):
+    key = request.match_info["key"]
+    info = load_meta().get(key)
+    if not info:
+        return web.json_response({"error": "key not found"}, status=404)
+    return web.json_response(info)
+
+
+# ---------------- 注册到 ComfyUI ----------------
+
+def _register():
+    if PromptServer is None or not hasattr(PromptServer, "instance"):
+        print("[MetaStyle-T8] PromptServer 未就绪，跳过路由注册")
+        return
+    app = PromptServer.instance.app
+    app.add_routes(routes)
+    print("[MetaStyle-T8] 已注册 HTTP 路由 /metastyle/*")
+
+
+_register()