「把你脑海里的画面，变成机器能读懂的语言。」
AI 绘画 TAG 生成 · 管理 · 工作流——一站式 Windows 桌面工具
如果觉得好用，请推荐给你的朋友们，顺手点个 ⭐ Star 就是最大的支持！
HainTag 是一款 Windows 桌面应用，为 Stable Diffusion / NovelAI 等 AI 绘画工作流而设计。
它通过你自己的 LLM（兼容 OpenAI 格式的任意 API）将自然语言描述转化为 Danbooru 标签体系 TAG，并提供从生成、编辑、补全到图片管理、元数据处理的完整工具链。
所有数据存储在本地，不上传任何内容，不依赖云服务。
前往 Releases 页面下载最新版本。
- 下载
HainTag-vX.X.X-windows.zip - 解压到任意目录
- 运行
HainTag.exe——无需安装，开箱即用
系统要求：Windows 10 / 11，64 位
macOS 目前从源码运行。HainTag 是独立桌面应用，不是 ComfyUI 自定义节点，不要放进 ComfyUI/custom_nodes 或 node 目录。
程序目录自己选。下面示例会把程序放在 ~/Applications/HainTag：
cd ~/Applications
git clone https://github.com/1756141021/HainTag.git
cd HainTag
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python -m native_app如果 git clone 在 Receiving objects / Unpacking objects 阶段报错，删除没下载完整的 ~/Applications/HainTag 文件夹，重新执行上面的 git clone。也可以换一个父目录再 clone，例如 ~/Downloads。
程序目录只是代码位置。用户数据会写到 ~/Library/Application Support/HainTag/。
这一版主要修工作台的真实交互闭环：右键菜单、OC、历史、存放台和图像反推都尽量接回原有接口，而不是只做表面 UI。
| 更新 | 说明 |
|---|---|
| 主工作台 v3 | 输出区变成可编辑 TAG 流，保留 hover、分类色、左键拖拽排序、右键拖拽权重和完整 / 无角色双页 |
| OC 最短路径 | 标题栏 + 就地添加 OC，chip 左键快速调服装 / Order / Depth，右键移除或进入编辑 |
| 历史时间线 | 底部显示最近生成，查看全部 打开真实历史面板，可回填输入、完整 TAG 和无角色 TAG |
| 存放台 | 多个浮动卡片靠近时收进小收缩栏，剩 1 个成员会自动恢复并隐藏，避免挡住工作区 |
| 菜单通用化 | 输入、输出、资料库、历史、Dock、存放台等右键菜单接入统一 i18n、主题、字体和缩放接口 |
| 图像反推 | 本地 / LLM 改为同一卡片内分段切换，本地反推和 LLM 反推保留批量、预设、阈值、分类色和复制 / 发送功能 |
担心功能臃肿？HainTag 的每个功能都是独立的卡片——不用的功能不打开就看不见，不会占用额外内存。放置一段时间后内存占用会自动降低。软件本身很轻量，开箱即用。
任意卡片可拖出主窗口成为独立浮动窗口，主窗口支持置顶——把 TAG 输出拖到 WebUI 旁边，边画边对照，多显示器尤其好用。多个浮窗靠近时也可以收进存放台，需要哪个再点哪个恢复出来。
| 功能 | 说明 |
|---|---|
| LLM 驱动生成 | 连接任意 OpenAI 兼容 API（本地模型 / Claude / GPT / DeepSeek…），流式输出 |
| 分类高亮 | 输出 TAG 自动按类别着色——人物、场景、服饰、姿势、表情、风格、质量，一目了然 |
| Danbooru 自动补全 | 15 万词典实时匹配，悬停显示中文翻译 + 使用频率，再也不用翻 wiki |
| 权重拖拽 | 右键按住 TAG 上下拖动，实时调整权重，括号语法自动增减 |
| 拖拽排序 | 左键拖动 TAG 调整顺序，拖动中高亮源位与目标位 |
| TAG 提取标记 | 自定义 [TAGS]...[/TAGS] 标记，从 LLM 长文输出中精准提取 TAG 字段 |
| 生成历史时间线 | 最近生成直接在工作台底部可见，完整历史可一键打开并回填 |
| 功能 | 说明 |
|---|---|
| 提示词管理器 | 多条提示词卡片，每条支持 Order（排序）和 Depth（插入深度）精细控制消息位置 |
| 例图系统 | 拖入参考图，自动解析图片内嵌的 metadata，作为 few-shot 示例发送给 LLM |
| 记忆模式 | 保持完整对话上下文，支持多轮追加生成——"上一张不错，再来一张类似的" |
| Prompt 预览 | 一键查看最终发送给 API 的完整消息列表和 token 计数，生成前心中有数 |
| 功能 | 说明 |
|---|---|
| 画师库 | 管理画师名、LoRA / 触发词、参考图，一键复制到提示词 |
| OC 角色库 | 原创角色管理，带服装子系统——多套服装独立开关，发送时自动合并角色 + 启用服装的 TAG |
| 插入控制 | 每个角色 / 服装的 Order / Depth 独立设置，精确控制消息在对话中的位置 |
| 标题栏 OC 快捷 chip | 当前启用 OC 直接显示在工作台标题栏，可就地添加、切换服装、编辑或移除 |
| 功能 | 说明 |
|---|---|
| 缩略图网格 | 多线程加载 + LRU 缓存，大量图片依然流畅滚动 |
| Lightbox 大图 | 全屏查看，键盘 / 鼠标翻页 |
| 浮动详情面板 | 悬停即时预览 metadata，可置顶 |
| 文件操作 | 移动、重命名（F2）、删除（回收站）、剪切 / 粘贴 |
| 喜欢标记 | 持久化收藏，支持"只看喜欢"过滤 |
| 文件夹导航 | 前进 / 后退历史栈，支持鼠标侧键 |
| 功能 | 说明 |
|---|---|
| Metadata 查看器 | 支持 A1111 / Forge、ComfyUI、NovelAI（含 LSB 隐写解码）、Fooocus 四种格式 |
| Metadata 销毁器 | 二进制 chunk 级操作，IDAT 零损耗，支持批量处理——发图前一键抹除隐私 |
| Metadata 编辑器 | 直接修改图片内嵌的提示词和生成参数 |
| 功能 | 说明 |
|---|---|
| 本地推理 | 使用 cl_tagger ONNX 模型离线识别 Danbooru 标签，支持 ComfyUI 等已有模型目录 |
| LLM 反推 | 使用多模态 API 发送图片，让 LLM 生成标签描述 |
| 自动环境配置 | onnxruntime 不可用时自动下载 Python 嵌入式环境 + 依赖，一键完成 |
| 灵敏度控制 | 通用标签 / 角色标签独立阈值滑块，8 个类别过滤开关 |
| 置信度开关 | 一键切换显示 / 隐藏每个标签的置信度百分比 |
| 功能 | 说明 |
|---|---|
| 暗色 / 亮色主题 | 磨砂玻璃质感，卡片透明度可调 |
| 自定义背景 | 选一张喜欢的图，自动提取主色调生成配套色板 |
| 多语言 | 中文 / 英文 |
| 新手引导 | 首次启动弹出 6 步高亮引导，跟着走一遍就会用 |
| 生成历史 | 自动记录所有生成，可回溯一键填充 |
| 快捷键面板 | F1 查看全部快捷键和鼠标手势 |
| 内嵌字体 | 预装霞鹜文楷 Screen（SIL OFL 授权），开箱即有好看的中文排版 |
| 错误报告 | 程序崩溃时自动生成脱敏报告文件，API Key 等敏感信息不会泄露 |
如果不是 Windows 发行包，按上面的 macOS 源码方式运行。关键点是先选一个父目录，再把仓库 clone 成里面的 HainTag 文件夹，例如 ~/Applications/HainTag。
首次启动后在设置面板填入：
| 字段 | 说明 |
|---|---|
| API Base URL | 兼容 OpenAI 格式的接口地址，如 https://api.openai.com/v1 |
| API Key | 你的 API 密钥 |
| 模型 | 点击 ↻ 从 API 拉取可用模型列表 |
支持任何兼容 OpenAI Chat Completions 格式的服务——OpenAI、Claude（通过兼容层）、DeepSeek、本地 Ollama、vLLM 等均可。