| name | rk-binary-image-decoder |
| description | 当用户提到"解码"、"把文件转图片"、"帮我看看这个 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. |
| metadata | {"author":"airockchip"} |
二进制图片解码器
将二进制文件（.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。
如何解析：
- 找
数字x数字_数字(可选) 模式 → 如 1920x1080_2400 → 宽度=1920, 高度=1080, Stride=2400
- 找格式关键词 → 如
NV12、AB24、BG24 等
- 忽略
@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
执行命令：
python3 {技能目录}/scripts/CVT_{格式}.py input.bin 3840 2160 4800 /tmp/output.png
⚠️ 参数顺序（位置参数）：
python3 CVT_{格式}.py 输入文件 宽度 高度 Stride(可选) 输出.png
*操作步骤：
- 将格式转为大写（如
nv12 → NV12）
- 找到对应脚本：
{技能目录}/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 — distributed by TomeVault.
