dsh-hyperframes 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 [返回简介](README.md) · [使用说明](docs/USAGE.md) · [验证记录](docs/VALIDATION.md)
 
+## 0.9.0 (2026-10-26)
+
+- Add this plugin’s own update controls and independent preferences. Automatic installation stays off until explicitly enabled.
+- Confirm manual installs, preserve local sources and disabled state, pause for tasks or unsaved changes, and use native DSH recovery without forced restarts.
+- Require the public DSH 0.2.1-rc.3 update APIs; Suite components remain managed through Suite.
+
+## 0.8.0（2026-10-25）
+
+- 视频主工作台，内容、真实预览、素材和导出记录重新编排；明确区分已保存修订与尚未导出的修改。
+- 提供 DSH 原生侧栏入口，保留设置页；统一中英、深浅色、窄屏、键盘焦点与真实空/失败状态。
+- 浏览器源码移至 templates/client.js、templates/panels/ 与共享组件，独立构建为 lib/client.js；移除重复的首次引导。
+- 官方 DSH 0.2.1-rc.3 Web 逐项实际操作验收，账户模拟和未验收范围见 [工作台说明](docs/WORKBENCH.md)。
+
 ## 0.7.0（2026-10-17）
 
 - 设置面板顶部新增「首次使用」分步引导：一次只讲一步，支持上一步/下一步/跳过，看完记在本机不再出现。

package/README.en.md

@@ -10,6 +10,8 @@ Bring HyperFrames HTML video creation skills into DSH.
 
 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).
+
 ## What it does
 
 - A settings workbench for templates, editable content, media uploads, official Studio preview and local MP4 export.
@@ -30,6 +32,8 @@ dsh plugin --profile desktop add dsh-hyperframes
 
 For the web version, replace `desktop` with `web`. Restart DSH after installation.
 
