dsh-hyperframes 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -2,8 +2,14 @@
 
 # dsh-hyperframes
 
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
 DSH (DeepSeek Harness) video-creation skill plugin: installing it registers the five official HyperFrames by HeyGen skills into DSH (video from HTML: compositions, GSAP animation, captions, voiceovers, audio-reactive visuals, website-to-video).
 
+## Compatibility
+
+Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+
 ## Installation
 
 ```bash
@@ -12,6 +18,15 @@ dsh plugin --profile web add dsh-hyperframes
 
 After restarting, say "turn this website into a HyperFrames video" to trigger it.
 
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-hyperframes
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+
 ## Skills
 
 | Skill | Purpose |
@@ -30,6 +45,20 @@ Node.js ≥ 22 + FFmpeg (`npx hyperframes`).
 
 Ported from the official OpenAI Codex HyperFrames by HeyGen plugin cache: frontmatter converted to the DSH format, Codex-only `agents/` stripped, and all internal references verified.
 
+## Multi-harness
+
+Skills use the open Agent Skills (SKILL.md) format — **not just DSH**. Copy the directories under `skills/` into another agent's skills directory:
+
+| Agent | Skills directory |
+| :-- | :-- |
+| Claude Code | `~/.claude/skills/` |
+| Cursor | `.cursor/skills/` (or project-local `skills/`) |
+| Gemini CLI | `~/.gemini/skills/` |
+| OpenAI Codex | `~/.codex/skills/` |
+
+Port once, use everywhere.
+
+
 ## License
 
-MIT for the porting arrangement; skill content copyright remains with HeyGen.
+MIT for the porting arrangement; skill content copyright remains with HeyGen.

package/README.md

@@ -2,8 +2,19 @@
 
 # dsh-hyperframes
 
+> **在 20+ 个 agent 里写视频**：HyperFrames by HeyGen 五件套，HTML 即视频。
+
+![npm version](https://img.shields.io/npm/v/dsh-hyperframes?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-hyperframes) ![license](https://img.shields.io/npm/l/dsh-hyperframes) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-hyperframes?style=social)
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+
 DSH（DeepSeek Harness）视频创作技能插件：**安装即把 HyperFrames by HeyGen 官方移植技能五件套注册进 DSH**（HTML 写视频：合成、GSAP 动画、字幕、配音、音频响应、网址转视频）。
 
+## 兼容性
+
+在 `@deepseek-ai/dsh@0.1.1-rc.2` 上验证（2026-08-26）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+
 ## 安装
 
 ```bash
@@ -12,6 +23,15 @@ dsh plugin --profile web add dsh-hyperframes
 
 重启后说「把这个网址做成 HyperFrames 视频」即可触发。
 
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-hyperframes
+```
+
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+
+
 ## 技能清单
 
 | 技能 | 用途 |
@@ -30,6 +50,20 @@ Node.js ≥ 22 + FFmpeg（`npx hyperframes`）。
 
 技能移植自 OpenAI Codex 官方 HyperFrames by HeyGen 插件缓存：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/` |
+
+一次移植，处处可用。
+
+
 ## License
 
 MIT（移植编排）；技能内容版权归 HeyGen。

package/lib/index.d.ts

@@ -1,4 +1,5 @@
 /** cordis 服务注入：apply 里要用 ctx.skills，必须显式声明。 */
