@zephinel/dsh-intelligent-ui 0.6.1 → 0.6.2
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.
- package/README.en.md +7 -7
- package/README.md +7 -7
- package/lib/client.js +100 -100
- package/lib/standalone.css +1 -1
- package/lib/standalone.js +1 -1
- package/locale/detail.en.md +11 -0
- package/locale/detail.zh.md +11 -0
- package/locale/en.json +2 -1
- package/locale/zh.json +2 -1
- package/package.json +2 -2
- package/skills/intelligent-ui/references/integration.md +7 -7
package/README.en.md
CHANGED
|
@@ -20,7 +20,7 @@ The model calls the `render_ui` tool and writes its answer as an [OpenUI Lang 1.
|
|
|
20
20
|
Ported from [Open Intelligent UI](https://github.com/thesysdev/open-intelligent-ui) (MIT), with an Agent Skill (`intelligent-ui`) that the plugin registers automatically.
|
|
21
21
|
|
|
22
22
|
> [!NOTE]
|
|
23
|
-
> **Current status**: published on GitHub and npm as **`@zephinel/dsh-intelligent-ui@0.6.
|
|
23
|
+
> **Current status**: published on GitHub and npm as **`@zephinel/dsh-intelligent-ui@0.6.2`** (`latest`). 0.6.2 turns the Plugins detail page into a short bilingual setup guide, makes the update notice a prompt that appears when relevant (the first explicit enable only records a newer version, a later enable shows it, Later / do-not-remind settle it per version, and the sidebar card is gone), and fixes `render_ui` calls dispatched inside `run_code` (PTC mode) showing no card and no export pill. 0.6.1's OpenUI parser fix and 0.6.0's in-place editing with revision history, Auto page-vs-text decision, experimental answer-as-document mode, local images and style switching remain available.
|
|
24
24
|
|
|
25
25
|
[Quick start](#quick-start) · [Getting the code](#getting-the-code) · [Build, test and deploy](#build-test-and-deploy)
|
|
26
26
|
|
|
@@ -87,7 +87,7 @@ Three real examples (sales dashboard, coffee brewing quiz, pour-over calculator
|
|
|
87
87
|
| Bilingual UI | Follows DSH's Chinese or English UI language |
|
|
88
88
|
| Agent Skill | Registers `intelligent-ui` with the plugin so the model can load syntax, examples and troubleshooting on demand |
|
|
89
89
|
| Plugin detail page | Manage global enablement, default style, templates, composition, experimental features and export preferences in one place |
|
|
90
|
-
| Update
|
|
90
|
+
| Update prompt | The Host reads the npm `latest` stable version (six-hour cache; highlights come from the human-reviewed `release-notes/<version>.md`; an optional `<version>.en.md` serves English UIs and falls back to the default file when missing). The prompt does not sit in the layout: the first explicit composer-chip enable only records a newer version, and the next explicit enable shows a bottom-right overlay; with the plugin enabled by the deployment-wide switch (default open), every page start asks as soon as the check answers. "Update" opens the plugin detail page (DSH owns the update), "Later" closes this prompt and three later clicks add "Don't remind me again" (that exact version only), and "Details" expands the highlights in place. The overlay is one additive `shell.overlay` entry and never inserts sidebar or other plugins' DOM; Escape or an outside click closes it exactly like Later, Update keeps the prompt open when the Plugins panel is unavailable, and a global switch enabled mid-session waits for the next page start |
|
|
91
91
|
| Replayable | Programs and temporary styles replay from recorded tool arguments; exported pages freeze the scheme at export time |
|
|
92
92
|
|
|
93
93
|
## Getting the code
|
|
@@ -105,7 +105,7 @@ To contribute, fork this repository and clone your fork. To use the plugin, inst
|
|
|
105
105
|
|
|
106
106
|
These commands are for DSH Web and source development; DSH Desktop users can follow the in-app steps in [Quick start](#quick-start).
|
|
107
107
|
|
|
108
|
-
- **DSH 0.2.2 plugin API** (the [`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)): the Host/Client halves and plugin protocol target this version; the verified version is `0.2.2-rc.1` (
|
|
108
|
+
- **DSH 0.2.2 plugin API** (the [`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)): the Host/Client halves and plugin protocol target this version; the verified version is `0.2.2-rc.1` (npm `latest`); `0.2.2-rc.3` (the `next` channel) has a community PTC check (plugin loads, process subrow renders) but this fix's card rendering has not been re-verified on it; later versions are unverified. Install the latest: `npm install -g @deepseek-ai/dsh`.
|
|
109
109
|
- **[Node.js 24 and its bundled npm](https://nodejs.org/en/download)**: builds, tests and the publish workflow use Node 24. The repository has no `engines` or `.nvmrc` pin, so select Node 24 before running `npm install`; the Host's Node 22 build target does not verify the whole toolchain on Node 22.
|
|
110
110
|
- **[Git](https://git-scm.com/downloads)**: needed only to get the source; the repository sets no minimum version.
|
|
111
111
|
- **`@deepseek-ai/dsh-client-locale`**: the browser half requires a deployment that composes it; DSH Web 0.2.2 includes it by default, and without it the switch and card do not mount (the Host tool and prompt keep working).
|
|
@@ -123,10 +123,10 @@ The restart examples cover a foreground `dsh web`, macOS launchd and Linux syste
|
|
|
123
123
|
|
|
124
124
|
## Quick start
|
|
125
125
|
|
|
126
|
-
**DSH Web**: install the published 0.6.
|
|
126
|
+
**DSH Web**: install the published 0.6.2 package and start the Web UI (first foreground run):
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.6.
|
|
129
|
+
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.6.2
|
|
130
130
|
dsh web
|
|
131
131
|
```
|
|
132
132
|
|
|
@@ -137,7 +137,7 @@ Alternative sources replace the install command above: use `dsh plugin --profile
|
|
|
137
137
|
**DSH Desktop** needs no terminal command — install it inside the app:
|
|
138
138
|
|
|
139
139
|
1. Open **Plugins** in the sidebar → **Add plugin** (or the arrow → **Install a third-party plugin**).
|
|
140
|
-
2. Enter `@zephinel/dsh-intelligent-ui@0.6.
|
|
140
|
+
2. Enter `@zephinel/dsh-intelligent-ui@0.6.2` (or just the package name for the latest), then click **Install**.
|
|
141
141
|
3. When the install finishes, click **Enable now**; if the **UI** control does not appear, quit and reopen DSH Desktop.
|
|
142
142
|
|
|
143
143
|
The desktop profile is owned by the Electron app, so `dsh plugin --profile desktop` is rejected. A mainland-China mirror can lag behind the official npm registry for a fresh release; switch the install source back to npm if the version is not found.
|
|
@@ -203,7 +203,7 @@ Everyday checks and packaging:
|
|
|
203
203
|
| `npm run check:release` | Extract the packed tarball, check that every packed path exists in the checkout, hash-compare `lib/`, `skills/`, `locale/` and the bundle patch, then install it into a throwaway `$DSH_HOME` on an isolated port and verify the installed file set and hashes, the mounted row, the served client bundle and uninstall; never touches the user's profile; needs the `dsh` CLI and pnpm on PATH |
|
|
204
204
|
| `npm run test:browser` | Run 10 browser suites after a build; Chrome required. `test/browser/visual-baselines/` holds manual visual baselines (5 PNGs + `captures.json` + `SHA256SUMS`) with no automated pixel comparison |
|
|
205
205
|
|
|
206
|
-
- Current verification record (
|
|
206
|
+
- Current verification record (main (0.6.2); the Auto format decision, the merged revision stage/version bar and block-arrangement batch operations, the composer notice and draft-row chips, this independent re-review follow-up, and the staged update prompt (the first explicit enable only records a newer version, the next explicit enable shows a bottom-right overlay, a default-open start asks immediately; the Host reads npm `latest` plus the human-reviewed release highlights and Update opens the plugin detail page)): **858/858** Node tests (Host 320, Client 501, packaging 37; covering block editing/arrangement/multi-card/branch/restore/draft persistence/temporary style/nested editing/hierarchical order/structure operations/container expansion/model additions/cross-container moves/structure preview/strict protection/runtime state/panel animation and width fit/experimental document mode (prompt, tool, replay and browser rendering)/revision history and deletion rollback/local image sources/active revision stage and visibility fallback/recent-tasks version bar with screenshot thumbnails/root and nested batch selection, ordering, duplicate/delete and draft confirmation; and the edit pipeline (pending structure queue, batch save/cancel, explicit global-instruction save, total Apply preview, draft remap after the structural revision, automatic model-request send and root structure operations on deep pages up to CST depth 10, plus the Phase A review fixes: nested Apply rebuild, queued-structure send blocking, attached preservation, preview contract checks and honest auto-send confirmation, and the Phase B review fixes: displayed-revision deletion fallback/read-only recovery, concrete image-export errors, props revision labels, the single 20-op shared cap and the contextual docs-facts checker), and the update-prompt state machine plus controller (record, prompt on the next explicit open, per-version later count, per-version silence, the real chip/global-settings triggers (including follow-global and the already-enabled no-retrigger rule), Escape/outside close, the queued-check race and the storage-less in-page fallback), and the turn-tail extractor now collects a `render_ui` dispatched inside a `run_code` (PTC) program from the parent node's child calls, so its card and export entry appear too (6 new Node cases)); renderer parse/render **42/42** each, CSS/prop contract **50/50** and **63/63**, typography **22/22**, i18n **4** programs, nested CSS-compensation contract **28/28 direct + 5/5 scoped**; **10/10** browser suites passed, including **101** settings template-exchange, **114** on-demand, **50** interactive-page and **76** image-export assertions and **39** update-prompt checks, plus **944** checks in the Artifact block-editing suite and **75** checks in the nested edit-renderer suite. Browser tests cover components/contracts; real-model validation scope and remaining scenarios are in the [verification record](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.en.md) (historical evidence).
|
|
207
207
|
- `node scripts/capture-screenshots.mjs` rebuilds panel, hint, temporary-result and settings captures at 2x in Chrome using fixed DSH tokens, production components and fake services. English UI; shell card glyphs use lucide stand-ins.
|
|
208
208
|
- The typography check inside `npm run check` needs a local Chrome; without one that check is skipped and the remaining tests still run. Use `CHROME_BIN` for a non-default Chrome executable location (also used by the browser suites).
|
|
209
209
|
|
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@
|
|
|
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.6.
|
|
23
|
+
> **当前状态**:已发布到 GitHub 与 npm,npm 版本 **`@zephinel/dsh-intelligent-ui@0.6.2`**(`latest`)。0.6.2 把插件详情页改为简短的中英设置指引,更新提示改为按需出现的浮层(首次打开只记录、之后提示,支持「下次再说」与按版本静默,不再常驻侧栏),并修复 `run_code`(PTC)内派发的 `render_ui` 不显示卡片与「导出」按钮的问题。0.6.1 的 OpenUI parser 修复、0.6.0 的就地编辑与修订历史、Auto 页面/文字决策、实验性「回答即文档」、本地图片与样式切换继续可用。
|
|
24
24
|
|
|
25
25
|
[快速开始](#快速开始) · [获取代码](#获取代码) · [构建、测试与部署](#构建测试与部署)
|
|
26
26
|
|
|
@@ -87,7 +87,7 @@
|
|
|
87
87
|
| 双语界面 | 跟随 DSH 的中文或英文界面语言 |
|
|
88
88
|
| Agent Skill | 随插件注册 `intelligent-ui`,模型按需加载完整语法、示例与排障 |
|
|
89
89
|
| 插件详情页 | 集中管理全局启用、默认样式、模板、编排方式、实验性功能与导出偏好 |
|
|
90
|
-
| 更新提示 | Host 侧查询 npm 最新稳定版与本次 Release 的更新要点(6 小时缓存;要点来自发布前人工审核的 `release-notes/<version>.md`,英文可选同目录 `<version>.en.md
|
|
90
|
+
| 更新提示 | Host 侧查询 npm 最新稳定版与本次 Release 的更新要点(6 小时缓存;要点来自发布前人工审核的 `release-notes/<version>.md`,英文可选同目录 `<version>.en.md`、缺失时回退默认文件)。提示不常驻:在输入框 chip 里第一次把 Intelligent UI 打开只记录新版本,下一次再打开才在右下角浮层提示;全局设置启用插件(默认打开)时每次启动检查到新版本即提示。「更新」跳转插件详情页(由 DSH 执行更新),「下次再说」关闭本次,累计三次后出现「不再提醒」(只静默该版本),「查看详情」就地展开更新要点。浮层走 DSH 的 `shell.overlay` list slot,不插入侧栏或其它插件的 DOM;Escape 或点击浮层外关闭(等同「下次再说」),无插件面板时「更新」保持提示打开,会话中途打开全局开关要等下次页面启动才提示 |
|
|
91
91
|
| 可重放 | 程序与临时样式随工具参数重放;导出页面冻结导出时的主题方案 |
|
|
92
92
|
|
|
93
93
|
## 获取代码
|
|
@@ -105,7 +105,7 @@ cd dsh-intelligent-ui
|
|
|
105
105
|
|
|
106
106
|
以下命令用于 DSH Web 与源码开发;DSH Desktop 用户可直接按[快速开始](#快速开始)中的应用内步骤安装。
|
|
107
107
|
|
|
108
|
-
- **DSH 0.2.2 插件接口**([`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)):Host/Client 与插件协议按这个版本开发;实际验证版本是 `0.2.2-rc.1
|
|
108
|
+
- **DSH 0.2.2 插件接口**([`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)):Host/Client 与插件协议按这个版本开发;实际验证版本是 `0.2.2-rc.1`(npm `latest`);`0.2.2-rc.3`(`next` 通道)有社区 PTC 实测(插件加载与进程子行正常),本修复的卡片渲染尚未在其上真机复验;更晚版本未验证。安装最新版:`npm install -g @deepseek-ai/dsh`。
|
|
109
109
|
- **[Node.js 24 与自带的 npm](https://nodejs.org/en/download)**:构建、测试与发布工作流使用 Node 24。仓库没有 `engines` 或 `.nvmrc` 版本锁,运行 `npm install` 前需自行选用 Node 24;Host 的 Node 22 编译目标不代表整个工具链已在 Node 22 验证。
|
|
110
110
|
- **[Git](https://git-scm.com/downloads)**:仅获取源码时需要,仓库未指定最低版本。
|
|
111
111
|
- **`@deepseek-ai/dsh-client-locale`**:浏览器半边要求部署组合了它;DSH Web 0.2.2 默认包含,缺少时开关和卡片不会挂载(Host 工具与提示词仍可用)。
|
|
@@ -123,10 +123,10 @@ git --version # 仅获取源码时需要
|
|
|
123
123
|
|
|
124
124
|
## 快速开始
|
|
125
125
|
|
|
126
|
-
**DSH Web**:从 npm 安装已发布的 0.6.
|
|
126
|
+
**DSH Web**:从 npm 安装已发布的 0.6.2,再启动 Web UI(首次前台运行示例):
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.6.
|
|
129
|
+
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.6.2
|
|
130
130
|
dsh web
|
|
131
131
|
```
|
|
132
132
|
|
|
@@ -137,7 +137,7 @@ dsh web
|
|
|
137
137
|
**DSH Desktop(桌面版)** 不需要终端命令,在应用内安装:
|
|
138
138
|
|
|
139
139
|
1. 侧栏 **插件** → **添加插件**(或箭头 → **安装第三方插件**)。
|
|
140
|
-
2. 输入 `@zephinel/dsh-intelligent-ui@0.6.
|
|
140
|
+
2. 输入 `@zephinel/dsh-intelligent-ui@0.6.2`(或只填包名装最新版),点 **安装**。
|
|
141
141
|
3. 安装完成后点 **立即启用**;若输入框右侧没有 **UI** 控件,退出并重开 DSH Desktop。
|
|
142
142
|
|
|
143
143
|
桌面版的 profile 由 Electron 应用独占管理,`dsh plugin --profile desktop` 会被拒绝。国内镜像可能晚于 npm 官方源同步刚发布的版本;装不到时把安装源切回 npm 官方源。
|
|
@@ -203,7 +203,7 @@ dsh web
|
|
|
203
203
|
| `npm run check:release` | 打包产物解包后校验每个打包路径都在 checkout 中存在,并对 `lib/`、`skills/`、`locale/` 与 bundle patch 全量哈希比对,再装进一次性 `$DSH_HOME`(独立端口),校验安装后文件集合与哈希、插件挂载、实际提供的 client bundle 与卸载;不改动现有 profile,需要 `dsh` 与 `pnpm` 在 PATH 上 |
|
|
204
204
|
| `npm run test:browser` | 先构建;运行 10 个浏览器套件,需要 Chrome |
|
|
205
205
|
|
|
206
|
-
-
|
|
206
|
+
- 当前验证记录(main(0.6.2);含 Auto 智能格式决策、已合并的修订舞台/版本条与区块编排批量操作、composer 通知与草稿行 chip、本轮独立复审修复与更新提示(分阶段浮层:首次显式打开只记录、下次打开才提示,全局默认打开时启动即提示;Host 查 npm latest、更新跳插件详情页)):Node 测试 **858/858**(Host 320、Client 501、packaging 37;覆盖区块编辑/编排/多卡片/分支/恢复/草稿持久化/临时样式/嵌套编辑/层级排序/结构操作/容器扩展/模型新增/跨容器移动/结构预览/严格保护/运行时状态/面板动画与宽度适配、实验性文档模式(提示词/工具/回放/浏览器渲染)、修订历史与删除回退、本地图片来源、活动舞台与可见性回落、最近任务式版本条与截图缩略图、顶层与嵌套区块批量操作(批量排序/复制/删除与草稿确认)、编辑流水线(结构操作待执行队列、批量保存/取消、整体说明显式保存、总预览 Apply、结构修订后草稿重映射与模型请求自动发送、深层页面(CST 深度≤10)根级结构操作、Phase A 复审修复(嵌套 Apply 重建、队列阻塞普通 Send、attached 保留、预览契约与诚实自动发送)、Phase B 复审修复(删除显示修订的回退选择与只读恢复、图片导出具体错误、版本条 props 来源、20 上限单一定义、文档事实检查器上下文匹配)、更新提示状态机与控制器(首次记录、下次提示、按版本累计「下次再说」、按版本静默、真实 chip/全局设置触发(含 follow-global 与已启用不重复触发)、Escape/外点关闭、排队检查防重开、无存储会话内回退)、`run_code`(PTC)内派发的 `render_ui` 卡片与导出(轮末提取器递归收集父节点子调用,含 6 条提取/导出用例)等特性);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** 条断言、更新提示 **39** 条检查,Artifact 区块编辑套件 **944** 条检查、嵌套编辑渲染套件 **75** 条检查。浏览器测试覆盖组件/契约;真实模型验证范围与尚未覆盖的场景见[验证记录](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.md)(历史记录)。
|
|
207
207
|
- `node scripts/capture-screenshots.mjs` 以固定 DSH token、生产组件与假服务在 Chrome 2x 重建面板、提示、临时结果与设置截图;英文 UI,卡片壳层图标用 lucide 替身。
|
|
208
208
|
- `npm run check` 里的排版检查(typography)需要本机 Chrome;没有 Chrome 时该检查会跳过,其余测试仍会运行。非默认安装位置可用 `CHROME_BIN` 指定 Chrome 可执行文件(也适用于浏览器套件)。
|
|
209
209
|
|