STARDUSTLC666/dsh-hyperframes

English

dsh-hyperframes

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

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

兼容性

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

安装

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/check/preview/render/timeline/publish/cloud/transcribe/tts/doctor…）
hyperframes-registry	hyperframes add 注册表组件安装与接线
hyperframes-studio	Studio 时间轴规范：轨道分层、字幕轨、安全区
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.82（2026-09-28）：官方打包的完整 skills/ 目录，共 21 个技能。相较 v0.8.20，新增 hyperframes-studio（Studio 时间轴规范），hyperframes-core 的 brief/storyboard/script 等文档改由 hyperframes 技能承载，media-use 与 music-to-video 大幅重构（新增内置动态原语），embedded-captions 等脚本随官方升级。旧版五件套中的 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。