dsh-motion-ui 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # DSH Motion UI
 
+## 0.5.3 — 2026-10-10
+
+- Prefer lightweight static diagrams, concise comparisons, short processes and compact dashboards; controls and animation are added when useful.
+- Inject static flow/comparison examples before the calculator, and add `ui_catalog({topic:"quick"})` with four short layouts.
+- Add reusable theme-aware flow/node/arrow/callout styles; static views omit parameter-save status and use the broader “可视化” label.
+- Elect one answer-area owner per document when multiple tail seats mount, and retire stale tool previews once the committed UI is available. Missing, late or removed inline markers retain a single fallback view. Explicitly opened sidebars remain separate views.
+
 ## 0.5.2 — 2026-10-10
 
 First public release for DeepSeek Harness Web 0.2.0-rc.2.

package/README.md

@@ -19,8 +19,44 @@ The release artifact includes the generated browser bundle; users installing the
 
 Development installs of `dsh-generative-ui` must be uninstalled before installing `dsh-motion-ui`; do not enable both because they register the same tools. Existing UI documents remain readable: the internal `dsh-generative-ui` storage directory, result metadata and authenticated route namespace are retained for compatibility. Plugin settings must be selected again under the new plugin entry.
 
+## 模型生成效果 / Model-generated UI
+
+以下是模型在 DSH 中实际生成并运行的界面，展示原生组件与自由 HTML/SVG 画布的组合。截图保留模型的实际布局与内容；动画展示为静态帧。它们来自开发期测试，代表这些案例的结果。
+
+### 电压、电流与发热功率
+
+**DeepSeek V4.1 Flash Fast · 主动选择 UI。** 用户只询问电压变化时电流和发热功率为什么不同，模型生成滑块、指标卡和联动曲线，用线性与平方关系解释差异。
+
+![DeepSeek V4.1 Flash Fast 生成的电阻交互解释：电压滑块、三项指标和电流与功率曲线](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/fast-resistor.png)
+
+### SVG 轨道动画
+
+**DeepSeek V4.1 Flash · 按文字需求生成。** 模型自行编写 SVG、CSS 和动画逻辑，组合轨道图、速度滑块与运行开关；这是数学动画示意，并非真实天体模拟。
+
+![DeepSeek V4.1 Flash 生成的 SVG 轨道动画：中心与环绕对象、速度控制和暂停开关](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/flash-orbit.png)
+
+### 周期运动单摆
+
+**DeepSeek V4.1 Flash · 按文字需求生成。** 振幅和频率控件驱动 SVG 摆动，支持暂停并保持当前角度；界面明确标注它是周期运动数学示意，而非真实物理仿真。
+
+![DeepSeek V4.1 Flash 生成的交互单摆：SVG 摆体、摆角读数、振幅与频率滑块](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/flash-pendulum.png)
+
+### 串联与并联电路
+
+**DeepSeek V4.1 Flash Fast · 主动选择 UI。** 用户要求讲清两只电阻怎样分配电压和电流，模型生成接法切换、三个参数滑块、电路图、指标和对比曲线。下面展示完整界面。
+
+![DeepSeek V4.1 Flash Fast 生成的串并联交互讲解：参数控制、电路图、等效电阻和响应曲线](https://raw.githubusercontent.com/Scorp1o117/dsh-motion-ui/main/docs/screenshots/fast-circuits.png)
+
+[截图来源与生成方式](docs/screenshots/README.md)。
+
 ## Use
 
+### Lightweight by default (0.5.3)
+
+静态图解、简短流程、方案对比和小看板都是完整的 UI，不要求添加控件或动画。引导模式优先注入静态流程与对比示例，计算器随后；复杂动画示例留在按需目录中。`ui_catalog({topic:"quick"})` 提供四个轻量起点。画布可直接使用 `.ui-flow`、`.ui-step`、`.ui-arrow` 和 `.ui-callout`，无需重复编写样式或脚本。模型仍可按用户需求生成复杂界面；这些是默认表达指导，不是思考时间或输出截断。
+
+每个文档在回答区域只保留一个展示实例。正文标记缺失时仅回退一次；标记后来出现或被删除时自动迁移。提交成功后退出同一调用的工具预览。手动打开的侧栏仍可作为独立视图与正文共享参数。
+
 ### Canvas delivery improvements (0.5.2)
 
 Free canvases now include optional theme-aware `.ui-*` primitives for typography, controls, result readouts, SVG nodes, connectors and annotations. Guided mode actively injects a construction handbook covering Chinese label widths, connector routing, actual rendered SVG font sizes, validated calculations and reset behavior. Free mode retains autonomous composition and only receives the interface/delivery contract.
@@ -39,13 +75,13 @@ For simple formulas, write `derived: {power: {expr: "state.V * state.V / state.R
 
 Each UI provides **版本历史** with read-only initial-state previews and restore. Preview never executes canvas scripts or writes input state. Restore appends a new head with the chosen document, retaining prior versions and current saved inputs; stale requests fail rather than overwrite another revision. The previous head is archived before replacement, and a failed head write cannot expose a fictitious future version. Preexisting documents start their available history at the first version observed after this update; overwritten older development revisions cannot be reconstructed. Archived input definitions must remain compatible. History uses the same authenticated Connection bridge and conversation ownership checks as document access.
 
-Ask for the useful result naturally, for example: “Create an interactive theoretical weight-size calculator; distinguish estimated weights from real inference VRAM.” The plugin actively injects its design skill, complete protocol and two minimal worked examples through DSH's system-prompt service; the model does not need to discover a skill file or call a catalog to receive this guidance.
+Ask for the useful result naturally, for example: “Create an interactive theoretical weight-size calculator; distinguish estimated weights from real inference VRAM.” The plugin actively injects its design skill, complete protocol and minimal static and calculator worked examples through DSH's system-prompt service; the model does not need to discover a skill file or call a catalog to receive this guidance.
 
 The packaged skill source is `skills/intelligent-ui/SKILL.md`. It teaches scene selection, composition, diagram grammar, theme/color/icon choices, responsive labels, local state, animation and error repair. `lib/ui-skill.js` injects it together with the shared protocol and concrete calculator/animation examples. It adapts public OpenUI, Diagram Design and Taste Skill ideas to DSH; it is not OpenAI's internal prompt. `ui_catalog` remains available for additional examples. This lowers the discovery/syntax burden for smaller models; it cannot guarantee complex program quality for every model.
 
 Supported components: heading, text, card, row, column, metric, table, bar/line chart, numeric/text input, slider, select, toggle, follow-up button, badge, progress, ordered steps and collapsible details. Charts provide their full data as an accessible table. Controls compute locally without calling a model on each change.
 
-The exact protocol and runnable examples are in `lib/catalog.js` and `examples/`. Component attribute definitions in `lib/components.js` drive both validation and capability discovery. `ui_catalog()` returns the protocol, component fields and two compact examples; `ui_catalog({topic:"canvas"})` adds the full design guide and four distinct visual examples. Other topics are `data`, `scenes`, and `all` (fourteen examples). This avoids sending every example on each request.
+The exact protocol and runnable examples are in `lib/catalog.js` and `examples/`. Component attribute definitions in `lib/components.js` drive both validation and capability discovery. `ui_catalog()` returns the protocol, component fields and two compact static examples; `ui_catalog({topic:"canvas"})` adds the full design guide and four distinct visual examples. Other topics are `quick` (four lightweight static layouts), `data`, `scenes`, and `all` (fourteen examples). This avoids sending every example on each request.
 
 The tool card retains a text result. A state-only conversation extension replays standard successful tool results into the official `conversation.chat.turnTail` list slot, so the interactive UI stays visible when DSH folds work details. It does not modify DSH core or add custom persisted event types.
 

package/VERIFICATION.md

@@ -1,5 +1,11 @@
 # Verification
 
+## 0.5.3 — lightweight delivery and one answer-area view
+
+55 tests and 12 release checks pass. The new browser regression mounts two native turn-tail seats plus a stale tool preview for the same document in inline mode without a marker: only one committed UI remains. It verifies ownership handoff, saved input restoration, late/removed markers, missing sidebar fallback and independent documents. Four stateless flow/comparison/architecture/dashboard examples render at PC widths without controls or parameter-save chrome.
+
+A natural-completion DeepSeek V4.1 Flash Fast trial, with no UI request in the question, generated a static project-tool comparison with seven nodes, no state and no script. The committed UI appeared at about 31 seconds. The first table submission used invalid inline rows; the model read the catalog and repaired it. This is a successful repaired trial, not a first-attempt pass or guaranteed delivery time. The final prompt and diagnostic now explicitly show the required data reference. A plain GiB follow-up used no UI tools. Inference was neither capped nor cancelled.
+
 ## Public release 0.5.2 — DSH Motion UI (2026-10-10)
 
 The renamed package passes 54 tests and all 11 release verification steps against DSH Web 0.2.0-rc.2. An isolated profile installs the packed package with all 50 distributed files matching source. Native PC browser checks confirm the new Home → Plugins settings entry saves settings, legacy Fast-generated documents replay, calculations and saved parameters survive reload, and actual HTML exports activate offline with the new branding. Earlier natural-completion DeepSeek V4.1 Flash Fast tests exercised an explicit bicycle diagram and a proactively generated resistor explanation; model-authored contrast and typography remained uneven in the bicycle case. Desktop support is not claimed. The sections below are historical development evidence.