dsh-kumquat
Manifest validMedia conversion panel for DSH: video and audio format conversion, clip trimming, and video-to-GIF, with every output checked for resolution, codec, framerate, duration, channels and sample rate.
Kumquat(金桔)
DeepSeek Harness 的媒体插件:视频格式转换、音频格式转换、视频取景做 GIF,产物出厂前自动验收。

它做什么
视频格式转换:MP4 / MKV / MOV / WEBM / AVI 互转;也能把视频里的声音抽成 MP3 / M4A / WAV / FLAC / AAC / OGG / OPUS / WMA。 目标容器装得下就流拷贝(百毫秒级、画质零损失),装不下明确告知并重编码(H.264 CRF 18),不偷偷降级。可勾选「裁剪片段」只转起止之间的一段;一次可选多个文件批量转换,结果逐条验收。
音频格式转换:MP3 / M4A / WAV / FLAC / AAC / OGG / OPUS / WMA 八种互转,只处理声音。
监控格式:.vdat / .sdv 按内容识别,内部是标准容器时可直接换壳;加密或私有外壳会明确告知,需先用原厂工具导出 MP4。
取段做 GIF:拖时间轴选几秒,帧率与宽度可调;超出目标体积自动降宽重试,最多两轮,然后告诉你还差多少。

为什么不是又一个转码工具
同类工具返回“成功/失败”;Kumquat 返回期望值、实际值、差多少、怎么修:
- 分辨率、编码、帧率、时长、声道、采样率逐项比对;
- 可解码性抽样检查,不用全片解码;
- 每条产物落一份
verify.json:完整 argv、FFmpeg 版本、逐项判定,失败可复现; - 结论不合格时,能自动修的给修复方案,不能修的给一句人话和下一步。
安装
要求 DSH 0.2.x、Node 20.12 以上。插件本身零依赖,不需要 npm install。
# 从 npm 安装
dsh plugin --profile desktop add dsh-kumquat
dsh plugin --profile web add dsh-kumquat
桌面客户端也可以在插件面板里按包名 dsh-kumquat 安装;开发时仍可指向本地目录。装完重启,侧栏出现「金桔」。
使用
- 侧栏点「金桔」;
- 选任务:视频格式转换 / 音频格式转换 / 视频做 GIF;
- 点「添加文件」,在文件对话框里选目录和文件(双击直接打开);也可以点「粘贴路径」直接填绝对路径;
- 选目标格式或拖时间轴选区;
- 需要时点「选择」指定保存位置与文件名(系统“另存为”),不选就写在源文件旁边;
- 点开始,结果挂在表单下面,点开看验收细目;面板右上角「×」可收成右下角胶囊。
成品默认写在源文件旁边;Desktop、Downloads、Documents 常被 Windows「受控文件夹访问」拦截 ffmpeg,此时会先在临时目录编码、再移动到你所选目录。
FFmpeg
优先使用本机已有的 ffmpeg;找不到时按平台自动下载并校验 sha256:
| 平台 | 自动安装 | 来源 |
|---|---|---|
| Windows x64 | 支持 | gyan.dev essentials |
| Linux x64 / arm64 | 支持 | BtbN |
| macOS | 不支持自动安装 | 需 brew install ffmpeg 或配置 ffmpegPath |
下载只解压 ffmpeg 与 ffprobe,不执行归档内其他文件;大小上限 200MB;失败自动清理。
兼容
DSH 桌面客户端与 dsh web 共用同一份客户端 bundle。文件以本机绝对路径登记,不上传、不复制。
没有 Key 也能用
- 转换、GIF、音频、验收全部在本机完成,不需要任何 Key;
- Key 只服务余额显示:没 Key 时余额行隐藏,插件不发任何余额请求;
- 配了 Harness 的 DEEPSEEK_API_KEY 会自动复用,也可用环境变量或插件配置覆盖;
- 唯一的联网行为是:余额查询(仅在有 Key 时)与本机缺 FFmpeg 时的下载。
安全与隐私
- 唯一的网络出口是余额查询
GET https://api.deepseek.com/user/balance,仅在拿到 key 时发起; - 默认复用 Harness 凭据里已保存的
DEEPSEEK_API_KEY,通常不需要单独配置;插件配置或环境变量可以覆盖它; - 未配置 key 时余额行直接隐藏,不会出现“未配置”提示,也不会有任何相关请求;
- key 只在宿主进程内存中拼 Bearer 头,不下发浏览器、不进日志;
- 仓库里只有
sk-...占位符,真实 key 请用环境变量DEEPSEEK_API_KEY或 profile 配置; - 不采集遥测,不上传媒体文件。
详见 SECURITY.md。
验证
- 单元测试 352 条、端到端 16 条(Windows 实测);
- 覆盖:视频/音频格式转换、GIF 取段与体积闭环、取消与临时文件清理、并发隔离、坏样本错误语义、宿主路由与注入;
- 验证记录见 docs/VERIFICATION.md。
Linux 只做了逻辑验证,macOS 未上机。
参与\n\n规则与本地跑法见 CONTRIBUTING.md;发布流程见 docs/PUBLISH.md。运行时零依赖,客户端改动需要提交重新生成的 client.js。\n\n## 开发
node scripts/make-fixtures.mjs
node --test --test-isolation=none "test/unit/*.test.mjs"
node --test --test-isolation=none "test/e2e/*.test.mjs"
沙箱里 node --test 会为每个文件 spawn 子进程,可能报 EPERM;用 --test-isolation=none 在当前进程内跑。
目录
src/engine/ ffmpeg 定位、探测、能力、参数构造、进程执行
src/verify/ 验收检查、容差、修复、证据
src/binary/ FFmpeg 按平台下载、校验、解压
src/host/ DSH 宿主接线、路由、余额
src/client/ 三屏界面
test/ 单元与端到端
design/ 设计稿与界面稿
docs/ 插件详情页、验证记录
License
MIT
Comments
Loading…
Similar plugins
Browser-local audio/video toolkit for DSH — extract frames, capture thumbnails, compress images, and convert clips to GIF with FFmpeg.wasm.
★ 0
dsh plugin --profile web add @piedpiper911/dsh-video-toolsby a1121611810
DeepSeek Harness 的多媒体工具箱插件:转换 / 裁剪 / 提取音轨 / 字幕 / 元数据 / Base64,本机 ffmpeg 完成。
★ 0
MIT
JavaScript
Nov 10, 2026
dsh plugin --profile web add dsh-media-converterby llafztq
Video editing toolset for DeepSeek Harness - trim, concat, audio, subtitles, transform, transcode and frame grabbing, powered by ffmpeg.
★ 4
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-video-toolMedia Review DSH — DeepSeek Harness 原生音视频审片插件:直接标注、波形、返修交接与新版复核。
★ 0
MIT
JavaScript
dsh plugin --profile web add media-review-dsh为模型展示交付成果和下达精细微调指示的dsh desktop面板
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-plugin-middle-panelby Bigesila-B
DSH Media Forge plugin: agent + skills workflow for media-generation APIs, with a sidebar skill panel (zh/en docs)
★ 0
TypeScript
Aug 26, 2026
dsh plugin --profile web add dsh-media-forge