dsh-hyperframes 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 [返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
 
+## 0.10.2 (2026-10-29)
+
+- 同步仓库与 npm 的简明介绍、中英文 README 和反馈入口；本次为文档与包元数据更新。
+- Sync npm descriptions and both README guides with the repository, including issue and pull-request links.
+- Correct the introductory engine reference to the already included HyperFrames 0.8.211.
+
+## 0.10.1 (2026-10-28)
+
+- 同步官方 HyperFrames 0.8.211：7 个当前技能、301 项资源逐一比对发布提交；更新两处上游文档，并固定新的 CLI 与渲染环境版本。
+
 ## 0.10.0 (2026-10-28)
 
 - 素材页支持上移/下移图片，显示播放序号，立即保存并校验工程修订；不改音频/视频位置和旧成品。

package/README.en.md

@@ -4,15 +4,15 @@
 
 ![dsh-hyperframes whale girl plugin cover](https://raw.githubusercontent.com/STARDUSTLC666/dsh-hyperframes/master/assets/cover-whale-girl.png)
 
-Bring HyperFrames HTML video creation skills into DSH.
+Create HTML videos in DSH with official HyperFrames skills, template projects, asset upload and ordering, archives, official preview and local MP4 export. Use AI-authored projects or start directly from a workbench template.
 
 [![npm](https://img.shields.io/npm/v/dsh-hyperframes)](https://www.npmjs.com/package/dsh-hyperframes) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-hyperframes-downloads.svg)](https://www.npmjs.com/package/dsh-hyperframes)
 
 Feedback and contributions are welcome: report [issues](https://github.com/STARDUSTLC666/dsh-hyperframes/issues) or submit [pull requests](https://github.com/STARDUSTLC666/dsh-hyperframes/pulls).
 
-Open the new native sidebar workbench after updating and restarting DSH. Settings remains available. See the [workbench guide and validation boundaries](docs/WORKBENCH.md).
+Open the workbench from the native DSH sidebar. See the [workbench guide](docs/WORKBENCH.md) for configuration and operating boundaries.
 
-Bundled skills: official HyperFrames 0.8.209, seven current skills with fourteen previous names retained as compatibility entries.
+Bundled skills: official HyperFrames 0.8.211, seven current skills with fourteen previous names retained as compatibility entries.
 
 Move images up or down in the Media tab, including with the keyboard. The order saves immediately; export again to apply it to a new MP4.
 

package/README.md

@@ -4,15 +4,15 @@
 
 ![dsh-hyperframes 鲸鱼娘插件封面](https://raw.githubusercontent.com/STARDUSTLC666/dsh-hyperframes/master/assets/cover-whale-girl.png)
 
-把 HyperFrames 的 HTML 视频创作技能接入 DSH。
+在 DSH 中用 HTML 创作视频：官方 HyperFrames 技能、模板工程、素材上传与排序、归档、官方预览和本地 MP4 导出。既可让 AI 编写视频工程，也可直接使用工作台模板。
 
 [![npm](https://img.shields.io/npm/v/dsh-hyperframes)](https://www.npmjs.com/package/dsh-hyperframes) [![downloads](https://raw.githubusercontent.com/STARDUSTLC666/dsh-suite/npm-downloads/assets/dsh-hyperframes-downloads.svg)](https://www.npmjs.com/package/dsh-hyperframes)
 
 欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-hyperframes/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-hyperframes/pulls)。
 
-更新并重启 DSH 后，可从原生侧栏打开新版工作台，原设置入口继续保留。详见[工作台说明与验收范围](docs/WORKBENCH.md)。
+从 DSH 原生侧栏打开工作台；配置与操作边界见[工作台说明](docs/WORKBENCH.md)。
 
-技能内容：官方 HyperFrames 0.8.209，7 个当前技能；14 个旧名称保留为兼容入口。
+技能内容：官方 HyperFrames 0.8.211，7 个当前技能；14 个旧名称保留为兼容入口。
 
 在「素材」页上移或下移图片即可调整轮播顺序，支持键盘操作。顺序立即保存；重新导出后应用于新 MP4。
 

package/docs/USAGE.en.md

@@ -46,7 +46,7 @@ Open Settings → HyperFrames in DSH Web or Desktop.
 
 1. Create a video. Select title card, product card or slideshow; set the title/body, canvas and an integer duration of 3–30 seconds, then save.
 2. Upload local copies of PNG/JPEG images, one MP3/WAV background audio and one muted MP4 background video. Limits: 20 MB per asset, 40 MB total. Slideshows follow upload order and need at least two seconds per image.
-3. Explicitly prepare the environment on first use. It downloads official CLI 0.8.209; Windows uses its managed rendering browser, while other platforms reuse installed Chrome when available. Project editing remains available. FFmpeg must be installed and in PATH; restart DSH after changing PATH.
+3. Explicitly prepare the environment on first use. It downloads official CLI 0.8.211; Windows uses its managed rendering browser, while other platforms reuse installed Chrome when available. Project editing remains available. FFmpeg must be installed and in PATH; restart DSH after changing PATH.
 4. Start official Studio and inspect the picture. Stop this preview before editing or exporting. No window is opened automatically.
 5. Export, play and download MP4. Later edits preserve earlier MP4s and display a revision warning. Export again for a new final output.
 
@@ -88,7 +88,7 @@ Node.js 22.19+ (22.x) / 24+ + FFmpeg (`npx hyperframes`).
 
 ## Porting notes
 
-Synced from official HyperFrames 0.8.209 release commit `53c975966611e7012b09b6d46707c26511ea077d` (2026-10-28). All seven current official skills retain their upstream files. Fourteen previous names remain as compatibility entries that load current workflows. The upstream plugin launcher pins the CLI and blocks standalone skill replacement. Source hashes and the Apache-2.0 license are recorded under `skills/UPSTREAM.json` and `skills/UPSTREAM-LICENSE.txt`.
+Synced from official HyperFrames 0.8.211 release commit `5ed694264e9a48aebca0a0f29b94dbd30c2e29d0` (2026-10-28). All seven current official skills retain their upstream files. Fourteen previous names remain as compatibility entries that load current workflows. The upstream plugin launcher pins the CLI and blocks standalone skill replacement. Source hashes and the Apache-2.0 license are recorded under `skills/UPSTREAM.json` and `skills/UPSTREAM-LICENSE.txt`.
 
 ## Multi-harness
 

package/docs/USAGE.md

@@ -46,7 +46,7 @@ dsh plugin --profile web remove dsh-hyperframes
 
 1. 新建视频，选择标题卡、产品介绍或图文轮播，填写标题/正文、画幅和 3–30 秒时长，明确保存。
 2. 上传 PNG/JPEG、一个背景音频（MP3/WAV）、一个静音背景视频（MP4）的副本。每个文件最多 20 MB、总计 40 MB；轮播按上传顺序，每张至少两秒。
-3. 首次点击「准备渲染环境」。此时下载固定版本官方 CLI 0.8.209；Windows 下载官方专用渲染浏览器，其他系统优先复用已安装的 Chrome；可以继续编辑工程。下载失败保留工程，查看运行记录后重试。需先安装 FFmpeg 并加入 PATH，重启 DSH 后生效。
+3. 首次点击「准备渲染环境」。此时下载固定版本官方 CLI 0.8.211；Windows 下载官方专用渲染浏览器，其他系统优先复用已安装的 Chrome；可以继续编辑工程。下载失败保留工程，查看运行记录后重试。需先安装 FFmpeg 并加入 PATH，重启 DSH 后生效。
 4. 启动官方 Studio，检查画面。停止本次预览后再编辑或导出；不会自动打开或占用前台窗口。
 5. 导出 MP4、在工作台播放并下载。工程更新后保留旧成品并显示旧修订提醒；再次导出即可生成新成片。
 
@@ -92,7 +92,7 @@ Node.js 22.19+ (22.x) / 24+ + FFmpeg（`npx hyperframes`）。
 
 ## 移植说明
 
-技能同步自官方 `heygen-com/hyperframes` 的 0.8.209 发布提交 `53c975966611e7012b09b6d46707c26511ea077d`（2026-10-28）。当前 7 个官方技能完整保留原文、脚本与资源；原来的 14 个旧名称改为兼容入口，转向当前技能，避免继续使用已合并的旧工作流。上游插件启动器固定 CLI 版本，并禁止独立技能更新命令覆盖 DSH 管理的包。来源、完整性与 Apache-2.0 许可证见 `skills/UPSTREAM.json` 和 `skills/UPSTREAM-LICENSE.txt`。
+技能同步自官方 `heygen-com/hyperframes` 的 0.8.211 发布提交 `5ed694264e9a48aebca0a0f29b94dbd30c2e29d0`（2026-10-28）。当前 7 个官方技能完整保留原文、脚本与资源；原来的 14 个旧名称改为兼容入口，转向当前技能，避免继续使用已合并的旧工作流。上游插件启动器固定 CLI 版本，并禁止独立技能更新命令覆盖 DSH 管理的包。来源、完整性与 Apache-2.0 许可证见 `skills/UPSTREAM.json` 和 `skills/UPSTREAM-LICENSE.txt`。
 
 ## 跨平台使用
 

package/docs/VALIDATION.md

@@ -1,5 +1,9 @@
 # dsh-hyperframes 验证记录
 
+## 2026-10-28：0.10.1
+
+[本次修复与验收边界](validation-0.10.1.md)。
+
 [0.5.1 中英文界面验收](validation-language-2026-10-03.md)。
 
 [Windows 安装排错与真实安装验收（2026-10-18）](validation-install-2026-10-18.md)。

package/docs/validation-0.10.1.md

@@ -0,0 +1,7 @@
+# 0.10.1 验证记录（2026-10-28）
+
+同步官方 HyperFrames 0.8.211，发布提交 5ed694264e9a48aebca0a0f29b94dbd30c2e29d0。7 个当前技能、301 项资源逐一验证 Git blob，2 项上游文档变化已同步；14 个旧名称兼容入口保留。CLI、插件清单及工作台渲染环境使用同一固定版本。
+
+Windows 48 项回归通过、0 跳过。官方 DSH 0.2.1-rc.4 隔离 profile 的工作台桌面、390px 窄屏及默认关闭自动安装已检查。另经实际 MediaWorkbench 准备官方环境、导出 720×720、24 FPS、6 秒 H.264 MP4，并用 ffprobe 和解码画面核对红/绿/蓝三张素材顺序。渲染不是模拟子进程；本轮导出由实际工作台类调用，最终公开安装另验插件加载与界面。
+
+未操作用户前台窗口；Electron 原生窗口及 Linux/macOS 渲染没有在本轮验收。上游链接：https://github.com/heygen-com/hyperframes/tree/5ed694264e9a48aebca0a0f29b94dbd30c2e29d0 。

package/lib/client.js

@@ -859,7 +859,7 @@ h('div', { className: 'bar' }, h('button', { disabled: busy || dirty || activeJo
         catch { } W.register(ctx,{id:'dsh-'+engine+'.workbench',label:()=>title,icon:engine==='hyperframes'?'layers':'play',component:Workbench,inject:()=>({locale}),order:engine==='hyperframes'?65:66});
 ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'dsh-' + engine, order: engine === 'hyperframes' ? 62 : 63, label: () => title, inject: () => ({ locale }) }, Workbench)); }
         return { inject: ['slots', 'locale'], apply };
-    } },{"name":"dsh-hyperframes","version":"0.1.0","hasWorkbench":true,"packageVersion":"0.10.0","label":"HyperFrames","labelEn":"HyperFrames","suiteComponent":true}));
+    } },{"name":"dsh-hyperframes","version":"0.1.0","hasWorkbench":true,"packageVersion":"0.10.2","label":"HyperFrames","labelEn":"HyperFrames","suiteComponent":true}));
 
 })();
 

