前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在 Web 环境下，模型生成复杂的数据可视化、交互式组件或动画往往需要编写大量底层代码，或者缺乏统一的验证机制。dsh-motion-ui 解决了这个问题，它为 DeepSeek Harness Web 提供了一套标准化的渲染工具，让模型能够直接生成经过验证的 UI 组件、图表和场景，而无需手动处理 HTML/SVG 源码的细节。
这是什么¶
dsh-motion-ui 是一个为 DeepSeek Harness Web 0.2.0-rc.2 设计的插件，由开发者 Scorp1o117 维护，采用 MIT 许可证。
它复用了 MIT 项目 dsh-genui 的核心渲染与校验逻辑，在此基础上扩展了针对动画、机制图解和本地计算的支持。该插件不提供后端 API，所有渲染和计算均在本地完成，确保了数据安全，同时也避免了与 dsh-generative-ui 的冲突。
核心功能¶
插件提供了以下核心能力：
- 渲染场景：支持流程、方案对比、总量分配和预算四种场景的快速渲染。
- 文本排版：提供 8 种预设（阅读、简洁、对比、列表、高亮、评分、流程、极简），支持自定义字体大小、颜色、对齐和布局。
- UI 组件：提供经过验证的原生组件，包括卡片、列表、表格、表单、时间线、选项卡等。
- 画布绘制：支持 HTML/SVG 自由绘制。
- 机制图解：支持装配拆解、齿轮传动和曲柄连杆等运动学场景。
- 样式管理：内置 5 种风格（明亮扁平、清爽阅读、柔和彩色、技术图解、活力展示）。
- 本地计算与图表：集成 ECharts、Mermaid、Three.js 和 KaTeX，支持本地数据排序、筛选和图表生成。
安装与启用¶
在 DeepSeek Harness Web 环境中，可以通过命令行安装此插件：
dsh plugin --profile web add dsh-motion-ui
安装完成后，需要重启 Web 进程并刷新浏览器页面以加载新插件。如果在开发环境中安装源码构建版本，请确保先卸载 dsh-generative-ui，因为两者注册了相同的工具。
典型用法¶
插件通过工具调用与模型交互，以下是一些典型的调用方式：
- 查看组件目录：
ui_catalog({topic:"text"})
- 渲染预算场景：
render_scene({scene:"budget",title:"假设旅行预算",values:{people:3,nights:3,roomRate:600,transportPerPerson:800}})
- 渲染文本块：
render_text({preset:"reading",blocks:[
{type:"text",spans:[{text:"重点："},{text:"先交付最小完整结果",weight:700,color:"success"}]}
]})
- 渲染自定义 UI：
render_ui({document:{title:"Git 小测",items:[
{type:"radio",group:"q1",label:"提交记录什么？",options:["暂存区快照","所有未暂存修改"],answer:0,explanation:"git commit 记录暂存区快照。"},
{type:"submit",label:"检查答案",groups:["q1"]}
]}})
适用场景与注意¶
该插件适用于需要可视化输出的场景，如数据报表、流程图解、在线测验和本地参数配置。
使用时需注意以下事实：
- 版本兼容性：仅兼容 DeepSeek Harness Web 0.2.0-rc.2。
- 环境限制：插件不提供
/panel命令或自定义渲染器注册 API。独立 HTML 界面无法发送宿主 Agent 请求或打开本地文件（外部媒体需网络），也无法访问宿主文件系统权限。 - 默认配置：默认风格为「明亮扁平」，首次使用无需额外设置。
- 开发环境：若需开发此插件，必须先卸载
dsh-generative-ui，否则会因工具注册冲突导致安装失败。
短结尾¶
dsh-motion-ui 通过复用成熟的渲染核心并封装成易用的工具，降低了在 DSH Web 中生成高质量交互界面的门槛。它专注于提供可靠的渲染工具和样式管理，适合需要处理数据可视化、本地计算和结构化交互界面的开发场景。
