DSH 的设计理念是「一切皆插件」。在开发智能体时，经常遇到需要读取图片尺寸、生成缩略图或转换图片格式（如 PNG 转 WebP）的需求。手动调用系统 ffmpeg 或在 Node 环境中配置依赖较为繁琐。dsh-image-uckkk 插件提供了封装好的图片处理能力。
插件定位¶
这是一个纯 Node 实现的插件，基于内置的 ffmpeg 二进制，支持跨平台。插件由 uckkk 维护（作者 istone ad571@qq.com），旨在解决智能体流程中的基础图片处理问题。
核心功能¶
插件提供了两个主要工具：
image_info：读取图片的宽×高与格式。resize_image：缩放图片（支持等比缩放或指定宽度）并转换格式（支持 jpg/png/webp）。
安装与启用¶
首先执行官方安装命令：
dsh plugin add dsh-image-uckkk
安装完成后，需要在项目根目录的 package.json 文件中进行配置。在 dsh.profile.bundles 字段中添加 "dsh-image-uckkk"：
{
"dsh.profile.bundles": [
"dsh-image-uckkk"
]
}
该插件依赖以下环境：
* @deepseek-ai/cordis: ^4.0.1
* @deepseek-ai/dsh-tools: >=0.1.0-rc.6
典型用法¶
以下是一个将图片缩放并转换格式的示例。假设需要将 hero.png 缩放为 800 像素宽，并输出为 hero.webp 格式：
调用 resize_image 接口：
resize_image(file="hero.png", width=800, outFile="hero.webp")
适用场景与注意事项¶
- 适用场景：适用于需要处理图片元数据（尺寸、格式）或对图片进行缩放、格式转换的智能体场景。
- 运行权限：插件以当前 DSH 进程的权限运行，请确保智能体有足够的权限读取源文件和写入输出文件。
- 安全与合规：安装前建议检查源码与许可证（MIT）。插件依赖
@ffmpeg-installer/ffmpeg，会自动下载对应的二进制文件。
总结¶
该插件通过封装 ffmpeg，简化了 DSH 智能体中常见的图片处理任务。更多配置细节与源码可参考插件目录页或GitHub 仓库。