package/lib/media-templates.d.ts

@@ -27,7 +27,7 @@ export interface MediaProject extends MediaFields {
     }>;
 }
 export declare const MEDIA_VERSIONS: {
-    readonly hyperframes: "0.8.209";
+    readonly hyperframes: "0.8.211";
     readonly remotion: "4.0.539";
     readonly gsap: "3.15.0";
 };

package/lib/media-templates.js

@@ -1,4 +1,4 @@
-export const MEDIA_VERSIONS = { hyperframes: '0.8.209', remotion: '4.0.539', gsap: '3.15.0' };
+export const MEDIA_VERSIONS = { hyperframes: '0.8.211', remotion: '4.0.539', gsap: '3.15.0' };
 export const MEDIA_TEMPLATES = [
     { id: 'title', zh: '标题卡', en: 'Title card', description: '一句标题、一段介绍，适合开场与通知。' },
     { id: 'product', zh: '产品介绍', en: 'Product card', description: '深色画布与一张主图，适合产品亮点。' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-hyperframes",
-  "version": "0.10.0",
-  "description": "DSH 视频插件：HyperFrames 技能、模板与素材工作台、官方预览和本地 MP4 导出。",
+  "version": "0.10.2",
+  "description": "DSH HTML 视频工作台：官方 HyperFrames 技能、模板、素材排序、预览与本地 MP4 导出。欢迎提交 issues 和 PR。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "hyperframes",
-  "version": "0.8.209",
+  "version": "0.8.211",
   "description": "Official HyperFrames skill release packaged by dsh-hyperframes. DSH manages this bundle; this manifest supplies the pinned upstream CLI version."
 }

package/skills/UPSTREAM.json

@@ -1,9 +1,9 @@
 {
   "name": "hyperframes",
-  "version": "0.8.209",
-  "gitHead": "53c975966611e7012b09b6d46707c26511ea077d",
-  "tarball": "https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.209.tgz",
-  "integrity": "sha512-08ft2bTwhVPUxklkEFQ3iw6JWi/bDDDC6s9yI6QjVabGFAZ2T5WfhPkSlgbCTNAOixS8GnjvDaJ0Z5rmf4op6w==",
+  "version": "0.8.211",
+  "gitHead": "5ed694264e9a48aebca0a0f29b94dbd30c2e29d0",
+  "tarball": "https://registry.npmjs.org/hyperframes/-/hyperframes-0.8.211.tgz",
+  "integrity": "sha512-v1ptp7VmmqXJs5s1GgJ87EY9fA3Uue1eebX+Fq1vq6ApffyKJAuZRNRRASh1A6qENG5BejjMrkxQF3uJr5QX+g==",
   "node": ">=22",
   "canonical": [
     "figma",
@@ -31,7 +31,7 @@
     "talking-head-recut"
   ],
   "repository": "https://github.com/heygen-com/hyperframes",
-  "checkedAt": "2026-10-27",
+  "checkedAt": "2026-10-28",
   "adaptation": "Official canonical files unchanged; DSH compatibility aliases and upstream launcher manifest.",
   "files": {
     "figma/scripts/verify-motion.mjs": "1988721525e929caa5d3ced6d16c31467996e0c57757d281a971fb77e2297de8",
@@ -122,14 +122,14 @@
     "hyperframes-cli/references/feedback.md": "ae188d5c3e90f0e011b1e322bbfbe10575667b2a5073cffdac05026ac59925a7",
     "hyperframes-cli/references/init-and-scaffold.md": "dad4c2212f6df8ed4ff8d7b8154c2f8a6bdeec0fa27562b0b6c4d8da9d2e1078",
     "hyperframes-cli/references/lambda.md": "80b8ce187a1dec26bf8bed682cdd1415a79a5d72ba6ef07650c58f5d3795845b",
-    "hyperframes-cli/references/lint-validate-inspect.md": "2629c4af5e2255c18e7782622516e225393ffef77844bde53fa923d34aa1be13",
+    "hyperframes-cli/references/lint-validate-inspect.md": "8144df629f9b913e1237539f2eafa24d8413be0ec4cf694264c6eab33b903904",
     "hyperframes-cli/references/preview-render.md": "851d85d7f4e6939d90ed6e350180a8edadc67b44dfc5d19163376485324d00b2",
     "hyperframes-cli/references/upgrade-info-misc.md": "a46662ad866669d1cf70bfa6404e9a01f68d2db4eb667fe6dc8a8442f6a069d8",
     "hyperframes-cli/SKILL.md": "44a48ccfa4cbd4f4234f8306c96268a4be56a0f2376abedbf31d2167b3c21286",
     "hyperframes-registry/examples/add-block.md": "0e3353755c4ef55e53570d1266a4a43b2c5aef9bbe41276430e38cfa6580b83a",
     "hyperframes-registry/examples/add-component.md": "d06992d31eec617a91f5c34630c9274c52dd07898bd24f10a869d0d1cab5af29",
     "hyperframes-registry/references/component-quality-bar.md": "f0d4c3c44131bc0791f8a8cc3d2d7478d38045451775af7d20b2dd47cf5f91ac",
-    "hyperframes-registry/references/contributing.md": "7e9e6fd894e54251fad9aa30a08730960ceb776da590a175eadfc1d9014106b1",
+    "hyperframes-registry/references/contributing.md": "3724d1dd269768da26b731f6592ac749f47f62443e909f881ac12ceba36db0fa",
     "hyperframes-registry/references/demo-html-pattern.md": "dfc50cd33eff2c2be75437786fc3e851ab0085f7d453fb35b3380ecf9a6e9f04",
     "hyperframes-registry/references/discovery.md": "ca82fcc1e0b2d824b72a8bda99b60d257b23d493fa1d28adbb0548a762cacd04",
     "hyperframes-registry/references/install-locations.md": "83793e7d6aeea9a751755e4bd23ea48182ff9af082287b98a1192343d2571dd1",

package/skills/hyperframes-cli/references/lint-validate-inspect.md

@@ -44,14 +44,14 @@ npx hyperframes check --strict           # exit non-zero on warnings too (defaul
 One command, one Chrome boot. `check` runs the linter first and skips the browser entirely when lint reports errors. When the browser never ran (lint errors, a linter crash, or a browser launch failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast` sections are empty, not clean. Otherwise it loads the bundled composition once, wires runtime listeners before navigation, and sweeps one seek grid running every audit per sample:
 
 - **Runtime**: JavaScript console errors, unhandled exceptions, failed network requests (media-file `ERR_ABORTED` filtered out), HTTP 4xx/5xx.
-- **Layout**: text extending outside its container or the canvas, text clipped by its own box, held text overlaps and occlusion (with an approximate covered fraction), children escaping clipping containers. Text under a transparent `<video>` (a `remove-background` cutout) is measured per word against the frame's alpha: partial cover is info with the share hidden, a word 80% hidden or two neighbouring words each half hidden is an error, and a frame that cannot be read falls back to opaque with a `video_alpha_unread` note.
+- **Layout**: text extending outside its container or the canvas, text clipped by its own box, held text overlaps and occlusion (with an approximate covered fraction), an opaque element covering the canvas above every other clip for most of the film (`canvas_covered`, naming it), children escaping clipping containers. Text under a transparent `<video>` (a `remove-background` cutout) is measured per word against the frame's alpha: partial cover is info with the share hidden, a word 80% hidden or two neighbouring words each half hidden is an error, and a frame that cannot be read falls back to opaque with a `video_alpha_unread` note.
 - **Motion**: `*.motion.json` sidecar assertions against the same seeked timeline (see below).
 - **Contrast**: WCAG AA on visible text, sampled at 5 grid points. Failures are **errors** and each finding carries the sampled fg/bg colors, measured vs required ratio, and a suggested compliant color in the same palette direction, so most contrast fixes need no screenshot at all.
 - **Craft**: warnings only, even under `--strict` (a film may break one on purpose), measured on an 8 fps sweep of the whole film and skipped under `--range`. Each message names the fix and the reference to read.
   - `line_unread`: a reading-size line (≥ 30 px tall at 1080) on screen under its floor: 0.4 s for 1–2 words, otherwise ¾ of 0.5 s + 0.3 s a word (3 words 1.05 s, 6 words 1.73 s); the film's last line needs 2 s. Edges are re-measured to ~0.01 s. Captions-track text and `data-layout-ignore` are exempt.
   - `dead_stretch`: more than 3 s where the `keepsMoving` classifier sees nothing change. The final 3 s and any time a `data-hold` element is on screen are exempt; it stays quiet when `sweep_static` fires or a whole-composition `keepsMoving` assertion sets the limit.
   - `text_below_floor`: text under 2.6% of the frame's short side (28 px on 1080) held 0.5 s or more, one finding per file listing every element.
-  - `first_frame_empty`: frame 0 paints nothing but the background (no text, image, video, canvas or svg); it is the thumbnail on social players.
+  - `first_frame_empty`: frame 0 paints nothing but the background (no text, image, video, canvas or svg), or an opaque element covers every other clip and the message names it; it is the thumbnail on social players.
   - `film_silent`: a film over 15 s with no unmuted `<audio>` or audible `<video>`.
 
 Every finding carries a selector, the element's `data-*` identity, the composition source file, a bbox, and the sample time: jump straight from the JSON to the HTML you must edit and re-run.

package/skills/hyperframes-registry/references/contributing.md

@@ -120,7 +120,7 @@ hyperframes render -o preview.mp4
 # Snapshot for visual QA
 hyperframes snapshot --at "1.0,3.0,5.0,7.0"
 
-# Publish to hyperframes.dev for review
+# Publish to hyperframes.studio for review
 npx hyperframes publish
 ```
 
@@ -152,7 +152,7 @@ npx tsx scripts/generate-registry-items.ts
 # 4. Generate catalog docs page
 npx tsx scripts/generate-catalog-pages.ts
 
-# 5. Publish to hyperframes.dev so reviewers can preview
+# 5. Publish to hyperframes.studio so reviewers can preview
 npx hyperframes publish
 
 # 6. Stage everything
@@ -161,9 +161,9 @@ git add registry/{kind}/{name}/ registry/registry.json docs/catalog/
 # 7. Commit
 git commit -m "feat(registry): add {name} — {one sentence}"
 
-# 8. Push and open PR with hyperframes.dev link
+# 8. Push and open PR with hyperframes.studio link
 git push origin feat/registry-{name}
-gh pr create --title "feat(registry): {name}" --body "preview: {hyperframes.dev-url}"
+gh pr create --title "feat(registry): {name}" --body "preview: {hyperframes.studio-url}"
 ```
 
 **If you don't have a GitHub account:** you need one to open a PR. Sign up at https://github.com/signup, then run `gh auth login`.