返回目录

dsh-genui

编辑精选维护状态: 活跃

omdsh-dev/dsh-genui

在助手回复中内联渲染可交互 UI 组件,支持图表、表单、测验、Mermaid 图、3D 场景和模型动作事件。

前往 GitHub项目主页
$ dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git

427

星标

42

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-09-09

最近推送

MIT 许可的 DeepSeek Harness(dsh)GenUI 插件:通过 `dsh plugin --profile web add` 安装,模型借 `dsh-ui` 代码块在回复中内联渲染图表、表单与测验等交互组件。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

MIT

01它能帮你完成什么?

  • Show interactive dashboards, charts and data panels inside DeepSeek Harness answers

    Clickable stat cards, trend charts, tables and monitoring panels rendered inline as the model streams — drag sliders, hit refresh, and the model regenerates the data

    dsh web users who want analysis results as live interactive UI instead of plain text

  • Build self-grading quizzes and interactive forms inside dsh sessions

    Quiz scores, per-question right/wrong and explanations shown instantly in the UI with zero model round-trips; inputs and submission locks persist across refreshes

    Educators, trainers and builders assembling practice quizzes or intake forms in DeepSeek Harness

02如何接入 DeepSeek Harness?

前置条件

  • dsh installed (any open-source build works — the plugin picks its rendering channel at startup)
  • `pnpm` on your PATH: the `dsh plugin` command depends on it. If missing: `corepack enable` (or `npm i -g pnpm`), then open a new terminal and confirm `pnpm -v` prints a version

安装步骤

  1. 01

    Run `dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git` (public GitHub install, works without an npm account)

    $ dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git

  2. 02

    Or clone and use the one-click script: `git clone https://github.com/omdsh-dev/dsh-genui.git && cd dsh-genui && ./scripts/install.sh` — it checks the prerequisites, performs the install, and prompts you to restart

    $ git clone https://github.com/omdsh-dev/dsh-genui.git && cd dsh-genui && ./scripts/install.sh

  3. 03

    Restart dsh web + hard refresh the browser

验证接入成功

  • In a new session say "use dsh-ui to draw a stats dashboard"
  • Successful activation prints `[genui] client active; fence-channel=registry|dom` in the browser console

回滚

  • Run `dsh plugin --profile web remove @omdsh-dev/dsh-genui`

03DSH 适配与能力边界

DSH 适配兼容

Installed as a dsh web profile plugin (`dsh plugin --profile web add <git URL>`) that renders `dsh-ui` fences inline in assistant replies via the host's fence-registry extension point or a DOM fallback channel — no host source patch required

  • Streaming `dsh-ui` fence rendering (registry + DOM channels)

    model replies containing `dsh-ui` JSON fencescomponents rendered inline as the model writes them — the first finished component shows up immediately, via the host's fence-registry pipeline or the DOM fallback channel

    On hosts without the fence-registry extension point, the DOM channel observes the session DOM and mounts its own render tree
  • 30+ interactive components with an action event loop to the model

    `dsh-ui` component specs (cards, tables, charts, forms, tabs, plots, quizzes, mermaid, 3D scenes)inline interactive UI; clicks or blur events on `action`-bearing components are sent back to the model, which updates the UI

    component actions send click/blur events back to the modelsame-name actions are debounced with a 300 ms trailing edge
  • Local-first quiz grading and state persistence

    quiz / form specs with `answer`, `submit`, `action` fieldsinstant local grading with zero model round-trips; answers, submission locks and input values restored after refresh or reopen

    user state is persisted in the browser per "session + content fingerprint" (LRU cap of 200 blocks)
  • Whitelisted, eval-free rendering with self-healing spec guards

    any `dsh-ui` spec from the modelsanitized render — bad nodes silently dropped, numbers clamped, strings truncated; the whole tree capped at 200 nodes / 8 nesting levels

04适合谁?何时不该用?

适合

  • dsh web users who want analysis results as live interactive UI instead of plain text
  • Educators, trainers and builders assembling practice quizzes or intake forms in DeepSeek Harness

不适合

  • On very old dsh builds the chat UI can go blank when rendering a `dsh-ui` fence — the README says to update dsh first, then reinstall the plugin.
  • The `dsh plugin` command requires `pnpm` on PATH, and a freshly cloned directory must be installed via the git URL — `link:` skips the plugin's dependencies (mermaid / three / react) and breaks the renderer.

05兼容性、维护与安全提示

  • On very old dsh builds the chat UI can go blank when rendering a `dsh-ui` fence — the README says to update dsh first, then reinstall the plugin.
  • The `dsh plugin` command requires `pnpm` on PATH, and a freshly cloned directory must be installed via the git URL — `link:` skips the plugin's dependencies (mermaid / three / react) and breaks the renderer.
  • The mermaid and three.js engines are not inlined; they load on demand the first time they're used through the plugin's self-registered HTTP routes — hosts without those asset routes degrade to source/load-error hints.
2026-08-132026-08-17v0.8.6

MIT · actively maintained (latest release v0.8.6, 2026-08-16)

06常见问题

如何把 dsh-genui 安装到 DeepSeek Harness?

确保已安装 dsh 且 `pnpm` 在 PATH 中,然后执行 `dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git`,重启 dsh web 并强制刷新浏览器;也可以克隆仓库后运行 `./scripts/install.sh`,脚本会检查前置条件、完成安装并提示重启。

它是 dsh 原生能力还是 MCP 工具?

它是 dsh web 的 profile 插件,不走 MCP,也不需要改宿主源码:新版 dsh 通过宿主的 `fence-registry` 扩展点注册渲染;标准 DSH 和旧版构建则自动切换到 DOM 通道,观察会话页面并挂载自己的渲染树。

安装需要什么前置条件?

已安装 dsh(任意开源构建均可),且 PATH 中有 `pnpm`(`corepack enable` 或 `npm i -g pnpm`,之后新开终端确认)。注意:不要对新克隆的目录使用 `link:`——它不会安装 mermaid/three/react 依赖,渲染器会坏掉。

我的交互和数据会去向哪里?

本地优先:测验判分、重置与输入持久化全部在浏览器本地完成,按「会话 + 内容指纹」保存(LRU 上限 200 块);只有显式带 `action` 的点击/失焦事件才会回传给模型。GenUI 绝不索取或持久化密码、API 密钥等敏感信息。

有什么已知限制?

dsh 版本过旧时,渲染 `dsh-ui` 代码块可能导致聊天界面空白——先升级 dsh 再重装插件。mermaid/three 引擎不内联,首次使用时通过插件自注册的 HTTP 路由按需加载。

08数据与来源

  • 作者声明github.com7ac881b8e351…

    dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git

  • 作者声明github.com7ac881b8e351…

    🔌 Ecosystem: the repo carries the `#dsh` · `#dsh-plugin` topics — welcome to be listed by @dsh-plugin.

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。