dsh-remotion 0.3.4 → 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# 更新记录
+
+[返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
+
+## 0.4.1 (2026-10-03)
+
+- 视频工作台后台错误与任务阶段支持英文；切换语言重新展示失败引导，项目文字和原始引擎日志保留原文。
+- 验收范围见 [中英文界面检查](docs/validation-language-2026-10-03.md)。
+
+## 0.4.0 (2026-10-03)
+
+- 新增视频工作台、三种模板、素材副本上传、官方 Studio 预览、本机 MP4 与可编辑 ZIP 备份。
+- 新增修订冲突检查、旧成片提示、任务记录与取消；首次环境准备使用固定版本官方 CLI 4.0.532。
+- 保留现有上游技能；模板与工作台为本仓库原创实现。
+
+## 0.3.4 (2026-09-28)
+
+- 更新官方 Harness 0.2.0-rc.1 的兼容声明和共同加载验证；运行时代码未变。验证范围见[验证记录](docs/VALIDATION.md)。
+
+## 0.3.3 (2026-09-28)
+
+- 同步 Remotion 官方 v4.0.529 的技能内容，保留来源与许可证。
+
+## 更早的改动
+
+完整历史可查阅 [GitHub 提交记录](https://github.com/STARDUSTLC666/dsh-remotion/commits/master)。

package/README.en.md

@@ -1,89 +1,50 @@
-[中文](README.md)
-
-![npm](https://img.shields.io/npm/v/dsh-remotion) ![downloads](https://img.shields.io/npm/dm/dsh-remotion) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-remotion) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-remotion?style=social)
-
 # dsh-remotion
 
-[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+[中文](README.md)
 
-DSH (DeepSeek Harness) video-creation skill plugin: installing it registers the official Remotion skill into DSH (programmatic video with React: animation, audio, captions, 3D, charts, fonts; synced with the official Remotion v4.0.529 twelve-skill structure).
+Bring Remotion React video creation skills into DSH.
 
-## Compatibility
+[![npm](https://img.shields.io/npm/v/dsh-remotion)](https://www.npmjs.com/package/dsh-remotion) [![downloads](https://img.shields.io/npm/dm/dsh-remotion)](https://www.npmjs.com/package/dsh-remotion)
 
-Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 23 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 12 skills and 1 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.
+## What it does
 
-## Installation
+- A settings workbench for templates, editable content, media uploads, official Studio preview and local MP4 export.
+- Title card, product card and slideshow templates in landscape, portrait or square format.
+- Editable project backups, cancellable jobs and a warning when an MP4 uses an older revision.
 
-```bash
-dsh plugin --profile web add dsh-remotion
-```
+- Cover animation, audio, captions, charts and 3D scenes.
+- Guide project creation, Studio preview and rendering.
+- Preserve upstream skills and provide runtime health checks.
 
-After restarting, say "make a video with Remotion" to trigger it.
+## Install
 
-## Uninstall
+In DSH Desktop, install `dsh-remotion` from the Plugins panel. If the bundled dsh command is available:
 
 ```bash
-dsh plugin --profile web remove dsh-remotion
+dsh plugin --profile desktop add dsh-remotion
 ```
 
-Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
-
-
-## Contents
-
-- **remotion-best-practices** (router hub) + 11 domain skills (captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade), synced from official Remotion v4.0.529
-
-## Requirements
-
-Node.js ≥ 22 + npx (npm registry); rendering needs ffmpeg (guided by the skill itself).
-
-## Porting notes
-
-Synced from the official `remotion-dev/skills` checkout at v4.0.529 (2026-09-25): upstream skill bodies are vendored as-is, including the embedded reference copies under `remotion-best-practices/` and `remotion-markup/`, with `scripts/sync-skills.mjs` making the port repeatable and checkable. Only the frontmatter is ours (`name`/`description` plus the upstream `version`).
+For the web version, replace `desktop` with `web`. Restart DSH after installation.
 
-## Multi-harness
+## Start using it
 
-Skills use the open Agent Skills (SKILL.md) format — **not just DSH**. Copy the directories under `skills/` into another agent's skills directory:
+Open Settings → Remotion → New video. Save your content, then upload media. Prepare the render environment on first use, inspect the official Studio preview, stop it and export MP4.
 
-| Agent | Skills directory |
-| :-- | :-- |
-| Claude Code | `~/.claude/skills/` |
-| Cursor | `.cursor/skills/` (or project-local `skills/`) |
-| Gemini CLI | `~/.gemini/skills/` |
-| OpenAI Codex | `~/.codex/skills/` |
+Ask: “Make a Remotion video from these assets, preview it in Studio, then export MP4.”
 
-Port once, use everywhere.
+## Requirements and configuration
 
+The plugin preserves upstream skills and adds a local workbench. First use needs Node.js 22.19+ / 24+ and npm; Remotion retains its [official license](https://www.remotion.dev/license). Dependencies are downloaded only when you explicitly prepare the environment.
 
-## Health checks and reloads
+Detailed configuration, tool arguments and troubleshooting are in the [usage guide](docs/USAGE.en.md). For standalone development, follow the Node requirement in [package.json](package.json).
 
-`remotion_health` rereads every `SKILL.md`, verifies readable files, valid YAML frontmatter, names matching their directories, and nonempty descriptions/bodies, then queries the host's `skills.get`. The effective name, description, body and resource directory must match this plugin instance's loaded snapshot. Existing files alone do not prove successful or still-active registration.
-
-Health checks do not mutate files or registrations. After changing a file or repairing one that failed initial loading, reload the plugin (or restart DSH). The result reports `changed`, `not_registered` or `registration_failed` until then. A previously loaded file that was temporarily missing becomes healthy again if its exact original content is restored and its registration remains active.
-
-Each item retains `name / ok / detail` and adds `code / fileOk / registered / registryChecked / reloadRequired`. `registered` means the registry still matches the loaded version, so a changed file can have `registered: true` and `ok: false`. Missing or failed registry lookup produces `registry_unavailable`; a disposed plugin produces `disposed`. The public `checkBundledSkills()` is disk-only, while the original non-throwing `parseSkillFile()` helper remains available.
-
-## Development and shared implementation
-
-`src/index.ts` declares only package identity, skill names and the resource directory. Parsing, validation, registration and health logic live in `src/skill-bundle.ts`. The canonical source is in `dsh-hyperframes`; Remotion carries an identical version-controlled copy. Each package builds and ships its own `lib/skill-bundle.js`, with no cross-package runtime dependency and no sibling checkout required for building or installation.
-
-With dependencies already installed:
-
-```bash
-node node_modules/typescript/bin/tsc -p tsconfig.json
-node --test "test/*.test.mjs"
-```
-
-When developing the sibling repositories together, edit the shared module and regression tests in HyperFrames, then synchronize:
-
-```bash
-# Run in dsh-hyperframes; updates only three shared files in sibling dsh-remotion
-node scripts/sync-skill-bundle.mjs
-node scripts/sync-skill-bundle.mjs --check
-```
+## Documentation
 
-Both suites compare shared source and regression tests to prevent drift. A standalone checkout skips only that cross-repository comparison. Tests cover invalid YAML, unreadable files, empty bodies, rejected/inactive registrations, file changes and repairs, disposal races and cleanup failures, without invoking video or speech services.
+- [Usage and troubleshooting](docs/USAGE.en.md)
+- [Changelog](CHANGELOG.md)
+- [Validation scope and history](docs/VALIDATION.md)
+- [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-remotion/issues)
 
 ## License
 
-MIT for the porting arrangement; skill content copyright remains with Remotion.
+[MIT](LICENSE). Upstream skill licensing is documented in the usage guide.

package/README.md

@@ -1,92 +1,50 @@
-[English](README.en.md)
-
 # dsh-remotion
 
-> **在 20+ 个 agent 里写视频**：Remotion 官方技能，React 编程式视频。
-
-![npm version](https://img.shields.io/npm/v/dsh-remotion?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-remotion) ![license](https://img.shields.io/npm/l/dsh-remotion) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-remotion?style=social)
+[English](README.en.md)
 
-[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+把 Remotion 的 React 视频创作技能接入 DSH。
 
+[![npm](https://img.shields.io/npm/v/dsh-remotion)](https://www.npmjs.com/package/dsh-remotion) [![downloads](https://img.shields.io/npm/dm/dsh-remotion)](https://www.npmjs.com/package/dsh-remotion)
 
-DSH（DeepSeek Harness）视频创作技能插件：**安装即把 Remotion 官方移植技能注册进 DSH**（React 编程式视频：动画、音频、字幕、3D、图表、字体等；同步 Remotion 官方 v4.0.529 的 12 技能结构）。
+## 功能
 
-## 兼容性
+- 设置页视频工作台：选模板、编辑内容、上传素材，在官方 Studio 预览并导出本机 MP4。
+- 提供标题卡、产品介绍、图文轮播；支持横屏、竖屏和正方形。
+- 保留可编辑工程备份、渲染记录与取消操作；工程修改后提醒重新导出。
 
-验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。23 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 12 个技能、1 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
+- 提供动画、音频、字幕、图表和 3D 场景指引。
+- 覆盖项目创建、Studio 预览与渲染流程。
+- 保留官方技能内容与运行时自检。
 
 ## 安装
 
-```bash
-dsh plugin --profile web add dsh-remotion
-```
-
-重启后说「用 Remotion 做个视频」即可触发。
-
-## 卸载
+桌面版可在「插件」面板按包名 `dsh-remotion` 安装。已配置 dsh 命令时也可使用：
 
 ```bash
-dsh plugin --profile web remove dsh-remotion
+dsh plugin --profile desktop add 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.529
-
-## 依赖
-
-Node.js ≥ 22 + npx（npm registry）；渲染需 ffmpeg（Remotion 自带指引）。
-
-## 移植说明
+网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
 
-技能同步自官方 `remotion-dev/skills` 检出 v4.0.529（2026-09-25）：上游正文原样引入（含 `remotion-best-practices/`、`remotion-markup/` 下的内嵌引用副本），仅把 frontmatter 换成本包的 `name`/`description` + 上游 `version`；`scripts/sync-skills.mjs` 让移植可复现、可校验（`--check`）。
+## 开始使用
 
-## 跨平台使用
+打开「设置 → Remotion」→「新建视频」，填写内容并保存，再上传素材。首次点击「准备渲染环境」下载依赖，完成后启动官方预览，检查画面、停止预览，再导出 MP4。
 
-技能采用开放的 Agent Skills（SKILL.md）格式，**不止 DSH 能用**——把 `skills/` 下的目录复制到其他 agent 的技能目录即可：
+可说：“用 Remotion 把这些素材做成视频，先在 Studio 预览，再导出 MP4。”
 
-| Agent | 技能目录 |
-| :-- | :-- |
-| Claude Code | `~/.claude/skills/` |
-| Cursor | `.cursor/skills/`（或项目内 `skills/`）|
-| Gemini CLI | `~/.gemini/skills/` |
-| OpenAI Codex | `~/.codex/skills/` |
+## 依赖与配置
 
-一次移植，处处可用。
+插件保留上游技能，并新增本地视频工作台。首次使用需 Node.js 22.19+ / 24+ 与 npm；Remotion 渲染器的使用条件见 [官方许可证](https://www.remotion.dev/license)。不会在 DSH 启动时自动下载依赖。
 
+详细配置、工具参数与排错见[使用说明](docs/USAGE.md)。从源码独立开发时，Node 要求以 [package.json](package.json) 为准。
 
-## 技能自检与重载
-
-运行 `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`，没有跨包运行时依赖，也不需要另一个仓库即可构建或安装。
-
-依赖预先安装后，可直接离线构建和测试：
-
-```bash
-node node_modules/typescript/bin/tsc -p tsconfig.json
-node --test "test/*.test.mjs"
-```
-
-两个仓库并列开发时，在 HyperFrames 修改公共模块与公共回归测试，再同步：
-
-```bash
-# 在 dsh-hyperframes 中执行；只更新相邻 dsh-remotion 的三个公共文件
-node scripts/sync-skill-bundle.mjs
-node scripts/sync-skill-bundle.mjs --check
-```
+## 文档
 
-两包测试都会检查公共源码与回归测试是否一致，防止副本漂移；单独检出时只跳过跨仓库比对，其余测试正常运行。测试覆盖损坏 YAML、不可读文件、空正文、注册异常/失效、内容变更与修复、卸载及清理异常，全程不调用视频或语音服务。
+- [使用与排错](docs/USAGE.md)
+- [更新记录](CHANGELOG.md)
+- [验证范围与历史记录](docs/VALIDATION.md)
+- [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-remotion/issues)
 
 ## License
 
-MIT（移植编排）；技能内容版权归 Remotion。
+[MIT](LICENSE)。上游技能内容的来源和许可证见使用说明。

package/docs/USAGE.en.md

@@ -0,0 +1,93 @@
+# dsh-remotion usage guide
+
+[Overview](../README.en.md) · [Changelog](../CHANGELOG.md) · [Validation](VALIDATION.md)
+
+## Installation
+
+```bash
+dsh plugin --profile web add dsh-remotion
+```
+
+After restarting, say "make a video with Remotion" to trigger it.
+
+## Uninstall
+
+```bash
+dsh plugin --profile web remove dsh-remotion
+```
+
+Then restart the web service. To clean up fully, also remove the plugin entry from your profile `cordis.patch.yml` if you overrode it.
+
+## Video workbench
+
+Open Settings → Remotion in DSH Web or Desktop.
+
+1. Create a video. Select title card, product card or slideshow; set title/body, canvas and 3–30 seconds, then save.
+2. Upload local PNG/JPEG copies, one MP3/WAV background audio and one muted MP4 background video. Limits: 20 MB each, 40 MB total. Slideshow follows upload order and needs at least two seconds per image.
+3. Explicitly prepare the environment. It downloads official CLI 4.0.532; installed Chrome is reused, with a browser download only when needed. You can continue editing during preparation. Check the [official Remotion license](https://www.remotion.dev/license) for your use case.
+4. Start official Studio and inspect the picture. Stop this preview before editing or exporting; no window opens automatically.
+5. Export, play and download MP4. Editing preserves earlier MP4s with a revision warning; export again for a new output.
+
+The editable ZIP includes source, data and media. Extract it, run npm install and npm run preview / render. Original template code is MIT; engines retain their own licenses. ZIP import is not yet available in settings.
+
+Projects and caches stay in DSH_HOME/data/dsh-remotion. Original assets and existing user projects are untouched. Closing settings preserves input within this page; saved projects survive restart, while active jobs stop with DSH. Jobs can be cancelled. Tools: remotion_project (list/create/get/update), remotion_render (prepare/preview/render/job/cancel). Updates/rendering need id/revision; job/cancel need job id.
+
+This is template editing, without a full timeline, transcription, TTS or cloud rendering. Default: 24 FPS, maximum 200 MB MP4. Preview listens on 127.0.0.1 only; other users on the same machine may still reach the service.
+
+## Contents
+
+- **remotion-best-practices** (router hub) + 11 domain skills (captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade), synced from official Remotion v4.0.529
+
+## Requirements
+
+Node.js `^22.19.0 || >=24.0.0` + npx (npm registry); rendering needs ffmpeg (guided by the skill itself).
+
+## Porting notes
+
+Synced from the official `remotion-dev/skills` checkout at v4.0.529 (2026-09-25): upstream skill bodies are vendored as-is, including the embedded reference copies under `remotion-best-practices/` and `remotion-markup/`, with `scripts/sync-skills.mjs` making the port repeatable and checkable. Only the frontmatter is ours (`name`/`description` plus the upstream `version`).
+
+## 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.
+
+## Health checks and reloads
+
+`remotion_health` rereads every `SKILL.md`, verifies readable files, valid YAML frontmatter, names matching their directories, and nonempty descriptions/bodies, then queries the host's `skills.get`. The effective name, description, body and resource directory must match this plugin instance's loaded snapshot. Existing files alone do not prove successful or still-active registration.
+
+Health checks do not mutate files or registrations. After changing a file or repairing one that failed initial loading, reload the plugin (or restart DSH). The result reports `changed`, `not_registered` or `registration_failed` until then. A previously loaded file that was temporarily missing becomes healthy again if its exact original content is restored and its registration remains active.
+
+Each item retains `name / ok / detail` and adds `code / fileOk / registered / registryChecked / reloadRequired`. `registered` means the registry still matches the loaded version, so a changed file can have `registered: true` and `ok: false`. Missing or failed registry lookup produces `registry_unavailable`; a disposed plugin produces `disposed`. The public `checkBundledSkills()` is disk-only, while the original non-throwing `parseSkillFile()` helper remains available.
+
+## Development and shared implementation
+
+`src/index.ts` declares only package identity, skill names and the resource directory. Parsing, validation, registration and health logic live in `src/skill-bundle.ts`. The canonical source is in `dsh-hyperframes`; Remotion carries an identical version-controlled copy. Each package builds and ships its own `lib/skill-bundle.js`, with no cross-package runtime dependency and no sibling checkout required for building or installation.
+
+With dependencies already installed:
+
+```bash
+node node_modules/typescript/bin/tsc -p tsconfig.json
+node --test "test/*.test.mjs"
+```
+
+When developing the sibling repositories together, edit the shared module and regression tests in HyperFrames, then synchronize:
+
+```bash
+# Run in dsh-hyperframes; updates only three shared files in sibling dsh-remotion
+node scripts/sync-skill-bundle.mjs
+node scripts/sync-skill-bundle.mjs --check
+```
+
+Both suites compare shared source and regression tests to prevent drift. A standalone checkout skips only that cross-repository comparison. Tests cover invalid YAML, unreadable files, empty bodies, rejected/inactive registrations, file changes and repairs, disposal races and cleanup failures, without invoking video or speech services.
+
+## License
+
+MIT for the porting arrangement; skill content copyright remains with Remotion.

package/docs/USAGE.md

@@ -0,0 +1,97 @@
+# dsh-remotion 使用说明
+
+[返回简介](../README.md) · [更新记录](../CHANGELOG.md) · [验证记录](VALIDATION.md)
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-remotion
+```
+
+重启后说「用 Remotion 做个视频」即可触发。
+
+## 卸载
+
+```bash
+dsh plugin --profile web remove dsh-remotion
+```
+
+卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。
+
+## 视频工作台
+
+在桌面或 Web 的「设置 → Remotion」中操作：
+
+1. 新建视频，选择标题卡、产品介绍或图文轮播，填写标题/正文、画幅和 3–30 秒时长，明确保存。
+2. 上传 PNG/JPEG、一个背景音频（MP3/WAV）、一个静音背景视频（MP4）的副本。每个文件最多 20 MB、总计 40 MB；轮播按上传顺序，每张至少两秒。
+3. 首次点击「准备渲染环境」。此时下载固定版本官方 CLI 4.0.532，优先使用已安装的 Chrome，没有时再下载浏览器；可以继续编辑工程。下载失败保留工程，查看运行记录后重试。使用前确认 [Remotion 官方许可证](https://www.remotion.dev/license)适合你的用途。
+4. 启动官方 Studio，检查画面。停止本次预览后再编辑或导出；不会自动打开或占用前台窗口。
+5. 导出 MP4、在工作台播放并下载。工程更新后保留旧成品并显示旧修订提醒；再次导出即可生成新成片。
+
+「备份可编辑工程」包含源代码、项目数据和素材。解压后按 README 使用 npm install、npm run preview / render；原模板代码 MIT，渲染器保留自己的许可证。
+
+工程、素材、运行目录和依赖缓存默认位于 DSH_HOME/data/dsh-remotion，两个插件分别保存。使用同一个 DSH_HOME 的 Web 与桌面 profile 共享这些已保存工程。不会改写原始素材或用户已有视频工程。关闭设置后，当前输入和任务状态保留在本次页面；刷新页面会提示未保存输入，已保存工程长期保留。任务可取消，关闭 DSH 会停止本插件任务。备份 ZIP 目前不支持在设置页导回。
+
+智能体工具：remotion_project（list/create/get/update）；remotion_render（prepare/preview/render/job/cancel）。渲染与更新需要工程 id 和当前 revision；查询/取消使用 job id。工具不会默认下载依赖。
+
+## 使用限制
+
+本轮为轻量模板编辑，尚不提供时间轴编辑、字幕转写、TTS 或云端渲染。外部链接不能作为素材路径；请先保存到本地再上传。默认 24 FPS，成品上限 200 MB。预览仅监听 127.0.0.1，属于本机服务；多用户机器仍需考虑同机访问。
+
+## 技能内容
+
+- **remotion-best-practices**（总纲路由）+ 11 个领域技能（captions/create/docs/interactivity/maps/markup/multimedia/render/saas/studio/upgrade），同步自 Remotion 官方 v4.0.529
+
+## 依赖
+
+Node.js `^22.19.0 || >=24.0.0` + npx（npm registry）；渲染需 ffmpeg（Remotion 自带指引）。
+
+## 移植说明
+
+技能同步自官方 `remotion-dev/skills` 检出 v4.0.529（2026-09-25）：上游正文原样引入（含 `remotion-best-practices/`、`remotion-markup/` 下的内嵌引用副本），仅把 frontmatter 换成本包的 `name`/`description` + 上游 `version`；`scripts/sync-skills.mjs` 让移植可复现、可校验（`--check`）。
+
+## 跨平台使用
+
+技能采用开放的 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`，没有跨包运行时依赖，也不需要另一个仓库即可构建或安装。
+
+依赖预先安装后，可直接离线构建和测试：
+
+```bash
+node node_modules/typescript/bin/tsc -p tsconfig.json
+node --test "test/*.test.mjs"
+```
+
+两个仓库并列开发时，在 HyperFrames 修改公共模块与公共回归测试，再同步：
+
+```bash
+# 在 dsh-hyperframes 中执行；只更新相邻 dsh-remotion 的三个公共文件
+node scripts/sync-skill-bundle.mjs
+node scripts/sync-skill-bundle.mjs --check
+```
+
+两包测试都会检查公共源码与回归测试是否一致，防止副本漂移；单独检出时只跳过跨仓库比对，其余测试正常运行。测试覆盖损坏 YAML、不可读文件、空正文、注册异常/失效、内容变更与修复、卸载及清理异常，全程不调用视频或语音服务。
+
+## License
+
+MIT（移植编排）；技能内容版权归 Remotion。

package/docs/VALIDATION.md

@@ -0,0 +1,24 @@
+# dsh-remotion 验证记录
+
+[0.4.1 中英文界面验收](validation-language-2026-10-03.md)。
+
+本页整理原 README 的历史验证说明，保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录，不能相互替代。更详细的版本验收文件仍保留在仓库中。
+
+## 0.4.0 视频工作台（2026-10-03）
+
+- Windows、Node 24.16.0：39 项测试全部通过，无跳过。覆盖工程修订冲突、素材限制、快照、路径与请求校验、渲染失败、取消及退出清理。
+- 官方 Harness 0.2.0-rc.2（639ed01）Web：实际完成新建、保存、上传图片/音频/背景视频、准备环境、启动/停止官方 Studio、导出、播放及下载源工程和 MP4。关闭设置后未保存输入保留；并发修改会提示冲突，明确放弃后才读取新版本。中文/英文和 390px 窄窗口均检查。
+- 官方 Remotion 4.0.532：实际生成标题卡 1280×720 和产品介绍 720×720 两份 H.264/AAC MP4，均为约 6 秒、24 FPS、144 帧。检查成片中文、图片与背景视频，并在浏览器播放到结尾。Studio 检查了画布、帧率、时长和时间轴。
+- 原素材保留，上传的是工作台副本；旧成片按其实际修订展示。导出失败不产生成功收据。
+- 生产依赖审计使用官方 npm registry，结果为 0 项漏洞；不把自动测试或网页验收当作原生桌面窗口操作验收。
+- 官方公开 npm 安装的 Harness 0.2.1-alpha.1：18 个独立插件同载的注册与输出检查通过（109 个工具、35 个技能、TypeScript/Python PTC 声明）；保存的工作台工程和环境正常恢复，并再次实际导出 720×720 的产品介绍 MP4。
+
+边界：这一版本的新工作台尚未在原生桌面窗口中逐项操作；Linux/macOS 的真实浏览器渲染、任意长文本与用户自有素材的最终成片不属于本次验收。原始模板为 MIT，Remotion 依赖遵循它自己的许可条件。
+
+## 原中文记录
+
+验证宿主：官方源码构建的 Harness `0.2.0-rc.1`（commit `407e65c8`）+ Node `24.16.0`（2026-09-28）。23 项插件测试在隔离环境全部通过；同一个宿主里 18 个插件共同加载，注册 12 个技能、1 个工具，工具 schema 与健康检查契约通过。本轮未启用真实端口与外部服务。
+
+## Original English record
+
+Validation host: Harness `0.2.0-rc.1` built from official sources (commit `407e65c8`) with Node `24.16.0` on 2026-09-28. All 23 plugin tests pass in an isolated environment; all 18 plugins mount together in one host registering 12 skills and 1 tools, with tool schemas and health-check contracts passing. No live ports or external services were exercised in this round.

package/docs/validation-language-2026-10-03.md

@@ -0,0 +1,16 @@
+# 0.4.1：中英文界面验收
+
+2026-10-03，Windows / Node 24.16.0。采用 E 盘独立 DSH_HOME、合成资料与无密钥 profile；用户资料、账号、密钥、桌面窗口与 VPN 保持原状。
+
+- 自动测试：39 项全部通过。
+- 可见 Web 操作：英文界面超长标题保存被拒绝，提示说明 72 字符上限并保留输入；改为合法中文标题后成功保存。中文界面恢复同一修订的项目和正文。
+- 宿主：官方 DSH 0.2.1-alpha.1 Web；官方 RC2 与 alpha SDK 同载 18 组件，110 工具、35 插件技能、19 输出样例注册与 schema 检查通过。无账号的健康结果不代表真实连接。
+- 边界：本轮没有重新渲染 MP4，渲染和 Studio 的实际验收见 0.4.0 记录。原始引擎日志保持原文。
+
+中英文共用同一份资料；界面翻译不会改写标题、正文、路径、引用或项目文件。系统文件选择控件和文件对话框跟随 Windows / 浏览器语言。未知技术诊断与原始引擎日志保留原文；英文界面提供操作恢复引导。
+
+此记录不代表原生桌面窗口内的新功能已逐项操作通过。发布包完整性、GitHub CI 与公开 npm 全新安装在发布时另行核对。
+
+## English scope
+
+The Chinese and English UI share the same data. UI translation preserves original content, paths and project files. Visible interactions were performed in an isolated official alpha Web profile; both RC2 and alpha SDK registration/schema checks passed. Native file controls use the OS/browser language, and original diagnostic logs are retained. Browser results do not certify native desktop interaction or real-service delivery.