omdsh-dev /dsh-genui

GenUI for DeepSeek Harness: interactive UI components rendered inline in assistant replies via the dsh-ui fence — layout, charts, plots, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model. Ships the fence-teaching host plugin, the browser renderer (client half), and the genui skill.

★ 1,004⑂ 96👁 2⑃ 283● 164▤ 25
TypeScriptMITCreated 2026-08-13omdsh-dev.github.io/dsh-genui/
下载:GenUI 0.16.0GenUI-0.16.0 ↓0.16.02026-11-09
+8
日增长
1,004
stars
96
forks
2
watchers
283
prs
164
issues
25
releases

README

为 DeepSeek Harness (DSH) 赋予原生交互式界面
  文字回答依旧完整,富交互组件即刻上线。









  English · 简体中文



  🌐 在线产品站 · 
  🎬 界面演示 · 
  🚀 快速开始 · 
  🧩 核心特性 · 
  📖 组件语法 (SKILL.md)




---

dsh-genui 将大模型的文本回答无缝升级为安全、可交互的原生 DSH 界面。

例如当你询问「这个月订单表现如何?」,模型给出的回答不再只是一串文字,而是边打字边在正文中展开一张可排序的数据面板、一段内嵌音视频、一个可拖拽调参的函数图像、一组即时判卷的测验,或是一个常驻的会话工作区——文本与 UI 和谐共存,浑然一体。

---

 🎬 真实界面预览

 [!NOTE]
 真实截图与录屏: 以下界面素材均直接截取自 DSH 真实对话环境中的渲染结果,无任何概念样机或预渲染伪造。

 40 秒完整体验



https://github.com/user-attachments/assets/f5db33ec-7471-4d4a-a85b-79c9962ab4ef


  
  (若 GitHub 视频播放器加载较慢,点击封面即可直接下载查看 原始 MP4;四幕测试提示词详见 demo-prompts.md)




 回答中的三类典型输出

| 1. 监控面板:回答即仪表盘 | 2. 探索绘图:本地即时重绘 | 3. 结构排版:构建工作界面 |
| :--- | :--- | :--- |
| !监控面板 | !函数图 | !排版与卡片 |
| 数据洞察: 指标卡(Eyebrow)、可筛选可钻取的服务表、分组合计与 Spark/Ring 单元格直接内嵌在回答中。 | 即时交互: plot 绘制数学曲线;拖动参数滑块在浏览器端实时重绘,零模型往返延迟。 | 层级工作区: 标题引言、指标卡片、环形进度与章节分隔线,由模型声明式灵活编排。 |

---

 ✨ 对比:装之前 vs 装之后

| 场景 | 传统纯文本回答 | 安装 dsh-genui 之后 |
| :--- | :--- | :--- |
| 业务监控 | “本月收入 ¥128,430,环比 +12.4%,转化率稍有下滑……” | 一行文字分析 + 紧贴正文的收入/订单/转化率指标卡、动态趋势图与进度条。 |
| 数据筛选 | 必须再发送一段提问要求模型重新生成表格。 | 表格自带本地点击排序与实时过滤框,无需重新请求模型。 |
| 深入探索 | 想要调整参数看趋势,必须反复调用模型对话。 | 拖动参数滑块,函数曲线在前端毫秒级重绘,带播放动画演示。 |
| 后续操作 | 复制文本自己另找工具处理。 | 面板自带「刷新」「切换视图」按钮,点击通过 Action 闭环驱动模型执行下一步。 |

---

 🚀 快速开始

 1. 环境准备

安装前请确认满足以下条件:
- DSH 版本:^0.2.0-rc.1 || ^0.2.1-rc.1 || ^0.2.2-alpha.2。安装包浏览器验收覆盖 0.2.0-rc.1、0.2.1-rc.3 与 npm 精确安装的 0.2.2-rc.1(当前 latest / next)和 0.2.2-alpha.2;0.2.1-rc.4 与 0.2.1-rc.5 继续单独执行公开接口、完整单元测试与构建检查。当前 RC 与 alpha 宿主要求 Node.js =24.9.0,图片集合、计算字段和地图使用官方本地回放验收;第三方侧栏接入在 rc.3 上验收。
- pnpm 处于 PATH 中:dsh plugin 底层依赖 pnpm。如尚未安装,请执行 corepack enable 或 npm i -g pnpm,之后重新打开终端,确认 pnpm -v 可正常输出。

 2. 一键安装与激活

