# VisionTagger — 再也不用手动给照片打标签了。

使用本地视觉模型从图片生成丰富的结构化元数据——无需上传、无需订阅，数据不会离开你的 Mac。

## 概览

- **平台：** macOS（仅限 Apple Silicon）
- **核心功能：** 使用本地图像转文字 LLM 生成图片元数据（在设备上运行）
- **隐私：** 无云端处理——图片和元数据始终留在你的 Mac 上
- **适用人群：** 摄影师、网页内容团队、档案管理员，以及所有需要整理图片库的人

## VisionTagger 的功能

VisionTagger 在本地分析图片并生成结构化元数据，你可以**导出为文件**（附属文件或批量输出）、写入**照片图库**（**标题、描述、关键词**），和/或**应用为 Finder 标签**。你可以控制生成*什么*以及*如何*生成，包括自定义元数据架构和提示词。

## 主要功能

### 本地视觉模型
- 完全在设备上运行，利用 Apple Silicon 的性能。
- 专为隐私敏感的图片库和离线工作流设计。

### 向导式工作流
1. **来源** — 选择图片位置：Mac 上的文件夹或你的照片图库
2. **选择** — 在网格或表格视图中挑选图片；通过 **[+]** 或拖放添加
3. **内容** — 下载/选择模型并选择元数据部分（包括自定义字段）
4. **生成** — 在处理完成时，观看元数据出现在每张图片旁边
5. **格式** — 选择输出方式（XMP/JSON/CSV/TXT 文件、照片图库、Finder 标签）并进行配置
6. **发布** — 查看摘要和覆盖警告，然后将元数据保存到输出

### 内置元数据部分
- **描述** — 描述每张图片（可选择详细程度）
- **关键词** — 生成描述性关键词。可配置最大关键词数量、在开头添加特定关键词、在末尾追加关键词，以及排除不需要的词条。
- **内容与风格** — 描述风格（如情绪/光线）；选择要包含的字段
- **安全与合规** — 分类风险等级（如敏感内容）；选择要包含的字段

### 附加上下文
通过向模型提供额外上下文来丰富生成的元数据：
- **上下文提示** — 对图片批次的自由文本描述（例如，"台湾夜市的街头小吃摊"）
- **GPS 位置** — 对图片 EXIF 数据中的 GPS 坐标进行反向地理编码，以包含地名
- **现有元数据** — 将每张图片中已有的元数据（拍摄细节如相机型号和日期，或现有的标题/描述/关键词）传递给模型

模型在相关时使用这些上下文来增强分析，但主要基于图片中可见的内容进行分析。

### 自定义元数据
添加包含一个或多个字段的定制部分：
- 字段**数据类型：**
  - **真/假**（布尔值）
  - **文本**（字符串）
  - **文本列表**（字符串数组）
- 每个字段包含一个**提示词**，用于指示模型提取什么内容。
- 示例：
  - 布尔值："包含文字" / "包含人物"
  - 文本："描述背景"
  - 列表："主要颜色"

### 模型选择
- 预配置下载：
  - Qwen3-VL 8B Instruct
  - Qwen3-VL 30B-A3B Instruct
  - Qwen2.5-VL 7B Instruct
  - Gemma 3 Vision 4B Instruct
  - InternVL3 8B Instruct
  - Pixtral 12B

- 自带模型：
  - 通过链接**模型 GGUF** 和**投影器 GGUF** 来添加单独下载的兼容模型

### 输出选项
- **XMP：** 嵌入式和/或附属文件
- **JSON / CSV /TXT：** 附属文件，或整个图片集的单个 JSON、CSV 或 TXT 文件
- **照片图库：** 回写**标题、描述、关键词**
- **Finder 标签：** 将生成的关键词/标签应用到文件
- 可以同时选择和配置多种输出方式。

### 输出语言
VisionTagger 始终以英文生成元数据，以确保 AI 模型的最佳质量。当选择其他输出语言时，生成的元数据会使用 macOS 内置翻译服务自动翻译。支持的语言包括阿拉伯语、中文、荷兰语、法语、德语、印地语、印尼语、意大利语、日语、韩语、波兰语、葡萄牙语、俄语、西班牙语、泰语、土耳其语、乌克兰语和越南语。翻译功能可用前需要在系统设置中下载语言包。

### 应用语言
用户界面提供 10 种语言：英语、荷兰语、德语、日语、法语、简体中文、西班牙语、意大利语、葡萄牙语和韩语。

### 快捷指令集成
VisionTagger 为 Apple 快捷指令提供两个操作来自动化工作流：
- **生成图片元数据** — 用于文件系统中的图片
- **生成照片元数据** — 用于照片图库中的照片

这些操作可以在快捷指令工作流、Finder 快速操作、文件夹自动化、命令行（`shortcuts run`）和 AppleScript 中使用。可以提供一个可选的设置预设（导出的 JSON）以使快捷指令自包含。

### 可调生成设置
使用滑块调整模型参数：

- Temperature
- Max tokens
- Context length
- Top-P
- Top-K


## 定价与许可

- **€ 29,99** / **$ 34.99**
- **含增值税**（美国和加拿大除外）
- **免费试用：** 100 张图片，**无时间限制**
- **一次性付款，无后续费用。**
- **许可：** 单用户，多台 Mac
- **支付：** 通过 **FastSpring**（MoR）安全结账
- **分发：** 直接下载（非通过 Mac App Store）

## 系统要求

- **需要 Apple Silicon：** M1 或更新机型
- **macOS：** Tahoe **26.0** 或更高版本


## 链接

- **产品页面：** https://www.synendo.com/zh-Hans/visiontagger/
- **工作流：** https://www.synendo.com/zh-Hans/visiontagger/#workflow
- **工作流演示（视频）：** https://youtu.be/QjDcUqb3QKg
- **常见问题：** https://www.synendo.com/zh-Hans/visiontagger/#faq
- **添加自定义元数据字段（视频）：** https://youtu.be/S2oEM6LTHVQ
