dsh-motion-ui 0.8.7 → 0.8.9

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # DSH Motion UI
 
+## 0.8.9 — 2026-10-31
+
+### DSH 兼容性
+
+- 支持 DSH Web / Desktop 0.2.1-rc.4 和 0.2.1-rc.5，保留此前声明的宿主版本。
+- 将开发 SDK 更新到 rc.5 并重新构建客户端；本插件未使用宿主本次调整的推理内容展示接口。
+- 149 项单元与集成测试及 29 项发布验证通过；rc.4、rc.5 隔离 Web 宿主的安装和插件页面检查通过。本次未实测原生 Desktop。
+
 ## 0.8.7 — 2026-10-18
 
 ### 补齐原生组件的皮肤兼容
@@ -118,7 +126,7 @@
 
 ### 验证
 
-148 项单元/集成测试、24 组构建与浏览器回归，以及 18 项播放器检查。Desktop 原生通道额外验证了真实鼠标拖动、解码帧时间、画面像素变化、播放状态和离开页面后的资源释放，未仅以进度数字变化判定成功。
+148 项单元/集成测试、24 组构建与浏览器回归，以及 18 项播放器检查。Desktop 原生通道额外验证了真实鼠标拖动、解码帧时间、画面像素变化、播放状态和离开页面后的资源释放，未仅以进度数字变化判定成功。
 
 
 ## 0.8.0 — 2026-10-17

package/DESIGN.zh-CN.md

@@ -37,13 +37,13 @@
 
 ## 实测范围
 
-五组预览：原显存预算规划器、计算器、比较图表、条件预算示例、语义配色/负数/全零图表。分别检查浅色、深色、390px；浏览器无 pageerror，无整页横向溢出。真实 Web 聊天还要验证历史恢复和主题继承，不能只以独立预览代替。
+五组预览：原显存预算规划器、计算器、比较图表、条件预算示例、语义配色/负数/全零图表。分别检查浅色、深色、390px；浏览器无 pageerror，无整页横向溢出。真实 Web 聊天还要验证历史恢复和主题继承，不能只以独立预览代替。
 
 ## 0.3 — 动态曲线与恢复操作
 
 线图按数据范围自动设置纵轴，柱图始终包含零基线。数字横轴可声明 xScale:linear，按实际采样距离放置点；分类轴保持旧版等距行为。曲线端点数值向绘图区内对齐，避免与坐标刻度叠字。精确值始终保留在展开数据表中。
 
-读取失败时控件保持禁用并提供重新读取；保存失败时保留本页参数并提供重试；冲突时明确提供“使用已保存参数”和“保留本页参数并重试”。恢复操作继承统一的次级按钮样式。无效数值草稿不会因失焦悄悄消失。
+读取失败时控件保持禁用并提供重新读取；保存失败时保留本页参数并提供重试；冲突时明确提供“使用已保存参数”和“保留本页参数并重试”。恢复操作继承统一的次级按钮样式。无效数值草稿不会因失焦悄悄消失。
 
 ## 0.4 — 六种场景设计与生成预览
 

package/README.en.md

