image-analyzer-mcp: Instructions file for Codex

图片分析使用规则

使用前提（先判断，再调用）

本工具不是“只要粘贴图片就调用”的通用工具。只有当当前主模型不支持图片输入时，才使用本工具：

1. 当前主模型支持图片输入（例如 Codex 内置的 ChatGPT 视觉模型）：直接由主模型分析图片，不要调用 analyze_image / compare_images / analyze_clipboard_image。
2. 当前主模型不支持图片输入（例如通过 CC Switch 切换到 DeepSeek 等不支持多模态图片输入的文本模型，图片在会话中显示为 [Unsupported Image]）：才调用本工具。

判断方法：先确认当前会话主模型是否支持视觉/图片输入。支持就直接分析；只有不支持（或图片显示为 [Unsupported Image]）时才调用本工具，不要因为用户粘贴了图片就无条件调用。

什么时候必须调用 analyze_image

只有确认主模型不支持图片输入后，当任务中出现以下情况时，自动调用 analyze_image，不要凭文字描述猜测：

• 用户引用 .png、.jpg、.jpeg、.webp 截图或设计图
• 任务包含 screenshot、mockup、wireframe、design、Figma 导出图等视觉参考
• 需要根据图片实现页面、组件或复刻设计细节
• 需要确认颜色、间距、字体、布局、组件结构

调用方式：

analyze_image(path="图片路径", prompt="需要重点分析的内容，可选")

工具会返回结构化 JSON，包含 layout、sections、components、colors、typography、spacing_system、issues、conversion_to_code 等字段。实现时应直接使用这些字段。

什么时候必须调用 compare_images

只有确认主模型不支持图片输入后，当任务是“按参考图修改当前实现”或“验证还原度”时，自动调用：

compare_images(
  referencePath="参考图路径",
  currentPath="当前实现截图路径",
  prompt="需要重点对比的部分，可选"
)

然后按返回的 differences 和 fix_plan 处理：

1. 先修复 high 严重度和 P0 优先级的问题
2. 再处理 medium / P1
3. 最后处理 low / P2
4. 修复完成后重新截屏并再次调用 compare_images 验证

硬性规则

• 调用前先确认当前主模型是否支持图片输入：支持则由主模型直接分析，不要调用本工具
• 只有主模型不支持图片输入（例如通过 CC Switch 切换到 DeepSeek 等文本模型）时，才调用本工具；不要因为用户粘贴了图片就无条件调用
• 不要用文字描述猜测图片里的颜色、间距、布局和组件细节
• 不要告诉用户“请先手动运行视觉分析”，直接调用工具
• 相对路径可以直接传给工具，服务端会按 VISION_BASE_DIR 或进程目录解析
• 如果用户粘贴或复制了图片（即使界面提示“此模型不支持图片输入”），不要回复“看不到图片”；优先调用 analyze_clipboard_image，如果消息里有图片文件路径则调用 analyze_image(path)
• 视觉模型只作为识图工具，它们返回的 JSON 只是分析素材；最终解释、回答、判断和代码决策必须由主模型（例如 DeepSeek）完成，不要直接把视觉模型的原始输出当作最终回答
• 如果工具返回 error 字段，先修复配置错误（API key、base URL、模型），再继续任务
• 如果模型没有返回可用 JSON，按 raw_output 内容谨慎处理，并考虑重试一次