STARDUSTLC666/dsh-remotion

English

dsh-remotion

在 20+ 个 agent 里写视频：Remotion 官方技能，React 编程式视频。

DSH（DeepSeek Harness）视频创作技能插件：安装即把 Remotion 官方移植技能注册进 DSH（React 编程式视频：动画、音频、字幕、3D、图表、字体等；同步 Remotion 官方 v4.0.529 的 12 技能结构）。

兼容性

验证宿主：官方源码构建的 Harness 0.2.0-rc.1（commit 407e65c8）+ Node 24.16.0（2026-09-28）。23 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 12 个技能、1 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。

安装

dsh plugin --profile web add dsh-remotion

重启后说「用 Remotion 做个视频」即可触发。

卸载

dsh plugin --profile web remove dsh-remotion

卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile cordis.patch.yml 中覆盖的插件行。

技能内容

• remotion-best-practices（总纲路由）+ 11 个领域技能（captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade），同步自 Remotion 官方 v4.0.529

依赖

Node.js ≥ 22 + npx（npm registry）；渲染需 ffmpeg（Remotion 自带指引）。

移植说明

技能同步自官方 remotion-dev/skills 检出 v4.0.529（2026-09-25）：上游正文原样引入（含 remotion-best-practices/、remotion-markup/ 下的内嵌引用副本），仅把 frontmatter 换成本包的 name/description + 上游 version；scripts/sync-skills.mjs 让移植可复现、可校验（--check）。

跨平台使用

技能采用开放的 Agent Skills（SKILL.md）格式，不止 DSH 能用——把 skills/ 下的目录复制到其他 agent 的技能目录即可：

Agent	技能目录
Claude Code	~/.claude/skills/
Cursor	.cursor/skills/（或项目内 skills/）
Gemini CLI	~/.gemini/skills/
OpenAI Codex	~/.codex/skills/

一次移植，处处可用。

技能自检与重载

运行 remotion_health 会重新读取每个 SKILL.md，验证文件可读、YAML frontmatter 合法、名称与目录一致、描述与正文非空，再通过宿主 skills.get 确认实际生效的名称、描述、正文和资源目录与本次加载内容相符。文件存在但未注册、注册失败或后来被移除时，自检都会失败。

自检不修改文件或注册表。修改技能文件，或修复加载时损坏的技能后，应重载插件（也可重启 DSH）。它会报告 changed、not_registered 或 registration_failed，不会把磁盘修复直接当成运行时修复。若原先已成功加载，只是文件暂时丢失，恢复与加载时完全相同的内容即可重新通过检查。

每项结果保留 name / ok / detail，并增加 code / fileOk / registered / registryChecked / reloadRequired：registered 表示注册表仍匹配加载时的版本，因此文件变更时它可以为 true 而 ok 为 false。缺少或无法查询宿主注册表时返回 registry_unavailable；插件卸载后返回 disposed。checkBundledSkills() 仅检查磁盘文件，不推断运行时状态；原有不抛错的 parseSkillFile() 解析入口保持可用。

开发与共享实现

src/index.ts 只声明包名、技能清单和目录，解析、校验、注册与自检集中在包内 src/skill-bundle.ts。规范源位于 dsh-hyperframes/src/skill-bundle.ts，Remotion 保存相同的受版本控制副本；两包都编译并分发自己的 lib/skill-bundle.js，没有跨包运行时依赖，也不需要另一个仓库即可构建或安装。

依赖预先安装后，可直接离线构建和测试：

node node_modules/typescript/bin/tsc -p tsconfig.json
node --test "test/*.test.mjs"

两个仓库并列开发时，在 HyperFrames 修改公共模块与公共回归测试，再同步：

# 在 dsh-hyperframes 中执行；只更新相邻 dsh-remotion 的三个公共文件
node scripts/sync-skill-bundle.mjs
node scripts/sync-skill-bundle.mjs --check

两包测试都会检查公共源码与回归测试是否一致，防止副本漂移；单独检出时只跳过跨仓库比对，其余测试正常运行。测试覆盖损坏 YAML、不可读文件、空正文、注册异常/失效、内容变更与修复、卸载及清理异常，全程不调用视频或语音服务。

License

MIT（移植编排）；技能内容版权归 Remotion。