HainTag

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #machine-learning #deep-learning #linux #nodejs #awesome-list #mcp #ios #openai #open-source

(★ 34)

AI 绘画 TAG 生成器 · AI Drawing Tag Generator

HainTag Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HainTag · 海茵的标签工坊

**「把你脑海里的画面，变成机器能读懂的语言。」**

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Platform: Windows](https://img.shields.io/badge/Platform-Windows_10%2F11-0078d4.svg)]()
[![Release](https://img.shields.io/github/v/release/1756141021/HainTag?color=green)](https://github.com/1756141021/HainTag/releases)
[![Downloads](https://img.shields.io/badge/Downloads-Release-orange)](https://github.com/1756141021/HainTag/releases)

AI 绘画 TAG 生成 · 管理 · 工作流——一站式 Windows 桌面工具

如果觉得好用，请推荐给你的朋友们，顺手点个 ⭐ Star 就是最大的支持！

[海茵的介绍 ☽](README.hein.md) · [English](README.en.md)

</div>

---

### 这是什么

HainTag 是一款 Windows 桌面应用，为 Stable Diffusion / NovelAI 等 AI 绘画工作流而设计。

它通过你自己的 LLM（兼容 OpenAI 格式的任意 API）将自然语言描述转化为 Danbooru 标签体系 TAG，并提供从生成、编辑、补全到图片管理、元数据处理的完整工具链。

**所有数据存储在本地，不上传任何内容，不依赖云服务。**

---

### 下载安装

#### Windows

前往 **[Releases](https://github.com/1756141021/HainTag/releases)** 页面下载最新版本。

1. 下载 `HainTag-vX.X.X-windows.zip`
2. 解压到任意目录
3. 运行 `HainTag.exe`——无需安装，开箱即用

> **系统要求**：Windows 10 / 11，64 位

#### macOS

macOS 目前从源码运行。HainTag 是独立桌面应用，不是 ComfyUI 自定义节点，不要放进 `ComfyUI/custom_nodes` 或 node 目录。

程序目录自己选。下面示例会把程序放在 `~/Applications/HainTag`：

```bash
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/`。

---

### 0.9.1 更新重点

这一版主要修工作台的真实交互闭环：右键菜单、OC、历史、存放台和图像反推都尽量接回原有接口，而不是只做表面 UI。

| 更新 | 说明 |
|------|------|
| **主工作台 v3** | 输出区变成可编辑 TAG 流，保留 hover、分类色、左键拖拽排序、右键拖拽权重和完整 / 无角色双页 |
| **OC 最短路径** | 标题栏 `+` 就地添加 OC，chip 左键快速调服装 / Order / Depth，右键移除或进入编辑 |
| **历史时间线** | 底部显示最近生成，`查看全部` 打开真实历史面板，可回填输入、完整 TAG 和无角色 TAG |
| **存放台** | 多个浮动卡片靠近时收进小收缩栏，剩 1 个成员会自动恢复并隐藏，避免挡住工作区 |
| **菜单通用化** | 输入、输出、资料库、历史、Dock、存放台等右键菜单接入统一 i18n、主题、字体和缩放接口 |
| **图像反推** | 本地 / LLM 改为同一卡片内分段切换，本地反推和 LLM 反推保留批量、预设、阈值、分类色和复制 / 发送功能 |

### 功能多不想装？

担心功能臃肿？HainTag 的每个功能都是独立的卡片——不用的功能不打开就看不见，不会占用额外内存。放置一段时间后内存占用会自动降低。软件本身很轻量，开箱即用。

---

### 功能总览

#### 📌 卡片浮动 & 置顶

任意卡片可拖出主窗口成为独立浮动窗口，主窗口支持置顶——把 TAG 输出拖到 WebUI 旁边，边画边对照，多显示器尤其好用。多个浮窗靠近时也可以收进存放台，需要哪个再点哪个恢复出来。

---

#### 🎨 TAG 生成与编辑

| 功能 | 说明 |
|------|------|
| **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 计数，生成前心中有数 |

#### 🖼️ 画师库 & OC 角色库

| 功能 | 说明 |
|------|------|
| **画师库** | 管理画师名、LoRA / 触发词、参考图，一键复制到提示词 |
| **OC 角色库** | 原创角色管理，带服装子系统——多套服装独立开关，发送时自动合并角色 + 启用服装的 TAG |
| **插入控制** | 每个角色 / 服装的 Order / Depth 独立设置，精确控制消息在对话中的位置 |
| **标题栏 OC 快捷 chip** | 当前启用 OC 直接显示在工作台标题栏，可就地添加、切换服装、编辑或移除 |

#### 📂 图像管理器

| 功能 | 说明 |
|------|------|
| **缩略图网格** | 多线程加载 + LRU 缓存，大量图片依然流畅滚动 |
| **Lightbox 大图** | 全屏查看，键盘 / 鼠标翻页 |
| **浮动详情面板** | 悬停即时预览 metadata，可置顶 |
| **文件操作** | 移动、重命名（F2）、删除（回收站）、剪切 / 粘贴 |
| **喜欢标记** | 持久化收藏，支持"只看喜欢"过滤 |
| **文件夹导航** | 前进 / 后退历史栈，支持鼠标侧键 |

#### 🔧 Metadata 工具

| 功能 | 说明 |
|------|------|
| **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

首次启动后在设置面板填入：

| 字段 | 说明 |
|------|------|
| API Base URL | 兼容 OpenAI 格式的接口地址，如 `https://api.openai.com/v1` |
| API Key | 你的 API 密钥 |
| 模型 | 点击 ↻ 从 API 拉取可用模型列表 |

支持任何兼容 OpenAI Chat Completions 格式的服务——OpenAI、Claude（通过兼容层）、DeepSeek、本地 Ollama、vLLM 等均可。

---

### 开源协议

[GNU General Public License v3.0](LICENSE)

HainTag

HainTag Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

HainTag

HainTag Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README