English
dsh-remotion
在 20+ 个 agent 里写视频：Remotion 官方技能，React 编程式视频。
DSH（DeepSeek Harness）视频创作技能插件：安装即把 Remotion 官方移植技能注册进 DSH（React 编程式视频：动画、音频、字幕、3D、图表、字体等；同步 Remotion 官方 v4.0.519 的 12 技能结构）。
兼容性
已在官方 @deepseek-ai/dsh@0.1.5-rc.1、Node 24.16.0 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 cordis.patch.yml + dsh.bundle.patch 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
安装
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.519
依赖
Node.js ≥ 22 + npx（npm registry）；渲染需 ffmpeg（Remotion 自带指引）。
移植说明
技能移植自 OpenAI Codex 官方 Remotion 插件缓存：frontmatter 已转换为 DSH 格式，codex 专属 agents/ 已剔除，规则引用逐一校验。
跨平台使用
技能采用开放的 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。
