媒体文件修复

技能简介

该技能通过读取文件的魔数字节（magic bytes）来识别真实的媒体文件类型，并对格式异常的文件进行自动修复。

业务背景

媒体文件修复技能保障企业数字资产的安全性与可用性。通过深度检测文件真实格式而非依赖扩展名，有效识别伪装攻击和传输损坏；自动修复头部异常减少人工介入，确保业务系统处理的图片、音视频文件合规可用，降低内容审核与展示故障风险。

落地案例：企业内容平台接收用户上传的"合同扫描件.jpg"，预览时却触发安全告警。运营人员调用本技能检测，发现文件魔数实为可执行程序，系恶意伪装攻击而被拦截。另一次场景中，批量导入的历史视频因头部损坏无法播放，系统自动修复后恢复存档价值，避免珍贵资料丢失。

能做什么

• 识别图片、音频、视频等文件的真实格式
• 检测文件扩展名与实际内容是否匹配
• 修复头部信息损坏的媒体文件
• 防范基于文件伪装的安全攻击

使用说明

安装指令

# 克隆技能仓库
git clone https://github.com/openclaw/skills.git
# 进入技能目录
cd skills/autogame-17/media-converter
# 按README完成环境配置

使用步骤

1. 准备待检测或修复的媒体文件
2. 调用技能接口传入文件路径
3. 获取文件真实类型识别结果
4. 根据返回结果执行修复操作

输入与输出

见下方输入与输出表格。

风险提示

• 修复操作可能改变原始文件内容，建议提前备份
• 无法保证100%修复成功率，严重损坏文件可能无法恢复
• 大文件处理可能消耗较多计算资源

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/autogame-17/media-converter/SKILL.md
来源类型：GitHub仓库