DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-kumquat

d

dsh-kumquat

Manifest valid

Media 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.

UI (client)hasBundlePatch

Kumquat(金桔)

npm license GitHub Gitee 镜像

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 安装;开发时仍可指向本地目录。装完重启,侧栏出现「金桔」。

使用

  1. 侧栏点「金桔」;
  2. 选任务:视频格式转换 / 音频格式转换 / 视频做 GIF;
  3. 点「添加文件」,在文件对话框里选目录和文件(双击直接打开);也可以点「粘贴路径」直接填绝对路径;
  4. 选目标格式或拖时间轴选区;
  5. 需要时点「选择」指定保存位置与文件名(系统“另存为”),不选就写在源文件旁边;
  6. 点开始,结果挂在表单下面,点开看验收细目;面板右上角「×」可收成右下角胶囊。

成品默认写在源文件旁边;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

dsh-video-tools

Browser-local audio/video toolkit for DSH — extract frames, capture thumbnails, compress images, and convert clips to GIF with FFmpeg.wasm.

Tools & CapabilitiesManifest valid

★ 0

dsh plugin --profile web add @piedpiper911/dsh-video-tools

by a1121611810

DeepSeek Harness 的多媒体工具箱插件:转换 / 裁剪 / 提取音轨 / 字幕 / 元数据 / Base64,本机 ffmpeg 完成。

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-media-converter

by llafztq

Video editing toolset for DeepSeek Harness - trim, concat, audio, subtitles, transform, transcode and frame grabbing, powered by ffmpeg.

Tools & CapabilitiesManifest valid

★ 4

JavaScript

Oct 8, 2026

dsh plugin --profile web add dsh-video-tool

Media Review DSH — DeepSeek Harness 原生音视频审片插件:直接标注、波形、返修交接与新版复核。

Workflow & AutomationManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add media-review-dsh

为模型展示交付成果和下达精细微调指示的dsh desktop面板

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-plugin-middle-panel

by Bigesila-B

DSH Media Forge plugin: agent + skills workflow for media-generation APIs, with a sidebar skill panel (zh/en docs)

Manifest valid

★ 0

TypeScript

Aug 26, 2026

dsh plugin --profile web add dsh-media-forge