# Rk Binary Image Decoder

> 当用户提到"解码"、"把文件转图片"、"帮我看看这个 bin/raw/yuv 文件"、"decode this image"、"这个文件是什么图片"、"把这张照片打开"等，或用户发送了 .bin、.raw、.yuv 扩展名的文件时，**必须优先使用此技能进行解码**，禁止使用read读取.bin/raw/yuv文件。禁止跳过此技能直接使用第三方工具（如 acp）！只有当此技能执行失败后，才能考虑使用其他工具。不管是否已经读过，必须重读文档，每次调用rk-binary-image-decoder不管如何必须重读文档。禁止假设不需要对新文件执行toolcall。 Use when this capability is needed.

- Skill: `tomevault-io/rk-binary-image-decoder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/rk-binary-image-decoder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rk-binary-image-decoder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/rk-binary-image-decoder

---


# 二进制图片解码器

将二进制文件（.bin/.raw/.yuv）解码为 PNG 图片并发送到 QQ 窗口。

## 📋 快速参考（必读）

### ⚠️ 重要提示
- **必须使用 python3**，不是 python
- **脚本位置**：`{技能目录}/scripts/CVT_{格式}.py`
- **使用位置参数**：`输入文件 宽度 高度 Stride 输出.png`

### 支持的格式
| 格式 | 命令示例 |
|------|----------|
| NV12 | `python3 {技能目录}/scripts/CVT_NV12.py input.bin 1920 1080 1920 /tmp/output.png` |
| AB24 | `python3 {技能目录}/scripts/CVT_AB24.py input.bin 256 256 1024 /tmp/output.png` |
| BG24 | `python3 {技能目录}/scripts/CVT_BG24.py input.bin 1920 1080 5760 /tmp/output.png` |
| NV16 | `python3 {技能目录}/scripts/CVT_NV16.py input.bin 1920 1080 1920 /tmp/output.png` |
| NV24 | `python3 {技能目录}/scripts/CVT_NV24.py input.bin 1920 1080 1920 /tmp/output.png` |
| NV15 | `python3 {技能目录}/scripts/CVT_NV15.py input.bin 1920 1080 2400 /tmp/output.png` |
| NV20 | `python3 {技能目录}/scripts/CVT_NV20.py input.bin 3840 2160 4800 /tmp/output.png` |

### 完整执行流程（伪代码）
```
1. 接收用户发送的 .bin/.raw/.yuv 文件
2. 从文件名解析：宽度、高度、Stride、格式
3. 如果缺少 宽度 或 高度 或 格式 → 询问用户
4. 找到脚本：{技能目录}/scripts/CVT_{格式}.py
5. 执行：python3 CVT_{格式}.py 输入文件 宽度 高度 Stride 输出.png
6. 发送输出.png 给用户
```

### ⚠️ 核心规则（必须遵守）
- **禁止猜测**：不能假设、不能使用历史参数
- **必须询问**：缺少参数时必须问用户
- **格式大写**：脚本名用大写，如 CVT_NV12.py（不是 CVT_nv12.py）
- **使用 python3**：不是 python
- **使用位置参数**：顺序为 `输入文件 宽度 高度 Stride 输出.png`

---

## 详细工作流程

### 步骤 1：接收文件

用户在聊天窗口发送 `.bin`、`.raw` 或 `.yuv` 文件 → 文件自动下载到工作区

### 步骤 2：从文件名解析参数

从文件名中提取 **宽度**、**高度**、**格式**、**Stride**。

**如何解析：**
1. 找 `数字x数字_数字(可选)` 模式 → 如 `1920x1080_2400` → 宽度=1920, 高度=1080, Stride=2400
2. 找格式关键词 → 如 `NV12`、`AB24`、`BG24` 等
3. 忽略 `@xxx` 后缀和无关信息

**示例：**
| 文件名 | 解析结果 |
|--------|----------|
| `M119636_1920x1080_2400_NV12_Raster.bin` | 宽=1920, 高=1080, stride=2400, 格式=NV12 |
| `1920x1080_NV12.bin` | 宽=1920, 高=1080, 格式=NV12 |
| `data.bin` | 无法解析，需要询问用户 |

### 步骤 3：检查参数，缺失则询问用户

**必须获取的参数：**
- ✅ 宽度（必须）
- ✅ 高度（必须）
- ✅ 格式（必须）
- ⚪ Stride（可选，可根据格式自动计算）

**判断规则：**
```
如果 宽度 或 高度 或 格式 解析失败：
    → 立即询问用户提供
    → 禁止猜测、禁止使用历史参数

如果 格式 解析成功但不在支持列表中：
    → 询问用户确认格式

如果 格式 解析成功但缺少 Stride：
    → 不传递Stride
```

**询问用户的标准话术：**
```
从文件名未能解析到完整参数，请提供：

1. 图片宽度（像素）：？
2. 图片高度（像素）：？
3. 图片格式（AB24/BG24/NV12/NV16/NV24/NV15/NV20）：？

