Skip to content

dsh-openui-studio

Verified

dsh-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 管理。

快速开始

  1. 安装 DSH,并在 设置 → 模型 中选好默认模型。

  2. 打开 设置 → 插件 → 添加插件,输入 dsh-openui-studio。安装或更新后需 完全退出并重新打开 DSH;也可以从 GitHub 仓库 直接安装。

  3. 在标准模式或 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 语言,生成内容跟随提问语言。

动画调试

  1. 在 render.js 中设置 toolbar: ['replay', 'debug', 'download-log'],然后 重启 DSH。
  2. 点击 OpenUI Studio 旁的虫形图标,重播并记录内容块、光标、动画、滚动 和结束事件。
  3. 播放结束后点击下载图标,保存 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。