视觉分析
- 作者仓库星标 12,348
- 作者仓库 skills
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @MiniMax-AI · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步:自动检测图像
当消息包含带有扩展名的图像文件路径或 URL 时,该技能会自动触发: `.jpg`、`.jpeg`、`.png`、`.gif`、`.webp`、`.bmp`、`.svg` 从消息中提取图像路径。
步骤2:选择分析模式并调用MCP工具
使用 `MiniMax_understand_image` 工具和特定于模式的提示:describe: ocr: ui-review: Chart-data:
第 3 步:展示结果
清晰返回分析。对于`describe`,请使用可读的散文。对于`ocr`,保留结构。对于`ui-review`,使用结构化批评格式。
# Vision Analysis
Analyze images using the MiniMax `MiniMax_understand_image` MCP tool available in the MiniMax Token Plan.
## Prerequisites
- MiniMax Token Plan subscription with valid `MINIMAX_API_KEY`
- MiniMax MCP configured (`MiniMax_understand_image` tool available)
### If MCP tool is not configured
**Step 1:** The agent should fetch setup instructions from:
**https://platform.minimaxi.com/docs/token-plan/mcp-guide**
**Step 2:** Detect the user's environment (OpenCode, Cursor, Claude Code, etc.) and output the exact commands needed. Common examples:
**OpenCode** — add to `~/.config/opencode/opencode.json` or `package.json`:
```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**:
```bash
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** — add to MCP settings:
```json
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-coding-plan-mcp"],
"env": {
"MINIMAX_API_KEY": "your-key",
"MINIMAX_API_HOST": "https://api.minimaxi.com"
}
}
}
}
```
**Step 3:** After configuration, tell the user to restart their app and verify with `/mcp`.
**Important:** If the user does not have a MiniMax Token Plan subscription, inform them that the `understand_image` tool requires one — it cannot be used with free or other tier API keys.
## Analysis Modes
| Mode | When to use | Prompt strategy |
|---|---|---|
| `describe` | General image understanding | Ask for detailed description |
| `ocr` | Text extraction from screenshots, documents | Ask to extract all text verbatim |
| `ui-review` | UI mockups, wireframes, design files | Ask for design critique with suggestions |
| `chart-data` | Charts, graphs, data visualizations | Ask to extract data points and trends |
| `object-detect` | Identify objects, people, activities | Ask to list and locate all elements |
## Workflow
### Step 1: Auto-detect image
The skill triggers automatically when a message contains an image file path or URL with extensions:
`.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.bmp`, `.svg`
Extract the image path from the message.
### Step 2: Select analysis mode and call MCP tool
Use the `MiniMax_understand_image` tool with a mode-specific prompt:
**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.
```
### Step 3: Present results
Return the analysis clearly. For `describe`, use readable prose. For `ocr`, preserve structure. For `ui-review`, use a structured critique format.
## Output Format Example
For describe mode:
```
## Image Description
[Detailed description of the image contents...]
```
For ocr mode:
```
## Extracted Text
[Preserved text structure from the image]
```
For ui-review mode:
```
## UI Design Review
### Strengths
- ...
### Issues
- ...
### Suggestions
- ...
```
## Notes
- Images up to 20MB supported (JPEG, PNG, GIF, WebP)
- Local file paths work if MiniMax MCP is configured with file access
- The `MiniMax_understand_image` tool is provided by the `minimax-coding-plan-mcp` package
章节与文件索引
按说明文件中的顺序排列。
先决条件
如果未配置 MCP 工具
分析模式
第 1 步:自动检测图像
步骤2:选择分析模式并调用MCP工具
文件/命令 -> MiniMax_understand_image · MINIMAX_API_KEY · ~/.config/opencode/opencode.json · package.json · /mcp · understand_image · describe · ocr
内容校验值 -> 8727e5f3eab1
当前原文的自动摘译,尚未人工审校。
先决条件
配置了有效
MINIMAX_API_KEYMiniMax MCP 的 MiniMax 令牌计划订阅(MiniMax_understand_image工具可用)如果未配置 MCP 工具
步骤 1:代理应从以下位置获取设置指令:https://platform.minimaxi.com/docs/token-plan/mcp-guide 步骤 2:检测用户的环境(OpenCode、Cursor、Claude Code 等)并输出所需的确切命令。常见示例: OpenCode — 添加到
~/.config/opencode/opencode.json或package.json: Claude 代码:分析模式
模式 · 何时使用 · 提示策略
describe· 一般图像理解 · 要求详细描述ocr· 从屏幕截图、文档中提取文本 · 要求逐字提取所有文本ui-review· UI 模型、线框图、设计文件 · 要求设计评论和建议chart-data· 图表、图形、数据可视化 · 要求提取数据点和趋势第 1 步:自动检测图像
当消息包含带有扩展名的图像文件路径或 URL 时,该技能会自动触发:
.jpg、.jpeg、.png、.gif、.webp、.bmp、.svg从消息中提取图像路径。