在终端中执行以下命令(一键全自动拉取依赖):

sh
 安装并激活至 DSH web profile(公开包,无需登录 npm)
dsh plugin --profile web add @changfenhuang/dsh-genui


 [!TIP]
 仅作为依赖引入? 若仅作为 Node 项目依赖引入而不注入 DSH 宿主,执行 npm install @changfenhuang/dsh-genui 即可。

 3. 60 秒验证

1. 重启 DSH web 服务,并在浏览器中执行硬刷新(Cmd + Shift + R 或 Ctrl + F5)。
2. 在 DSH 中开启一个新会话,发送以下指令:
   text
   用 dsh-ui 画一个带可排序服务表的统计看板。
   
3. 预期效果:回答中的代码块将实时转变为精美的交互式仪表盘,而非原样文本。
4. 控制台激活检测:打开浏览器开发者工具 Console,若看到输出 [genui] client active; fence-channel=dom,说明客户端已成功激活。

---

 [!WARNING]
  ⚠️ 安装避坑指南
 
 1. 认准包名 Scope(极为关键):
    必须安装 @changfenhuang/dsh-genui。npm 上存在一个同名但无 Scope 的 dsh-genui(由其他维护者基于 Vue/OpenTiny 开发,与本插件完全不兼容),如不慎安装会被 DSH 宿主因 peer 依赖冲突拒绝。
 2. 切勿使用 link: 安装刚 git clone 的目录:
    纯 link: 不会自动安装 Mermaid、Three.js、React 等对等依赖,导致前端渲染报错。日常使用请走 npm 安装;仅本地源码开发时才使用 link(见开发者指南)。
 3. 从旧包名 @omdsh-dev 迁移:
    若在 v0.9.2 之前使用过 GitHub 源或旧组织名安装,请执行:
    sh
    dsh plugin --profile web remove @omdsh-dev/dsh-genui
    dsh plugin --profile web add @changfenhuang/dsh-genui
    

---

 🧩 核心能力全景

dsh-genui 的所有组件与交互受严格的白名单规范约束,兼顾丰富表现力与高安全性。完整字段定义见 SKILL.md。


dsh-genui 核心能力矩阵
├── 🌊 1. 边流边渲染 (Streaming UI)
├── 🎨 2. 30+ 丰富组件生态 (Components Matrix)
├── ⚡ 3. 本地优先即时交互 (Local-First Experience)
├── 🔄 4. 闭环事件回传系统 (Action Event-Loop)
├── 📌 5. 常驻会话工作台 (Session Panel & Templates)
└── 🛡️ 6. 安全沙箱与容错自愈 (Safety & Self-Healing)


 1. 🌊 边流边渲染 (Streaming UI)
- 回答即界面:组件内

Top issues

Latest release

GenUI 0.16.0 v0.16.0 2026-11-09
GenUI 0.16.0 新增更完整的编辑、选择与图解交互,并支持 DSH 0.2.2-rc.1。

 新增与改进

- 新增 compare 图片对比、choices 丰富选项与本地判卷。
- 新增 editor 编辑器、entity-card 实体卡片、popover 浮层、date-picker 日期选择与 segmented-control 分段选项。
- diagram 支持节点选择、键盘操作、节点详情与字段联动;when / disabledWhen 提供条件显示与禁用,隐藏字段不提交。
- 容器内完整子项和表格行可提前呈现,骨架屏根据已知结构显示;移除固定组件配额和强制触发规则。
- 新增表格按列换行,并修复中文排版、深色图解对比度、步骤角标、逗号小数及面板校验与恢复。

 DSH 兼容与验证

- 将精确 npm 宿主的接口、完整测试、构建和安装包浏览器验收更新到 DSH 0.2.2-rc.1,覆盖正文渲染、图片选择、计算字段提交与 Linux 地图交互。
- 保留最低宿主、此前 RC 与 0.2.2-alpha.2 检查;第三方侧栏仍在 0.2.1-rc.3 上验收。
- DSH 当前 RC 与 alpha 宿主要求 Node.js =24.9.0。

自动会话验收使用官方本地回放;真实模型账户、Android 真机和原 Windows Desktop 环境的验收

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON