@zephinel/dsh-intelligent-ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/NOTICE +7 -0
  2. package/README.en.md +107 -86
  3. package/README.md +103 -82
  4. package/assets/intelligent-ui-components-layout.webp +0 -0
  5. package/assets/intelligent-ui-dashboard-en.webp +0 -0
  6. package/assets/intelligent-ui-dashboard-zh.webp +0 -0
  7. package/assets/intelligent-ui-editing-en.webp +0 -0
  8. package/assets/intelligent-ui-editing-zh.webp +0 -0
  9. package/assets/intelligent-ui-itinerary-en.webp +0 -0
  10. package/assets/intelligent-ui-itinerary-zh.webp +0 -0
  11. package/assets/intelligent-ui-on-demand-hint.webp +0 -0
  12. package/assets/intelligent-ui-quiz-en.webp +0 -0
  13. package/assets/intelligent-ui-quiz-zh.webp +0 -0
  14. package/assets/intelligent-ui-readme-components.webp +0 -0
  15. package/assets/intelligent-ui-readme-controls.webp +0 -0
  16. package/assets/intelligent-ui-readme-generation-en.webp +0 -0
  17. package/assets/intelligent-ui-readme-generation-zh.webp +0 -0
  18. package/assets/intelligent-ui-readme-overview-en.webp +0 -0
  19. package/assets/intelligent-ui-readme-overview-zh.webp +0 -0
  20. package/assets/intelligent-ui-readme-temporary.webp +0 -0
  21. package/assets/intelligent-ui-real-dashboard-en.webp +0 -0
  22. package/assets/intelligent-ui-real-dashboard-zh.webp +0 -0
  23. package/assets/intelligent-ui-real-itinerary-en.webp +0 -0
  24. package/assets/intelligent-ui-real-itinerary-zh.webp +0 -0
  25. package/assets/intelligent-ui-real-quiz-en.webp +0 -0
  26. package/assets/intelligent-ui-real-quiz-zh.webp +0 -0
  27. package/assets/intelligent-ui-settings.webp +0 -0
  28. package/assets/intelligent-ui-style-panel.webp +0 -0
  29. package/assets/intelligent-ui-temporary-result-dark.webp +0 -0
  30. package/assets/intelligent-ui-temporary-result.webp +0 -0
  31. package/assets/intelligent-ui-toggle.png +0 -0
  32. package/lib/client.js +169 -146
  33. package/lib/index.js +101 -62
  34. package/lib/standalone.css +1 -1
  35. package/lib/standalone.js +139 -133
  36. package/licenses/remix-icon-LICENSE +186 -0
  37. package/package.json +12 -6
  38. package/skills/intelligent-ui/SKILL.md +46 -25
  39. package/skills/intelligent-ui/references/components.md +10 -10
  40. package/skills/intelligent-ui/references/integration.md +24 -22
  41. package/skills/intelligent-ui/references/troubleshooting.md +11 -2
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  [![npm version](https://img.shields.io/npm/v/@zephinel/dsh-intelligent-ui?label=npm)](https://www.npmjs.com/package/@zephinel/dsh-intelligent-ui)
8
8
  [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
9
- [![DSH](https://img.shields.io/badge/DSH-0.2.1-4f46e5)](https://www.npmjs.com/package/@deepseek-ai/dsh)
9
+ [![DSH](https://img.shields.io/badge/DSH-0.2.2-4f46e5)](https://www.npmjs.com/package/@deepseek-ai/dsh)
10
10
  [![publish](https://github.com/Zephinel/dsh-intelligent-ui/actions/workflows/publish.yml/badge.svg)](https://github.com/Zephinel/dsh-intelligent-ui/actions/workflows/publish.yml)
11
11
 
12
12
  **把 DeepSeek Harness(DSH)的模型回答变成一张真正能用的页面。** 安装并启用后,直接提问:
@@ -15,59 +15,79 @@
15
15
  帮我排一个上海两日游,要能勾选和调整
16
16
  ```
17
17
 
18
- 模型调用 `render_ui` 工具,把答案写成一份 [OpenUI Lang 1.0](https://openui.com) 程序;DSH 聊天页在该轮结束时把它渲染成可交互页面——地图、照片、图表、清单、表单、SVG 绘图、小游戏都是真实组件,不是截图。
18
+ 模型调用 `render_ui` 工具,把答案写成一份 [OpenUI Lang 1.0](https://openui.com) 程序;DSH 聊天页在该轮结束时把它渲染成可交互页面——地图、照片、图表、清单、表单、SVG 绘图、小游戏都是真实组件。
19
19
 
20
20
  基于 [Open Intelligent UI](https://github.com/thesysdev/open-intelligent-ui)(MIT)移植,并附带一个随插件自动注册的 Agent Skill(`intelligent-ui`)。
21
21
 
22
22
  > [!NOTE]
23
- > **当前状态**:已发布到 GitHub 与 npm,npm 版本 **`@zephinel/dsh-intelligent-ui@0.5.0`**(`latest`)。自定义样式、按需生成、自由布局与模板文件导入/导出,以及渲染契约、Host 校验与导出语义修复均已包含在 0.5.0 中。
23
+ > **当前状态**:已发布到 GitHub 与 npm,npm 版本 **`@zephinel/dsh-intelligent-ui@0.6.1`**(`latest`)。0.6.1 修复内置 OpenUI parser 的指数展开导致的 Host 卡顿/OOM(`@openuidev/lang-core` 1.0.1 → 1.1.1);0.6.0 的就地编辑与修订历史、Auto 页面/文字决策、实验性「回答即文档」、本地图片、样式切换与侧栏更新提示继续可用。
24
24
 
25
25
  [快速开始](#快速开始) · [获取代码](#获取代码) · [构建、测试与部署](#构建测试与部署)
26
26
 
27
27
  ## 效果
28
28
 
29
- ![上海两日行程:照片、地图、时间线、清单、预算与可交互控件都由 OpenUI Lang 渲染](assets/intelligent-ui-itinerary.webp)
29
+ ![总览:行程页面、编辑画布与设置页](assets/intelligent-ui-readme-overview-zh.webp)
30
30
 
31
31
  - 用户问「帮我排一个上海两日游」,模型不再只回一段文字:回答末尾直接渲染一张可点击、可勾选、可拖动的行程页面(地图 + 照片 + 时间线 + 清单 + 预算)。
32
32
  - 卡片内的 `$变量`、`@Set`、`@functions` 全部在浏览器本地执行:勾选、滑动条、Stepper、计时器、预算分配都不需要再请求模型。
33
+ - 已经渲染的页面可以继续改:点卡片标题栏的「编辑」,选择区块填写修改要求,或在「区块编排」里拖拽/键盘调整顺序;复制、删除、移动、嵌套编辑、快捷调整和修订会由 Host 确定性记录。完整操作见[使用指南](docs/usage.md#编辑已渲染页面)。
33
34
  - 只有真正需要继续对话的动作(`@ToAssistant`,例如表单提交)会把一条简短消息放回输入框并发送。
34
35
 
35
- ## 组件一览
36
+ ## 生成
37
+
38
+ 生成是插件的核心:打开输入框右侧的 **UI** 控件(或发送 `/iui on`),然后正常提问。模型调用 `render_ui`,把答案写成一份 [OpenUI Lang](https://openui.com) 程序;DSH 在该轮结束时把它渲染成可交互页面。
36
39
 
37
- 渲染器不是把一段文字包进聊天气泡,而是一套完整的组件库:**57 个组件、73 个函数、5 种动作**。下面三张卡片都是扩展的真实渲染结果——同一套渲染器、同一套 DSH 主题 token,没有设计稿:
40
+ - 不需要额外步骤:提问 → 模型生成 → 轮末出现卡片。
41
+ - **模型决定要不要出页面(Auto 无默认)**:按「是否让用户更快、更准地理解」判断——概念、机制/流程、结构、对比、数据或交互用页面;裸事实、术语复述、不解释运作方式的一句话定义、代码/翻译、闲聊或明确要文字时直接用 Markdown。两边都像适用时看**种类**:解释「怎么运作」即使文字版本很短也用页面。出页面时可在 **UI → 显示样式** 里按会话选 Card / Article,或交给 **Auto**(Card、Article 或自由布局);**按需生成** 则只描述需求、不选模板。
42
+ - 页面里的 `$变量`、`@Set`、`@functions` 在浏览器本地运行;只有 `@ToAssistant` 会把一条简短消息放回输入框。
43
+ - 生成的是真实组件:可以勾选、拖动、展开、播放,也可以继续编辑。
38
44
 
39
- ![一切可渲染的内容:57 个组件、73 个函数、5 类动作,以及布局(11 个)与文本(12 个)组件分组](assets/intelligent-ui-components-layout.webp)
45
+ ![三个真实 DSH 会话生成的不同页面:上海两日游行程、咖啡店数据看板和欧洲首都小测](assets/intelligent-ui-readme-generation-zh.webp)
40
46
 
41
- ![输入、媒体与数据:13 个输入组件,以及照片、表格、图表、地图与 YouTube](assets/intelligent-ui-components-inputs.webp)
47
+ 上面的组合图来自真实 DSH 会话(DeepSeek V4.1 Flash · Max):同一套渲染器生成了行程、数据看板和小测三种不同类型的页面,不是手写样例。
42
48
 
43
- ![交互与绘制:翻面卡、撒花开关、十个 Svg 绘图组件与沙盒 iframe 小游戏](assets/intelligent-ui-components-drawing.webp)
49
+ 更完整的开关、样式、模板和按需生成说明见[使用指南](docs/usage.md)。
44
50
 
45
- ## 更多示例
51
+ ## 编辑已渲染页面
46
52
 
47
- ![销售看板:KPI、折线、环图与明细表都随区域筛选实时重算](assets/intelligent-ui-example-dashboard.webp)
53
+ 页面渲染出来之后,还可以继续改。
48
54
 
49
- ![咖啡冲煮小测:翻面卡、答对反馈、得分条与沙盒小游戏](assets/intelligent-ui-example-quiz.webp)
55
+ ![编辑画布:轨道光晕、样式区(样式切换 + 样式要求)、行尾 More 菜单、编排与请求面板](assets/intelligent-ui-editing-zh.webp)
50
56
 
51
- 窄屏下卡片自动切为单列,地图与图表按卡片宽度自适应;图表分类标签过长时会截断而不是溢出(约 380 px 宽):
57
+ - 点卡片标题栏的 **编辑** 进入画布;根层区块显示淡色轨道光晕。
58
+ - 每行右侧的 **更多** 菜单提供定位/编辑/复制/移动到…/删除;删除在菜单内二次确认。
59
+ - 区块请求、拖拽/键盘排序、嵌套编辑、Divider/Spacer 快捷调整和结构预览都在左侧面板完成;结构操作先进入本轮待执行队列,点底部「应用」并在总预览中确认后,由 Host 一次性记录一条结构修订。仅含结构操作的 Apply 记录修订后关闭草稿;同时含区块请求/整体说明/排序时,剩余请求会在结构修订后自动发送(输入框有正文时保留 chip 手动发送)。
60
+ - 修订历史(卡片头部历史图标,编辑过的修订会在图标后显示修订号)可查看每个 Artifact 的修订,并删除已记录的修订;删除前会内联确认,初始渲染不可删,仍被其他修订作为基础的修订需先删更新的那条。删除卡片正在渲染的修订时,确认文案会写明回退目标;删除后该卡片回退到修订号更小、program 仍保留的最新一条修订(回退目标后来又删除时会沿回退链继续解析到仍存在的修订),stage 选中这个回退目标并在显示它时保持只读;选择其他修订即可恢复编辑。回退后的卡片只读,避免与原生卡片共用编辑会话。会话内任一张卡有未发送编辑草稿时,对应基础修订不可删。找不到可回退目标时这一行不提供删除;仍被更新的修订作为基础的修订直接隐藏删除说明原因。其他仍显示该修订的卡片只在回退目标可用时才会一起回退,否则可能变为 stale。
61
+ - 面板顶部的 **样式** 区(点 **更改样式** 展开)有两件事:一是 **样式切换**——用单选列表选择并预览内置 Card/Article 或已保存模板,再点 **应用样式**(零模型、立即记录一条新修订,只换样式与主题、不改内容;Article 需要页面本身有目录和章节,不满足时该行会置灰);二是 **或用文字描述(由模型修改)**——用一句话描述视觉调整(≤2000 字),发送后模型按说明调整样式(版式由 Host 强制保持,内容变动只会告警),并记录为新的临时样式修订。临时结果也可以在这里调样式。支持新 Host 且可编辑的卡片不再显示底部的「调整样式」按钮(旧 Host/不可编辑卡片保留回退;被重定向的只读回退卡不显示 Save/Adjust)。
62
+ - 完整流程见[使用指南](docs/usage.md#编辑已渲染页面)。
63
+
64
+ ## 组件一览
52
65
 
53
- ![窄屏下的手冲咖啡计算器:单列布局、无横向溢出](assets/intelligent-ui-responsive.webp)
66
+ 生成的页面由下面这些组件构成。渲染器不是把一段文字包进聊天气泡,而是一套完整的组件库:**57 个组件、73 个函数、5 种动作**。下面这张总览来自扩展的真实渲染结果——同一套渲染器、同一套 DSH 主题 token,没有设计稿:
67
+
68
+ ![组件与示例总览:布局、文本、输入、媒体、数据、交互、绘图和真实示例](assets/intelligent-ui-readme-components.webp)
69
+
70
+ 三个真实示例(销售看板、咖啡冲煮小考、手冲计算器·窄屏)也在同一张图里;窄屏下卡片自动切为单列,图表标签过长时截断而不是溢出。
54
71
 
55
72
  ## 核心能力
56
73
 
57
74
  | 能力 | 说明 |
58
75
  |---|---|
59
- | 交互页面 | 地图、照片、图表、清单、表单、SVG 绘图、小游戏都是真实组件,不是截图 |
76
+ | 交互页面 | 地图、照片(含工作区里的本地图片文件)、图表、清单、表单、SVG 绘图、小游戏都是真实组件 |
77
+ | 区块编辑与编排 | 在已渲染页面上为区块填写修改要求、拖拽或用键盘调整顶层区块顺序(画布实时预览目标顺序);支持只改内容、只调顺序或两者同时,内容修改以区块片段返回、由 Host 合并回未选区块逐字节不变的页面,结果是新的修订。同一聊天可并行保留多份草稿(单画布激活、每 Artifact 一个 chip),一次发送最多提交 3 个 Artifact 的修改请求,各修订独立生成;历史修订可零模型恢复为本地修订卡片,或在冲突时基于旧修订创建新分支;临时样式结果支持区块内容修改(保留原样式快照);容器内嵌套区块(`Col`/`Row`/`Box`/`Grid`/`Card`/`Section`/`Carousel`,opt-in)支持内容修改、同父内部排序、模型新增区块,以及零模型的复制/删除/跨容器移动结构操作(记录新修订,根层顺序不变) |
60
78
  | 导出图片 | 把该轮渲染结果保存为一张 PNG:原始 / 圆角 / 卡片三种美化;背景色与 1x/2x 在插件详情页设置 |
61
- | 导出交互页面 | 把该轮全部卡片导出为单个 HTML 文件,浏览器打开后继续交互;`@ToAssistant` 改为复制文案并提示回 DSH 粘贴 |
79
+ | 导出交互页面 | 把该轮全部卡片导出为单个 HTML 文件,浏览器打开后继续交互;工作区本地图片会内联为 data URL,离线也能显示;`@ToAssistant` 改为复制文案并提示回 DSH 粘贴 |
62
80
  | 本地执行 | `$变量`、`@Set`、`@functions` 在浏览器运行;只有 `@ToAssistant` 回写消息 |
81
+ | 回答即文档(实验) | 插件详情页「实验性功能 → 回答即文档(实验)」开关;开启后普通回答渲染为无卡片外壳的文档,读起来接近聊天正文,模型把整篇内容写进页面、不再额外输出文字;边界见[已知限制](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/limitations.md) |
63
82
  | 开关与样式 | 全局默认在插件详情页;输入框 UI 控件按会话覆盖;内置 Auto / Card / Article 与自定义模板 |
64
83
  | 自定义模板与视觉主题 | 保存可复用的展示偏好与明暗配色、字体、圆角、密度、阴影;在「我的样式」中使用、重命名、编辑或删除 |
65
84
  | 聊天内按需生成 | 无需模板;在 UI 面板选择「按需生成」,正常发送需求,必要时用内置提问工具澄清 |
66
- | 按需自由布局(未发布) | 按用户需求编排页面;保存模板保留自由布局、偏好与主题,再次使用仍无 Card/Article 外壳 |
67
- | 临时结果与可选保存 | 结果自带内联样式快照,可直接使用、调整样式或事后保存为模板;不强制预览、命名或保存 |
85
+ | 按需自由布局 | 按用户需求编排页面;保存模板保留自由布局、偏好与主题,再次使用仍无 Card/Article 外壳 |
86
+ | 临时结果与可选保存 | 结果自带内联样式快照,可直接使用、在编辑画布内调整样式或事后保存为模板;不强制预览、命名或保存 |
68
87
  | 双语界面 | 跟随 DSH 的中文或英文界面语言 |
69
88
  | Agent Skill | 随插件注册 `intelligent-ui`,模型按需加载完整语法、示例与排障 |
70
- | 插件详情页 | 集中管理全局启用、默认样式、模板、编排方式与导出偏好 |
89
+ | 插件详情页 | 集中管理全局启用、默认样式、模板、编排方式、实验性功能与导出偏好 |
90
+ | 更新提示 | Host 侧查询 npm 最新稳定版与本次 Release 的更新要点(6 小时缓存;要点来自发布前人工审核的 `release-notes/<version>.md`,英文可选同目录 `<version>.en.md`、缺失时回退默认文件);有新版本时在侧栏插入卡片,点「点击查看详情」只弹出要点浮窗,点卡片其余区域(含右侧箭头)打开插件详情页;箭头始终朝右,卡片在正常文档流中,不遮挡 Plugins / Automation tasks |
71
91
  | 可重放 | 程序与临时样式随工具参数重放;导出页面冻结导出时的主题方案 |
72
92
 
73
93
  ## 获取代码
@@ -85,17 +105,17 @@ cd dsh-intelligent-ui
85
105
 
86
106
  以下命令用于 DSH Web 与源码开发;DSH Desktop 用户可直接按[快速开始](#快速开始)中的应用内步骤安装。
87
107
 
88
- - **DSH 0.2.1 插件接口**([`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)):Host/Client 与插件协议按这个版本开发;实际验证版本是 `0.2.1-rc.2`,更晚版本未验证。安装命令固定到已验证版本:`npm install -g @deepseek-ai/dsh@0.2.1-rc.2`。
108
+ - **DSH 0.2.2 插件接口**([`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)):Host/Client 与插件协议按这个版本开发;实际验证版本是 `0.2.2-rc.1`(当前最新),更晚版本未验证。安装最新版:`npm install -g @deepseek-ai/dsh`。
89
109
  - **[Node.js 24 与自带的 npm](https://nodejs.org/en/download)**:构建、测试与发布工作流使用 Node 24。仓库没有 `engines` 或 `.nvmrc` 版本锁,运行 `npm install` 前需自行选用 Node 24;Host 的 Node 22 编译目标不代表整个工具链已在 Node 22 验证。
90
110
  - **[Git](https://git-scm.com/downloads)**:仅获取源码时需要,仓库未指定最低版本。
91
- - **`@deepseek-ai/dsh-client-locale`**:浏览器半边要求部署组合了它;DSH Web 0.2.1 默认包含,缺少时开关和卡片不会挂载(Host 工具与提示词仍可用)。
111
+ - **`@deepseek-ai/dsh-client-locale`**:浏览器半边要求部署组合了它;DSH Web 0.2.2 默认包含,缺少时开关和卡片不会挂载(Host 工具与提示词仍可用)。
92
112
 
93
113
  确认工具存在:
94
114
 
95
115
  ```bash
96
116
  node --version # v24.x
97
117
  npm --version
98
- dsh --version # 已验证:0.2.1-rc.2
118
+ dsh --version # 已验证:0.2.2-rc.1
99
119
  git --version # 仅获取源码时需要
100
120
  ```
101
121
 
@@ -103,10 +123,10 @@ git --version # 仅获取源码时需要
103
123
 
104
124
  ## 快速开始
105
125
 
106
- **DSH Web**:从 npm 安装已发布的 0.5.0,再启动 Web UI(首次前台运行示例):
126
+ **DSH Web**:从 npm 安装已发布的 0.6.1,再启动 Web UI(首次前台运行示例):
107
127
 
108
128
  ```bash
109
- dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.5.0
129
+ dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.6.1
110
130
  dsh web
111
131
  ```
112
132
 
@@ -117,29 +137,26 @@ dsh web
117
137
  **DSH Desktop(桌面版)** 不需要终端命令,在应用内安装:
118
138
 
119
139
  1. 侧栏 **插件** → **添加插件**(或箭头 → **安装第三方插件**)。
120
- 2. 输入 `@zephinel/dsh-intelligent-ui@0.5.0`(或只填包名装最新版),点 **安装**。
140
+ 2. 输入 `@zephinel/dsh-intelligent-ui@0.6.1`(或只填包名装最新版),点 **安装**。
121
141
  3. 安装完成后点 **立即启用**;若输入框右侧没有 **UI** 控件,退出并重开 DSH Desktop。
122
142
 
123
143
  桌面版的 profile 由 Electron 应用独占管理,`dsh plugin --profile desktop` 会被拒绝。国内镜像可能晚于 npm 官方源同步刚发布的版本;装不到时把安装源切回 npm 官方源。
124
144
 
125
- 安装后在输入框右侧点 **UI** 控件,选择「仅本会话」(或发送 `/iui on`),再发送开头的行程示例。该轮结束后出现可交互的行程页面即验证成功。需要时可在同一面板设置本会话的 Auto / Card / Article 样式。
145
+ 安装后在输入框右侧点 **UI** 控件,选择「仅本会话」(或发送 `/iui on`),再发送开头的行程示例。该轮结束后出现可交互的行程页面即验证成功。需要时再打开 **UI** 菜单,选「显示样式」(或点击已激活的「仅本会话」项)设置本会话的 Auto / Card / Article 样式——切换启用范围本身不会再自动弹出样式面板。
126
146
 
127
147
  本地开发(从 checkout 构建并安装)、卸载与排障见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md);扩展没有独立的开发服务器。
128
148
 
129
149
  ## 开关与回答样式
130
150
 
131
- ![输入框右侧的 UI 控件:Off / This session only / All sessions,以及分隔线下的 Display style](assets/intelligent-ui-toggle.png)
132
-
133
- ![样式面板:内置 Auto / Card / Article 卡片、自定义样式与底部按需生成入口](assets/intelligent-ui-style-panel.webp)
151
+ ![控件与面板:Composer UI 开关、样式面板与按需生成提示](assets/intelligent-ui-readme-controls.webp)
134
152
 
135
153
  - **全局默认**:插件详情页的「在所有会话中启用」与「回答样式」设置新会话默认值;可以选择内置样式或已保存的全局模板。
136
- - **会话覆盖**:点 Composer 的 **UI** chip →「仅本会话」或「显示样式」进入面板。上方是内置 Auto / Card / Article 预览卡片,中间是「自定义样式」(已保存模板),底部是「按需生成」。「全部会话」表示本会话跟随全局开关,不会打开全局开关;`/iui on|off|inherit` 与 `/iui style auto|card|article|inherit|<cs_id>` 提供命令入口。
137
- - **Auto** 由模型按请求选择:交互/结构化用紧凑 Card,详尽/深入/长文用 Article。Article 需要 `Toc`、可折叠 `Section` 和实质正文。
154
+ - **会话覆盖**:点 Composer 的 **UI** chip:切换启用范围只改变开关状态、不自动打开面板;要打开样式面板,点菜单里的「显示样式」行,或点击已激活的「仅本会话」/「跟随全局」项(仅在解析为开启时)。上方是内置 Auto / Card / Article 预览卡片,中间是「自定义样式」(已保存模板),底部是「按需生成」。「跟随全局」表示本会话跟随全局开关,不会打开全局开关;chip 会直接显示「全局开启 / 全局关闭」,全局关闭时这里会明确显示 `跟随全局 · 全局关闭`;`/iui on|off|inherit` 与 `/iui style auto|card|article|inherit|<cs_id>` 提供命令入口。
155
+ - **Auto** 由模型决定格式与版式:先判断这次回答该不该出页面;要出时交互/结构化用紧凑 Card,详尽/深入/长文用 Article,两种外壳都不合适时用自由布局(`Toc`/`Section` 可选)。Article 需要 `Toc`、可折叠 `Section` 和实质正文。**Card / Article 只是出页面时的版式偏好**,模型认为文字更合适时仍可只回 Markdown。
156
+ - **实验性:回答即文档**:插件详情页的「实验性功能」分组提供「回答即文档(实验)」。开启后,普通回答出页面时不再有标题栏、折叠、边框和卡片操作,页面读起来就是这一轮的聊天正文;模型把正文、表格等普通内容与交互块一起写进同一个 `render_ui` 程序,并且不再额外输出 Markdown。它是消息内嵌 UI 的过渡呈现:页面仍挂在轮末,复制、搜索和会话导出 Markdown 不包含页面正文,DSH 原生支持后会移除此开关;按需生成、保存模板与 Artifact 编辑请求不受影响。
138
157
  - **按需生成**:选择后面板关闭,焦点回到输入框,出现可取消的提示与示例;示例只填入内容,保留已有草稿,不自动发送。正常发送后,清晰需求直接渲染,有重要歧义时由内置 `ask_user_question` 结构化提问,回答后继续生成。
139
158
  - 会话启用/样式设置原子写入 `<DSH_HOME>/dsh-intelligent-ui.json`;按需操作不改这些设置,临时样式也不是当前选中的样式。完整边界见[架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md)。
140
159
 
141
- ![已武装的按需生成提示:示例只填入输入框,不发送](assets/intelligent-ui-on-demand-hint.webp)
142
-
143
160
  ## 使用
144
161
 
145
162
  打开开关后直接用自然语言提问,例如:
@@ -149,37 +166,21 @@ dsh web
149
166
  - 「把这几张表变成一个可以筛选的销售看板」
150
167
  - 「介绍一下中国历史,要能按朝代展开」
151
168
  - 先选「按需生成」,再发送「把这次分析做成紧凑仪表盘,用卡片和图表突出关键指标」
152
- - 点结果下的「调整样式」,再发送「保留内容,改成留白更多的阅读版式」
153
-
154
- 开启后,**有结构的回答默认用卡片呈现**——包括讲解、介绍、时间线、阶段、对比和可探索内容;文字只用于单个事实、一两句话的答复、你明确要文字/文档/代码,或渲染连续失败。开关没打开时,模型看不到 `render_ui`,会直接用文字回答——这不是故障;打开开关再问即可。
155
-
156
- 如果一定要保证出卡片(或模型仍然回了文字),在开关已打开的会话里用 `/intelligent-ui` 显式调用技能;显式调用会被当作直接指令。也可以说「读取 intelligent-ui skill 然后用 render_ui 做一个…」。
157
-
158
- ![临时结果:临时样式标记、调整样式与保存为模板](assets/intelligent-ui-temporary-result.webp)
159
-
160
- ![同一临时结果在固定深色主题下的渲染](assets/intelligent-ui-temporary-result-dark.webp)
161
-
162
- 临时结果可以立即使用。点「调整样式」会关联这张结果并在保留草稿的前提下填入调整提示,仍需正常发送;点「保存为模板」才填写名称、描述与可用范围(本会话或全局);保存完整保留该结果的布局(free/card/article)、偏好与显式明暗主题,不再选择布局。结果没有显式主题时继承会话主题,此时不提供「保存为模板」,因为没有可复制的配色。自由模板使用独立预览与「自由布局」提示;选中后仍无 Card/Article 外壳,保留 DSH 卡片标题栏,Toc/Section 可选。保存复用该结果的已校验样式,不再次生成,也不自动选中模板或更改全局默认;不要求先预览、命名或保存。
163
-
164
- **0.5.0 起**:Host 要求新按需生成使用自由布局;调整保留父结果的布局(free、旧 card 或 article)。若父快照已不在最近 200 条结果注册表中,调整会报错;请取消调整后重新选择「按需生成」。历史结果仍可从工具参数重放。
169
+ - 点已渲染页面标题栏的「编辑」,修改区块或调整顺序后正常发送
165
170
 
166
- ![插件详情页:全局启用、默认样式、我的样式管理、编排方式与导出](assets/intelligent-ui-settings.webp)
171
+ 编辑请求会留在输入框的 chip 里:每个 Artifact 一个 chip,标签为「编辑 {title} · 修订 N · {摘要}」;从旧修订分支时追加「 · 分支」。删除 chip 只会把对应草稿从本次发送移除,草稿仍可在「待提交编辑」区重新附加;一次发送最多合并 3 个 Artifact。
167
172
 
168
- 插件详情页按 **可用性**、**回答样式**、**我的样式**、**编排方式** 和 **导出** 分组。「我的样式」管理已保存的全局模板,可设为默认、重命名、编辑描述/展示偏好、导出文件、导入模板或删除;Composer 管理当前会话可见的全局与会话模板。生成入口在 Composer,设置页提供说明,不设生成工作台。全局值是新会话的默认;输入框 UI 控件里的会话值优先。**自由布局**只影响设计规范的建议强度,与回答样式正交。**导出** 保存图片的默认背景色、1x/2x 分辨率,以及图片/交互页面是否移除 `@ToAssistant` 追问控件及其表单字段(含正文的 Card 保留正文,只有纯追问区块整块消失;默认移除)。
173
+ 开关打开后由模型按回答判断是否出页面;想确保这次一定出页面(或模型仍然回了文字),在已开启的会话里用 `/intelligent-ui` 显式调用技能。更完整的开关、模板、按需生成和编辑教程见[使用指南](docs/usage.md)。
169
174
 
170
- **模板文件分享**:在插件设置页「我的样式」或 Composer 的「显示样式」面板中点模板的 `…` →「导出文件」,检查敏感信息提示后点「下载」,得到 `<模板名>.iui-style.json`。Composer 面板同时覆盖仅本会话的模板,因此不必先另存为全局模板。文件包含名称、描述、基础布局、展示规范全文和主题;分享前检查其中是否包含个人或内部信息。接收方在「我的样式」或「显示样式」面板点「导入模板」,选择文件或粘贴 JSON →「预览」→ 检查名称、描述、布局、明暗色板及展示规范全文。可以改名、编辑或清空展示规范;导入前必须勾选「我已阅读并理解上述风险,确认导入该外部模板」,再点「导入模板」。导入只新建全局模板(Composer 里的导入同样只写全局;导入到本会话仍待会话授权校验后开放),不自动应用,也不改变当前选择或全局默认;随后可正常选用、编辑、删除或再次导出。
175
+ ### 临时结果
171
176
 
172
- 模板交换格式 v1 只包含可移植样式配置,支持 `card|article|free`,不含本地 id、作用域、会话和时间戳。支持 v1 的插件版本可以导入该格式;未知版本会被拒绝,不尝试降级解析。导入器只接受该交换格式:原始模板导出文件与持久化库文件都会被拒绝(当前没有外部用户,不维护旧格式兼容)。交换格式版本独立于 npm 包版本;未来引入 v2 应继续支持 v1,新增布局或移除 `baseLayout` 必须显式演进格式,不允许 v1 静默接受未知布局。
177
+ ![临时结果:临时样式标记与保存为模板,以及固定深色主题版本](assets/intelligent-ui-readme-temporary.webp)
173
178
 
174
- 单次只交换一个模板,输入最多 **32 KiB(UTF-8 字节)**;文件大小先检查再读取,不依赖扩展名或 MIME。允许全文包住的一层 Markdown 代码围栏,不从任意说明文字中提取 JSON。未知字段和模板库备份均拒绝。全局最多 40 个模板;重名时建议 `(Imported)` 后缀,仍冲突时需改名,配额满时先删除不需要的模板。没有分享码、在线链接、批量备份或会话范围导入;Composer 的导入同样只写全局。
175
-
176
- **安全边界**:外部模板的名称与展示规范会进入提示词、可能影响模型行为;描述仅保存/导出,不会进入提示词。三者都按不可信文本处理,预览、阅读确认和不自动应用是缓解措施,不能消除提示词注入;实际执行权限仍由 DSH 工具/权限层控制。当前实现按 owner 已确认的方案(2026-10-24)用免责声明 + 阅读确认后保留外部内容;真实部署的 Origin/CSRF 与工具越权审计仍是发布前建议补做的加固。
177
-
178
- 回答渲染完成后,消息底部操作栏的**最右侧**会出现带「导出」字样的**药丸按钮**(只有扩展渲染的回答才有)。点开后可把该轮全部卡片保存为一张 PNG——**原始**(只截取答案本身)、**圆角**(背景色 + 圆角留白)或 **卡片**(留白、圆角与柔和阴影);也可以导出为单文件 HTML,直接在浏览器打开即可继续交互,页面里的 `@ToAssistant` 改为复制消息并提示回到 DSH 粘贴。导出的图片只包含渲染出的卡片,不包含聊天里的 Markdown 文字或导出按钮本身。完整流程见[架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md)。
179
+ 临时结果可以立即使用;样式调整在卡片的「编辑」画布内完成(在 **样式 → 更改样式** 区描述或直接切换内置/已保存样式;版式由 Host 保持,内容变动只会告警),点「保存为模板」才填写名称和范围。保存复用该结果的已校验样式,不自动选中模板或更改全局默认。旧 Host 或不可编辑的临时卡片仍保留底部的「调整样式」回退按钮。
179
180
 
180
181
  ## 构建、测试与部署
181
182
 
182
- 从[获取代码](#获取代码)的 checkout 根目录开始。`npm install` 的 `prepare` 会自动构建;本地安装器默认写入 `web` profile 并自动备份。若该 profile 已安装 npm/GitHub 版,先用 `dsh plugin --profile web remove @zephinel/dsh-intelligent-ui` 移除,避免同一插件重复注册。
183
+ 从[获取代码](#获取代码)的 checkout 根目录开始。`npm install` 的 `prepare` 会自动构建;本地安装器默认写入 `web` profile 并自动备份。若该 profile 已安装 npm/GitHub 版,先用 `dsh plugin --profile web remove @zephinel/dsh-intelligent-ui` 移除,避免同一插件重复注册。切换与回滚步骤见[两种安装模式与切换](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md#两种安装模式与切换);发布前按[发布前检查](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md#发布前检查)依次运行三条命令。
183
184
 
184
185
  ```bash
185
186
  npm install
@@ -197,54 +198,55 @@ dsh web
197
198
  | `npm run build` | 生成 prompt、Host、Client 与独立导出页面 bundle |
198
199
  | `npm test` | 构建后运行 Host、Client 与打包的 Node 测试 |
199
200
  | `npm run typecheck` | 运行 `tsc --noEmit`(浏览器 `src/client` 暂因运行时平台类型不可解析而排除) |
200
- | `npm run check` | 提交前完整检查:typecheck、构建、Node 测试与 renderer 检查 |
201
+ | `npm run check` | 提交前完整检查:typecheck、构建、Node 测试、renderer 检查、文档事实/链接与打包事实检查 |
201
202
  | `npm run pack:check` | 预览 npm 包最终文件清单,不发布 |
202
- | `npm run test:browser` | 先构建;运行 7 个浏览器套件,需要 Chrome |
203
+ | `npm run check:release` | 打包产物解包后校验每个打包路径都在 checkout 中存在,并对 `lib/`、`skills/`、`locale/` 与 bundle patch 全量哈希比对,再装进一次性 `$DSH_HOME`(独立端口),校验安装后文件集合与哈希、插件挂载、实际提供的 client bundle 与卸载;不改动现有 profile,需要 `dsh` 与 `pnpm` 在 PATH 上 |
204
+ | `npm run test:browser` | 先构建;运行 10 个浏览器套件,需要 Chrome |
203
205
 
204
- - 当前 main 分支验证记录:Node 测试 **247/247**(Host 117、Client 109、packaging 21);renderer 解析/渲染各 **42/42**,CSS/组件契约 **50/50** 与 **63/63**,排版 **22/22**,i18n **4** 个程序;浏览器 **7/7** 套件通过,其中设置页模板交换 **101** 条、按需流程 **114** 条、交互页面 **46** 条、图片导出 **65** 条断言。浏览器测试覆盖组件/契约;真实模型验证范围与尚未覆盖的场景见[验证记录](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.md)(历史记录)。
206
+ - 当前验证记录(本地 `main` 已推送并与 origin/main 同步;含 Auto 智能格式决策、已合并的修订舞台/版本条与区块编排批量操作、composer 通知与草稿行 chip、本轮独立复审修复与侧栏更新提示(Host 查 npm latest、点击打开插件详情页)):Node 测试 **821/821**(Host 320、Client 464、packaging 37;覆盖区块编辑/编排/多卡片/分支/恢复/草稿持久化/临时样式/嵌套编辑/层级排序/结构操作/容器扩展/模型新增/跨容器移动/结构预览/严格保护/运行时状态/面板动画与宽度适配、实验性文档模式(提示词/工具/回放/浏览器渲染)、修订历史与删除回退、本地图片来源、活动舞台与可见性回落、最近任务式版本条与截图缩略图、顶层与嵌套区块批量操作(批量排序/复制/删除与草稿确认)、编辑流水线(结构操作待执行队列、批量保存/取消、整体说明显式保存、总预览 Apply、结构修订后草稿重映射与模型请求自动发送、深层页面(CST 深度≤10)根级结构操作、Phase A 复审修复(嵌套 Apply 重建、队列阻塞普通 Send、attached 保留、预览契约与诚实自动发送)、Phase B 复审修复(删除显示修订的回退选择与只读恢复、图片导出具体错误、版本条 props 来源、20 上限单一定义、文档事实检查器上下文匹配)等特性);renderer 解析/渲染各 **42/42**,CSS/组件契约 **50/50** 与 **63/63**,排版 **22/22**,i18n **4** 个程序,嵌套 CSS 补偿契约 **28/28 direct + 5/5 scoped**;浏览器 **10/10** 套件通过,其中设置页模板交换 **101** 条、按需流程 **114** 条、交互页面 **50** 条、图片导出 **76** 条断言,Artifact 区块编辑套件 **944** 条检查、嵌套编辑渲染套件 **75** 条检查。浏览器测试覆盖组件/契约;真实模型验证范围与尚未覆盖的场景见[验证记录](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.md)(历史记录)。
205
207
  - `node scripts/capture-screenshots.mjs` 以固定 DSH token、生产组件与假服务在 Chrome 2x 重建面板、提示、临时结果与设置截图;英文 UI,卡片壳层图标用 lucide 替身。
206
208
  - `npm run check` 里的排版检查(typography)需要本机 Chrome;没有 Chrome 时该检查会跳过,其余测试仍会运行。非默认安装位置可用 `CHROME_BIN` 指定 Chrome 可执行文件(也适用于浏览器套件)。
207
209
 
208
210
  发布物是一个 DSH bundle;部署就是把插件安装进目标 DSH profile。卸载与版本注意事项见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md)。
209
211
 
212
+ ## 上架与分发
213
+
214
+ 扩展已发布到 npm 与 GitHub,并收录在这些 DSH 社区市场(DSH 官方没有内置插件市场;Discover 只读取用户添加的索引源):
215
+
216
+ - **awesome-dsh-plugin / dsh-market**:[awesome 条目](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/data/plugins/Zephinel__dsh-intelligent-ui.yml) · [展示页](https://awesome-dsh-plugin.com/p/Zephinel/dsh-intelligent-ui/);dsh-market 的目录来自 awesome,随其同步。
217
+ - **Open Plugin Market**:[索引条目](https://dshopen.org/zh/plugins/@zephinel/dsh-intelligent-ui/)([dshopen.org](https://dshopen.org/zh/))。
218
+ - **bradeGithub/DSH-Plugins-Marketplace**:按 GitHub `dsh-plugin` topic 自动收录。
219
+
220
+ npm 包:[`@zephinel/dsh-intelligent-ui`](https://www.npmjs.com/package/@zephinel/dsh-intelligent-ui)(默认 `latest`);GitHub 仓库:[Zephinel/dsh-intelligent-ui](https://github.com/Zephinel/dsh-intelligent-ui)(topics:`dsh-plugin`、`dsh-bundle`、`deepseek-harness`、`intelligent-ui`、`agent-skills`)。
221
+
222
+ 市场里的版本跟随 npm `latest`;发布新版本并推送仓库后,各市场按自己的周期自动刷新,无需重新申请收录。截图来自本仓库 `screenshots.json`,维护细节见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md#插件市场维护)。
223
+
210
224
  ## 贡献
211
225
 
212
226
  - 问题与功能请求:使用 [GitHub Issues](https://github.com/Zephinel/dsh-intelligent-ui/issues)。
213
- - 提交 PR 前运行 `npm run check`;仓库没有 PR CI,以本地命令结果为准。发布由 [GitHub Actions Trusted Publishing 工作流](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.github/workflows/publish.yml)执行,流程见开发文档。
227
+ - 提交 PR 前运行 `npm run check`;CI([`ci.yml`](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.github/workflows/ci.yml))在 PR 与 main 上跑本地门禁:CHANGELOG/PRODUCT/docs 等纯文档改动只跑文档检查,README 属打包内容走全量门禁;main 上的代码改动另跑 10 个浏览器套件。发布由 [GitHub Actions Trusted Publishing 工作流](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.github/workflows/publish.yml)在 `v*` tag 上执行,流程见开发文档。
214
228
  - 贡献者与 AI 协作代理都应遵循[文档同步技能](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.agents/skills/sync-iui-docs/SKILL.md):行为、文案或计数变化时,同步中英 README、`CHANGELOG.md` 与 `docs/` 对应文档。checkout 中以本地 `.agents/skills/sync-iui-docs/SKILL.md` 为准。
215
229
  - 维护者:[@Zephinel](https://github.com/Zephinel)。
216
230
 
217
231
  ## 已知限制
218
232
 
219
- - 卡片在该轮**结束时**出现;生成过程中进程区显示一行「交互式回答」(英文界面 "Interactive answer")。
220
- - 模型偶发生成不合法 OpenUI Lang;Host 校验会返回精确错误,通常同一轮内自修(实测 1–2 次)。
221
- - 地图底图依赖 OpenFreeMap 瓦片,路线依赖 OSRM demo,照片依赖 Wikipedia/Wikimedia;离线时地图降级为地点列表、照片降级为占位块。
222
- - KaTeX 使用 DSH 壳层已加载的全局样式;若该样式被移除,Math 组件会退化为纯文本。
223
- - 生成提示词约 10K tokens,**只在开关命中该会话时发送**(全局开启,或该会话显式开启);关闭时这部分开销为 0(工具 schema 也不出现)。Article 模式会生成更长的页面,输出 token 与渲染时间相应增加。
224
- - 扩展 UI 文案随 DSH 界面语言切换;但 `/iui` 的 Host 返回文案、命令面板里的命令描述与 README 截图仍是英文(前两者是 DSH 平台行为)。
225
- - 导出图片时,沙盒 iframe(`HtmlView` 里的小游戏)不会被截入图片,图片中该区域会缺失;地图通过保留 WebGL 绘制缓冲入图,禁用 WebGL 的浏览器会按地图自身的降级逻辑显示地点列表。
226
- - 同一轮回复渲染出的多张卡片会合并成一张图片;导出的是**当前屏幕上渲染出的内容**,因此导出的图片会包含当时的交互状态(勾选项、筛选结果等)。导出会等待卡片内的图片加载和图片搜索完成(最多约 12.5 秒);离线或仍未就绪时按页面上的占位状态导出。
227
- - 交互页面导出会把渲染器、当前主题与全部卡片内联进一个 HTML(约 3.4–4.9 MB),因此文件较大但无需安装;地图、照片等组件仍依赖网络。页面里的 `@ToAssistant` 会尝试写入剪贴板并弹出提示;剪贴板不可用时提示会保留原消息供手动复制。
228
- - 浏览器半边要求部署组合 `dsh-client-locale`(DSH Web 0.2.1 默认包含);最小自定义 profile 缺少它时开关和卡片不挂载,Host 工具与提示词仍可用。
229
- - 插件详情页里的配置依赖 DSH 的 settings 服务:最小自定义 profile 未组合 `dsh-settings` / `dsh-client-ui-settings` 时不出现;Host/Client 版本错位时开关可能显示为不可用。全局启用/样式与自由布局只改变提示词与页面形态,不保证每个模型都完全遵守;会话样式覆盖仍以 Host 注入的提示词为准。
230
- - 交互页面导出需要部署提供 `webServer` 服务(DSH Web 0.2.1 默认包含);最小自定义 profile 缺少它时无法导出交互页面,图片导出不受影响。
231
-
232
- - 临时样式保存在工具参数/结果快照中,不进入模板库;历史工具参数仍在加载窗口时可重放。事后保存依赖有界结果注册表(最近 200 条),被淘汰的结果可能仍能重放但无法再保存。保存模板与结果快照在 `<DSH_HOME>` 的独立 JSON 文件中持久化。
233
- - 样式创建/按需生成使用部署的默认主对话模型服务;扩展不提供独立生成模型或 draft 访谈服务。`ask_user_question` 是结构化澄清路径;工具不可用时降级为文字提问,文字轮结束后提示会保留,下一条消息继续同一操作,不需要重新选择「按需生成」(过期、重启或失败后除外)。
234
- - 按需操作只在内存中:等待发送(armed)10 分钟过期,重启后活动操作无法恢复,需要重新武装;已完成结果不因此丢失。每会话最多一个活动操作:armed 时重新武装会替换,已绑定的 running/clarifying 拒绝重新武装且需先取消;最多两轮澄清。文本结束但未渲染时操作回到待继续状态,下一条消息继续;失败/中断会显示重试/关闭提示。
235
- - 多标签页采用保守绑定:提示只显示在发起标签页,但 Host 绑定该会话的下一条人工消息,并不验证发送标签来源;请在发起标签页发送,避免另一标签同时发送。
236
- - 自定义主题只应用到 renderer host,portaled Popover 与沙盒 iframe 保留默认主题;语义状态色保持渲染器定义。导出交互页面冻结导出时的明/暗方案,不随系统切换。
237
- - 已保存模板的 directives 是有界展示偏好(最多 2,000 字符),不能覆盖系统、工具或安全规则;模板库上限为全局 40 个、每会话 20 个。删除/不可用的已保存模板按默认主题降级;没有显式主题的临时结果沿用会话模板或内置主题,带显式主题的快照单独重放/导出、不依赖模板库。
233
+ 卡片在轮末出现;模型校验、网络依赖、导出、模板安全、编辑范围、旧页面/base 限制、真机和 a11y 未验证项等完整边界见[已知限制](docs/limitations.md)。
234
+
235
+ - 实验性「回答即文档」只模拟消息正文的呈现:内容仍在轮末的 `render_ui` 结果里,不在消息正文内;复制、搜索和会话导出 Markdown 不包含页面正文;文档页没有卡片编辑入口与修订历史;只有 Web 渲染器(Web/Desktop)显示,TUI/headless 等不渲染插件卡片的客户端看不到内容。开关只影响之后的回答,已生成的结果保持生成时的文档呈现。
236
+ - 编辑覆盖根 `Col` 直接子区块和七个容器内部的区块;CST 节点预算 200,超出时页面不可编辑。
237
+ - 旧版本渲染的卡片不需要手动迁移:首次打开编辑、修订历史或恢复时客户端会自动登记权威 program;旧 Host 混部或登记失败时,快捷属性调整退回指令编辑,结构操作可能需要重新渲染。
238
+ - 真实屏幕阅读器、Windows 高对比度、iPad/Safari 和深色主题下的输入框焦点对比度尚未实测;视觉基线是手动对照。
239
+ - client bundle 更新后必须重启 `dsh-web`,刷新页面不够。
238
240
 
239
241
  ## 常见问题
240
242
 
241
243
  **必须先建模板、预览或命名吗?** 不需要。选「按需生成」后正常聊天,结果可以直接使用;只有主动「保存为模板」才需要名称。临时结果不会替换当前会话选中的样式。
242
244
 
243
- **能晚些保存或继续调整吗?** 可以。使用那张结果下的「调整样式」或「保存为模板」;保存的是点选结果的版本,不会自动保存后来生成的版本。注册表已淘汰该结果时会提示快照不可用。
245
+ **能晚些保存或继续调整吗?** 可以。点卡片「编辑」进入画布,在顶部 **样式 → 更改样式** 里描述视觉调整,或直接用 **样式切换** 应用内置/已保存样式;「保存为模板」仍在卡片底部。保存的是点选结果的版本,不会自动保存后来生成的版本。注册表已淘汰该结果时会提示快照不可用。
244
246
 
245
247
  **为什么追问后没有继续生成?** 结构化 `ask_user_question` 回答会恢复同一操作;文字提问后,下一条消息会自动继续同一操作。只有过期、重启、失败或中断后才需要重新武装/重试。多个标签同时发送也可能消费同一意图。
246
248
 
247
- **为什么回答只有文字、没有卡片?** 先确认该会话的开关已打开(输入框右侧 **UI** 控件,或 `/iui on`);开启后模型仍可能把单个事实、一两句话或明确的文字/代码请求当作有界例外。想强制出卡片时,在开关已打开的会话里用 `/intelligent-ui` 显式调用技能。详见[使用](#使用)。
249
+ **为什么回答只有文字、没有卡片?** 先确认该会话的开关已打开(输入框右侧 **UI** 控件,或 `/iui on`);开启后是否出页面由模型按内容判断——短回答、概念解释、代码/翻译或明确要文字时直接用 Markdown 是预期行为。想让这次一定出页面时,在开关已打开的会话里用 `/intelligent-ui` 显式调用技能。详见[使用](#使用)。
248
250
 
249
251
  **回答底部为什么没有「导出」按钮?** 只有扩展渲染出的回答才有这个药丸按钮;开关关闭、模型用文字回答或渲染失败时都不会出现。详见[使用](#使用)与[已知限制](#已知限制)。
250
252
 
@@ -254,12 +256,31 @@ dsh web
254
256
 
255
257
  详细文档、变更日志与仓库维护技能不随 npm 包发布,因此链接使用绝对 GitHub 地址;未提交功能以 checkout 内对应文件为准。
256
258
 
257
- - [架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md):Host/Client 组件树、开关与回答样式的完整语义、界面语言、图片与交互页面导出流程、Agent Skill。
259
+ - [架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md):Host/Client 组件树、开关与回答样式的完整语义、Artifact 区块编辑、编排与多卡片并行、界面语言、图片与交互页面导出流程、Agent Skill。
258
260
  - [开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md):安装与卸载、开发命令、改名/重建后的重启提示、Host/Client 版本错位、发布物布局与插件市场维护。
259
261
  - [验证记录](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.md):端到端验证、测试与打包结果(历史记录)。
260
262
  - [变更日志](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/CHANGELOG.md):按版本记录新增、变更与修复(英文)。
263
+ - [使用指南](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/usage.md):开关、提问、编辑、模板与导出。
264
+ - [已知限制](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/limitations.md):当前边界与未验证项。
261
265
  - [GitHub Releases](https://github.com/Zephinel/dsh-intelligent-ui/releases):带日期的版本发布页与安装说明。
262
266
 
267
+ ## 致谢与第三方依赖
268
+
269
+ 这个扩展建立在下面这些开源项目与素材之上,感谢作者和维护者:
270
+
271
+ - **[Open Intelligent UI](https://github.com/thesysdev/open-intelligent-ui) / [OpenUI](https://github.com/thesysdev/openui)** — 组件库、渲染层、系统提示词与组件规范的起点。MIT,Copyright (c) 2026 Thesys Inc.
272
+ - **OpenUI packages** — `@openuidev/lang-core`、`@openuidev/react-lang`,以及随依赖树附带的 `@openuidev/devtools`、`@openuidev/observability`;负责 OpenUI Lang 解析、组件定义与渲染。MIT。
273
+ - **[Remix Icon](https://github.com/Remix-Design/RemixIcon)** — 插件自身 chrome 的图标(编辑、删除、移动、定位、信息等),path 数据按原样内联。Remix Icon License v1.0,Copyright (c) 2017-2026 Remix Design。
274
+ - **[lucide-react](https://github.com/lucide-icons/lucide)** — 模型生成内容中 `Icon` 组件的图标。ISC。
275
+ - **[KaTeX](https://github.com/KaTeX/KaTeX)** — `Math` 组件的公式渲染,含随包内联的字体。MIT。
276
+ - **[MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js)** — 地图与路线渲染,worker 源码随 bundle 内嵌。BSD-3-Clause,Copyright (c) MapLibre contributors。
277
+ - **[SnapDOM](https://github.com/zumerlab/snapdom)**(`@zumer/snapdom`)— 把回答卡片导出为图片。MIT,Copyright (c) 2025 ZumerLab。
278
+ - **[zod](https://github.com/colinhacks/zod)** — 组件 props 与 OpenUI 程序结构的运行时校验。MIT。
279
+
280
+ 此外,**React / React DOM**(MIT)由 DSH Web 平台提供,独立交互页面 bundle 会内置它们。地图底图与路线数据来自 OpenFreeMap / OpenMapTiles / OpenStreetMap、Esri 与 OSRM,使用时会在图内显示相应 attribution。
281
+
282
+ 每项的完整许可证见 [NOTICE](NOTICE) 与 [licenses/](licenses/)。如果发现遗漏或归属有误,欢迎提 issue 或 PR。
283
+
263
284
  ## 许可证
264
285
 
265
286
  本项目采用 [MIT](LICENSE) 许可证。基于 Open Intelligent UI(MIT, Copyright (c) 2026 Thesys Inc.)与 OpenUI 生态;浏览器 bundle 内含 lucide-react(ISC)、KaTeX(MIT)、MapLibre GL JS(BSD-3-Clause)、zod(MIT)与 SnapDOM(MIT);交互页面的独立 bundle 还内联 React / React DOM(MIT)。完整声明与许可证全文见 [NOTICE](NOTICE) 与 [licenses/](licenses/)。
Binary file
Binary file