STARDUSTLC666/dsh-hyperframes

English

dsh-hyperframes

在 20+ 个 agent 里写视频：HyperFrames by HeyGen 官方 20 技能，HTML 即视频。

npm version npm downloads license stars

Awesome DSH Plugin

DSH（DeepSeek Harness）视频创作技能插件：安装即把 HyperFrames by HeyGen 官方 20 个技能注册进 DSH（HTML 写视频：核心工作流、动画、音频、字幕、关键帧、创意模板、CLI、注册表、网站转视频等，同步官方 v0.8.20）。

兼容性

已在官方 @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-hyperframes

重启后说「把这个网址做成 HyperFrames 视频」即可触发。

卸载

dsh plugin --profile web remove dsh-hyperframes

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

技能清单

| 技能 | 用途 |
| :-- | :-- |
| hyperframes | 总纲：HTML 视频合成（视觉风格/调色板/字幕/音频响应/转场）|
| hyperframes-core | 核心概念与组件模型 |
| hyperframes-animation | 动画：GSAP/Anime.js/Lottie/Three.js/WAAPI 适配 |
| hyperframes-audio | 音频：配音、音频响应视觉 |
| hyperframes-keyframes | 关键帧动画 |
| hyperframes-creative | 创意模板与风格 |
| hyperframes-cli | npx hyperframes 命令行（init/lint/inspect/preview/render/transcribe/tts/doctor）|
| hyperframes-registry | hyperframes add 注册表组件安装与接线 |
| embedded-captions | 内嵌字幕 |
| faceless-explainer | 无脸讲解视频 |
| figma | Figma 素材接入 |
| general-video | 通用视频制作 |
| media-use | 媒体素材使用规范 |
| motion-graphics | 动态图形 |
| music-to-video | 音乐驱动视频 |
| pr-to-video | PR 转视频 |
| product-launch-video | 产品发布视频 |
| remotion-to-hyperframes | Remotion 项目迁移 |
| slideshow | 幻灯片视频 |
| talking-head-recut | 口播重剪 |

依赖

Node.js 22.19+ (22.x) / 24+ + FFmpeg（npx hyperframes）。

移植说明

技能同步自官方仓库 heygen-com/hyperframes v0.8.20（2026-08-31）：官方 codex 插件打包的完整 skills/ 目录；旧版五件套中的 gsap、website-to-hyperframes 已被上游合并进新技能体系。

跨平台使用

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

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

一次移植，处处可用。

技能自检与重载

运行 hyperframes_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（移植编排）；技能内容版权归 HeyGen。