dsh-openui-studio
Verifieddsh-openui-studio · v0.1.2 · MIT · Web UI
Interactive OpenUI answers in the native DeepSeek Harness conversation.
Install
dsh plugin add dsh-openui-studio Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
DeepSeek Harness 的 OpenUI Studio 插件
English | 简体中文
OpenUI Studio 在普通 DeepSeek Harness(DSH)对话中增加按需使用的 /openui
指令。插件使用当前选中的模型生成 OpenUI Lang,按 OpenUI 官方聊天组件库校验,
再用官方 Renderer 将结果显示在原对话中。对话、思考过程、历史记录、工具记录和输入框
仍由 DSH 管理。
快速开始
安装 DSH,并在 设置 → 模型 中选好默认模型。
打开 设置 → 插件 → 添加插件,输入
dsh-openui-studio。安装或更新后需 完全退出并重新打开 DSH;也可以从 GitHub 仓库 直接安装。在标准模式或 PTC 模式的对话中输入,例如:
/openui 解释 KV Cache 的显存开销,并用图表和算例展示
只有明确使用 /openui 的这一轮才会启用 OpenUI 生成;普通消息继续走 DSH
原有流程。指令支持附件,也支持只附附件、不输入问题的用法。
Agent 会结合当前对话中的相关信息调用 openui_generate。有效结果作为 DSH
工具结果保存,并显示在聊天正文。如果第一次生成未通过 OpenUI 校验,插件会尝试
修复一次;仍然失败时由 DSH 展示工具错误,不保存不完整的界面。重新打开历史对话
只渲染已保存的结果,不会再次调用模型。
插件生成 OpenUI 源码时沿用当前 DSH 会话的模型、输出 token 上限和推理强度。
如果模型没有产生可用文本,
工具错误会记录流的结束原因、各分片数量和原始文本长度,不记录模型内容。
同一轮 /openui 不会再次启动生成;失败后可重新发送一条 /openui 请求。
点击 OpenUI 回答中的交互选项,会把建议问题填入 DSH 输入框并将焦点移过去; 不会自动发送消息。
绘制动画与重播
新回答使用 Swarm Rebuild 引擎逐层重建已经渲染好的界面。多个光标会绘制边框、 输入文字、放置媒体、复制重复元素、调整尺寸,并显示对齐辅助线。巡航会跟随尚未 完成的区域向下滚动,结束后恢复可交互的 OpenUI 回答。 镜头跟随最靠前的活跃工作,任务密集处放慢、稀疏处加快;滚动到回答的实际末尾后, 绘制层通过短暂淡出交还真实页面。 播放时直接显示可读内容,不再先播放只有光标的开场。
历史回答会立即完整显示。点击 OpenUI Studio 旁的重播图标,可在不调用 模型的情况下重新播放绘制动画。点击画布或按 Escape 可直接返回可交互回答。 系统设置了减少动态效果,或新回答在 DSH 后台完成时,会跳过自动播放。 尺规与操作栏跟随 DSH 的深浅色主题;播放途中切换主题会直接显示真实回答。
动画从已渲染的 OpenUI DOM 获取快照,不修改 OpenUI Lang 结果,也不增加聊天记录。
渲染配置
编辑 render.js 可以调整渲染层。点击 OpenUI Studio 旁的
配置图标可在 DSH 中打开它,也可以直接编辑文件。文件默认导出一个 JavaScript
对象:
| 参数 | 默认值 | 作用 |
|---|---|---|
showEditButton |
true |
显示打开 render.js 的配置图标。 |
toolbar |
['replay'] |
排列或隐藏 replay、debug、download-log 按钮。 |
animation.autoPlay |
true |
新回答自动播放;关闭后仍可手动重播。 |
animation.followScroll |
true |
随绘制位置滚动;关闭时直接显示完整回答。 |
css |
插件内置样式 | 覆盖 OpenUI 回答区域的 CSS。 |
css 中提供 --openui-studio-font、--openui-studio-body-size、
--openui-studio-body-leading、--openui-studio-heading-size 等字体变量。
新增 CSS 选择器应限定在 .openui-answer 或 .openui-native 下,避免影响
DSH 自身界面。这些设置只改变渲染和按钮,不改变大模型提示词或已保存的回答。
修改 render.js 后需完全退出并重新打开 DSH;无需重新构建插件或调用模型。
配置无效时会回退到插件内置默认值,并在回答标题旁显示错误。
模型调用参数维护在 cordis.patch.yml:provider、
model、maxTokens、temperature、reasoningEffort、maxQuestionChars
和 promptSuffix。模型与生成参数设为 null 时,优先使用当前 DSH 会话的请求
设置;会话未指定输出上限时读取所选模型的 defaultMaxTokens,再没有则交给
DSH 决定。插件中填入的非空值会覆盖对应会话设置。maxQuestionChars 限制传给
生成器的问题长度;promptSuffix 可按环境追加提示词。基础提示词和校验 Schema
仍来自已安装的 OpenUI 官方组件库。DSH 会在插件包配置之后应用当前 profile 的
cordis.patch.yml,因此不同环境可在各自 profile 中覆盖这些字段,无需修改插件
源码。修改配置后需重启 DSH。界面控件跟随 DSH 语言,生成内容跟随提问语言。
动画调试
- 在
render.js中设置toolbar: ['replay', 'debug', 'download-log'],然后 重启 DSH。 - 点击 OpenUI Studio 旁的虫形图标,重播并记录内容块、光标、动画、滚动 和结束事件。
- 播放结束后点击下载图标,保存 JSON 日志。
日志只包含时间与几何信息,不包含回答正文;不需要打开开发者工具控制台。 默认工具栏只显示重播按钮,调试和下载按钮默认隐藏。
开发与验证
使用 Node.js 20 或更新版本从本地源码开发:
git clone https://github.com/zouyao-andy/dsh-openui-studio.git
cd dsh-openui-studio
npm ci
npm run build
然后通过 DSH 插件管理器将该目录安装为本地插件。新版与 npm 包使用相同插件 ID;
添加前请移除旧的 @local/dsh-openui-studio 安装。
npm test
npm run test:render
npm run build
src/host/index.js 负责指令、受控工具、模型调用和 OpenUI 校验;
src/client/chat-answer.js 把已保存结果放进 DSH 回答区;
src/client/native-answer.js 使用官方 Renderer 和样式。
src/client/swarm-reveal.js 将回答接入改造后的
src/client/vendor/swarm-rebuild.js 引擎。旧绘制策略文件保留供
对比,但新动画不再依赖它们。
scripts/gen.mjs 生成官方 OpenUI 提示词和 Schema,scripts/build.mjs
生成 Host 的 index.js 与 Client 的 client.js。修改插件源码后需要重新构建,
并重启 DSH。
插件不会另建对话数据库、侧边栏、输入框或 DSH 模式。这个基于官方 Renderer
的版本不兼容早期自定义 Stack 回答。
社区与许可证
可以通过 dsh-plugin 主题发现其他 DSH
插件。DSH 的反馈和问题请到
DeepSeek Harness Discussions
提交,也可以加入 DSH Discord 社区。
本插件采用 MIT License。
绘制引擎改编自 Swarm Rebuild
的 601f6e2 提交,遵循其 MIT License。