+For a marketplace `spawn … ENOENT` error, follow the [installation troubleshooting](docs/USAGE.en.md#marketplace-error-spawn--enoent). The npm package name is `dsh-hyperframes`.
+
 ## Start using it
 
 Open Settings → HyperFrames → 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.
@@ -49,6 +53,12 @@ Detailed configuration, tool arguments and troubleshooting are in the [usage gui
 - [Validation scope and history](docs/VALIDATION.md)
 - [Report a problem or suggest a feature](https://github.com/STARDUSTLC666/dsh-hyperframes/issues)
 
+## Plugin updates
+
+Requires DSH 0.2.1-rc.3 or newer. Each plugin provides its own check, release-note and confirmed-install controls on its page or in settings. Preferences are independent. Automatic checks are on by default; **automatic installation is off by default**. Explicitly enabled automatic updates only install compatible stable patches while idle with no unsaved changes. Disable, defer or ignore reminders per plugin. DSH is never restarted or upgraded automatically, and local-source installs are preserved. Suite components clearly direct updates through Suite.
+
+Older releases need one manual update in native plugin management to acquire these controls. Publishing to npm does not replace an existing user installation.
+
 ## License
 
 [MIT](LICENSE). Upstream skill licensing is documented in the usage guide.

package/README.md

@@ -10,6 +10,8 @@
 
 欢迎使用，遇到问题或有改进建议，请提交 [issues](https://github.com/STARDUSTLC666/dsh-hyperframes/issues) 和 [PR](https://github.com/STARDUSTLC666/dsh-hyperframes/pulls)。
 
+更新并重启 DSH 后，可从原生侧栏打开新版工作台，原设置入口继续保留。详见[工作台说明与验收范围](docs/WORKBENCH.md)。
+
 ## 功能
 
 - 设置页视频工作台：选模板、编辑内容、上传素材，在官方 Studio 预览并导出本机 MP4。
@@ -30,6 +32,8 @@ dsh plugin --profile desktop add dsh-hyperframes
 
 网页版把命令中的 `desktop` 改为 `web`。安装后重启 DSH。
 
+插件市场出现 `spawn … ENOENT` 时，按[安装排错](docs/USAGE.md#插件市场报-spawn--enoent)处理。npm 包名是 `dsh-hyperframes`。
+
 ## 开始使用
 
 打开「设置 → HyperFrames」→「新建视频」，填写内容并保存，再上传素材。首次点击「准备渲染环境」下载依赖，完成后启动官方预览，检查画面、停止预览，再导出 MP4。
@@ -49,6 +53,12 @@ dsh plugin --profile desktop add dsh-hyperframes
 - [验证范围与历史记录](docs/VALIDATION.md)
 - [问题反馈与功能建议](https://github.com/STARDUSTLC666/dsh-hyperframes/issues)
 
+## 插件更新
+
+需要 DSH 0.2.1-rc.3 或更新版本。每个插件在自己的页面或设置项提供检查、更新记录与确认安装入口，开关独立保存。自动检查默认开启；**自动安装默认关闭**，只有明确授权后，兼容的稳定补丁才会在空闲且没有未保存修改时安装。可单独关闭、推迟或忽略提醒；不会强制重启 DSH、升级 DSH 本体或替换本地源码安装。Suite 安装的组件会明确提示通过 Suite 整包更新。
+
+旧版用户先在官方插件管理中手动更新一次，之后才会获得此入口。发布到 npm 不会直接替换用户已经安装的版本。
+
 ## License
 
 [MIT](LICENSE)。上游技能内容的来源和许可证见使用说明。

package/docs/USAGE.en.md

@@ -14,6 +14,24 @@ dsh plugin --profile web add dsh-hyperframes
 
 After restarting, say "turn this website into a HyperFrames video" to trigger it.
 
+### Marketplace error `spawn … ENOENT`
+
+The `spawn … DSH Desktop.exe ENOENT` reported in [#2](https://github.com/STARDUSTLC666/dsh-hyperframes/issues/2) occurs while the installer launches the host CLI. A missing executable and a missing child working directory can both produce this error; that line alone does not distinguish them.
+
+Hub 1.6.5 uses the target profile directory as the working directory even when it does not exist. [Hub 1.6.12](https://github.com/dshplugin/dsh-plugin-hub/blob/v1.6.12/src/server/services/install/task-queue.ts) adds a directory fallback and a separate host launch failure hint. See the matching upstream report, [Hub #212](https://github.com/dshplugin/dsh-plugin-hub/issues/212).
+
+1. Fully exit DSH, including the tray application, then launch it from its actual installation location. Repair or reinstall Desktop if it was moved or executable files are missing after an update; retain your existing user data.
+2. Update Plugin Hub to **1.6.12 or newer**, preferably through the Plugins panel. Alternatively, run the following in DSH's built-in terminal. This example preserves the `web` profile from #2; manage a `desktop` profile through Desktop's own terminal or Plugins panel.
+
+   ```bash
+   dsh plugin --profile web add dsh-plugin@latest
+   dsh plugin --profile web add dsh-hyperframes
+   ```
+
+3. Restart DSH and check Settings → HyperFrames. Use the same `DSH_HOME`; a regular terminal's default `~/.dsh` may differ from Desktop's user directory. Compare it with `DSH Home` in the Hub report.
+
+The published npm package is **`dsh-hyperframes`**; `@stardustlc/dsh-hyperframes` is not published. Installing through `dsh plugin` also registers the plugin bundle, which a plain `pnpm add` does not replace. If it still fails, include the current Hub version, full `hub.log` and the command actually executed.
+
 ## Uninstall
 
 ```bash

package/docs/USAGE.md

@@ -14,6 +14,24 @@ dsh plugin --profile web add dsh-hyperframes
 
 重启后说「把这个网址做成 HyperFrames 视频」即可触发。
 
+### 插件市场报 `spawn … ENOENT`
+
+[#2](https://github.com/STARDUSTLC666/dsh-hyperframes/issues/2) 报告的 `spawn … DSH Desktop.exe ENOENT` 发生在安装器启动宿主 CLI 时。可执行文件不存在、子进程工作目录不存在都可能产生这个错误；仅凭这一行无法区分。
+
+Hub 1.6.5 在目标 profile 目录尚未创建时仍把它用作工作目录。[Hub 1.6.12](https://github.com/dshplugin/dsh-plugin-hub/blob/v1.6.12/src/server/services/install/task-queue.ts) 已增加目录回退，并为宿主启动失败提供单独提示。上游的同类报告见 [Hub #212](https://github.com/dshplugin/dsh-plugin-hub/issues/212)。
+
+1. 完全退出 DSH（包括托盘），从实际安装位置重新打开。若程序已被移动、升级后文件缺失，先修复或重新安装 Desktop，保留原有用户资料。
+2. 将 Plugin Hub 更新到 **1.6.12 或更新版本**。优先使用插件面板的更新功能；也可在 DSH 内置终端执行下面的命令。下例沿用 #2 的 `web` profile，桌面 profile 应使用 `desktop`，并通过 Desktop 自带的终端或插件面板管理。
+
+   ```bash
+   dsh plugin --profile web add dsh-plugin@latest
+   dsh plugin --profile web add dsh-hyperframes
+   ```
+
+3. 重启 DSH 后检查「设置 → HyperFrames」。命令必须使用同一个 `DSH_HOME`；普通终端默认的 `~/.dsh` 可能与 Desktop 使用的用户目录不同，可对照 Hub 报告中的 `DSH Home`。
+
+npm 包名是 **`dsh-hyperframes`**，`@stardustlc/dsh-hyperframes` 未发布。使用 `dsh plugin` 安装会同时登记插件 bundle，单独 `pnpm add` 不能代替这一步。若仍失败，请附上当前 Hub 版本、完整 `hub.log` 和实际执行的命令。
+
 ## 卸载
 
 ```bash

package/docs/VALIDATION.md

@@ -2,6 +2,8 @@
 
 [0.5.1 中英文界面验收](validation-language-2026-10-03.md)。
 
+[Windows 安装排错与真实安装验收（2026-10-18）](validation-install-2026-10-18.md)。
+
 本页整理原 README 的历史验证说明，保留当时的版本、日期与范围。自动测试、启动检查、浏览器操作和真实服务验收分别记录，不能相互替代。更详细的版本验收文件仍保留在仓库中。
 
 ## 0.5.0 视频工作台（2026-10-03）

package/docs/WORKBENCH.md

@@ -0,0 +1,29 @@
+# dsh-hyperframes 工作台 / Workbench
+
+视频主工作台，内容、真实预览、素材和导出记录重新编排；明确区分已保存修订与尚未导出的修改。
+
+Video workbench with content, real preview, media and exports; distinguishes saved revisions from changes not yet rendered.
+
+## 使用 / Use
+
+更新插件并重启 DSH，在原生左侧栏打开工作台；没有固定时可在“更多”中找到。原有“设置”入口继续可用。侧栏排序和固定由 DSH 管理。
+
+Update the plugin, restart DSH and open its native sidebar panel (or More if it is not pinned). The existing Settings entry remains available. DSH owns sidebar order and pinning.
+
+界面跟随宿主中英文和深浅色，保留用户内容原文。窄窗口中先显示列表，打开详情后可返回；编辑器按可用宽度分栏或顺序排列。危险操作需要明确确认，未保存内容不会因切页而静默丢失。
+
+The UI follows host language and theme without translating user content. Narrow master/detail views have a Back action; editors adapt their columns to available space. Destructive actions require confirmation and edits are protected.
+
+## 源码 / Source
+
+编辑 templates/client.js、templates/panels/*.js 与 templates/workbench-ui.js，运行 pnpm run build。lib/client.js 是确定性产物，请随源码提交。公共组件的规范源位于 dsh-suite/ui/workbench-ui.js，Suite 的同步脚本显式分发副本；单个仓库可独立构建和安装。
+
+Edit the template sources and run pnpm run build. Commit generated lib/client.js with source changes. The vendored UI has no Suite runtime dependency.
+
+## 验收范围 / Validation boundary
+
+2026-10-25：Windows、官方 DSH 0.2.1-rc.3 Web，后台 Chrome/Playwright 实际点击和输入；覆盖中英文、浅深色、1536px 与 390px、状态读回与控制台。Browser plugin 不可用，因此使用本地 Playwright。
+
+邮件使用受控 AgentMail HTTP 服务，日历使用受控 CalDAV 协议传输；插件处理器、存储、校验和原生宿主均实际运行。未使用真实邮箱、真实日历账号或付费模型。RSS 访问 Node.js 官方公开来源。PPT 实际生成并渲染 PPTX、下载 ZIP；两个视频插件实际运行官方引擎并播放 MP4。
+
+这些是 Web 共用界面的验收结果，不代表已验收 Electron 专属菜单、系统权限、真实账号、全部外部来源或所有可选模型/引擎。Docker、Slack、钉钉继续按用户约定搁置。

package/docs/validation-install-2026-10-18.md

@@ -0,0 +1,27 @@
+# Windows 安装排错验证（2026-10-18）
+
+[使用与排错](USAGE.md#插件市场报-spawn--enoent) · [Issue #2](https://github.com/STARDUSTLC666/dsh-hyperframes/issues/2)
+
+环境：Windows x64、Node 24.16.0、官方 npm `@deepseek-ai/dsh@0.2.0-rc.2`。安装使用公开 npm 包，独立 `DSH_HOME` 和含空格的路径。
+
+| 检查 | 结果 |
+| :-- | :-- |
+| npm 包名 | `dsh-hyperframes` 存在；原回复中的 `@stardustlc/dsh-hyperframes` 返回 404 |
+| Hub 1.6.5 worker，目标 profile 目录不存在 | 可执行文件存在，仍报 `spawn … ENOENT`，CLI 未启动 |
+| Hub 1.6.12 worker，同样的初始目录 | CLI 启动，自动创建 profile，安装退出码 0 |
+| Hub 完整 `startPluginMutation` 队列，宿主可执行文件不存在 | 任务失败，报 ENOENT，CLI 未启动 |
+| 同一完整队列恢复有效宿主入口后重试 | 任务完成，退出码 0，公开插件包安装成功 |
+| bundle 与分发物 | profile 登记 `dsh-hyperframes`，pnpm 锁文件 integrity 与官方 npm 对应版本一致 |
+| 实际宿主启动 | 官方 CLI 启动 Web，注册 3 个 HyperFrames 工具，21 个插件技能自检全部通过 |
+| HTTP 鉴权 | 启动 token 换取 cookie 返回 303；未登录访问返回 401；携 cookie 访问 HTML 返回 200 |
+
+本次默认安装实际解析到 **0.6.0**。npm 最新的 0.7.0 仅确认元数据存在，不计为本轮已安装验收版本。
+
+## 证据边界
+
+- worker 的目录对比直接调用真实 `runPluginMutation`，验证缺失工作目录的行为；正常队列的默认日志可能先创建 profile 目录，因此不能据此判定报告者命中了该路径。
+- 完整队列测试调用真实 `startPluginMutation`，包含日志、排队、子进程与终态处理。
+- Electron 的 asar 布局使用目录夹具，宿主启动器使用真实 Node 和官方 CLI 的 `runCli`。没有执行报告者电脑上的 Desktop，也没有做原生 Desktop 窗口验收。
+- 本轮验证安装、注册、自检和 Web 启动；未重复执行视频渲染验收。
+
+上游修复依据：[1.6.5 安装器源码](https://github.com/dshplugin/dsh-plugin-hub/blob/v1.6.5/src/server/services/install/task-queue.ts)、[1.6.12 安装器源码](https://github.com/dshplugin/dsh-plugin-hub/blob/v1.6.12/src/server/services/install/task-queue.ts)、[Hub #212 的维护者说明](https://github.com/dshplugin/dsh-plugin-hub/issues/212#issuecomment-6192085277)。