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
TA的项目
+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
#398[Bug] 页面背景非纯色时(背景图/玻璃态外观)card / callout / table 底色完全透明,文字压花纹不可读4 comments · 2026-10-29#259[Discussion] 零交付回合的宿主层自动恢复:EMPTY_RESPONSE 策略与逐字节重放检测(承接 #242 调查)1 comments · 2026-10-05#450[Bug] 启用 dsh-genui 后 DSH 内置“引用文本”选区操作消失0 comments · 2026-11-15#443[性能] 单张 mermaid 图渲染阻塞主线程 4615 ms:241 张样式表下的强制同步布局(独立复现 #303,渲染环境未变)0 comments · 2026-11-13#441[Feature] genui:fence 系统提示从 1,739 回涨到 3,397 字符:建议加 minimal/off 开关,并把 type 白名单真正下沉到 skill0 comments · 2026-11-12#436[Bug] choices 组件漏写 action 字段时提交静默失效:建议渲染为禁用态或在教学层强制0 comments · 2026-11-10#434该插件会影响到 0.2.2-rc.1 版本的选中文本引用的功能0 comments · 2026-11-10#432Fence-feedback loop is blind to fences whose opening label is not at line start (extracted=[] and delivered=true)0 comments · 2026-11-08
Latest release
GenUI 0.16.0 v0.16.0 2026-11-09GenUI 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 环境的验收