📘 Eagle AI Agent 使用说明

欢迎使用 Eagle AI Agent！这是一款基于多模态大模型的 Eagle 智能分类与打标插件，旨在帮助您自动化整理素材库，提升工作效率。

✨ 主要功能

1. 🗂️ 自动归档 (Auto Archive)

   • 深度分析图片内容，自动创建并移动文件到相应的分类文件夹。
   • 支持多级目录整理。

2. 🏷️ 智能打标 (Smart Tagging)

   • 根据图片视觉信息，自动添加精确的描述性标签。
   • 保留原文件位置，仅增加元数据。

3. 💬 AI 助手 (AI Assistant)

   • 内置对话窗口，您可以询问关于图片内容的任何问题。
   • 支持自然语言指令，如“把所有蓝色的风景图放到一个新文件夹里”。

4. 📊 资源统计 (Statistics)

   • 可视化展示素材库的健康状况。
   • 分析文件类型分布、添加时间趋势等。

📦 安装指南

1. 下载插件安装包（文件后缀为 .eagleplugin）。
2. 双击该文件，Eagle 将自动启动并弹出安装确认窗口。
3. 点击“安装插件”按钮完成安装。
4. 安装完成后，您可以在 Eagle 的“插件中心”或顶部工具栏中找到 Eagle AI Agent。

⚙️ 配置设置

在使用前，请先配置 AI 服务：

1. 打开插件窗口，点击右上角的设置图标 ⚙️。
2. AI Provider: 选择您支持的 AI 模型服务商（推荐 Zhipu, OpenAI, 或本地 Ollama）。
3. API Key: 输入您的 API 密钥。
   • 注：您的密钥仅保存在本地，不会上传到任何第三方服务器。
4. Concurrency: 设置并发处理的任务数量（默认为 5）。
5. 点击 Save 保存配置。

🚀 快速开始

场景一：自动整理一批新素材

1. 在 Eagle 中选中需要整理的图片（支持多选）。
2. 点击顶部工具栏的 plugin 图标，打开 Eagle AI Agent。
3. 在首页选择 “自动归档” 模式。
4. (可选) 在输入框中填写自定义提示词，例如：“按设计风格分类：极简、复古、赛博朋克”。
5. 点击 “开始任务”。
6. AI 将逐个分析并移动文件，您可以在下方进度条查看状态。

场景二：为老素材补充标签

1. 选中未打标签的图片。
2. 打开插件，选择 “智能打标” 模式。
3. 点击 “开始任务”。
4. 完成后，文件的详细信息中将自动增加 AI 生成的标签。

❓ 常见问题 (FAQ)

Q: 支持哪些图片格式？ A: 支持 Eagle 兼容的所有主流图片格式 (JPG, PNG, WEBP, GIF 等)。

Q: 为什么处理速度比较慢？ A: 速度取决于所选的模型和网络状况。如果使用 GPT-4o 等大型模型，分析单张图片可能需要 3-5 秒。您可以尝试调高并发数 (Concurrency)，或者使用速度更快的模型（如 GPT-4o-mini 或本地模型）。

Q: 如何使用本地模型？ A: 请确保本地已安装 Ollama 或 LM Studio，并开启了 API 服务。在插件设置中选择 Local，并填写本地服务地址（通常是 http://localhost:11434）。