@zephinel/dsh-intelligent-ui 0.4.1 → 0.5.0
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 +63 -45
- package/README.md +62 -44
- package/assets/intelligent-ui-on-demand-hint.webp +0 -0
- package/assets/intelligent-ui-settings.webp +0 -0
- package/assets/intelligent-ui-style-panel.webp +0 -0
- package/assets/intelligent-ui-temporary-result-dark.webp +0 -0
- package/assets/intelligent-ui-temporary-result.webp +0 -0
- package/assets/intelligent-ui-toggle.png +0 -0
- package/lib/client.js +125 -125
- package/lib/index.js +59 -56
- package/lib/standalone.css +1 -1
- package/lib/standalone.js +77 -77
- package/package.json +4 -3
- package/skills/intelligent-ui/SKILL.md +19 -11
- package/skills/intelligent-ui/references/components.md +26 -26
- package/skills/intelligent-ui/references/integration.md +16 -15
- package/skills/intelligent-ui/references/troubleshooting.md +20 -3
package/README.en.md
CHANGED
|
@@ -9,15 +9,20 @@
|
|
|
9
9
|
[](https://www.npmjs.com/package/@deepseek-ai/dsh)
|
|
10
10
|
[](https://github.com/Zephinel/dsh-intelligent-ui/actions/workflows/publish.yml)
|
|
11
11
|
|
|
12
|
-
**Turn a model answer into a page you can actually use.**
|
|
12
|
+
**Turn a DeepSeek Harness (DSH) model answer into a page you can actually use.** After installing and enabling the plugin, ask:
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
Plan two days in Shanghai, with checkboxes and adjustments
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
The model calls the `render_ui` tool and writes its answer as an [OpenUI Lang 1.0](https://openui.com) program; at the end of the turn, DSH renders it into an interactive page — maps, photos, charts, checklists, forms, SVG drawings and mini-games are all real components, not screenshots.
|
|
13
19
|
|
|
14
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.
|
|
15
21
|
|
|
16
22
|
> [!NOTE]
|
|
17
|
-
> **Current status**: published on GitHub and npm as **`@zephinel/dsh-intelligent-ui@0.
|
|
23
|
+
> **Current status**: published on GitHub and npm as **`@zephinel/dsh-intelligent-ui@0.5.0`** (`latest`). Custom styles, on-demand generation, free layouts and template file import/export, plus the renderer-contract, Host-validation and export-semantics fixes, are all included in 0.5.0.
|
|
18
24
|
|
|
19
|
-
|
|
20
|
-
> **Want to try it now?** Install with one command: `dsh plugin --profile web add @zephinel/dsh-intelligent-ui`; restart the DSH process that serves the Web UI, then choose **This session only** from the **UI** control in the composer. See [Quick start](#quick-start) for the full path.
|
|
25
|
+
[Quick start](#quick-start) · [Getting the code](#getting-the-code) · [Build, test and deploy](#build-test-and-deploy)
|
|
21
26
|
|
|
22
27
|
## What it looks like
|
|
23
28
|
|
|
@@ -58,10 +63,11 @@ On a narrow screen (about 380 px) the card switches to a single column, and maps
|
|
|
58
63
|
| Switch and style | Global defaults on the Plugin detail page; composer overrides per session; built-in Auto / Card / Article and custom templates |
|
|
59
64
|
| Custom templates and visual themes | Reusable display preferences with light/dark palettes, font, radius, density and shadow; use, rename, edit or delete in My styles |
|
|
60
65
|
| Chat-native on-demand UI | No template required; choose On-demand UI in the UI panel, send a normal message, clarify with the built-in question tool when needed |
|
|
66
|
+
| Free on-demand layouts (unreleased) | Compose the page from the user's request; saved templates keep the free layout, preferences and theme without a Card/Article shell |
|
|
61
67
|
| Temporary results and optional saving | Inline style snapshots are ready to use, adjust or save later; no required preview, naming or saving |
|
|
62
|
-
| Bilingual UI | Follows DSH's
|
|
68
|
+
| Bilingual UI | Follows DSH's Chinese or English UI language |
|
|
63
69
|
| Agent Skill | Registers `intelligent-ui` with the plugin so the model can load syntax, examples and troubleshooting on demand |
|
|
64
|
-
| Plugin detail page |
|
|
70
|
+
| Plugin detail page | Manage global enablement, default style, templates, composition and export preferences in one place |
|
|
65
71
|
| Replayable | Programs and temporary styles replay from recorded tool arguments; exported pages freeze the scheme at export time |
|
|
66
72
|
|
|
67
73
|
## Getting the code
|
|
@@ -73,52 +79,50 @@ git clone https://github.com/Zephinel/dsh-intelligent-ui.git
|
|
|
73
79
|
cd dsh-intelligent-ui
|
|
74
80
|
```
|
|
75
81
|
|
|
76
|
-
|
|
82
|
+
To contribute, fork this repository and clone your fork. To use the plugin, install from npm without a checkout (see [Quick start](#quick-start)).
|
|
77
83
|
|
|
78
84
|
## Prerequisites
|
|
79
85
|
|
|
80
|
-
|
|
81
|
-
|
|
86
|
+
These commands are for DSH Web and source development; DSH Desktop users can follow the in-app steps in [Quick start](#quick-start).
|
|
87
|
+
|
|
88
|
+
- **DSH 0.2.1 plugin API** (the [`dsh` CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)): the Host/Client halves and plugin protocol are developed against this version; the verified version is `0.2.1-rc.2`, and later versions are unverified. Pin the install to the verified version: `npm install -g @deepseek-ai/dsh@0.2.1-rc.2`.
|
|
89
|
+
- **[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.
|
|
90
|
+
- **[Git](https://git-scm.com/downloads)**: needed only to get the source; the repository sets no minimum version.
|
|
82
91
|
- **`@deepseek-ai/dsh-client-locale`**: the browser half requires a deployment that composes it; DSH Web 0.2.1 includes it by default, and without it the switch and card do not mount (the Host tool and prompt keep working).
|
|
83
92
|
|
|
84
93
|
Confirm the tools are present:
|
|
85
94
|
|
|
86
95
|
```bash
|
|
87
96
|
node --version # v24.x
|
|
88
|
-
|
|
97
|
+
npm --version
|
|
98
|
+
dsh --version # verified: 0.2.1-rc.2
|
|
99
|
+
git --version # only needed to get the source
|
|
89
100
|
```
|
|
90
101
|
|
|
91
102
|
The restart examples cover a foreground `dsh web`, macOS launchd and Linux systemd; for other supervisors restart the corresponding service. Verified platforms: macOS (Web + DSH Desktop) and Windows (DSH Desktop); Linux is unverified.
|
|
92
103
|
|
|
93
104
|
## Quick start
|
|
94
105
|
|
|
95
|
-
|
|
106
|
+
**DSH Web**: install the published 0.5.0 package and start the Web UI (first foreground run):
|
|
96
107
|
|
|
97
108
|
```bash
|
|
98
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui
|
|
99
|
-
|
|
100
|
-
# pin the current version
|
|
101
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.4.1
|
|
102
|
-
|
|
103
|
-
# or install from GitHub
|
|
104
|
-
dsh plugin --profile web add github:Zephinel/dsh-intelligent-ui
|
|
109
|
+
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.5.0
|
|
110
|
+
dsh web
|
|
105
111
|
```
|
|
106
112
|
|
|
107
|
-
|
|
113
|
+
If Web is already running, restart that process after installing (foreground: Ctrl+C, then run `dsh web` again; launchd/systemd: restart the service). Open the printed URL and look for the **UI** control on the right of the composer; the DSH profile determines the address and port.
|
|
114
|
+
|
|
115
|
+
Alternative sources replace the install command above: use `dsh plugin --profile web add @zephinel/dsh-intelligent-ui` to follow npm's latest version, or `dsh plugin --profile web add github:Zephinel/dsh-intelligent-ui` for committed GitHub code. Neither installs uncommitted changes from your checkout.
|
|
108
116
|
|
|
109
117
|
**DSH Desktop** needs no terminal command — install it inside the app:
|
|
110
118
|
|
|
111
119
|
1. Open **Plugins** in the sidebar → **Add plugin** (or the arrow → **Install a third-party plugin**).
|
|
112
|
-
2. Enter `@zephinel/dsh-intelligent-ui@0.
|
|
120
|
+
2. Enter `@zephinel/dsh-intelligent-ui@0.5.0` (or just the package name for the latest), then click **Install**.
|
|
113
121
|
3. When the install finishes, click **Enable now**; if the **UI** control does not appear, quit and reopen DSH Desktop.
|
|
114
122
|
|
|
115
123
|
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.
|
|
116
124
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
```text
|
|
120
|
-
Plan two days in Shanghai, with checkboxes and adjustments
|
|
121
|
-
```
|
|
125
|
+
After installing, click **UI**, choose **This session only** (or send `/iui on`), then send the itinerary example at the top. An interactive itinerary at the end of the turn confirms it works. Set the session Auto / Card / Article style in the same panel if needed.
|
|
122
126
|
|
|
123
127
|
See [Development and deployment](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.en.md) for the local-checkout development loop, uninstall and troubleshooting; the extension has no development server of its own.
|
|
124
128
|
|
|
@@ -155,47 +159,59 @@ To guarantee a card (or when the model still replies in text), invoke the skill
|
|
|
155
159
|
|
|
156
160
|

|
|
157
161
|
|
|
158
|
-
A temporary result is ready to use. **Adjust style** binds that result and fills an adjustment prompt while preserving your draft; send it normally. **Save as template** optionally asks for a name, description and availability (this session or global). Saving reuses the validated result style, makes no new model request, and neither selects the template nor changes the global default. No preview, naming or saving is required before use.
|
|
162
|
+
A temporary result is ready to use. **Adjust style** binds that result and fills an adjustment prompt while preserving your draft; send it normally. **Save as template** optionally asks for a name, description and availability (this session or global); saving preserves the result’s layout (free/card/article), preferences and explicit light/dark theme without a layout choice. A result without an explicit theme inherits the session theme and is not offered Save as template, because there is no palette to copy. Free templates have a local preview and **Free layout** hint; selecting one keeps the DSH card header without a Card/Article shell, with optional Toc/Section. Saving reuses the validated result style, makes no new model request, and neither selects the template nor changes the global default. No preview, naming or saving is required before use.
|
|
163
|
+
|
|
164
|
+
**Since 0.5.0**: the Host requires free layout for new on-demand generation; adjustments preserve the parent layout (free, legacy card or article). If the parent snapshot is absent from the latest-200 result registry, adjustment returns an error; cancel it and choose **On-demand UI** again. Historical results can still replay from tool arguments.
|
|
159
165
|
|
|
160
166
|

|
|
161
167
|
|
|
162
|
-
The Plugin detail page groups settings into **Availability**, **Answer style**, **My styles**, **Composition** and **Export**. My styles manages saved global templates: set as default, rename, edit description/display preferences, export
|
|
168
|
+
The Plugin detail page groups settings into **Availability**, **Answer style**, **My styles**, **Composition** and **Export**. My styles manages saved global templates: set as default, rename, edit description/display preferences, export file, import template or delete. The composer manages global and session templates visible in that session. Generation happens in the composer; settings explain the entry without providing a generation workbench. Global values are the defaults for new sessions; a session override in the composer wins. **Free-form layout** only changes how strongly the design guidance is advisory; it is orthogonal to the answer style. **Export** stores the default background color, the 1x/2x resolution, and whether images/pages remove the `@ToAssistant` follow-up control together with its form fields (a Card with prose keeps its prose; only a pure follow-up block disappears whole; on by default).
|
|
169
|
+
|
|
170
|
+
**Template file sharing**: in My styles, or in the composer’s **Display style** panel, choose a template’s `…` → **Export file**, review the sensitive-information notice, then **Download** to get `<template-name>.iui-style.json`. The composer panel also covers session-scoped templates, so they need no separate global copy first. The file contains the name, description, base layout, full display preferences and theme. Check all of it for personal or internal information before sharing. The recipient chooses **Import template** in My styles or the composer’s **Display style** panel, selects a file or pastes JSON → **Preview**, then checks the name, description, layout, light/dark swatches and full preferences. Rename, edit or clear the preferences as needed. Importing always requires **I have read and understood the risks above; import this external template** before **Import template**. Import creates a new global template (the composer entry also writes global templates only; importing into the current session remains deferred until session authorization is checked), never applies it or changes the current selection/global default; afterwards use, edit, delete and export it normally.
|
|
171
|
+
|
|
172
|
+
Template exchange format v1 contains only portable style configuration, supports `card|article|free`, and excludes local IDs, scope, sessions and timestamps. Plugin versions supporting v1 can import it; unknown versions are rejected without downgrade guessing. Only this exchange format is accepted: raw template exports and library backups are rejected (no external users yet, so no legacy-format support is maintained). Exchange versions are independent of npm package versions. Future v2 implementations should retain v1 support; adding layouts or removing `baseLayout` requires explicit format evolution rather than silently accepting unknown layouts in v1.
|
|
173
|
+
|
|
174
|
+
Exchange is limited to one template and **32 KiB of UTF-8 input**. Files are size-checked before reading, regardless of extension or MIME. One Markdown code fence around the entire input is tolerated; JSON is never extracted from arbitrary prose. Unknown fields and library backups are rejected. The global limit is 40 templates; duplicate names get an `(Imported)` suggestion, remaining collisions require a rename, and a full library requires deleting unneeded templates. Share codes, online links, batch backups and session imports are unavailable; the composer import also writes global templates only.
|
|
175
|
+
|
|
176
|
+
**Security boundary**: an external template's name and display preferences enter the prompt and may affect model behavior; the description is stored/exported only and never enters the prompt. All three are treated as untrusted text. Preview, acknowledgement and no automatic application mitigate risk without eliminating prompt injection; DSH’s tool/permission layer controls execution authority. The current implementation follows the owner-approved approach (2026-10-24): a disclaimer plus acknowledgement before retaining external content. Real-deployment Origin/CSRF and tool-privilege auditing remain recommended pre-release hardening.
|
|
163
177
|
|
|
164
178
|
Once an answer has rendered, a labeled **export pill** appears at the **far right** of the message action strip (visually distinct from the native copy / like / branch icons); only answers rendered by the extension have it. It can save every card from that turn as one PNG — **Raw** (the answer alone), **Rounded** (background color and rounded padding) or **Card** (padding, rounded corners and a soft shadow) — or export them as a single-file HTML page, which opens in a browser with the interactions intact; in that page `@ToAssistant` copies the message and shows the paste-back-into-DSH hint instead of calling DSH. The image contains the rendered cards only, not the Markdown text around them and not the export control itself. See [Architecture and behavior](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.en.md) for the full flow.
|
|
165
179
|
|
|
166
180
|
## Build, test and deploy
|
|
167
181
|
|
|
168
|
-
|
|
182
|
+
Start at the checkout root from [Getting the code](#getting-the-code). `npm install` builds automatically through `prepare`; the local installer defaults to the `web` profile and backs up its patch. If that profile already has the npm/GitHub version, remove it first with `dsh plugin --profile web remove @zephinel/dsh-intelligent-ui` to avoid registering the plugin twice.
|
|
169
183
|
|
|
170
184
|
```bash
|
|
171
185
|
npm install
|
|
172
|
-
|
|
186
|
+
dsh plugin --profile web list # check the profile; initializes it on first use
|
|
173
187
|
node scripts/install.mjs
|
|
188
|
+
dsh web
|
|
174
189
|
```
|
|
175
190
|
|
|
176
|
-
|
|
191
|
+
If Web is already running, restart it after installing and open the printed URL. Once **UI** appears on the right of the composer, enable it and try a request as in [Quick start](#quick-start). There is no separate development server or watch mode; run `npm run build` and restart DSH after each change. See [Development and deployment](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.en.md) for uninstall and troubleshooting.
|
|
177
192
|
|
|
178
193
|
Everyday checks and packaging:
|
|
179
194
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
npm run
|
|
183
|
-
npm
|
|
184
|
-
npm run
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
195
|
+
| Command | Purpose |
|
|
196
|
+
|---|---|
|
|
197
|
+
| `npm run build` | Generate the prompt, Host, Client and standalone export-page bundles |
|
|
198
|
+
| `npm test` | Run Host, Client and packaging Node tests after a build |
|
|
199
|
+
| `npm run typecheck` | Run `tsc --noEmit` (the browser `src/client` half is currently excluded: its DSH platform types are runtime-provided) |
|
|
200
|
+
| `npm run check` | Full pre-submit check: typecheck, build, Node tests and renderer checks |
|
|
201
|
+
| `npm run pack:check` | Preview the final npm package file list without publishing |
|
|
202
|
+
| `npm run test:browser` | Run 7 browser suites after a build; Chrome required |
|
|
203
|
+
|
|
204
|
+
- Current main-branch verification record: **247/247** Node tests (Host 117, Client 109, packaging 21); renderer parse/render **42/42** each, CSS/prop contract **50/50** and **63/63**, typography **22/22**, i18n **4** programs; **7/7** browser suites passed, including **101** settings template-exchange, **114** on-demand, **46** interactive-page and **65** image-export assertions. 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).
|
|
188
205
|
- `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.
|
|
189
|
-
- The typography check inside `npm run check` needs a local Chrome; without one that check is skipped and the remaining tests still run.
|
|
206
|
+
- 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).
|
|
190
207
|
|
|
191
208
|
The published artifact is a DSH bundle; deploying means installing the plugin into the target DSH profile. See [Development and deployment](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.en.md) for uninstall and version notes.
|
|
192
209
|
|
|
193
210
|
## Contributing
|
|
194
211
|
|
|
195
212
|
- Questions and feature requests: use [GitHub Issues](https://github.com/Zephinel/dsh-intelligent-ui/issues).
|
|
196
|
-
- Run `npm run check` before
|
|
197
|
-
-
|
|
198
|
-
- Repository maintenance skills and doc-sync rules live under `.agents/skills/` (not shipped); AI coding agents also use `npm run check` as the pre-submit gate.
|
|
213
|
+
- Run `npm run check` before opening a PR; there is no PR CI, so the local command is the gate. Releases use the [GitHub Actions Trusted Publishing workflow](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.github/workflows/publish.yml); the development guide describes the process.
|
|
214
|
+
- Contributors and AI coding agents should follow the [doc-sync skill](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.agents/skills/sync-iui-docs/SKILL.md): when behavior, copy or counts change, update both READMEs, `CHANGELOG.md` and the matching documents under `docs/`. In a checkout, use the local `.agents/skills/sync-iui-docs/SKILL.md`.
|
|
199
215
|
- Maintainer: [@Zephinel](https://github.com/Zephinel).
|
|
200
216
|
|
|
201
217
|
## Known limitations
|
|
@@ -204,7 +220,7 @@ The published artifact is a DSH bundle; deploying means installing the plugin in
|
|
|
204
220
|
- The model occasionally generates invalid OpenUI Lang; Host validation returns precise errors, and it usually repairs them within the same turn (1–2 attempts in testing).
|
|
205
221
|
- The map basemap relies on OpenFreeMap tiles, routes on the OSRM demo, and photos on Wikipedia/Wikimedia; when offline, maps degrade to a list of places and photos to placeholder blocks.
|
|
206
222
|
- KaTeX uses global styles already loaded by the DSH shell; if those styles are removed, the Math component degrades to plain text.
|
|
207
|
-
- The generation prompt is about
|
|
223
|
+
- The generation prompt is about 10K tokens and is **sent only when the switch covers that session** (global on, or the session explicitly on); when off, that cost is zero (the tool schema is absent too). Article mode produces longer pages, so output tokens and render time increase accordingly.
|
|
208
224
|
- The extension's UI copy follows DSH's UI language; the `/iui` Host replies, the command palette's command description and the README screenshots stay in English (the first two are DSH platform behavior).
|
|
209
225
|
- Image export does not capture sandboxed iframes (`HtmlView` mini-games), so that region is missing from the image; maps are captured through the preserved WebGL drawing buffer, and a browser without WebGL falls back to the map's own place-list presentation.
|
|
210
226
|
- Every card rendered by one turn is combined into one image; the image captures **what is currently rendered**, so it includes the interaction state at export time (checked items, active filters and so on). The export waits for in-card photos and image searches to settle (at most about 12.5 seconds); offline or still-pending photos are recorded from the placeholder state shown on the page.
|
|
@@ -218,7 +234,7 @@ The published artifact is a DSH bundle; deploying means installing the plugin in
|
|
|
218
234
|
- Operations are in memory: armed intent expires after 10 minutes; active operations cannot resume after restart and must be re-armed. Completed results survive. There is one active operation per session: re-arming replaces it while armed, while a bound running/clarifying operation rejects re-arming until explicitly cancelled. Clarification is limited to two rounds. A text-only completion without rendering returns to the pending/resume state and the next message continues; failed/interrupted turns show Retry/Dismiss guidance.
|
|
219
235
|
- Multi-tab binding is conservative: only the arming tab shows the hint, but the Host binds the next human message in the session without verifying its sending tab. Send from the arming tab and avoid concurrent messages in another tab.
|
|
220
236
|
- Custom themes apply to the renderer host; portaled popovers and sandboxed iframes keep the default theme, and semantic status colors remain renderer-owned. Exported pages freeze the light/dark scheme at export time.
|
|
221
|
-
- Saved-template directives are bounded display preferences (2,000 characters), with no authority over system, tool or safety rules. Limits are 40 global templates and 20 per session. Missing/deleted saved templates fall back to the default theme;
|
|
237
|
+
- Saved-template directives are bounded display preferences (2,000 characters), with no authority over system, tool or safety rules. Limits are 40 global templates and 20 per session. Missing/deleted saved templates fall back to the default theme; a theme-less temporary result inherits the session template or built-in theme, while a snapshot with an explicit theme remains catalog-independent.
|
|
222
238
|
|
|
223
239
|
## FAQ
|
|
224
240
|
|
|
@@ -236,6 +252,8 @@ The published artifact is a DSH bundle; deploying means installing the plugin in
|
|
|
236
252
|
|
|
237
253
|
## Documentation
|
|
238
254
|
|
|
255
|
+
Detailed docs, the changelog and repository maintenance skills are excluded from the npm package, so their links use absolute GitHub URLs. For uncommitted features, use the corresponding files in the checkout.
|
|
256
|
+
|
|
239
257
|
- [Architecture and behavior](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.en.md): Host/Client component tree, the full switch and answer-style semantics, UI language, image and interactive-page export flows, and the Agent Skill.
|
|
240
258
|
- [Development and deployment](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.en.md): install and uninstall, development commands, the restart tip after renaming/rebuilding, Host/Client version mismatch, release layout and community marketplace maintenance.
|
|
241
259
|
- [Verification record](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.en.md): end-to-end verification, test and packaging results (historical).
|
|
@@ -244,4 +262,4 @@ The published artifact is a DSH bundle; deploying means installing the plugin in
|
|
|
244
262
|
|
|
245
263
|
## License
|
|
246
264
|
|
|
247
|
-
This project is [MIT](LICENSE). It is based on Open Intelligent UI (MIT, Copyright (c) 2026 Thesys Inc.) and the OpenUI ecosystem; the browser bundle contains lucide-react (ISC), KaTeX (MIT), MapLibre GL JS (BSD-3-Clause), zod (MIT) and SnapDOM (MIT); the standalone interactive-page bundle also inlines React / React DOM (MIT). Full notices and license texts are in
|
|
265
|
+
This project is [MIT](LICENSE). It is based on Open Intelligent UI (MIT, Copyright (c) 2026 Thesys Inc.) and the OpenUI ecosystem; the browser bundle contains lucide-react (ISC), KaTeX (MIT), MapLibre GL JS (BSD-3-Clause), zod (MIT) and SnapDOM (MIT); the standalone interactive-page bundle also inlines React / React DOM (MIT). Full notices and license texts are in [NOTICE](NOTICE) and [licenses/](licenses/).
|
package/README.md
CHANGED
|
@@ -9,15 +9,20 @@
|
|
|
9
9
|
[](https://www.npmjs.com/package/@deepseek-ai/dsh)
|
|
10
10
|
[](https://github.com/Zephinel/dsh-intelligent-ui/actions/workflows/publish.yml)
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
**把 DeepSeek Harness(DSH)的模型回答变成一张真正能用的页面。** 安装并启用后,直接提问:
|
|
13
|
+
|
|
14
|
+
```text
|
|
15
|
+
帮我排一个上海两日游,要能勾选和调整
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
模型调用 `render_ui` 工具,把答案写成一份 [OpenUI Lang 1.0](https://openui.com) 程序;DSH 聊天页在该轮结束时把它渲染成可交互页面——地图、照片、图表、清单、表单、SVG 绘图、小游戏都是真实组件,不是截图。
|
|
13
19
|
|
|
14
20
|
基于 [Open Intelligent UI](https://github.com/thesysdev/open-intelligent-ui)(MIT)移植,并附带一个随插件自动注册的 Agent Skill(`intelligent-ui`)。
|
|
15
21
|
|
|
16
22
|
> [!NOTE]
|
|
17
|
-
> **当前状态**:已发布到 GitHub 与 npm,npm 版本 **`@zephinel/dsh-intelligent-ui@0.
|
|
23
|
+
> **当前状态**:已发布到 GitHub 与 npm,npm 版本 **`@zephinel/dsh-intelligent-ui@0.5.0`**(`latest`)。自定义样式、按需生成、自由布局与模板文件导入/导出,以及渲染契约、Host 校验与导出语义修复均已包含在 0.5.0 中。
|
|
18
24
|
|
|
19
|
-
|
|
20
|
-
> **想先跑起来?** 安装只需一条命令:`dsh plugin --profile web add @zephinel/dsh-intelligent-ui`;重启承载 Web UI 的 DSH 进程后,在输入框右侧的 **UI** 控件里选择「仅本会话」即可开启。完整步骤见[快速开始](#快速开始)。
|
|
25
|
+
[快速开始](#快速开始) · [获取代码](#获取代码) · [构建、测试与部署](#构建测试与部署)
|
|
21
26
|
|
|
22
27
|
## 效果
|
|
23
28
|
|
|
@@ -58,10 +63,11 @@
|
|
|
58
63
|
| 开关与样式 | 全局默认在插件详情页;输入框 UI 控件按会话覆盖;内置 Auto / Card / Article 与自定义模板 |
|
|
59
64
|
| 自定义模板与视觉主题 | 保存可复用的展示偏好与明暗配色、字体、圆角、密度、阴影;在「我的样式」中使用、重命名、编辑或删除 |
|
|
60
65
|
| 聊天内按需生成 | 无需模板;在 UI 面板选择「按需生成」,正常发送需求,必要时用内置提问工具澄清 |
|
|
66
|
+
| 按需自由布局(未发布) | 按用户需求编排页面;保存模板保留自由布局、偏好与主题,再次使用仍无 Card/Article 外壳 |
|
|
61
67
|
| 临时结果与可选保存 | 结果自带内联样式快照,可直接使用、调整样式或事后保存为模板;不强制预览、命名或保存 |
|
|
62
|
-
| 双语界面 | 跟随 DSH
|
|
68
|
+
| 双语界面 | 跟随 DSH 的中文或英文界面语言 |
|
|
63
69
|
| Agent Skill | 随插件注册 `intelligent-ui`,模型按需加载完整语法、示例与排障 |
|
|
64
|
-
| 插件详情页 |
|
|
70
|
+
| 插件详情页 | 集中管理全局启用、默认样式、模板、编排方式与导出偏好 |
|
|
65
71
|
| 可重放 | 程序与临时样式随工具参数重放;导出页面冻结导出时的主题方案 |
|
|
66
72
|
|
|
67
73
|
## 获取代码
|
|
@@ -77,48 +83,46 @@ cd dsh-intelligent-ui
|
|
|
77
83
|
|
|
78
84
|
## 前置条件
|
|
79
85
|
|
|
80
|
-
|
|
81
|
-
|
|
86
|
+
以下命令用于 DSH Web 与源码开发;DSH Desktop 用户可直接按[快速开始](#快速开始)中的应用内步骤安装。
|
|
87
|
+
|
|
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`。
|
|
89
|
+
- **[Node.js 24 与自带的 npm](https://nodejs.org/en/download)**:构建、测试与发布工作流使用 Node 24。仓库没有 `engines` 或 `.nvmrc` 版本锁,运行 `npm install` 前需自行选用 Node 24;Host 的 Node 22 编译目标不代表整个工具链已在 Node 22 验证。
|
|
90
|
+
- **[Git](https://git-scm.com/downloads)**:仅获取源码时需要,仓库未指定最低版本。
|
|
82
91
|
- **`@deepseek-ai/dsh-client-locale`**:浏览器半边要求部署组合了它;DSH Web 0.2.1 默认包含,缺少时开关和卡片不会挂载(Host 工具与提示词仍可用)。
|
|
83
92
|
|
|
84
93
|
确认工具存在:
|
|
85
94
|
|
|
86
95
|
```bash
|
|
87
96
|
node --version # v24.x
|
|
88
|
-
|
|
97
|
+
npm --version
|
|
98
|
+
dsh --version # 已验证:0.2.1-rc.2
|
|
99
|
+
git --version # 仅获取源码时需要
|
|
89
100
|
```
|
|
90
101
|
|
|
91
102
|
重启示例覆盖前台 `dsh web`、macOS launchd 与 Linux systemd;用其他方式托管时重启对应服务。验证平台:macOS(Web + DSH Desktop)与 Windows(DSH Desktop);Linux 未验证。
|
|
92
103
|
|
|
93
104
|
## 快速开始
|
|
94
105
|
|
|
95
|
-
|
|
106
|
+
**DSH Web**:从 npm 安装已发布的 0.5.0,再启动 Web UI(首次前台运行示例):
|
|
96
107
|
|
|
97
108
|
```bash
|
|
98
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui
|
|
99
|
-
|
|
100
|
-
# 固定当前版本
|
|
101
|
-
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.4.1
|
|
102
|
-
|
|
103
|
-
# 或从 GitHub 安装
|
|
104
|
-
dsh plugin --profile web add github:Zephinel/dsh-intelligent-ui
|
|
109
|
+
dsh plugin --profile web add @zephinel/dsh-intelligent-ui@0.5.0
|
|
110
|
+
dsh web
|
|
105
111
|
```
|
|
106
112
|
|
|
107
|
-
|
|
113
|
+
已有 Web 进程时,安装后重启该进程(前台:Ctrl+C 后重新运行 `dsh web`;launchd/systemd:重启对应服务)。打开它打印的 URL,输入框右侧出现 **UI** 控件即加载成功;地址与端口由 DSH profile 决定。
|
|
114
|
+
|
|
115
|
+
其他安装来源可替代上面的安装命令:跟随 npm 最新版用 `dsh plugin --profile web add @zephinel/dsh-intelligent-ui`;从 GitHub 已提交代码安装用 `dsh plugin --profile web add github:Zephinel/dsh-intelligent-ui`。两者都不会安装当前 checkout 的未提交改动。
|
|
108
116
|
|
|
109
117
|
**DSH Desktop(桌面版)** 不需要终端命令,在应用内安装:
|
|
110
118
|
|
|
111
119
|
1. 侧栏 **插件** → **添加插件**(或箭头 → **安装第三方插件**)。
|
|
112
|
-
2. 输入 `@zephinel/dsh-intelligent-ui@0.
|
|
120
|
+
2. 输入 `@zephinel/dsh-intelligent-ui@0.5.0`(或只填包名装最新版),点 **安装**。
|
|
113
121
|
3. 安装完成后点 **立即启用**;若输入框右侧没有 **UI** 控件,退出并重开 DSH Desktop。
|
|
114
122
|
|
|
115
123
|
桌面版的 profile 由 Electron 应用独占管理,`dsh plugin --profile desktop` 会被拒绝。国内镜像可能晚于 npm 官方源同步刚发布的版本;装不到时把安装源切回 npm 官方源。
|
|
116
124
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
```text
|
|
120
|
-
帮我排一个上海两日游,要能勾选和调整
|
|
121
|
-
```
|
|
125
|
+
安装后在输入框右侧点 **UI** 控件,选择「仅本会话」(或发送 `/iui on`),再发送开头的行程示例。该轮结束后出现可交互的行程页面即验证成功。需要时可在同一面板设置本会话的 Auto / Card / Article 样式。
|
|
122
126
|
|
|
123
127
|
本地开发(从 checkout 构建并安装)、卸载与排障见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md);扩展没有独立的开发服务器。
|
|
124
128
|
|
|
@@ -155,47 +159,59 @@ dsh plugin --profile web add github:Zephinel/dsh-intelligent-ui
|
|
|
155
159
|
|
|
156
160
|

|
|
157
161
|
|
|
158
|
-
|
|
162
|
+
临时结果可以立即使用。点「调整样式」会关联这张结果并在保留草稿的前提下填入调整提示,仍需正常发送;点「保存为模板」才填写名称、描述与可用范围(本会话或全局);保存完整保留该结果的布局(free/card/article)、偏好与显式明暗主题,不再选择布局。结果没有显式主题时继承会话主题,此时不提供「保存为模板」,因为没有可复制的配色。自由模板使用独立预览与「自由布局」提示;选中后仍无 Card/Article 外壳,保留 DSH 卡片标题栏,Toc/Section 可选。保存复用该结果的已校验样式,不再次生成,也不自动选中模板或更改全局默认;不要求先预览、命名或保存。
|
|
163
|
+
|
|
164
|
+
**0.5.0 起**:Host 要求新按需生成使用自由布局;调整保留父结果的布局(free、旧 card 或 article)。若父快照已不在最近 200 条结果注册表中,调整会报错;请取消调整后重新选择「按需生成」。历史结果仍可从工具参数重放。
|
|
159
165
|
|
|
160
166
|

|
|
161
167
|
|
|
162
|
-
插件详情页按 **可用性**、**回答样式**、**我的样式**、**编排方式** 和 **导出**
|
|
168
|
+
插件详情页按 **可用性**、**回答样式**、**我的样式**、**编排方式** 和 **导出** 分组。「我的样式」管理已保存的全局模板,可设为默认、重命名、编辑描述/展示偏好、导出文件、导入模板或删除;Composer 管理当前会话可见的全局与会话模板。生成入口在 Composer,设置页提供说明,不设生成工作台。全局值是新会话的默认;输入框 UI 控件里的会话值优先。**自由布局**只影响设计规范的建议强度,与回答样式正交。**导出** 保存图片的默认背景色、1x/2x 分辨率,以及图片/交互页面是否移除 `@ToAssistant` 追问控件及其表单字段(含正文的 Card 保留正文,只有纯追问区块整块消失;默认移除)。
|
|
169
|
+
|
|
170
|
+
**模板文件分享**:在插件设置页「我的样式」或 Composer 的「显示样式」面板中点模板的 `…` →「导出文件」,检查敏感信息提示后点「下载」,得到 `<模板名>.iui-style.json`。Composer 面板同时覆盖仅本会话的模板,因此不必先另存为全局模板。文件包含名称、描述、基础布局、展示规范全文和主题;分享前检查其中是否包含个人或内部信息。接收方在「我的样式」或「显示样式」面板点「导入模板」,选择文件或粘贴 JSON →「预览」→ 检查名称、描述、布局、明暗色板及展示规范全文。可以改名、编辑或清空展示规范;导入前必须勾选「我已阅读并理解上述风险,确认导入该外部模板」,再点「导入模板」。导入只新建全局模板(Composer 里的导入同样只写全局;导入到本会话仍待会话授权校验后开放),不自动应用,也不改变当前选择或全局默认;随后可正常选用、编辑、删除或再次导出。
|
|
171
|
+
|
|
172
|
+
模板交换格式 v1 只包含可移植样式配置,支持 `card|article|free`,不含本地 id、作用域、会话和时间戳。支持 v1 的插件版本可以导入该格式;未知版本会被拒绝,不尝试降级解析。导入器只接受该交换格式:原始模板导出文件与持久化库文件都会被拒绝(当前没有外部用户,不维护旧格式兼容)。交换格式版本独立于 npm 包版本;未来引入 v2 应继续支持 v1,新增布局或移除 `baseLayout` 必须显式演进格式,不允许 v1 静默接受未知布局。
|
|
173
|
+
|
|
174
|
+
单次只交换一个模板,输入最多 **32 KiB(UTF-8 字节)**;文件大小先检查再读取,不依赖扩展名或 MIME。允许全文包住的一层 Markdown 代码围栏,不从任意说明文字中提取 JSON。未知字段和模板库备份均拒绝。全局最多 40 个模板;重名时建议 `(Imported)` 后缀,仍冲突时需改名,配额满时先删除不需要的模板。没有分享码、在线链接、批量备份或会话范围导入;Composer 的导入同样只写全局。
|
|
175
|
+
|
|
176
|
+
**安全边界**:外部模板的名称与展示规范会进入提示词、可能影响模型行为;描述仅保存/导出,不会进入提示词。三者都按不可信文本处理,预览、阅读确认和不自动应用是缓解措施,不能消除提示词注入;实际执行权限仍由 DSH 工具/权限层控制。当前实现按 owner 已确认的方案(2026-10-24)用免责声明 + 阅读确认后保留外部内容;真实部署的 Origin/CSRF 与工具越权审计仍是发布前建议补做的加固。
|
|
163
177
|
|
|
164
178
|
回答渲染完成后,消息底部操作栏的**最右侧**会出现带「导出」字样的**药丸按钮**(只有扩展渲染的回答才有)。点开后可把该轮全部卡片保存为一张 PNG——**原始**(只截取答案本身)、**圆角**(背景色 + 圆角留白)或 **卡片**(留白、圆角与柔和阴影);也可以导出为单文件 HTML,直接在浏览器打开即可继续交互,页面里的 `@ToAssistant` 改为复制消息并提示回到 DSH 粘贴。导出的图片只包含渲染出的卡片,不包含聊天里的 Markdown 文字或导出按钮本身。完整流程见[架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md)。
|
|
165
179
|
|
|
166
180
|
## 构建、测试与部署
|
|
167
181
|
|
|
168
|
-
|
|
182
|
+
从[获取代码](#获取代码)的 checkout 根目录开始。`npm install` 的 `prepare` 会自动构建;本地安装器默认写入 `web` profile 并自动备份。若该 profile 已安装 npm/GitHub 版,先用 `dsh plugin --profile web remove @zephinel/dsh-intelligent-ui` 移除,避免同一插件重复注册。
|
|
169
183
|
|
|
170
184
|
```bash
|
|
171
185
|
npm install
|
|
172
|
-
|
|
186
|
+
dsh plugin --profile web list # 检查 profile;首次使用会初始化
|
|
173
187
|
node scripts/install.mjs
|
|
188
|
+
dsh web
|
|
174
189
|
```
|
|
175
190
|
|
|
176
|
-
|
|
191
|
+
已有 Web 进程时,安装后重启该进程,再打开它打印的 URL;输入框右侧出现 **UI** 控件后按[快速开始](#快速开始)启用并试问。扩展没有独立开发服务器或 watch 模式;每次修改后重新 `npm run build` 并重启 DSH。卸载与排障见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md)。
|
|
177
192
|
|
|
178
193
|
日常检查与打包:
|
|
179
194
|
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
npm run
|
|
183
|
-
npm
|
|
184
|
-
npm run
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
195
|
+
| 命令 | 用途 |
|
|
196
|
+
|---|---|
|
|
197
|
+
| `npm run build` | 生成 prompt、Host、Client 与独立导出页面 bundle |
|
|
198
|
+
| `npm test` | 构建后运行 Host、Client 与打包的 Node 测试 |
|
|
199
|
+
| `npm run typecheck` | 运行 `tsc --noEmit`(浏览器 `src/client` 暂因运行时平台类型不可解析而排除) |
|
|
200
|
+
| `npm run check` | 提交前完整检查:typecheck、构建、Node 测试与 renderer 检查 |
|
|
201
|
+
| `npm run pack:check` | 预览 npm 包最终文件清单,不发布 |
|
|
202
|
+
| `npm run test:browser` | 先构建;运行 7 个浏览器套件,需要 Chrome |
|
|
203
|
+
|
|
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)(历史记录)。
|
|
188
205
|
- `node scripts/capture-screenshots.mjs` 以固定 DSH token、生产组件与假服务在 Chrome 2x 重建面板、提示、临时结果与设置截图;英文 UI,卡片壳层图标用 lucide 替身。
|
|
189
|
-
- `npm run check` 里的排版检查(typography)需要本机 Chrome;没有 Chrome
|
|
206
|
+
- `npm run check` 里的排版检查(typography)需要本机 Chrome;没有 Chrome 时该检查会跳过,其余测试仍会运行。非默认安装位置可用 `CHROME_BIN` 指定 Chrome 可执行文件(也适用于浏览器套件)。
|
|
190
207
|
|
|
191
208
|
发布物是一个 DSH bundle;部署就是把插件安装进目标 DSH profile。卸载与版本注意事项见[开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md)。
|
|
192
209
|
|
|
193
210
|
## 贡献
|
|
194
211
|
|
|
195
212
|
- 问题与功能请求:使用 [GitHub Issues](https://github.com/Zephinel/dsh-intelligent-ui/issues)。
|
|
196
|
-
-
|
|
197
|
-
-
|
|
198
|
-
- 仓库内的维护技能与文档同步规则在 `.agents/skills/`(不随 npm 包发布);AI 协作代理同样以 `npm run check` 作为提交前门槛。
|
|
213
|
+
- 提交 PR 前运行 `npm run check`;仓库没有 PR CI,以本地命令结果为准。发布由 [GitHub Actions Trusted Publishing 工作流](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/.github/workflows/publish.yml)执行,流程见开发文档。
|
|
214
|
+
- 贡献者与 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` 为准。
|
|
199
215
|
- 维护者:[@Zephinel](https://github.com/Zephinel)。
|
|
200
216
|
|
|
201
217
|
## 已知限制
|
|
@@ -204,7 +220,7 @@ npm run test:browser # 先构建;7 个浏览器套件:按需生成、样式
|
|
|
204
220
|
- 模型偶发生成不合法 OpenUI Lang;Host 校验会返回精确错误,通常同一轮内自修(实测 1–2 次)。
|
|
205
221
|
- 地图底图依赖 OpenFreeMap 瓦片,路线依赖 OSRM demo,照片依赖 Wikipedia/Wikimedia;离线时地图降级为地点列表、照片降级为占位块。
|
|
206
222
|
- KaTeX 使用 DSH 壳层已加载的全局样式;若该样式被移除,Math 组件会退化为纯文本。
|
|
207
|
-
- 生成提示词约
|
|
223
|
+
- 生成提示词约 10K tokens,**只在开关命中该会话时发送**(全局开启,或该会话显式开启);关闭时这部分开销为 0(工具 schema 也不出现)。Article 模式会生成更长的页面,输出 token 与渲染时间相应增加。
|
|
208
224
|
- 扩展 UI 文案随 DSH 界面语言切换;但 `/iui` 的 Host 返回文案、命令面板里的命令描述与 README 截图仍是英文(前两者是 DSH 平台行为)。
|
|
209
225
|
- 导出图片时,沙盒 iframe(`HtmlView` 里的小游戏)不会被截入图片,图片中该区域会缺失;地图通过保留 WebGL 绘制缓冲入图,禁用 WebGL 的浏览器会按地图自身的降级逻辑显示地点列表。
|
|
210
226
|
- 同一轮回复渲染出的多张卡片会合并成一张图片;导出的是**当前屏幕上渲染出的内容**,因此导出的图片会包含当时的交互状态(勾选项、筛选结果等)。导出会等待卡片内的图片加载和图片搜索完成(最多约 12.5 秒);离线或仍未就绪时按页面上的占位状态导出。
|
|
@@ -218,7 +234,7 @@ npm run test:browser # 先构建;7 个浏览器套件:按需生成、样式
|
|
|
218
234
|
- 按需操作只在内存中:等待发送(armed)10 分钟过期,重启后活动操作无法恢复,需要重新武装;已完成结果不因此丢失。每会话最多一个活动操作:armed 时重新武装会替换,已绑定的 running/clarifying 拒绝重新武装且需先取消;最多两轮澄清。文本结束但未渲染时操作回到待继续状态,下一条消息继续;失败/中断会显示重试/关闭提示。
|
|
219
235
|
- 多标签页采用保守绑定:提示只显示在发起标签页,但 Host 绑定该会话的下一条人工消息,并不验证发送标签来源;请在发起标签页发送,避免另一标签同时发送。
|
|
220
236
|
- 自定义主题只应用到 renderer host,portaled Popover 与沙盒 iframe 保留默认主题;语义状态色保持渲染器定义。导出交互页面冻结导出时的明/暗方案,不随系统切换。
|
|
221
|
-
- 已保存模板的 directives 是有界展示偏好(最多 2,000 字符),不能覆盖系统、工具或安全规则;模板库上限为全局 40 个、每会话 20
|
|
237
|
+
- 已保存模板的 directives 是有界展示偏好(最多 2,000 字符),不能覆盖系统、工具或安全规则;模板库上限为全局 40 个、每会话 20 个。删除/不可用的已保存模板按默认主题降级;没有显式主题的临时结果沿用会话模板或内置主题,带显式主题的快照单独重放/导出、不依赖模板库。
|
|
222
238
|
|
|
223
239
|
## 常见问题
|
|
224
240
|
|
|
@@ -236,6 +252,8 @@ npm run test:browser # 先构建;7 个浏览器套件:按需生成、样式
|
|
|
236
252
|
|
|
237
253
|
## 文档
|
|
238
254
|
|
|
255
|
+
详细文档、变更日志与仓库维护技能不随 npm 包发布,因此链接使用绝对 GitHub 地址;未提交功能以 checkout 内对应文件为准。
|
|
256
|
+
|
|
239
257
|
- [架构与行为](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/architecture.md):Host/Client 组件树、开关与回答样式的完整语义、界面语言、图片与交互页面导出流程、Agent Skill。
|
|
240
258
|
- [开发与部署](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/development.md):安装与卸载、开发命令、改名/重建后的重启提示、Host/Client 版本错位、发布物布局与插件市场维护。
|
|
241
259
|
- [验证记录](https://github.com/Zephinel/dsh-intelligent-ui/blob/main/docs/verification.md):端到端验证、测试与打包结果(历史记录)。
|
|
@@ -244,4 +262,4 @@ npm run test:browser # 先构建;7 个浏览器套件:按需生成、样式
|
|
|
244
262
|
|
|
245
263
|
## 许可证
|
|
246
264
|
|
|
247
|
-
本项目采用 [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)。完整声明与许可证全文见
|
|
265
|
+
本项目采用 [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
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|