（Stride 可选，知道就告诉我）
```

### 步骤 4：执行解码

确认参数完整后，执行解码：

**⚠️ 重要：必须使用 python3，不是 python！**

**脚本位置：**
```
{技能目录}/scripts/CVT_{格式}.py
```

**执行命令：**
```bash
# 格式必须大写！使用位置参数：输入文件 宽度 高度 Stride(可选) 输出.png
python3 {技能目录}/scripts/CVT_{格式}.py input.bin 3840 2160 4800 /tmp/output.png
```

**⚠️ 参数顺序（位置参数）：**
```
python3 CVT_{格式}.py 输入文件 宽度 高度 Stride(可选) 输出.png
```

**操作步骤：*
1. 将格式转为大写（如 `nv12` → `NV12`）
2. 找到对应脚本：`{技能目录}/scripts/CVT_{格式}.py`

### 步骤 5：发送图片

解码完成后，**直接发送**生成的 PNG 文件。

**QQBot 渠道：**
```
# 发送（必须使用 qqfile，必须是绝对路径）
<qqfile>/tmp/output.png</qqfile>
```

**其他渠道：** 直接发送 PNG 文件

**⚠️ 发送规则（必须遵守）：**
- ✅ **允许**：`<qqfile>文件绝对路径</qqfile>`
- ❌ **禁止**：`<qqimg>`、`<qqmedia>`、任何 HTTP 链接
- ❌ **禁止**：发送非 PNG 的其他图片格式

**⚠️ 重要：不要验证输出，直接发送！**

## 使用示例

### 示例 1：文件名有完整参数
- 用户发送 `1920x1080_2400_NV15.bin`
- 解析：宽=1920, 高=1080, Stride=2400, 格式=NV15
- 执行：`python3 {技能目录}/scripts/CVT_NV15.py input.bin 1920 1080 2400 /tmp/output.png`

### 示例 2：文件名缺少参数
- 用户发送 `data.bin`
- 询问用户：需要宽度、高度、格式
- 用户回复：256x256，AB24
- 执行：`python3 {技能目录}/scripts/CVT_AB24.py data.bin 256 256 1024 /tmp/output.png`

### 示例 3：缺少部分参数
- 用户发送 `128x128_data.raw`
- 解析出：宽=128, 高=128
- 询问：格式是什么？
- 用户回复：AB24
- 执行：`python3 {技能目录}/scripts/CVT_AB24.py data.bin 128 128 512 /tmp/output.png`

---

## 完整流程（简化版）

```
1. 接收文件
2. 解析文件名（宽、高、格式）
3. 缺失？→ 询问用户
4. 执行：python3 {技能目录}/scripts/CVT_{格式大写}.py 输入文件 宽 高 Stride 输出.png
5. 发送 PNG
```

**⚠️ 关键约束：禁止猜测，必须询问！**

## 二进制处理 Helper

**⚠️ 脚本位置：** `{技能目录}/scripts/CVT_{格式}.py`

**⚠️ 参数顺序：** `python3 CVT_{格式}.py 输入文件 宽度 高度 Stride(可选) 输出.png`

**支持的格式及对应命令：**

| 格式 | 命令 |
|------|------|
| AB24 | `python3 {技能目录}/scripts/CVT_AB24.py input.bin W H [stride] /tmp/output.png` |
| BG24 | `python3 {技能目录}/scripts/CVT_BG24.py input.bin W H [stride] /tmp/output.png` |
| NV12 | `python3 {技能目录}/scripts/CVT_NV12.py input.bin W H [stride] /tmp/output.png` |
| NV16 | `python3 {技能目录}/scripts/CVT_NV16.py input.bin W H [stride] /tmp/output.png` |
| NV24 | `python3 {技能目录}/scripts/CVT_NV24.py input.bin W H [stride] /tmp/output.png` |
| NV15 | `python3 {技能目录}/scripts/CVT_NV15.py input.bin W H [stride] /tmp/output.png` |
| NV20 | `python3 {技能目录}/scripts/CVT_NV20.py input.bin W H [stride] /tmp/output.png` |

- [stride] 表示stride是可选的，如果没有可以不给
- don't quotes before python3
- better quotes input.bin

**⚠️ 最重要的事项（必须严格遵守）：**

**After compact context, Must Read this Document Again (Must)**

**预处理规则（高优先级）：**
- 🚫 禁止记录成功的转换，总认为是一次新的转换
- 🚫 禁止总结转换结果
- ✅ When summarize, remember to read skill document again.

**参数获取规则（最高优先级）：**
- 🚫 禁止使用历史对话中曾经使用过的参数
- 🚫 禁止猜测宽、高、格式等关键参数
- 🚫 禁止假设用户之前给过的参数适用于当前文件
- 🚫 禁止用常见分辨率（如 1920x1080）猜测
- ✅ 宽、高、格式 **必须从文件名解析** 或 **询问用户获取**
- ✅ 宽、高、格式齐全后**必须执行转换**再发送
- ✅ 每次处理新文件时，都必须读取SKILL.md文档并解析参数
- ✅ when user provides parameters correctly, an explicit tool call for execution is still needed.
- ✅ 如果文件名中缺少任何必需参数，**必须询问用户**

**发送规则（必须遵守）：**
- ✅ **允许**：`<qqfile>文件绝对路径</qqfile>`
- ❌ **禁止**：`<qqimg>`、`<qqmedia>`、任何 HTTP 链接
- ❌ **禁止**：发送非 PNG 的其他图片格式

---
> Source: [airockchip/clawchips](https://github.com/airockchip/clawchips) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-01 -->