dsh-genui 0.2.0 → 0.2.1

package/README.md

@@ -20,13 +20,13 @@ All three screenshots are from a live DSH session — not mockups.
 
 ### "Generate a calculator"
 
-![A calculator rendered inside a DSH conversation](./public/computer.png)
+![A calculator rendered inside a DSH conversation](./public/computer.webp)
 
 Digits, operators, parentheses, backspace, clear — every key works. That 666 was typed on the keypad, not written into the text by the model.
 
 ### "Generate a form"
 
-![A project proposal form rendered inside a DSH conversation](./public/form.png)
+![A project proposal form rendered inside a DSH conversation](./public/form.webp)
 
 One sentence produces a full project proposal form: required-field validation, radio group, dropdown, headcount stepper, date picker, toggle, checkboxes, long text.
 
@@ -34,7 +34,7 @@ Hit **Submit** and your answers go back into the conversation, so the AI can ran
 
 ### "Show the last 7 days of traffic as a line chart"
 
-![A traffic line chart rendered inside a DSH conversation](./public/chat.png)
+![A traffic line chart rendered inside a DSH conversation](./public/chat.webp)
 
 Two series, legend, axes, gridlines — a rendered chart, not ASCII art.
 
@@ -155,9 +155,9 @@ DSH locks in its plugin set at startup, so **nothing changes in the UI until you
 3. Refresh the browser
 4. **Start a new conversation**
 
-### Turn the authoring prompt on
+### GenUI authoring prompt
 
-Click the sparkle button in the composer tool row to turn GenUI authoring on. The toggle starts off after DSH restarts or the plugin reloads, and it only controls the authoring guidance sent to the model. Card rendering stays installed either way.
+GenUI authoring starts on by default and remembers your last choice across DSH restarts. Use the sparkle button in the composer tool row if you want to turn the authoring guidance off. Card rendering stays installed either way.
 
 ### Check that it worked
 
@@ -197,7 +197,7 @@ DSH needs pnpm to manage plugins. Run `corepack enable` (or `npm i -g pnpm`), th
 
 **The AI doesn't use interfaces on its own?**
 
-If the sparkle toggle is off, the model has no GenUI authoring guidance. Turn it on, then say something like "give me a form / chart / interface."
+If the sparkle toggle is off, the model has no GenUI authoring guidance. Turn it back on, then say something like "give me a form / chart / interface."
 
 **Does this change how DSH normally works?**
 
@@ -213,7 +213,7 @@ Yes. Run `dsh plugin remove`, restart, and DSH is back to its original state wit
 
 In short: the model no longer writes only text — it also writes a *description of an interface*, and the browser renders that description into real components.
 
