dsh-genui 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-genui 兼容性怎么样？

自动检查通过：npm 包已发布且 engines 声明满足基线（声明 Node ^22.19.0 || >=24.0.0）；该结论来自程序自动检查，未经人工实机验证。

dsh-genui 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-genui 还在维护吗？

GitHub 846 星。最近一次上游提交在 2026/11/3。

内联交互界面 omdsh-dev/dsh-genui

DeepSeek Harnessv0.15.0低风险

omdsh-dev0 天前有提交已提供中文文档扫描：含敏感能力uioffice

在 GitHub 查看 ↗

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

69.4/100

综合分

846

GitHub 星标

21,098

npm 周下载

—/5

用户评分

数据截至 2026/11/3 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

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

npm 源 · @changfenhuang/dsh-genui 的发布者账号已校验与本仓库一致

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · market

装得上吗

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

安全吗

已做风险分级，标记为低

还在维护吗

活跃：最近一次提交在 0 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查✓ 自动检查通过

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包@changfenhuang/dsh-genui @ 0.15.0

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✓入口文件main/exports/bin 已声明

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/29 01:39:00

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力人工评估：低风险

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

自动扫描比人工评估更严格：扫描在源码里找到了可复现的能力项，而人工评估未标注。两者覆盖范围不同（人工按需抽查，扫描按范围全覆盖），可看下方证据自行判断。

查看扫描证据（共 10 处，展示前 10 条）

