关于 vision-analysis
vision-analysis 是借助 MiniMax 图像理解工具分析图片的技能,适用于图像描述、文字提取、界面评审、图表分析和物体识别。它根据分析模式构造提示词,并要求配置 MiniMax MCP 与 Token Plan。
主要功能
- 01支持五种图像分析模式
- 02从截图或文档提取文字
- 03评审界面模型并给出改进建议
- 04提取图表数据与趋势
- 05根据环境提供 MCP 配置指引
适用场景
- 01描述图片内容与构图
- 02转录截图或文档中的文字
- 03检查界面模型的可用性问题
- 04汇总图表中的数据与趋势
MCP 相关
该技能调用 MiniMax MCP 提供的 `MiniMax_understand_image` 工具分析图片。使用前需配置 MiniMax MCP 和有效的 Token Plan API 密钥。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ minimax-ai/ skills --skill vision-analysis安装后在 Claude Code 中输入/vision-analysis确认已加载。
详细介绍
视觉分析
使用 MiniMax Token Plan 中提供的 MiniMax MiniMax_understand_image MCP 工具分析图像。
前提条件
- 订阅 MiniMax Token Plan,并拥有有效的
MINIMAX_API_KEY - 已配置 MiniMax MCP(可使用
MiniMax_understand_image工具)
如果未配置 MCP 工具
步骤 1: Agent 应从以下地址获取设置说明: https://platform.minimaxi.com/docs/token-plan/mcp-guide
步骤 2: 检测用户的环境(OpenCode、Cursor、Claude Code 等),并输出所需的准确命令。常见示例:
OpenCode — 添加到 ~/.config/opencode/opencode.json 或 package.json:
{
"mcp": {
"MiniMax": {
"type": "local",
"command": ["uvx", "minimax-coding-plan-mcp", "-y"],
"environment": {
"MINIMAX_API_KEY": "YOUR_TOKEN_PLAN_KEY",
"MINIMAX_API_HOST": "https://api.minimaxi.com"
},
"enabled": true
}
}
}
Claude Code:
claude mcp add -s user MiniMax --env MINIMAX_API_KEY=your-key --env MINIMAX_API_HOST=https://api.minimaxi.com -- uvx minimax-coding-plan-mcp -y
Cursor — 添加到 MCP 设置中:
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-coding-plan-mcp"],
"env": {
"MINIMAX_API_KEY": "your-key",
"MINIMAX_API_HOST": "https://api.minimaxi.com"
}
}
}
}
步骤 3: 配置完成后,告知用户重启应用,并使用 /mcp 验证。
重要: 如果用户未订阅 MiniMax Token Plan,请告知他们,understand_image 工具需要此订阅,无法使用免费 API 密钥或其他等级的 API 密钥。
分析模式
| 模式 | 适用场景 | 提示词策略 |
|---|---|---|
describe | 通用图像理解 | 要求提供详细描述 |
ocr | 从屏幕截图、文档中提取文本 | 要求逐字提取所有文本 |
ui-review | UI 模型图、线框图、设计文件 | 要求进行设计评审并提供建议 |
chart-data | 图表、绘图、数据可视化 | 要求提取数据点和趋势 |
object-detect | 识别物体、人物、活动 | 要求列出并定位所有元素 |
工作流
步骤 1:自动检测图像
当消息包含带有以下扩展名的图像文件路径或 URL 时,此技能会自动触发:
.jpg、.jpeg、.png、.gif、.webp、.bmp、.svg
从消息中提取图像路径。
步骤 2:选择分析模式并调用 MCP 工具
使用 MiniMax_understand_image 工具,并提供与模式对应的提示词:
describe:
Provide a detailed description of this image. Include: main subject, setting/background,
colors/style, any text visible, notable objects, and overall composition.
ocr:
Extract all text visible in this image verbatim. Preserve structure and formatting
(headers, lists, columns). If no text is found, say so.
ui-review:
You are a UI/UX design reviewer. Analyze this interface mockup or design. Provide:
(1) Strengths — what works well, (2) Issues — usability or design problems,
(3) Specific, actionable suggestions for improvement. Be constructive and detailed.
chart-data:
Extract all data from this chart or graph. List: chart title, axis labels, all
data points/series with values if readable, and a brief summary of the trend.
object-detect:
List all distinct objects, people, and activities you can identify. For each,
describe what it is and its approximate location in the image.
步骤 3:呈现结果
清晰地返回分析结果。对于 describe,使用易读的文字说明;对于 ocr,保留原有结构;对于 ui-review,使用结构化的评审格式。
输出格式示例
对于 describe 模式:
## Image Description
[Detailed description of the image contents...]
对于 ocr 模式:
## Extracted Text
[Preserved text structure from the image]
对于 ui-review 模式:
## UI Design Review
### Strengths
- ...
### Issues
- ...
### Suggestions
- ...
备注
- 支持最大 20MB 的图像(JPEG、PNG、GIF、WebP)
- 如果 MiniMax MCP 配置了文件访问权限,则可使用本地文件路径
MiniMax_understand_image工具由minimax-coding-plan-mcp软件包提供