本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-genui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @changfenhuang/dsh-genui

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Registry 通道：宿主提供 fence-registry 扩展点（新版 dsh 构建）时，围栏经宿主流式渲染管线注册，行为与宿主无缝；
• 回答即界面：组件嵌在回答里，边生成边出现，不用等整段写完
• 30+ 组件：卡片、表格、图表、表单、标签页、折叠面板、文件树、时间线、diff……
• 函数图：plot 画曲线，参数滑块拖动实时重绘，支持自动动画
• 测验：quiz 点选判题 + 解析 + 重试；带 action 时答案同时回传模型（判题仍本地即时）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

围栏渲染成了普通代码块，怎么办？

依次检查三件事：宿主 dsh 是否具备 fence-registry 扩展点（不具备会自动回退到 DOM 通道）、dsh plugin --profile web list 是否能看到本插件、最后重启 dsh web 并硬刷新（Cmd/Ctrl+Shift+R）。

安装时报 pnpm not found on PATH，怎么解决？

dsh 的 plugin 子命令依赖 pnpm。运行 corepack enable 或 npm i -g pnpm 安装后，必须新开一个终端让 PATH 生效，确认 pnpm -v 有输出再重试。

装好了但 mermaid 或 3D 场景渲染不出来？

这两个引擎按需加载，首次使用时会从 /plugins/@omdsh-dev/dsh-genui/assets/*.js 拉取。先硬刷新一次浏览器；若仍失败，移除后重新安装即可（dsh plugin --profile web remove @omdsh-dev/dsh-genui 再 add）。

模型不输出 dsh-ui 围栏，只回文字怎么办？

新会话需要重启 dsh web 才生效；或者在提问时直接说"用 dsh-ui 画一个统计面板"提醒模型。

刚 clone 下来没有 lib/ 目录，能直接用吗？

不能直接用。lib/ 是构建产物，需要先 pnpm install 再 pnpm run check（会自动构建）。

可以用 link: 安装刚 clone 的目录吗？

日常迭代可以，但 link 模式不会自动安装插件的依赖（mermaid/three/react），渲染器会因此坏掉。普通安装请用 git URL 形式。

围栏节点太多会被截断吗？

会的。插件有硬性资源上限：单条围栏最多 200 个节点、嵌套深度 8 层；超出部分会被静默丢弃，不会让界面崩溃。

怎么卸载这个插件？

运行 dsh plugin --profile web remove @omdsh-dev/dsh-genui，然后重启 dsh web；围栏会自然降级回普通代码块，不会污染已有会话。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.6
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则