-A bit more detail: when the composer toggle is enabled, the plugin adds a prompt section teaching the model to emit structured JSON (inside a `schemaJson` code block) when an interface would help. The DSH web client picks up that JSON and hands it to a renderer. It's streaming, so the interface appears as the model writes it — no waiting for the full reply.
+A bit more detail: the plugin adds a prompt section teaching the model to emit structured JSON (inside a `schemaJson` code block) when an interface would help. The composer sparkle toggle controls that section and is enabled by default. The DSH web client picks up the JSON and hands it to a renderer. It's streaming, so the interface appears as the model writes it — no waiting for the full reply.
 
 The components come from [OpenTiny GenUI SDK](https://opentiny.design/genui-sdk) and the OpenTiny Vue library — OpenTiny's generative-UI stack, a spec plus rendering engine for letting LLMs produce interfaces. dsh-genui wires that into the DSH conversation flow.
 

package/README.zh-CN.md

@@ -20,13 +20,13 @@
 
 ### 说「生成一个计算器」
 
-![DSH 对话里渲染出的计算器](./public/computer.png)
+![DSH 对话里渲染出的计算器](./public/computer.webp)
 
 数字键、四则运算、括号、退格、清空，全都能按。算出来的 666 是真按出来的，不是 AI 写在文字里的。
 
 ### 说「生成一个表单」
 
-![DSH 对话里渲染出的项目立项申请表](./public/form.png)
+![DSH 对话里渲染出的项目立项申请表](./public/form.webp)
 
 一句话生成一整张立项申请表：必填校验、单选按钮组、下拉框、人数步进器、日期选择、开关、多选框、长文本，一次到位。
 
@@ -34,7 +34,7 @@
 
 ### 说「用折线图展示最近 7 天访问量」
 
-![DSH 对话里渲染出的访问量折线图](./public/chat.png)
+![DSH 对话里渲染出的访问量折线图](./public/chat.webp)
 
 双折线、图例、坐标轴、网格线，都是渲染出来的图，不是字符画。
 
@@ -155,9 +155,9 @@ DSH 在启动时就锁定了当前的插件集合，所以**装完插件不重
 3. 浏览器刷新一下页面
 4. **开一个新会话**
 
-### 打开 GenUI 提示词
+### GenUI 提示词
 
-点击输入框工具行里的星形按钮，开启 GenUI 授权提示词。DSH 重启或插件重新加载后，开关默认关闭；它只控制发给模型的提示词，卡片渲染能力始终保留。
+GenUI 授权提示词默认开启，并且会记住你上一次的选择：DSH 重启后保持关闭或开启。想临时关闭时，点击输入框工具行里的星形按钮即可；它只控制发给模型的提示词，卡片渲染能力始终保留。
 
 ### 验证装好了没
 
@@ -197,7 +197,7 @@ DSH 管理插件依赖 pnpm。执行 `corepack enable`（或 `npm i -g pnpm`）
 
 **AI 不主动用界面回答？**
 
-如果星形开关是关闭的，模型不会收到 GenUI 提示词。先打开开关，再说一句「用界面/表单/图表的方式给我」就行。
+如果星形开关是关闭的，模型不会收到 GenUI 提示词。重新打开开关，再说一句「用界面/表单/图表的方式给我」就行。
 
 **会不会影响原来的用法？**
 
@@ -213,7 +213,7 @@ DSH 管理插件依赖 pnpm。执行 `corepack enable`（或 `npm i -g pnpm`）
 
 一句话：AI 不再只写文字，它还会写一段「界面描述」，浏览器把这段描述渲染成真正的组件。
 
-具体一点：输入框开关打开时，插件给模型加一段提示词，教它在需要的时候输出一段结构化的 JSON（写在 `schemaJson` 代码块里）；DSH 网页端拿到这段 JSON 后，交给渲染器变成实际组件。整个过程是流式的，AI 写到哪、界面就渲染到哪，不用等它把话说完。
+具体一点：插件默认给模型加一段提示词，教它在需要的时候输出一段结构化的 JSON（写在 `schemaJson` 代码块里）；输入框里的星形开关控制是否加这段提示词。DSH 网页端拿到 JSON 后，交给渲染器变成实际组件。整个过程是流式的，AI 写到哪、界面就渲染到哪，不用等它把话说完。
 
 组件本身来自 [OpenTiny GenUI SDK](https://opentiny.design/genui-sdk) 和 OpenTiny Vue 组件库——这是 OpenTiny 团队做的生成式 UI 方案，一整套「让大模型输出界面」的规范和渲染引擎。dsh-genui 做的事情，是把它接到了 DSH 的对话流里。
 

package/lib/index.js

@@ -6102,6 +6102,26 @@ function He(r, e, t, s) {
 //#endregion
 //#region src/prompt-control.ts
 /**
+* Mirror prompt-toggle changes into DSH settings without delaying the UI.
+* @param control - the in-memory prompt section control.
+* @param settings - the registered settings scope.
+* @param initialEnabled - fallback when settings contains no stored value.
+* @param onError - called when persisting a user choice fails.
+*/
+function createPersistedPromptControl(control, settings, initialEnabled, onError, onPersist) {
+	const stored = settings.get().enabled;
+	control.set(typeof stored === "boolean" ? stored : initialEnabled);
+	return {
+		isEnabled: control.isEnabled,
+		set(enabled) {
+			const next = control.set(enabled);
+			onPersist?.(next);
+			settings.update({ enabled: next }).catch((error) => onError?.(error));
+			return next;
+		}
+	};
+}
+/**
 * Create the host-side on/off state for the GenUI authoring section.
 * @param section - stable prompt section values.
 * @param systemPrompt - host system-prompt registry.
@@ -6129,7 +6149,10 @@ function createGenuiPromptControl(section, systemPrompt) {
 function createGenuiPromptControlHandler(control) {
 	return async (req, res) => {
 		if (req.method === "GET") {
-			respond(res, 200, { enabled: control.isEnabled() });
+			respond(res, 200, {
+				enabled: control.isEnabled(),
+				...control.persisted === void 0 ? {} : { persisted: control.persisted() }
+			});
 			return;
 		}
 		if (req.method !== "POST") {
@@ -6225,6 +6248,8 @@ const Config = z.object({
 	sectionOrder: z.number().default(80),
 	sectionName: z.string().default("genui:cards")
 });
+/** Settings schema for the user's last prompt-toggle choice. */
+const PromptSettings = z.object({ enabled: z.boolean().default(true) });
 /**
 * Create the GenUI authoring guidance for the host system-prompt registry.
 * @returns The prompt text to register while the composer toggle is enabled.
@@ -6244,7 +6269,7 @@ function genuiPromptText() {
 	}] });
 }
 /**
-* Register the GenUI runtime and the on-demand authoring prompt toggle.
+* Register the GenUI runtime and the authoring prompt toggle.
 * @param ctx - Cordis context with `systemPrompt` injected.
 * @param config - validated plugin config.
 */
@@ -6255,13 +6280,39 @@ function apply(ctx, config) {
 		order: config.sectionOrder,
 		text: genuiPromptText()
 	}, systemPrompt);
-	ctx.effect(() => () => promptControl.set(false), "dsh-genui: prompt toggle state");
+	let currentControl = promptControl;
+	let persistedAttached = false;
+	const endpointControl = {
+		isEnabled: () => currentControl.isEnabled(),
+		set: (enabled) => currentControl.set(enabled),
+		persisted: () => persistedAttached
+	};
+	ctx.effect(() => {
+		promptControl.set(true);
+		return () => promptControl.set(false);
+	}, "dsh-genui: prompt toggle state");
+	ctx.inject(["settings"], (settingsCtx) => {
+		const scope = settingsCtx.settings.register("dsh-genui", PromptSettings);
+		ctx.logger.debug("dsh-genui: settings service attached");
+		settingsCtx.effect(() => {
+			currentControl = createPersistedPromptControl(promptControl, scope, true, (error) => {
+				ctx.logger.warn("dsh-genui: failed to persist prompt state", error);
+			}, (enabled) => {
+				ctx.logger.debug("dsh-genui: persisting prompt state enabled=%s", String(enabled));
+			});
+			persistedAttached = true;
+			return () => {
+				currentControl = promptControl;
+				persistedAttached = false;
+			};
+		}, "dsh-genui: persisted prompt control");
+	});
 	const artifacts = genuiRuntimeArtifactPaths();
 	const webServer = ctx.webServer;
 	ctx.effect(() => webServer.register({
 		kind: "exact",
 		path: GENUI_PROMPT_CONTROL_URL,
-		handler: createGenuiPromptControlHandler(promptControl)
+		handler: createGenuiPromptControlHandler(endpointControl)
 	}), "dsh-genui: prompt toggle state endpoint");
 	ctx.effect(() => webServer.register({
 		kind: "exact",
@@ -6275,4 +6326,4 @@ function apply(ctx, config) {
 	}), "dsh-genui: runtime.js.map");
 }
 //#endregion
-export { Config, apply, inject, name };
+export { Config, PromptSettings, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-genui",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "packageManager": "pnpm@11.21.0",
   "description": "GenUI for DeepSeek Harness: interactive charts, forms, calculators, dashboards, and mini apps rendered inline in assistant replies, with actions that flow back to the model.",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "prepublishOnly": "pnpm build && pnpm test",
     "website:dev": "pnpm --filter dsh-genui-website dev",
     "website:build": "pnpm sync:website-assets && pnpm --filter dsh-genui-website build",
-    "sync:website-assets": "mkdir -p website/public && cp public/*.png website/public/"
+    "sync:website-assets": "mkdir -p website/public && cp public/*.webp website/public/"
   },
   "dsh": {
     "bundle": {