读取本地文件
lib/index.js:7650
const body = await readFile(join(dir, file));
读取本地文件
lib/index.js:7733
const raw = readFileSync(path, "utf8");
发起网络请求
lib/assets/standalone-runtime.js:289
`+h+` children.`);for(var v=0;v<h;v++){var y=new $e([new et(d[v])],{width:`400em`,height:E(m),viewBox:`0 0 `+n+` `+p,preserveAspectRatio:_[v]+` slice`
发起网络请求
lib/assets/standalone-runtime.js:293
`,this.tokenRegex.lastIndex);return i===-1?(this.tokenRegex.lastIndex=e.length,this.settings.reportNonstrict(`commentAtEnd`,`% comment has no terminat
写入剪贴板
lib/assets/standalone-runtime.js:310
`)})]},`${e.path}:${t}`))})}function kc({data:e,label:t,copyable:n,labels:r}){let[i,a]=(0,d.useState)(!0),[o,s]=(0,d.useState)(!1),c=JSON.stringify(e,
发起网络请求
src/client/artifact/html.ts:30
const task = fetch(assetUrl(name)).then(async response => {
写入剪贴板
src/client/blocks/charts.tsx:186
void writeClipboard(text).then(ok => {
写入剪贴板
src/client/blocks/advanced.tsx:230
const accepted = await writeClipboard(text)
读取本地文件
src/plugin/index.ts:74
const body = await readFile(join(dir, file))
读取本地文件
src/plugin/index.ts:168
const raw = readFileSync(path, 'utf8')

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/cordis-plugin-include@deepseek-ai/cordis-plugin-loader@deepseek-ai/dsh-agent@deepseek-ai/dsh-agent-default-model@deepseek-ai/dsh-agent-loop@deepseek-ai/dsh-api-gateway@deepseek-ai/dsh-api-session-controller@deepseek-ai/dsh-atomic-write@deepseek-ai/dsh-attachment@deepseek-ai/dsh-brand@deepseek-ai/dsh-client-connection

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

界面预览

4 张 · 点击查看大图

功能亮点

内联渲染交互式UI组件
支持布局图表表单测验
动作事件回传模型

展开完整介绍（138 字）↓

DeepSeek Harness 的 GenUI：用 dsh-ui 围栏在助手回复里内联渲染交互式 UI 组件——布局、图表、绘图、表单、测验、mermaid、3D 场景，还有回传给模型的动作事件循环。自带教围栏语法的宿主插件、浏览器渲染器（客户端部分）和 genui 技能。

README

由 DeepSeek 最新模型翻译生成

为 DeepSeek Harness (DSH) 赋予原生交互式界面文字回答依旧完整，富交互组件即刻上线。 English · 简体中文 🌐 在线产品站 · 🎬 界面演示 · 🚀 快速开始 · 🧩 核心特性 · 📖 组件语法 (SKILL.md) dsh-genui 将大模型的文本回答无缝升级为安全、可交互的原生 DSH 界面。例如当你询问「这个月订单表现如何？」，模型给出的回答不再只是一串文字，而是边打字边在正文中展开一张可排序的数据面板、一段内嵌音视频、一个可拖拽调参的函数图像、一组即时判卷的测验，或是一个常驻的会话工作区——文本与 UI 和谐共存，浑然一体。 🎬 真实界面预览 [!NOTE] 真实截图与录屏：以下界面素材均直接截取自 DSH 真实对话环境中的渲染结果，无任何概念样机或预渲染伪造。

展开完整文档（README 剩余 1 节）

为 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-alpha.2；npm next 的 0.2.1-rc.4 单独执行公开接口、完整单元测试与构建检查。alpha 宿主要求 Node.js >=24.9.0，图片集合、计算字段和地图使用官方本地回放验收；第三方侧栏接入在 rc.3 上验收。
- pnpm 处于 PATH 中：dsh plugin 底层依赖 pnpm。如尚未安装，请执行 corepack enable 或 npm i -g pnpm，之后重新打开终端，确认 pnpm -v 可正常输出。

2. 一键安装与激活

在终端中执行以下命令（一键全自动拉取依赖）：

安装并激活至 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 中开启一个新会话，发送以下指令：用 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 源或旧组织名安装，请执行：
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)

- 回答即界面：组件内嵌在回复正文中，跟随模型 Token 流式吐出，边生成边即时挂载，无需等待整段回复输出完毕。
- 零破坏降级：若未安装或禁用插件，dsh-ui 围栏将退回为优雅的 Markdown 代码块，绝不破坏会话内容。

2. 🎨 30+ 丰富组件生态 (Components Matrix)

- 展示与排版：包含指标卡（stat，支持 Hero 超大字号与微趋势线 Sparkline）、表格（table）、时间线（timeline）、代码对比（diff）、步骤条（steps）、文件树（file-tree，支持点击展开折叠）、提示卡（callout）、徽章（badge）等。
- 内容字号：卡片字号会随宿主「设置 → 外观 → 内容字号」增大；宿主设置为 17px 或更小时保留各组件原有字号。独立导出的 HTML 保留原有字号。
- 高级表格：
- 点击表头纯本地排序（升序/降序/还原，支持千分位、百分比、货币及万/亿数值感知）；
- 单元格支持 bar 进度条、ring 环形、spark 趋势线，带正负符号数值自动着色；
- 一键支持数据导出（复制 Markdown / CSV）与即时文本过滤（Filter）。
- ECharts 深度集成 (echart)：
- 预设简写模式（preset）：支持 bar、line、area、pie、scatter、radar、gauge、funnel、treemap、sankey、graph、heatmap、bigline、wordCloud 等数十种图形，配色自动匹配 DSH 主题；
- 完整配置模式（option）：支持原生 ECharts 选项，轻松开启 DataZoom、VisualMap 等高级特性；
- 按需异步加载：ECharts 引擎（~1MB）独立打包，未调用图表组件的会话绝不加载多余代码。
- 数学函数绘图 (plot)：
- 支持多曲线绘制（line / area / scatter），公式支持三角函数、对数、幂运算等；
- 动态参数滑块：拖动滑块前端毫秒级重绘，锁定 Y 轴，支持自动动画循环演示。
- Mermaid & 3D 场景：支持流程图、序列图及轻量 3D 模型渲染，引擎按需异步加载。
- 原生多媒体：支持浏览器可直达的音频（audio）与视频（video）嵌入播放，包含封面图、比例自适应及播放控制。
- 数学公式集成：基于 KaTeX，支持行内公式 $...$、块级公式 $$...$$，支持矩阵与多行推导。

3. ⚡ 本地优先即时交互 (Local-First Experience)

- 本地优先原则：前端界面能够独立完成的操作（表格排序、过滤、内容展开/收起、标签切换、参数重绘、测验判题），一律在浏览器本地即时完成，绝不进行不必要的模型往返。
- 测验与本地判卷 (quiz / submit)：
- 单题测验点击即在本地判题、展示解析并支持重试；
- 多题问卷/表单可通过 submit 统一交卷，支持 groups 必填项控制与进度感知。
- 状态持久化：表单输入、单选多选与测验进度基于「会话 + 内容指纹」自动存入缓存（LRU 200 块），刷新页面或重开会话无缝恢复。

4. 🔄 闭环事件回传系统 (Action Event-Loop)

- 真实动作闭环：当按钮或表单带上 action 字段时，用户的点击或提交会即时组装为结构化事件回传给大模型，触发下一轮智能分析。
- 诚实交互设计：未声明 action 的按钮自动渲染为禁用态，杜绝“看起来可点但无反应”的假交互；点击有效按钮触发即刻给予视觉反馈。
- 智能防抖：按钮与切换项单次手势单次发送，连续滑块拖动自动开启尾沿防抖，仅回传最终停顿值。

5. 📌 常驻会话工作台 (Session Panel & Templates)

- 常驻 Dock 面板：支持通过 /panel 指令或 panel: true 将 UI 固化在输入框上方；支持鼠标拖拽边框调整高度；支持 append: true 增量追加标签页。
- 模板中心与成就系统：
- 模板中心：点击 Dock 顶部的「模板」即可预览 11 类典型业务场景模板，一键插词唤起模型；
- 探索成就：内置 12 项探索趣味成就，本地计数记录使用足迹。

6. 🛡️ 安全沙箱与容错自愈 (Safety & Self-Healing)

- 严格安全防线：所有组件严格受白名单结构约束，杜绝一切外部代码注入与 eval 执行；严禁索取与收集密码、API Key 等任何敏感凭据，密码类输入强制打码且绝不持久化。
- 同回合轮内自修 (Fence Steer Repair)：若模型生成的 dsh-ui 围栏存在格式缺陷，插件自动捕获错误并在同一回合内将精确节点诊断反馈给模型，触发自主纠正与重发（可配置 fenceFeedback: false 关闭）。
- 节点级自愈降级：单个语法异常节点被静默舍弃，同级其他正常组件继续完好渲染，绝不因个别节点错误拖垮整屏界面；Mermaid 常见语法缺陷自动修复重试。

💻 快速示例

示例 1：核心业务指标看板

模型在正文中输出以下 dsh-ui 围栏（规范化 JSON）：

{
"title": "2026 Q3 业务运行概览",
"items": [
{
"type": "row",
"items": [
{ "type": "stat", "label": "总营收", "value": "¥128,430", "delta": "+12.4%", "spark": [40, 55, 60, 85, 120] }, { "type": "stat", "label": "支付订单数", "value": "1,024", "delta": "-3.1%", "spark": [90, 85, 80, 75, 70] }, { "type": "progress", "label": "季度目标完成率", "value": 82, "variant": "ring" } ] } ] }

示例 2：ECharts 丰富折线与柱状图

{
"title": "月度营收走势分析",
"items": [
{
"type": "echart",
"title": "2026 上半年走势", "preset": "bar",
"data": [
{ "label": "1月", "value": 98 }, { "label": "2月", "value": 112 }, { "label": "3月", "value": 128 }, { "label": "4月", "value": 145 }, { "label": "5月", "value": 160 } ] } ] }

更多高级组件（函数绘图、表格排序过滤、测验表单等）的完整协议规范，请参阅 SKILL.md。

⚙️ 架构与运行机制

sequenceDiagram
autonumber
actor User as 用户 participant Host as DSH 宿主 / 大模型 participant DOM as DSH 对话 DOM participant GenUI as GenUI 客户端渲染器 participant Assets as 动态资产服务 (ECharts/Three)

User->>Host: 提问（例如："分析近期订单趋势"）
Host-->>DOM: 流式输出 Markdown 正文与 dsh-ui 围栏
DOM->>GenUI: 捕获围栏节点并进行白名单结构规范化 alt 依赖重型图表引擎 GenUI->>Assets: 动态按需加载引擎脚本
Assets-->>GenUI: 注入完成
end
GenUI->>DOM: 原地挂载独立 React 组件树，实时流式上屏 opt 本地即时交互 User->>GenUI: 点击表单排序 / 拖动函数滑块 / 答题判卷
GenUI-->>User: 毫秒级即时前端重绘与状态持久化
end
opt 触发闭环 Action User->>GenUI: 点击触发模型交互的按钮 GenUI->>Host: 回传结构化 Action 数据流
Host-->>DOM: 模型响应下一轮分析或更新常驻 Panel
end

成果导出能力

对渲染完成的 GenUI 内容，支持点击菜单导出为：
- 独立 .html：内嵌渲染核心、样式、KaTeX 字体及所用图表引擎，脱离 DSH 也能在任意浏览器中离线打开与交互。
- .genui.json：完整保存规范化后的 Spec 结构与持久化交互状态。

🧑💻 开发者指南

本地开发联调（Link 模式）

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

本地联调构建并软链至 DSH
dsh plugin --profile web add link:$PWD

常用命令

sh
pnpm run check # 类型检查 + 单元测试 + 构建
pnpm run test # 运行 Vitest 测试套件
pnpm run check:host-api dsh-v0.2.1-rc.3 # 检查当前发布版 DSH 的公开接口
pnpm run check:host-api dsh-v0.2.1-rc.4 # 检查 npm next；与源码宿主浏览器验收分开
pnpm run check:host-api dsh-v0.2.2-alpha.2 # 检查受支持的 npm alpha 接口、完整测试与构建
node scripts/verify-pack.mjs --keep # 生成并打包校验 tarball

端到端 E2E 验证

CI 与发布任务通过 node scripts/prepare-published-host.mjs 0.2.2-alpha.2 从 npm 安装精确版本，在独立 web profile 中验收插件安装包。此通道使用 DSH_HOST_LAYOUT=registry、DSH_HOST_VERSION=0.2.2-alpha.2 和脚本返回的 DSH_ROOT、DSH_BIN；源码宿主通道继续固定到对应官方标签。alpha 的接口、图片集合与计算字段、Linux 地图检查全部通过后才发布 npm。

- 视觉回归 E2E（无需模型 API Key）： sh
npx tsx scripts/e2e-visual.mts # 生成全量组件截图与交互验证断言
- 真机闭环 E2E（调用模型真实响应）： sh
export DSH_ROOT=/path/to/deepseek-harness-0.2.1-rc.3
export DSH_BIN="$DSH_ROOT/apps/cli/lib/bin.js"
DEEPSEEK_API_KEY=sk-... node scripts/e2e.mjs

进阶配置项

若需自定义插件行为，可在用户 profile 的 cordis.patch.yml 中调整： yaml
- id: genui
name: '@changfenhuang/dsh-genui'
config:
renderUiTool: false # 关闭额外注入的 render_ui 工具调用，仅保留正文 dsh-ui 围栏与 panel fenceFeedback: false # 关闭模型生成失败时的同回合自动 steer 纠错

dsh-go 接入

dsh-go 适配使用 App 已有的原生卡片、正文选择与确认、插件面板，无需修改或重新安装 App。网页版继续读取完整的 GenUI 规格；原生面板支持选择、开关、按钮、提交、本地判卷、页签、折叠、复制和受控链接。正文围栏由验证工具生成网页与原生共用的 JSON。面板交互目前需要本机引擎提供 dsh-go 桥接；SSH、中转仍可显示原生工具卡。高级图形和自由输入等缺口会明确提示。详见接入能力与验证范围。

Sidechat surface 接入（可选）

GenUI 可在 provider 明确提供的 sidechat surface 上渲染已结算的 dsh-ui 围栏。BetterSidebar 使用现有的 registerSidechatSurfaceAdapter 能力；其他 provider 可提供可选的 genuiSidechat Cordis service。每个 surface 都携带所属线程身份和专属 prompt 回调，因此动作与交互状态留在对应子线程。流式内容及不支持或无效的围栏保留原 Markdown。

请参阅 sidechat surface adapter 接口说明。BetterSidebar 侧边对话渲染需要包含配套 provider 实现的发布版本；已发布的 0.28.0 尚未提供 registerSidechatSurfaceAdapter。启用 DSH 原生 Side Chat 接入需要其 provider 提供 genuiSidechat。

❓ 常见问题排查 (FAQ)

Q: 为什么生成的 dsh-ui 仍然显示为普通代码块？

1. 打开浏览器开发者工具（F12），切换到 Console 面板；
2. 检索是否有 [genui] client active; fence-channel=dom 日志：
- 若没有：说明客户端 Bundle 尚未被 DSH 宿主激活。请检查 dsh plugin list 确认插件已正确安装，并尝试重启 DSH web 与硬刷新浏览器；
- 若已有：检查模型输出的代码块标签是否准确为 dsh-ui，且内容为合法的 JSON。

Q: 提示 "pnpm not found on PATH"？

DSH 的插件管理需要调用宿主系统的 pnpm。请在系统终端执行 corepack enable 或 npm i -g pnpm，安装完成后新开一个终端窗口再执行 dsh plugin add。

Q: npm install 返回 404？

本包是公开包（无需任何 npm 账号授权）。可先执行 npm view @changfenhuang/dsh-genui version 查看最新公开版本。若刚发布可能存在几分钟镜像同步延迟，请稍后重试。

Q: 3D 场景、Mermaid 或 ECharts 无法渲染？

图形重型引擎采用按需加载机制（首次使用时通过插件内置的静态路由拉取）。请先硬刷新网页（Cmd + Shift + R）；如果仍失败，可尝试重新安装插件：sh
dsh plugin --profile web remove @changfenhuang/dsh-genui
dsh plugin --profile web add @changfenhuang/dsh-genui

Q: 渲染 dsh-ui 时界面出现白屏？

当前版本要求 DSH ^0.2.0-rc.1 || ^0.2.1-rc.1 || ^0.2.2-alpha.2。如运行在较老版本的 DSH 上可能存在 React 上下文兼容问题，请升级 DSH 宿主。

🗺️ 路线图评估 (Roadmap)

| 探索方向 | 评估结论 | 决策理由 |
| 增量 Diff Patch | 暂不做 | 一条围栏仅消耗 200–800 Token，全量重发代价极小且极其稳定；Patch 差异协议的模型遵循成本与出错率反而偏高。 |
| 细粒度 Action 回传 | ✅ 已上线 | 按钮/表单离散手势立即回传；连续滑块拖动尾沿防抖，确保流畅度与模型上下文整洁。 |
| 跨会话深度状态继承 | 暂不做 | 新一轮对话由模型更新新 UI，状态重置是更合理的自然行为；流式输出期间状态已完整保留。 |
| 独立画廊与多语言抽取 | 暂不做 | 画廊素材已由 demo-prompts、gallery.ts 与 README 全面覆盖；核心内置文案仅数处，保持极简轻量。 |

🔗 链接与致谢

- Linux.do 社区讨论
- 欢迎访问 在线产品站 体验更多特性

📄 开源许可

本项目遵循 MIT License 开源协议。

交互式地图

map 使用延迟加载的 MapLibre 标记和内联路线，并始终提供可键盘操作的地点列表。
地点选择只在本地更新，可通过既有字段机制持久化并由独立提交按钮发送地点 ID。
默认是无街道底图的离线坐标地图；外部样式仅由可信宿主配置，不接受模型 JSON URL。
详见 地图契约与嵌入、导出说明。