+export declare const name = "hyperframes-skills";
 export declare const inject: string[];
 /** 技能注册定义（最小面）。 */
 export interface SkillRegistration {
@@ -16,12 +17,21 @@ export interface SkillsPluginContext {
     skills: {
         register(definition: SkillRegistration): () => void;
     };
+    tools?: {
+        register(definition: Record<string, unknown>): () => void;
+    };
     on?(event: string, listener: () => void): () => void;
 }
 /** 随包分发的技能清单。 */
 export declare const SKILL_NAMES: readonly ["hyperframes", "hyperframes-cli", "hyperframes-registry", "website-to-hyperframes", "gsap"];
 /** 打包技能目录的绝对路径。 */
 export declare function bundledSkillsDir(): string;
+/** 检查随包技能资源完整性：每个技能的 SKILL.md 是否存在。 */
+export declare function checkBundledSkills(): Array<{
+    name: string;
+    ok: boolean;
+    detail: string;
+}>;
 /** 拆分 SKILL.md 的 frontmatter 与正文。 */
 export declare function parseSkillFile(text: string): {
     name: string;

package/lib/index.js

@@ -6,18 +6,27 @@
  *
  * @module dsh-hyperframes
  */
-import { readFileSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { join } from 'node:path';
 import YAML from 'yaml';
 /** cordis 服务注入：apply 里要用 ctx.skills，必须显式声明。 */
-export const inject = ['skills'];
+export const name = 'hyperframes-skills';
+export const inject = ['skills', 'tools'];
 /** 随包分发的技能清单。 */
 export const SKILL_NAMES = ["hyperframes", "hyperframes-cli", "hyperframes-registry", "website-to-hyperframes", "gsap"];
 /** 打包技能目录的绝对路径。 */
 export function bundledSkillsDir() {
     return fileURLToPath(new URL('../skills/', import.meta.url));
 }
+/** 检查随包技能资源完整性：每个技能的 SKILL.md 是否存在。 */
+export function checkBundledSkills() {
+    return SKILL_NAMES.map((skillName) => {
+        const file = join(bundledSkillsDir(), skillName, 'SKILL.md');
+        const ok = existsSync(file);
+        return { name: skillName, ok, detail: ok ? file : 'SKILL.md 缺失：' + file };
+    });
+}
 /** 拆分 SKILL.md 的 frontmatter 与正文。 */
 export function parseSkillFile(text) {
     const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
@@ -65,6 +74,30 @@ export function apply(ctx) {
             console.warn('[dsh-hyperframes] 技能 ' + skillName + ' 加载失败：' + (error instanceof Error ? error.message : String(error)));
         }
     }
+    if (typeof ctx.tools?.register === 'function') {
+        disposers.push(ctx.tools.register({
+            name: 'hyperframes_health',
+            description: 'dsh-hyperframes 自检：检查随包技能资源（SKILL.md）是否完整。遇到问题时先运行本工具定位。',
+            parameters: { type: 'object', properties: {} },
+            output: {
+                schema: { type: 'object', additionalProperties: true },
+                render(_args, value) {
+                    const rec = (value ?? {});
+                    const skills = Array.isArray(rec.skills) ? rec.skills : [];
+                    const lines = ['dsh-hyperframes 自检' + (rec.ok === true ? '：技能资源完整。' : '：发现缺失。')];
+                    for (const item of skills) {
+                        const s = (item ?? {});
+                        lines.push('- ' + String(s.name) + '：' + (s.ok === true ? '✅' : '❌ ' + String(s.detail ?? '')));
+                    }
+                    return [{ type: 'text', text: lines.join('\n') }];
+                },
+            },
+            async execute() {
+                const skills = checkBundledSkills();
+                return { ok: skills.every((s) => s.ok), plugin: 'dsh-hyperframes', skills };
+            },
+        }));
+    }
     if (typeof ctx.on === 'function') {
         ctx.on('dispose', () => {
             for (const dispose of disposers)

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "dsh-hyperframes",
-  "version": "0.1.0",
-  "description": "DSH 视频创作技能插件：注册 HyperFrames by HeyGen 官方移植技能五件套（hyperframes / hyperframes-cli / hyperframes-registry / website-to-hyperframes / gsap），安装即用。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "skills",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepare": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
-    "prepublishOnly": "pnpm run build"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "skills",
-    "video"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "yaml": "^2.9.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/STARDUSTLC666/dsh-hyperframes"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-hyperframes/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-hyperframes#readme",
-  "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
-}
+{
+  "name": "dsh-hyperframes",
+  "version": "0.2.0",
+  "description": "DSH 视频创作技能插件：注册 HyperFrames by HeyGen 官方移植技能五件套（hyperframes / hyperframes-cli / hyperframes-registry / website-to-hyperframes / gsap），安装即用。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "skills",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "skills",
+    "video",
+    "dsh-plugin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STARDUSTLC666/dsh-hyperframes.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-hyperframes/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-hyperframes#readme",
+  "author": "stardustlc",
+  "packageManager": "pnpm@11.7.0"
+}