@@ -0,0 +1,86 @@
+# DSH Motion UI
+
+[简体中文](README.md) | English
+
+Turn [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) responses into **interactive interfaces, diagrams and animations** when useful: from comparisons, quizzes and parameter calculators to HTML/SVG canvases, mechanical illustrations and local video production. The model can still answer in ordinary text; interface generation depends on the task, model and settings.
+
+## What can it do?
+
+| Use case | Capabilities |
+| --- | --- |
+| Everyday explanations | Cards, comparisons, flows, timelines, code, formulas and tabs |
+| Data exploration | Table filtering / sorting, CSV export, charts and adjustable parameters |
+| Learning and input | Local quizzes, forms, function plots and structural diagrams |
+| Freeform expression | Model-authored HTML/SVG, animations, basic 3D and interactive canvases |
+| Mechanical illustrations | Adjustable assembly, gear and crank-linkage demonstrations |
+| Video production | Motion timelines, storyboard previews, MP4 export, editing, and optional voice and captions |
+
+Interfaces appear in the response and the **Smart UI** sidebar. Compatible parameters and some view state can be saved, and the model can later edit an existing interface. Controls respond locally; parameters are sent to the Agent only when a follow-up is explicitly submitted.
+
+## Examples from real generations
+
+These screenshots come from real DSH development sessions. The first was proactively generated by DeepSeek V4.1 Flash Fast for a circuit question; the second was generated by DeepSeek V4.1 Flash from an animation request. Both are static captures. Results depend on the model and prompt, and illustrations are not precision simulations.
+
+![Interactive series and parallel circuit explanation with parameters and charts](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/fast-circuits.png)
+
+![Pendulum animation illustration with adjustable amplitude and frequency](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/flash-pendulum.png)
+
+[View all screenshots and their provenance](docs/screenshots/README.md).
+
+## Compatibility and installation
+
+- Supports DSH **Web / Desktop**. The current repository explicitly declares compatibility with `0.2.0-rc.2`, `0.2.1-rc.1`, `0.2.1-rc.2`, `0.2.1-rc.3`, `0.2.1-rc.4` and `0.2.1-rc.5`; see [package.json](package.json).
+- Requires Node.js `>=22.19`. Everyday interfaces do not require the video toolchain; see video requirements below.
+
+For Desktop, install its `dsh` command through **Application → Manage dsh Command** first:
+
+```sh
+dsh plugin --profile desktop add dsh-motion-ui
+```
+
+Replace `desktop` with `web` for Web. Restart DSH after installation; Web users should also reload the browser page. Settings are under **Plugins → Installed → dsh-motion-ui**. You can also install it through the [Enhancement Suite](https://github.com/Scorp1o117/dsh-enhancement-suite).
+
+If the development plugin `dsh-generative-ui` is installed, remove it before installing Motion UI. They register the same tools and should not run together. Older interface documents remain readable, but settings must be selected again under the new plugin entry.
+
+## Quick start
+
+Ask for a task that benefits from a visual, for example:
+
+- “Explain voltage, current and power with adjustable parameters.”
+- “Compare these two options and let me adjust the budget.”
+- “Make a local quiz with answer explanations.”
+- “Animate a gear drive with speed and pause controls.”
+
+In plugin settings, choose **Guided** or **Free** mode. Guided mode supplies design guidance, style and examples; Free mode leaves the design to the model without injecting those styles and examples. Whether the model invokes tools, as well as interface quality and correctness, depends on the model and request.
+
+## Tools and behavior
+
+| Tool | Purpose |
+| --- | --- |
+| `render_text` / `render_scene` | Quick typography or common flow, comparison, allocation and budget scenes |
+| `render_ui` | Validated native components, charts, quizzes and forms |
+| `render_canvas` | Freeform HTML / SVG canvases and animation |
+| `render_mechanism` | Assembly, gear and crank-linkage illustrations |
+| `ui_catalog` | Retrieve protocol, fields and examples on demand |
+| `inspect_ui` / `update_ui` / `patch_ui` | Inspect and continue editing an existing interface |
+
+Completed content can appear progressively during generation. Full interaction starts after a successful result and state restoration. Some PTC / composite tool paths may show the text fallback instead. Removing the plugin does not automatically delete locally saved interface state.
+
+## Video production
+
+When explicitly asked to make a video, the model can preview a timeline, render MP4, inspect a video or join clips, and deliver editable source and project files. Install **Chrome / Edge or Playwright Chromium, FFmpeg and FFprobe** locally first; the plugin does not download a browser or encoders automatically. The plugin settings can check the video environment.
+
+Optional voice synthesis uses MiniMax, requires separate authentication and may incur API charges. Silent motion videos work without it. Ordinary conversations are not automatically exported as video. Frame sampling checks only selected moments; it is not a complete visual, audio or content review.
+
+## Limits and safety
+
+- The correctness of charts, calculations and illustrations depends on supplied data, model output and implementation. Verify results for professional use.
+- Freeform canvases run in an isolated iframe with restrictions on host-page and network access. Isolation does not provide hard CPU or memory limits; complex or problematic code can still affect responsiveness.
+- Do not supply unrelated credentials or private data to generated canvases. External services, models and assets have their own terms.
+- This project does not claim to implement ChatGPT's proprietary UI protocol or compiler.
+
+## More information
+
+- [Changelog](CHANGELOG.md) · [Verification](VERIFICATION.md) · [Historical detailed documentation](https://github.com/Scorp1o117/dsh-motion-ui/blob/52ad63919cd1b40b26f80a65102ca1459b4a7ec4/README.md) (protocol and examples; older installation and compatibility notes may be outdated)
+- The extended component core reuses [dsh-genui](https://github.com/omdsh-dev/dsh-genui); mechanical illustrations reference Anatomy; the motion skill comes from OpenDesign. See [dsh-genui NOTICE](lib/third-party/dsh-genui-NOTICE.md), [Anatomy NOTICE](lib/third-party/anatomy-NOTICE.md) and [motion-design NOTICE](skills/motion-design/NOTICE.md) for versions, attribution and licenses.
+- [npm](https://www.npmjs.com/package/dsh-motion-ui) · [Issues](https://github.com/Scorp1o117/dsh-motion-ui/issues) · [MIT License](LICENSE)