dsh-genui:交互式 UI 组件
omdsh-dev/dsh-genui
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
安装
把 dsh-genui 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
桌面版有自己的 profile,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-genui 之前,先看这几条
- 源码在这里: omdsh-dev/dsh-genui——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 dsh-genui 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
既没提 shell 命令,也没提密钥。
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — 让 DSH 回复在对话里直接变成可点、可拖、可填的界面,并把用户操作送回模型。
谁该装 — 在 DSH 网页里核对订单或服务指标时,缺的是回复内部就能本地排序、筛选、拖滑条改参数。只把 DSH 当无界面生成器、结果直接进脚本或下游 API 的人不必装,那些界面没有落点。
注意 — 沙箱里在全新 profile 装上后,harness 把它注册进了 profile。可用版本仅 ^0.2.0-rc.1、^0.2.1-rc.1、^0.2.2-alpha.2,alpha 宿主另需 Node.js >=24.9.0。dsh plugin 要求 PATH 上有 pnpm,装完要重启 DSH web 并强制刷新浏览器,只加 npm 依赖不会注册。
锐评 — 对我而言,只有打算在同一条对话里继续点、拖、提交时才值得,否则 SKILL.md 的组件写法是白写的。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-genui 是做什么的

dsh-genui 是一个 DeepSeek Harness 插件,把模型回复中的交互内容直接渲染成可操作的组件,包括卡片、表格、图表、表单、测验、Mermaid、函数绘图和 3D 场景。用户点击按钮、修改输入或完成测验后,事件可以回传给模型,由模型生成下一步内容;评分、重置、展开折叠等本地可完成的操作则立即在页面处理。
插件启动时会根据宿主能力选择渲染通道:检测到 fence-registry 时接入宿主的流式渲染管线,否则观察会话 DOM,识别 dsh-ui 代码块并挂载自己的渲染树。组件可以在回复尚未结束时出现。render_ui tool 使用同一套 UI 规格,panel: true 可把内容放进会话面板。交互状态按会话和内容指纹保存,最多保留 200 个 block。
它适合需要把答案做成可视化、可填写或可选择内容的 DSH 用户。不需要交互 UI 时,纯文本回复更合适;如果不希望维护 pnpm 依赖,也不应安装。目录将 dsh-genui 标记为需要 credentials,但 README 没有说明具体凭据;插件会接触宿主会话 DOM、本地 UI 状态和模型事件循环。
dsh-genui 的文档
环境要求
README 要求已安装 DSH,并且 pnpm 位于 PATH。插件支持任意开源 DSH build。安装或更新后,需要重启 DSH web 并执行 hard refresh;可在新会话中输入 “use dsh-ui to draw a stats dashboard” 验证。源码开发需先执行 pnpm install;README 特别说明,link: 不会安装 mermaid、three 和 react,因此不能直接用于全新源码目录。
渲染通道
插件启动时检查 fence-registry extension point。宿主提供它时,fence 进入宿主的 streaming render pipeline;否则使用 DOM channel,观察会话 DOM 并自行挂载 render tree。DOM channel 支持 md-code-block、.code-block、.code-block-small,也支持带有 dsh-ui 标识和 <pre> 内容的结构性 fallback。组件可在模型输出过程中逐步出现。
命令与交互
render_ui tool 会把相同的 UI spec 渲染到 tool row 中;回复内的 UI 通过 fence 传递,工具式 UI 通过 render_ui 传递。panel: true 会将内容放入 composer 上方的持久会话面板。
按钮、switch、input、dropdown、checkbox、radio、textarea 和 quiz 可以携带 action。事件回传模型;同名 action 使用 300 ms trailing debounce,快速操作会合并。input 按 Enter 提交,textarea 按 Ctrl+Enter 提交,前提是设置 submit:true。带 id 的字段会收集到 submit action 的 fields 中。
状态与限制
答案、提交锁和输入值按会话及 content fingerprint 保存,LRU 上限为 200 个 block;相同内容重新渲染时保留状态,新内容重新开始。quiz 的评分、重置、展开折叠和选择等本地操作不需要模型往返。不得请求密码、API key、access token、recovery code 或其他 secrets;密码输入会保持遮罩、不持久化,也不会进入表单收集。README 未说明其他配置 key 或环境变量。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-genui 的同类插件
dsh-web-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上