@changfenhuang/dsh-genui 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
-## [Unreleased]
+## [0.11.0] - 2026-09-15
+
+### 新增
+- 数学公式支持 `$...$`、`$$...$$`、`\(...\)`、`\[...\]`，覆盖文本、表格、标题、步骤、时间线、选项与显示标签，以及强调中的公式、矩阵、分段和多行推导（#162、#168、#169）。使用 KaTeX 渲染，保留交互原值；不提供完整 LaTeX 文档或任意宏包编译，代码、输入原值、原生下拉选项与图形引擎内部标签仍遵循各自格式。
+- 提供应用嵌入入口、图形资源入口与技能文档导出；支持宿主传入初始状态、接收交互状态和配置资源地址，修复状态保存回调变化引起的重复回传（#167）。
+
+### 修复
+- 图示随宿主浅深主题即时更新配色，修正背景、高度与图例截断，移除水印序号（#152、#157）。
+- 浅色卡片恢复明亮卡面，保留描边与阴影层次（#159、#166）。
+- 被丢弃组件的校验结果保留具体字段错误；补齐字段速查中的类型与缺失字段（#163、#164、#168）。
+- 围栏识别忽略语言标签两端空白，拒绝疑似消息容器时记录结构原因并保留原文，便于定位未渲染问题（#158、#168）。
+- 常驻提示与技能明确要求正文和界面文案跟随用户语言（#165、#168）。
+- 按宿主插件规范导出插件名称（#155）。
+- 保留 ECharts 中有意留空的合法配置，同时继续移除不安全配置（#167）。
+
+### 验证与体积
+- 覆盖 Node.js 22/24、DSH 0.1.2-rc.1 与 0.1.5-rc.2，以及 Windows 打包检查；真实安装包验证公式、浅深主题和窄宽布局。
+- 数学渲染使浏览器脚本增加约 260 KB（未压缩）。
 
 ## [0.10.0] - 2026-09-11
 

package/README.md

@@ -93,7 +93,7 @@ The repository ships both renderer channels, the host plugin, and the built brow
 
 Prerequisites — all required:
 
-1. **dsh `^0.1.2-rc.1 || ^0.1.5-alpha.1`** (dsh-genui 0.10.0 is verified on DSH 0.1.5-rc.2 and the 0.1.2-rc.1 minimum; users on DSH `<=0.1.1-rc.x` should use dsh-genui `0.9.8`)
+1. **dsh `^0.1.2-rc.1 || ^0.1.5-alpha.1`** (dsh-genui 0.11.0 is verified on DSH 0.1.5-rc.2 and the 0.1.2-rc.1 minimum; users on DSH `<=0.1.1-rc.x` should use dsh-genui `0.9.8`)
 2. **`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
 
 Install and activate in DSH (one command, all dependencies included):

package/README.zh-CN.md

@@ -93,7 +93,7 @@ https://github.com/user-attachments/assets/f5db33ec-7471-4d4a-a85b-79c9962ab4ef
 
 前置条件，缺一不可：
 
-1. **dsh `^0.1.2-rc.1 || ^0.1.5-alpha.1`**（dsh-genui 0.10.0 已验证 DSH 0.1.5-rc.2，并保留 0.1.2-rc.1 下限验证；使用 DSH `<=0.1.1-rc.x` 的用户请使用 dsh-genui `0.9.8`）
+1. **dsh `^0.1.2-rc.1 || ^0.1.5-alpha.1`**（dsh-genui 0.11.0 已验证 DSH 0.1.5-rc.2，并保留 0.1.2-rc.1 下限验证；使用 DSH `<=0.1.1-rc.x` 的用户请使用 dsh-genui `0.9.8`）
 2. **`pnpm` 在 PATH 上**：`dsh plugin` 命令依赖它。没有就 `corepack enable`（或 `npm i -g pnpm`），然后**新开一个终端**，确认 `pnpm -v` 有输出
 
 安装并在 DSH 中激活（一行命令，自动带上全部依赖）：
@@ -230,6 +230,14 @@ dsh plugin --profile web add link:$PWD
 
 ## 🧑‍💻 开发
 
+### 嵌入其他应用
+
+支持 CSS Modules 和 TypeScript 的浏览器构建器可以从 `@changfenhuang/dsh-genui/embed` 导入 `GenuiBlock`、`GenuiActionContext`、`ErrorBoundary` 和 `processGenuiSpec`，复用同一份组件、样式与规格校验，无需加载 DSH 的插件入口。
+
+嵌入宿主通过 `initialState` / `onStateChange` 接管持久化，使用稳定的 `stateKey` 区分界面，通过 `GenuiActionContext.Provider` 接收动作。改变 `stateKey` 会开始新的交互生命周期；同一界面的后续刷新保留输入。设置 `onStateChange` 后不读写浏览器的交互状态存储。
+
+调用 `setGenuiAssetBase` 设置本地引擎目录；从公开的 `@changfenhuang/dsh-genui/assets/mermaid`、`assets/three`、`assets/echarts-core`、`assets/echarts` 构建对应脚本。模型指引从 `@changfenhuang/dsh-genui/skill` 读取。宿主只补自己的交付通道和设计变量；渲染器仍使用本包与 `@deepseek-ai/dsh-client-ui-primitives` 的组件。构建时提供 React、CSS Modules、KaTeX 字体及所用引擎依赖。
+
 ```sh
 pnpm install
 pnpm run check   # 类型检查 + 全量测试 + 构建

package/SKILL.md

@@ -5,12 +5,16 @@ description: "Render structured interactive UI inline in your reply via the dsh-
 
 # GenUI — 生成式 UI 输出规范
 
+**Language:** Match the user's requested language (otherwise the language of their message) in both surrounding prose and all user-visible UI text: titles, labels, content, options, and explanations. Chinese examples below illustrate the schema only; do not switch the conversation to Chinese after loading this skill. Keep JSON keys, component types, IDs, and actions unchanged. An English request gets English prose and UI text; a Chinese request gets Chinese prose and UI text.
+
 你可以**在回答正文中间**输出可交互 UI 组件：写一个 `dsh-ui` 围栏（fenced block with language tag `dsh-ui`），内含 JSON 规格，渲染器会把这一整块画成真实组件，文字照常穿插在前后。组件**就是回答的一部分**，不是工具调用。
 
 ```dsh-ui
 {"title":"可选标题","gap":14,"items":[...]}
 ```
 
+公式：`$...$` / `\(...\)` 为行内公式，`$$...$$` / `\[...\]` 为独立公式；支持矩阵、分段函数、多行对齐推导，以及加粗/高亮内的公式。正文、列表、键值、表头/单元格、卡片/步骤/时间线/标签页标题、题目与说明、按钮与表单标签、指标、媒体说明和图表外层标题共用此能力。JSON 字符串中的反斜杠必须双写，如 `"content": "\\(\\frac{a}{b}\\)"`。代码源码、输入值/占位符、原生下拉选项和图表引擎内部绘图文本仍遵循各自的原生格式，不解析富文本。数学语法以 KaTeX 为准，不执行 HTML、外部资源或脚本；不支持 LaTeX 文档编译、加载任意宏包。
+
 ## 组件词汇（只允许这些 type）
 
 布局：`text` `row` `col` `grid` `card` `divider` `spacer`