analyze-images-advanced
Public
Forked from vadimfedenko/analyze-images
Forked from vadimfedenko/analyze-images
Forked from vadimfedenko/analyze-images
README.zh-CN.md
README.zh-CN.md
English | 日本語 | 简体中文 | 한국어 | Español
版本 0.6.0 — 查找本地图片，分析单张图片或联合比较多张图片，并在模型开始下一次回复之前自动附加相关图片。
本项目基于 Analyze Images。可配合 Visit Website Advanced 和 DuckDuckGo Advanced 使用，后两者可将图片及来源元数据下载到工作目录。
插件 ID 为 yuanjumay/analyze-images-advanced。从 LM Studio Hub 安装时，请使用页面提供的安装入口。本文介绍 0.6.0；已发布的修订版可能与本地版本不同。
从本地源码安装时，在此插件目录内运行。示例使用 Windows PowerShell；在 macOS/Linux 上请将 npm.cmd 替换为 npm：
在聊天中启用插件，选择支持视觉输入的本地模型，或配置支持视觉输入的 Strata 端点。使用本地图片工具时，需要设置聊天的工作目录。请禁用以前的图片注入测试插件和测试 MCP 服务器，以免重复处理。
所有语言文档中的工具名称和设置标签均保留实际界面的英文名称。
| 工具 | 用途 |
|---|---|
| List Local Images Advanced | 列出本地图片路径及可用元数据。 |
| Search Local Images Advanced | 按文件名、说明、来源页面 URL 等元数据搜索图片。 |
| Analyze Local Image Advanced | 分析一张已确认身份的本地图片。 |
| Multi Analyze Local Images Advanced | 在一次推理请求中联合分析或比较 2–4 张图片。 |
分析前，请先通过 List/Search 确认准确文件名。每张不同的分析图片都需要对应的 sidecar JSON 元数据文件，配套下载插件会生成这些文件。不要根据本地编号或 JSON-LD 图片顺序猜测文件身份。支持相对路径，拒绝绝对路径和向父目录越界的路径。选择缩略图时，会优先查找对应的原尺寸图片。
请求示例：
多图分析接收 imageNames、prompt 和可选的 context。输入顺序对应 Image 1、Image 2 等；结果包括联合分析 analysis、有序图片与来源映射 images、去重数量 duplicatesRemoved。字节完全相同的图片会被去重，去重后必须至少保留两张不同图片。无效输入或超限批次会在推理前被拒绝，不会只分析其中一部分。
开启页面图片自动附加后，消息中的页面 URL 会在主模型开始生成之前触发图片获取。即使关闭了 URL 自动处理，也可以显式请求：
只处理第一个 HTTP(S) URL。优先采用与页面匹配的 JSON-LD Product.image；没有匹配项时使用第一个 Product。若没有图片，则依次回退到 OG/Twitter 图片、main/article 内的图片。保留来源顺序和 URL 对应关系，不把页面说明、alt 文本或评论当作图片分析结果注入。
成功的单图或多图分析，也会将相关图片作为下一条用户消息的候选。优先级为 本次手动附加 → 本聊天最近的 Analyze 目标 → 页面图片。仅下载或列出图片不会加入候选。无法向正在进行的主模型推理中插入实际图片；Analyze 会立即将分析文字作为工具结果返回，实际图片则在后续用户发送消息时附加。
去重依据是图片字节完全一致，而非视觉相似度。手动图片优先；即使历史中已存在，本次主动重新附加的图片仍会保留。已自动附加的图片会在检查的历史范围内被跳过。失败候选可以重试；自动处理失败时，也可手动附加。如果无法读取手动图片进行比较，会保留它并推迟自动追加。不会改写已经发送的消息。
已有聊天中保存的设置优先于默认值。
| 标签 | 默认值 | 含义 |
|---|---|---|
| Image analysis backend | Auto | 识别到界面辅助模型时使用 Strata，否则使用已加载的本地视觉模型。 |
| Strata analysis model | strata | 独立 Strata 分析的模型名。 |
| Automatically attach page images | 开启 | 在推理前处理第一个 URL。 |
| Attach analyzed images on the next turn | 开启 | 在下一条用户消息中附加符合条件的 Analyze 图片。 |
| Default page URL | 空 | 未指定 URL 的 @inject-url 所用地址。 |
| Maximum attached images | 2 | 自动附加名额，扣除本次手动图片数量；可设为 1–4。 |
| Start image number | 1 | 页面图片选择的起始位置，从 1 开始计数。 |
| Strata analysis Base URL | http://127.0.0.1:8080/v1 | 全局端点设置。 |
| Strata analysis API key (optional) | 空 | 全局凭据设置。 |
Strata 设置与生成器插件的设置分开。显式选择 Strata (separate request) 时，不选择本地模型。单图与多图分析都会等待 Strata 完整回复；多图分析在同一个请求中发送全部图片。界面辅助模型不执行该推理。若分析四张图片而附加上限为两张，剩余候选会按输入顺序，在后续用户发送消息时分批附加。
这不意味着 Gemma 普遍不支持 WebP。 在一个验证环境中，相同 WebP 通过常规 SDK 上传可用，但通过原始 base64: 直接内嵌失败；转换为 PNG 后内嵌可用。转换针对该路径提供兼容性处理。更新后旧聊天仍失败时，请在新聊天中重试，或手动附加 PNG/JPEG。参见官方图片输入文档及 GUI/API 兼容性报告。
自动处理失败时会显示状态和调试信息，并保留成功的附件。显式 @inject-url 失败会停止预处理。页面自动附加不会将图片或 sidecar 保存到工作目录；需要本地文件时，请使用下载工具。
测试使用真实 SDK 消息、图片转换、文件及 HTTP，并替代模型与控制器的响应。验证的是传输与行为，而非真实模型的视觉比较质量。视觉和多图能力仍取决于所选模型与后端。
英文 README.md 是主要公开指南，其他四种语言保持相同内容范围。参见发布与语言维护政策。添加翻译不会自动发布插件。
基于 Analyze Images，原始／改进项目为 vadimfedenko/analyze-images。Advanced 分支修改：Yuan Jumay。MIT；请保留原始版权和许可证声明。
English | 日本語 | 简体中文 | 한국어 | Español
版本 0.6.0 — 查找本地图片，分析单张图片或联合比较多张图片，并在模型开始下一次回复之前自动附加相关图片。
本项目基于 Analyze Images。可配合 Visit Website Advanced 和 DuckDuckGo Advanced 使用，后两者可将图片及来源元数据下载到工作目录。
插件 ID 为 yuanjumay/analyze-images-advanced。从 LM Studio Hub 安装时，请使用页面提供的安装入口。本文介绍 0.6.0；已发布的修订版可能与本地版本不同。
从本地源码安装时，在此插件目录内运行。示例使用 Windows PowerShell；在 macOS/Linux 上请将 npm.cmd 替换为 npm：
在聊天中启用插件，选择支持视觉输入的本地模型，或配置支持视觉输入的 Strata 端点。使用本地图片工具时，需要设置聊天的工作目录。请禁用以前的图片注入测试插件和测试 MCP 服务器，以免重复处理。
所有语言文档中的工具名称和设置标签均保留实际界面的英文名称。
| 工具 | 用途 |
|---|---|
| List Local Images Advanced | 列出本地图片路径及可用元数据。 |
| Search Local Images Advanced | 按文件名、说明、来源页面 URL 等元数据搜索图片。 |
| Analyze Local Image Advanced | 分析一张已确认身份的本地图片。 |
| Multi Analyze Local Images Advanced | 在一次推理请求中联合分析或比较 2–4 张图片。 |
分析前，请先通过 List/Search 确认准确文件名。每张不同的分析图片都需要对应的 sidecar JSON 元数据文件，配套下载插件会生成这些文件。不要根据本地编号或 JSON-LD 图片顺序猜测文件身份。支持相对路径，拒绝绝对路径和向父目录越界的路径。选择缩略图时，会优先查找对应的原尺寸图片。
请求示例：
多图分析接收 imageNames、prompt 和可选的 context。输入顺序对应 Image 1、Image 2 等；结果包括联合分析 analysis、有序图片与来源映射 images、去重数量 duplicatesRemoved。字节完全相同的图片会被去重，去重后必须至少保留两张不同图片。无效输入或超限批次会在推理前被拒绝，不会只分析其中一部分。
开启页面图片自动附加后，消息中的页面 URL 会在主模型开始生成之前触发图片获取。即使关闭了 URL 自动处理，也可以显式请求：
只处理第一个 HTTP(S) URL。优先采用与页面匹配的 JSON-LD Product.image；没有匹配项时使用第一个 Product。若没有图片，则依次回退到 OG/Twitter 图片、main/article 内的图片。保留来源顺序和 URL 对应关系，不把页面说明、alt 文本或评论当作图片分析结果注入。
成功的单图或多图分析，也会将相关图片作为下一条用户消息的候选。优先级为 本次手动附加 → 本聊天最近的 Analyze 目标 → 页面图片。仅下载或列出图片不会加入候选。无法向正在进行的主模型推理中插入实际图片；Analyze 会立即将分析文字作为工具结果返回，实际图片则在后续用户发送消息时附加。
去重依据是图片字节完全一致，而非视觉相似度。手动图片优先；即使历史中已存在，本次主动重新附加的图片仍会保留。已自动附加的图片会在检查的历史范围内被跳过。失败候选可以重试；自动处理失败时，也可手动附加。如果无法读取手动图片进行比较，会保留它并推迟自动追加。不会改写已经发送的消息。
已有聊天中保存的设置优先于默认值。
| 标签 | 默认值 | 含义 |
|---|---|---|
| Image analysis backend | Auto | 识别到界面辅助模型时使用 Strata，否则使用已加载的本地视觉模型。 |
| Strata analysis model | strata | 独立 Strata 分析的模型名。 |
| Automatically attach page images | 开启 | 在推理前处理第一个 URL。 |
| Attach analyzed images on the next turn | 开启 | 在下一条用户消息中附加符合条件的 Analyze 图片。 |
| Default page URL | 空 | 未指定 URL 的 @inject-url 所用地址。 |
| Maximum attached images | 2 | 自动附加名额，扣除本次手动图片数量；可设为 1–4。 |
| Start image number | 1 | 页面图片选择的起始位置，从 1 开始计数。 |
| Strata analysis Base URL | http://127.0.0.1:8080/v1 | 全局端点设置。 |
| Strata analysis API key (optional) | 空 | 全局凭据设置。 |
Strata 设置与生成器插件的设置分开。显式选择 Strata (separate request) 时，不选择本地模型。单图与多图分析都会等待 Strata 完整回复；多图分析在同一个请求中发送全部图片。界面辅助模型不执行该推理。若分析四张图片而附加上限为两张，剩余候选会按输入顺序，在后续用户发送消息时分批附加。
这不意味着 Gemma 普遍不支持 WebP。 在一个验证环境中，相同 WebP 通过常规 SDK 上传可用，但通过原始 base64: 直接内嵌失败；转换为 PNG 后内嵌可用。转换针对该路径提供兼容性处理。更新后旧聊天仍失败时，请在新聊天中重试，或手动附加 PNG/JPEG。参见官方图片输入文档及 GUI/API 兼容性报告。
自动处理失败时会显示状态和调试信息，并保留成功的附件。显式 @inject-url 失败会停止预处理。页面自动附加不会将图片或 sidecar 保存到工作目录；需要本地文件时，请使用下载工具。
测试使用真实 SDK 消息、图片转换、文件及 HTTP，并替代模型与控制器的响应。验证的是传输与行为，而非真实模型的视觉比较质量。视觉和多图能力仍取决于所选模型与后端。
英文 README.md 是主要公开指南，其他四种语言保持相同内容范围。参见发布与语言维护政策。添加翻译不会自动发布插件。
基于 Analyze Images，原始／改进项目为 vadimfedenko/analyze-images。Advanced 分支修改：Yuan Jumay。MIT；请保留原始版权和许可证声明。
npm.cmd ci
lms dev --install
通过 List/Search 确认已下载的商品图片，然后用
Multi Analyze Local Images Advanced 一起比较两张图片。
比较背景、构图和表面外观，并区分视觉证据与元数据。
@inject-url https://hoju.jp/rapunzel
请描述并比较附加的图片，不要使用其他工具。
npm.cmd run check
npm.cmd test
npm.cmd run dev
npm.cmd ci
lms dev --install
通过 List/Search 确认已下载的商品图片，然后用
Multi Analyze Local Images Advanced 一起比较两张图片。
比较背景、构图和表面外观，并区分视觉证据与元数据。
@inject-url https://hoju.jp/rapunzel
请描述并比较附加的图片，不要使用其他工具。
npm.cmd run check
npm.cmd test
npm.cmd run dev