@changfenhuang/dsh-genui 0.11.4 → 0.12.0

package/lib/index.js

@@ -1547,6 +1547,46 @@ function opt(key, value) {
 	return value === void 0 ? {} : { [key]: value };
 }
 //#endregion
+//#region src/client/file-link.ts
+/** Decode a local file destination and its optional first line fragment. */
+function parseFileLink(value) {
+	if (value.length > 2048) return void 0;
+	const hash = value.indexOf("#");
+	const destination = hash < 0 ? value : value.slice(0, hash);
+	if (destination.includes("?")) return void 0;
+	let path;
+	try {
+		path = decodeURIComponent(destination);
+	} catch {
+		return;
+	}
+	if (path === "" || /[\u0000-\u001f\u007f]/.test(path) || /^[\\/]{2}/.test(path) || /^[a-z][a-z\d+.-]*:/i.test(path) && !/^[a-z]:[\\/]/i.test(path)) return void 0;
+	if (hash < 0) return { path };
+	const match = /^L([1-9]\d*)(?:-L([1-9]\d*))?$/.exec(value.slice(hash + 1));
+	if (match === null) return void 0;
+	const line = Number(match[1]);
+	const end = match[2] === void 0 ? line : Number(match[2]);
+	if (!Number.isSafeInteger(line) || !Number.isSafeInteger(end) || end < line) return void 0;
+	return {
+		path,
+		line
+	};
+}
+/** Classify a link destination while preserving the existing external URL policy. */
+function classifyLinkTarget(value) {
+	const external = safeHref(value);
+	if (external !== void 0) return {
+		type: "external",
+		href: external
+	};
+	if (typeof value !== "string") return { type: "invalid" };
+	const file = parseFileLink(value.trim());
+	return file === void 0 ? { type: "invalid" } : {
+		type: "file",
+		file
+	};
+}
+//#endregion
 //#region src/client/guard.ts
 function fieldKindMatches(value, kind) {
 	switch (kind) {
@@ -1791,10 +1831,11 @@ function repairNodeFields(value, ctx, depth) {
 		case "link": {
 			const label = str(v.label, GENUI_LIMITS.maxString);
 			if (label === void 0) return null;
+			const target = classifyLinkTarget(v.href);
 			return {
 				type: "link",
 				label,
-				...opt("href", safeHref(v.href))
+				...opt("href", target.type === "external" ? target.href : target.type === "file" ? String(v.href).trim() : void 0)
 			};
 		}
 		case "image": {
@@ -3270,6 +3311,7 @@ function validateNode(value, depth, at, errors, walk) {
 *    with ASCII quotes (e.g. `对"别名路径"判定失败`), which makes JSON.parse
 *    fail near that quote with "Expected ',' or ']'...".
 * 2. Trailing commas before `}` / `]` or at end of input.
+* 3. Valueless object keys immediately before a complete key-and-colon pair.
 *
 * A shared grammar-aware scan distinguishes object keys from values and
 * checks the continuation after a potential string terminator. Ambiguous
@@ -3292,6 +3334,33 @@ const MAX_QUOTE_LOOKAHEAD = 4096;
 function isJsonSpace(ch) {
 	return ch === " " || ch === "	" || ch === "\n" || ch === "\r";
 }
+/** Skip only complete, valueless object keys followed by a valued member. */
+function skipValuelessKeys(raw, start, limit = raw.length) {
+	let cursor = start;
+	let repairs = 0;
+	while (cursor < limit && raw[cursor] === "\"") {
+		const keyStart = cursor++;
+		while (cursor < limit && raw[cursor] !== "\"") if (raw[cursor] === "\\") cursor += 2;
+		else cursor++;
+		if (cursor >= limit) return null;
+		cursor++;
+		try {
+			JSON.parse(raw.slice(keyStart, cursor));
+		} catch {
+			return null;
+		}
+		while (cursor < limit && isJsonSpace(raw[cursor])) cursor++;
+		if (raw[cursor] === ":") return repairs > 0 ? {
+			start: keyStart,
+			repairs
+		} : null;
+		if (raw[cursor] !== ",") return null;
+		repairs++;
+		cursor++;
+		while (cursor < limit && isJsonSpace(raw[cursor])) cursor++;
+	}
+	return null;
+}
 /**
 * Quote closure is contextual: only keys may be followed by `:`, and a comma
 * must introduce the next member of the enclosing object/array. Walk closing
@@ -3330,6 +3399,8 @@ function quoteCanClose(raw, index, key, scopes, complete) {
 	if (raw[cursor] === scope.closer) return true;
 	if (scope.closer === "]") return /["[{tfn\-0-9]/.test(raw[cursor]);
 	if (raw[cursor] !== "\"") return false;
+	const valueless = skipValuelessKeys(raw, cursor, limit);
+	if (valueless !== null) cursor = valueless.start;
 	cursor++;
 	while (cursor < limit) {
 		if (raw[cursor] === "\\") {
@@ -3406,6 +3477,14 @@ function scanFenceCandidate(raw, complete, contentQuotes) {
 		}
 		if (ch === "\"") {
 			key = scopes[scopes.length - 1]?.expecting === "key";
+			if (key) {
+				const valueless = skipValuelessKeys(raw, i);
+				if (valueless !== null) {
+					repairs += valueless.repairs;
+					i = valueless.start - 1;
+					continue;
+				}
+			}
 			interiorQuote = false;
 			inString = true;
 			out += ch;
@@ -4132,6 +4211,7 @@ function formatProcessWarnings(processed) {
 			const canonicalPath = `${separator < 0 ? "" : warning.path.slice(0, separator + 1)}${warning.canonical}`;
 			return warning.message.includes("ignored") ? `warning=alias_ignored path=${warning.path} canonical=${canonicalPath}` : `warning=alias_normalized path=${warning.path} canonical=${canonicalPath}`;
 		}
+		if (warning.kind === "unknown-field") return `warning=unknown_field path=${JSON.stringify(warning.path)} detail=${JSON.stringify(warning.message)}`;
 		return `warning=process detail=${JSON.stringify(warning.message)}`;
 	});
 }
@@ -4226,7 +4306,7 @@ function createRenderUiTool() {
 * before emitting — turning "render a red banner after the fact" into
 * "verify before you send". Purely local: no LLM, no network, no DOM.
 */
-const VALIDATE_DESCRIPTION = "Validate the JSON body of a ```dsh-ui fence BEFORE emitting it — use for non-trivial specs (≥3 nodes or containing a table); skip for trivial ones (≤2 nodes). Pass the exact JSON text you are about to put inside the fence as the \"spec\" argument (a string). Returns a [genui-validation] protocol block with status, diagnostics, next action, and reply_language=conversation. When invalid JSON is repairable, repaired_json contains the fixed body; emit it only with next=emit_repaired_fence. A warning=block_markdown requires the indicated replacement node and another validation call.";
+const VALIDATE_DESCRIPTION = "Validate the JSON body of a ```dsh-ui fence BEFORE emitting it — use for non-trivial specs (≥3 nodes or containing a table); skip for trivial ones (≤2 nodes). Pass the exact JSON text you are about to put inside the fence as the \"spec\" argument (a string). Returns a [genui-validation] protocol block with status, diagnostics, next action, and reply_language=conversation. When invalid JSON is repairable, repaired_json contains the fixed body; emit it only with next=emit_repaired_fence. A warning=unknown_field requires fixing the indicated path and another validation call. A warning=block_markdown requires the indicated replacement node and another validation call.";
 const VALIDATE_PARAMETERS = {
 	type: "object",
 	properties: { spec: {
@@ -4342,6 +4422,7 @@ function createValidateDshUiTool() {
 					if (processed.spec !== null && processed.errors.length === 0) {
 						const warnings = formatProcessWarnings(processed);
 						const inlineWarnings = formatInlineContentWarnings(processed.spec);
+						const requiresCorrection = inlineWarnings.length > 0 || processed.warnings.some((warning) => warning.kind === "unknown-field");
 						return `${validationProtocol([
 							"status=invalid",
 							"error=invalid_json",
@@ -4351,7 +4432,7 @@ function createValidateDshUiTool() {
 							...inlineWarnings,
 							"repair=applied",
 							`repair_count=${repaired.repairs}`,
-							inlineWarnings.length === 0 ? "next=emit_repaired_fence" : "next=fix_and_revalidate"
+							requiresCorrection ? "next=fix_and_revalidate" : "next=emit_repaired_fence"
 						])}\nrepaired_json:\n\`\`\`\n${repaired.text}\n\`\`\``;
 					}
 				}
@@ -4383,12 +4464,13 @@ function createValidateDshUiTool() {
 			}
 			const warnings = formatProcessWarnings(processed);
 			const inlineWarnings = formatInlineContentWarnings(processed.spec);
+			const requiresCorrection = inlineWarnings.length > 0 || processed.warnings.some((warning) => warning.kind === "unknown-field");
 			return validationProtocol([
 				"status=valid",
 				`rendered=${processed.renderedCount}`,
 				...warnings,
 				...inlineWarnings,
-				inlineWarnings.length === 0 ? "next=emit_fence" : "next=fix_and_revalidate"
+				requiresCorrection ? "next=fix_and_revalidate" : "next=emit_fence"
 			]);
 		},
 		presentCall() {
@@ -4631,9 +4713,9 @@ function fenceFailures(text) {
 }
 /** `null` when this fence renders; otherwise the reason it does not. */
 function fenceFailureDetail(fence) {
-	if (!fence.closed) return "error=unterminated_fence\nrequired=closing_fence";
 	const resolution = resolveFence(fence.raw, { settled: true });
 	if (resolution.spec !== null) return null;
+	if (!fence.closed) return "error=unterminated_fence\nrequired=closing_fence";
 	if (resolution.processed !== null) return droppedNodeFailure(resolution.processed, resolution.value)?.join("\n") ?? ["error=invalid_spec", ...resolution.processed.errors.map((error) => `diagnostic=${JSON.stringify(error)}`)].join("\n");
 	return "error=invalid_json\nrepair=failed";
 }
@@ -4710,7 +4792,7 @@ function planFenceFeedback(input) {
 	if (input.validatedThisTurn !== true || input.deliveredThisTurn === true) return null;
 	if (input.deliveryRemindedTurns?.has(input.turn) === true) return null;
 	return {
-		text: missingBodyCorrectionText(input.turn, used + 1),
+		text: missingBodyCorrectionText(input.turn, used + 1, input.renderUiToolEnabled ?? true),
 		fingerprints: [],
 		turn: input.turn,
 		kind: "delivery"
@@ -4722,10 +4804,11 @@ function planFenceFeedback(input) {
 *
 * @param turn - turn that reached the boundary.
 * @param attempt - correction number within the shared turn budget.
+* @param renderUiToolEnabled - whether the correction may recommend `render_ui`.
 * @returns the message text to steer into the running turn.
 */
-function missingBodyCorrectionText(turn, attempt = 1) {
-	return `${`${MARKER_PREFIX}turn-${turn}]\n\n[genui-fence-repair]\nstatus=nothing_delivered\nfences=0\nnext=emit_fence_in_body\nrepeat_rendered_content=false\nreply_language=conversation\n\n`}本轮尚未产生正式回答，也没有通过支持的通道交付结果${attempt <= 1 ? "" : `（第 ${attempt} 次提醒）`}。请根据用户当前请求完成正式答复；需要 UI 时，在回答正文输出你最终选定的 dsh-ui 围栏，或明确调用 render_ui。可以修改或放弃此前候选；不能完成时，请在正文说明原因。\n`;
+function missingBodyCorrectionText(turn, attempt = 1, renderUiToolEnabled = true) {
+	return `${`${MARKER_PREFIX}turn-${turn}]\n\n[genui-fence-repair]\nstatus=nothing_delivered\nfences=0\nnext=emit_fence_in_body\nrepeat_rendered_content=false\nreply_language=conversation\n\n`}本轮尚未产生正式回答，也没有通过支持的通道交付结果${attempt <= 1 ? "" : `（第 ${attempt} 次提醒）`}。请根据用户当前请求完成正式答复；需要 UI 时，在回答正文输出你最终选定的 dsh-ui 围栏${renderUiToolEnabled ? "，或明确调用 render_ui" : ""}。可以修改或放弃此前候选；不能完成时，请在正文说明原因。\n`;
 }
 /**
 * 将 GenUI 回合中仅含 reasoning 的完整响应转换为宿主已有的可重试空响应错误。
@@ -4861,8 +4944,9 @@ function isFeedbackSource(source) {
 *
 * @param ctx - 宿主 Context。
 * @param enabled - 是否启用同回合围栏修正。
+* @param renderUiToolEnabled - 是否已注册 `render_ui` 工具。
 */
-function installFenceFeedback(ctx, enabled) {
+function installFenceFeedback(ctx, enabled, renderUiToolEnabled = true) {
 	const sessions = /* @__PURE__ */ new Map();
 	const stateOf = (sessionId) => {
 		let state = sessions.get(sessionId);
@@ -4992,7 +5076,8 @@ function installFenceFeedback(ctx, enabled) {
 			deliveredThisTurn: state.deliveredThisTurn,
 			aborted: signal.aborted,
 			correctionsThisTurn: usedThisTurn,
-			correctionsTurn: state.correctionsTurn
+			correctionsTurn: state.correctionsTurn,
+			renderUiToolEnabled
 		});
 		if (plan === null) return;
 		for (const fingerprint of plan.fingerprints) state.correctedSpec.add(fingerprint);
@@ -5064,6 +5149,7 @@ async function serveGenuiAsset(req, res) {
 		res.end();
 	}
 }
+const RENDER_UI_TOOL_GUIDANCE = "- Tool channel: render_ui 工具把同一 spec 渲染为工具行卡片；围栏用于回答内联 UI。";
 /** The fence language description injected into every assembled system prompt.
 *  Deliberately slim: the `genui` skill carries the full component→field
 *  mapping; this section keeps only the contract that must always be
@@ -5104,7 +5190,7 @@ Rules:
 - Durable state: 交互状态按「会话+内容指纹」持久化——刷新/重放恢复；相同内容保留，新内容重置。
 - 卷子模式: 每题一个 radio（group+answer+explanation）+ 一个 submit（groups 全列），本地判分。
 - Secrets ban: 不索取密码、API Key、Token、恢复码；需要时拒绝并解释。
-- Tool channel: render_ui 工具把同一 spec 渲染为工具行卡片；围栏用于回答内联 UI。
+${RENDER_UI_TOOL_GUIDANCE}
 - 围栏位置：\`dsh-ui\` 只写在**回答正文**；写在 reasoning/思考块里不渲染、用户看不到——思考里验证好 spec，正文再输出同一份。
 - Panel: "panel":true 只渲染进会话面板 dock 并原地更新；"append":true 追加合并；上限 200 节点/200 次追加，满了发 replace 重建。面板来的 [genui-action] 只回一个 panel:true 围栏 + 至多一行 10 字内确认。`;
 /**
@@ -5159,15 +5245,16 @@ function bundledSkillProvider() {
 	};
 }
 function apply(ctx, config) {
+	const renderUiToolEnabled = config?.renderUiTool !== false;
 	ctx.systemPrompt.section({
 		name: "genui:fence",
 		order: ctx.systemPrompt.getSectionOrder("STRUCTURED_OUTPUT"),
-		text: GENUI_SECTION_TEXT
+		text: renderUiToolEnabled ? GENUI_SECTION_TEXT : GENUI_SECTION_TEXT.replace(`${RENDER_UI_TOOL_GUIDANCE}\n`, "")
 	});
-	installFenceFeedback(ctx, config?.fenceFeedback !== false);
+	installFenceFeedback(ctx, config?.fenceFeedback !== false, renderUiToolEnabled);
 	ctx.inject(["tools"], (toolsCtx) => {
 		toolsCtx.effect(function* () {
-			yield toolsCtx.tools.register(createRenderUiTool());
+			if (renderUiToolEnabled) yield toolsCtx.tools.register(createRenderUiTool());
 			yield toolsCtx.tools.register(createValidateDshUiTool());
 		}, "dsh-genui: model tools");
 	});

package/lib/types/client/dom-fence.d.ts

@@ -1,6 +1,7 @@
 import { type Root } from 'react-dom/client';
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import { type FileLinkAvailability } from './file-link-context.tsx';
 /** Override the React root factory (tests / tuning). */
 export declare function setDomRootFactory(factory: (container: HTMLElement) => Root): void;
 /**
@@ -27,4 +28,4 @@ export declare function hostFenceIndexOf(row: Element, block: Element): number;
  * @param sendAction - plugin-owned relay: (sessionId, action, payload) → the
  *   scoped conversation send carrying the `[genui-action]` prompt.
  */
-export declare function installDomFenceRenderer(ctx: Context, sendAction: (sessionId: SessionId, action: string, payload: Record<string, unknown>) => void): () => void;
+export declare function installDomFenceRenderer(ctx: Context, sendAction: (sessionId: SessionId, action: string, payload: Record<string, unknown>) => void, fileLinkAvailability?: FileLinkAvailability): () => void;

package/lib/types/client/file-address.d.ts

@@ -0,0 +1,4 @@
+/** Build a session resource address while preserving encoded path segments. */
+export declare function sessionFileAddress(sessionId: string, path: string): string;
+/** Resolve workspace absolute paths to session-relative resource addresses. */
+export declare function fileAddressFor(sessionId: string, cwd: string | undefined, path: string): string;

package/lib/types/client/file-link-context.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+interface SidebarRightService {
+    openResource(address: string, options?: {
+        params: {
+            line: number;
+        };
+    }): void;
+}
+interface FileLinkHostContext {
+    get(name: 'sidebarRight', strict?: false): SidebarRightService | undefined;
+    sessions: {
+        list: {
+            getSnapshot(): unknown;
+        };
+    };
+}
+interface FileLinkScope {
+    get(name: 'sidebarRight'): SidebarRightService | undefined;
+    effect(callback: () => void | (() => void), name?: string): unknown;
+}
+export interface FileLinkCordisContext extends FileLinkHostContext {
+    inject(services: ['sidebarRight'], callback: (scope: FileLinkScope) => void): unknown;
+}
+export interface FileLinkAvailability {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): boolean;
+}
+/** Track an optional host service through arrival, removal, and plugin unload. */
+export declare function createFileLinkAvailability(ctx: FileLinkCordisContext): FileLinkAvailability;
+/** Render a file link as an accessible host navigation button when available. */
+export declare function FileLink({ path, line, label, children }: {
+    path: string;
+    line?: number;
+    label: string;
+    children?: ReactNode;
+}): import("react").DetailedReactHTMLElement<{
+    title: string;
+}, HTMLElement>;
+/** Add session-scoped file navigation to one fence render tree. */
+export declare function withFileLinkContext(ctx: FileLinkHostContext, availability: FileLinkAvailability, sessionId: string | undefined, streaming: boolean, children: ReactNode): ReactNode;
+export {};

package/lib/types/client/file-link.d.ts

@@ -0,0 +1,17 @@
+export interface ParsedFileLink {
+    path: string;
+    line?: number;
+}
+export type LinkTarget = {
+    type: 'external';
+    href: string;
+} | {
+    type: 'file';
+    file: ParsedFileLink;
+} | {
+    type: 'invalid';
+};
+/** Decode a local file destination and its optional first line fragment. */
+export declare function parseFileLink(value: string): ParsedFileLink | undefined;
+/** Classify a link destination while preserving the existing external URL policy. */
+export declare function classifyLinkTarget(value: unknown): LinkTarget;

package/lib/types/client/i18n/en.d.ts

@@ -262,6 +262,10 @@ export declare const EN: {
     readonly 'label.copyButtonTitle': "{action}; right-click for copy options";
     readonly 'block.copyMarkdown': "Copy Markdown";
     readonly 'block.copyCsv': "Copy CSV";
+    readonly 'block.table.expandDetails': "Expand details for {label}";
+    readonly 'block.table.collapseDetails': "Collapse details for {label}";
+    readonly 'block.table.expandGroup': "Expand group {label}";
+    readonly 'block.table.collapseGroup': "Collapse group {label}";
     readonly 'block.total': "Total";
     readonly 'block.filteredRows': "{visible} / {total} rows after filtering";
     readonly 'block.filterMatch': "{shown} / {total} matched";
@@ -277,7 +281,7 @@ export declare const EN: {
     readonly 'block.svgPreview': "Preview";
     readonly 'block.svgSource': "Source";
     readonly 'block.svgError': "SVG could not be displayed — showing the source instead";
-    readonly 'block.mermaidError': "Invalid diagram syntax — showing the source instead";
+    readonly 'block.mermaidError': "Diagram rendering failed — showing the source instead";
     readonly 'block.mermaidLoading': "Rendering…";
     readonly 'block.scene3dLoading': "Loading 3D scene…";
     readonly 'block.scene3dError': "3D rendering failed";

package/lib/types/client/inline.d.ts

@@ -2,4 +2,4 @@
 import { type ReactNode } from 'react';
 export declare function hasInlineMarkup(text: string): boolean;
 /** Render safe phrasing content, usable in headings, buttons and labels too. */
-export declare function renderInline(text: string, allowLinks?: boolean, depth?: number): ReactNode;
+export declare function renderInline(text: string, allowLinks?: boolean | 'file', depth?: number): ReactNode;

package/lib/types/client/mermaid-colors.d.ts

@@ -0,0 +1,2 @@
+/** Resolve host CSS colors before passing them to Mermaid's limited parser. */
+export declare function readMermaidThemeColor(name: string, fallback: string): string;

package/lib/types/client/panel.d.ts

@@ -1,9 +1,14 @@
 import { type GenuiActionHandler } from './action-context.ts';
+import { type FileLinkAvailability, type FileLinkCordisContext } from './file-link-context.tsx';
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 /** Injection face built per session in apply (scoped conversation send). */
 export interface GenuiPanelInjected {
     sessionId: string;
     sendGenuiAction: GenuiActionHandler;
+    fileLinkContext?: {
+        ctx: FileLinkCordisContext;
+        availability: FileLinkAvailability;
+    };
     /** Template center "try it": insert the template instruction into the
      *  current composer draft (standard conversation.input.for channel). */
     insertTemplate: (text: string) => void;
@@ -15,4 +20,4 @@ export type GenuiPanelProps = PropsRuntime<'conversation.input.dock'> & GenuiPan
  * default so the dock never steals the message flow's scroll room; the
  * header always shows the current panel title.
  */
-export declare function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate }: GenuiPanelProps): import("react").JSX.Element | null;
+export declare function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate, fileLinkContext }: GenuiPanelProps): import("react").JSX.Element | null;

package/lib/types/plugin/fence-feedback.d.ts

@@ -105,6 +105,8 @@ export interface FenceFeedbackPlanInput {
     readonly correctionsThisTurn?: number | undefined;
     /** Turn {@link correctionsThisTurn} counts (stale counts are ignored). */
     readonly correctionsTurn?: number | undefined;
+    /** Whether the host has registered the `render_ui` tool. Defaults to enabled. */
+    readonly renderUiToolEnabled?: boolean | undefined;
 }
 /** A correction the caller must account for before steering. */
 export interface FenceFeedbackPlan {
@@ -139,13 +141,15 @@ export declare function planFenceFeedback(input: FenceFeedbackPlanInput): FenceF
  *
  * @param turn - turn that reached the boundary.
  * @param attempt - correction number within the shared turn budget.
+ * @param renderUiToolEnabled - whether the correction may recommend `render_ui`.
  * @returns the message text to steer into the running turn.
  */
-export declare function missingBodyCorrectionText(turn: number, attempt?: number): string;
+export declare function missingBodyCorrectionText(turn: number, attempt?: number, renderUiToolEnabled?: boolean): string;
 /**
  * 注册 GenUI 回合跟踪、宿主重试判定和可选的围栏修正流程。
  *
  * @param ctx - 宿主 Context。
  * @param enabled - 是否启用同回合围栏修正。
+ * @param renderUiToolEnabled - 是否已注册 `render_ui` 工具。
  */
-export declare function installFenceFeedback(ctx: Context, enabled: boolean): void;
+export declare function installFenceFeedback(ctx: Context, enabled: boolean, renderUiToolEnabled?: boolean): void;

package/lib/types/plugin/index.d.ts

@@ -31,5 +31,9 @@ export interface GenuiPluginConfig {
      * 每回合和每个围栏正文最多请求一次，子代理不触发，每次修正请求会消耗模型步数。
      */
     fenceFeedback?: boolean;
+    /**
+     * 是否注册 render_ui 模型工具。默认开启，设置为 false 时关闭；不影响 validate_dsh_ui 和 dsh-ui 围栏渲染。
+     */
+    renderUiTool?: boolean;
 }
 export declare function apply(ctx: Context, config?: GenuiPluginConfig): void;

package/lib/types/shared/fence-repair.d.ts

@@ -31,6 +31,7 @@ export declare function describeJsonFailure(raw: string): string | null;
  *    with ASCII quotes (e.g. `对"别名路径"判定失败`), which makes JSON.parse
  *    fail near that quote with "Expected ',' or ']'...".
  * 2. Trailing commas before `}` / `]` or at end of input.
+ * 3. Valueless object keys immediately before a complete key-and-colon pair.
  *
  * A shared grammar-aware scan distinguishes object keys from values and
  * checks the continuation after a potential string terminator. Ambiguous

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@changfenhuang/dsh-genui",
   "description": "GenUI for DeepSeek Harness: interactive UI components rendered inline in assistant replies via the ```dsh-ui fence — layout, charts, plots, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model. Ships the fence-teaching host plugin, the browser renderer (client half), and the genui skill.",
-  "version": "0.11.4",
+  "version": "0.12.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/plugin/index.d.ts",
@@ -10,10 +10,6 @@
       "types": "./lib/types/plugin/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/plugin/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -29,12 +25,10 @@
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/client.js",
     "lib/assets/mermaid.js",
     "lib/assets/three.js",
     "lib/types/plugin/index.d.ts",
-    "lib/types/plugin/invariant.d.ts",
     "lib/types/client/index.d.ts",
     "SKILL.md",
     "README.md",
@@ -86,7 +80,6 @@
     "@deepseek-ai/dsh-client-ui-session": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-tool": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-llm": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-session": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
     "@deepseek-ai/dsh-skill": "^0.1.2-rc.1 || ^0.1.5-alpha.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1 || >=0.2.0-rc.1 <0.3.0-0",
@@ -122,7 +115,6 @@
     "@deepseek-ai/dsh-deque": "0.1.2-rc.1",
     "@deepseek-ai/dsh-file-reference": "0.1.2-rc.1",
     "@deepseek-ai/dsh-home-paths": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
     "@deepseek-ai/dsh-jobs": "0.1.2-rc.1",
     "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
     "@deepseek-ai/dsh-native-command": "0.1.2-rc.1",
@@ -226,9 +218,6 @@
     "@deepseek-ai/dsh-client-ui-tool": {
       "optional": true
     },
-    "@deepseek-ai/dsh-invariants": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },

package/src/client/GenuiBlock.module.css

@@ -421,6 +421,9 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
 }
 .inlineLink { color: var(--dsl-g-accent); text-decoration: underline; text-underline-offset: 2px; }
 .inlineLink:hover { text-decoration-thickness: 2px; }
+.inlineFileLink { padding: 0; border: 0; background: none; color: var(--dsl-g-accent); font: inherit; text-decoration: underline; text-underline-offset: 2px; cursor: pointer; }
+.inlineFileLink:hover { text-decoration-thickness: 2px; }
+.inlineFileLink:focus-visible { outline: 2px solid var(--dsl-g-accent); outline-offset: 2px; border-radius: 3px; }
 
 /* ---------- badges / stat / progress ---------- */
 
@@ -651,6 +654,18 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
 /* An inline code span keeps its own spacing too (a pasted snippet often lives
    inside backticks), matching the block-level code surface. */
 .inlineCode { white-space: pre-wrap; }
+/* Table cells are single-line by default, so a chip inside them must not
+   re-open line breaking. Host shells render message bodies inside `.markdown`,
+   which makes every chip an atomic `inline-flex` box and inherits
+   `overflow-wrap: anywhere` into the cell; together with `pre-wrap` the chip's
+   automatic minimum size collapses, the column can then be sized below its
+   content, and the still-unbroken text is painted over the next column (#280).
+   Keep the cell's own line-breaking contract for every table section. */
+.table > thead > tr > th:not(.tdCode):not(.tdMultiline) .inlineCode,
+.table > tbody > tr:not(.detailRow) > td:not(.tdCode):not(.tdMultiline) .inlineCode,
+.table > tfoot > tr > td:not(.tdCode):not(.tdMultiline) .inlineCode {
+  white-space: pre;
+}
 /* Rich-text owners must paint the real newlines kept by renderInline. Scope
    this to prose/labels: table data keeps nowrap and code keeps pre-wrap. For
    flex controls, target the label span so emphasis and plain text share one
@@ -1127,11 +1142,17 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
 /* Master-detail rows (table.details): a chevron in the first cell opens a
    full-width panel underneath, so a table can drill down without leaving the
    page or opening a modal. */
-.detailCell { padding-left: var(--dsl-g-gap-sm); }
+.detailCell { position: relative; padding-left: var(--dsl-g-gap-sm); }
 .detailToggle {
+  position: relative;
+  z-index: 1;
   display: inline-flex;
   align-items: center;
-  gap: 6px;
+  justify-content: center;
+  vertical-align: middle;
+  width: 24px;
+  height: 24px;
+  margin-right: 4px;
   padding: 0;
   border: none;
   background: none;
@@ -1142,7 +1163,9 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
   text-align: left;
 }
 .detailToggle:hover { color: var(--dsl-g-accent); }
+.detailCell:hover .detailToggle { color: var(--dsl-g-accent); }
 .detailToggle:focus-visible { outline: 2px solid var(--dsl-g-accent); outline-offset: 2px; border-radius: 4px; }
+.detailContent { position: relative; z-index: 1; vertical-align: middle; cursor: pointer; }
 .detailChevron {
   flex-shrink: 0;
   font-size: 10px;
@@ -1182,10 +1205,17 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
 .table tbody tr.groupRow:first-child td { box-shadow: none; padding-top: 10px; }
 .table tbody tr.groupRow:hover { background: none; }
 .table tbody tr.groupRow:nth-child(even) { background: none; }
+.groupRow td { position: relative; }
 .groupToggle {
+  position: relative;
+  z-index: 1;
   display: inline-flex;
   align-items: center;
-  gap: 7px;
+  justify-content: center;
+  vertical-align: middle;
+  width: 24px;
+  height: 24px;
+  margin-right: 7px;
   padding: 0;
   border: none;
   background: none;
@@ -1197,7 +1227,9 @@ img.mediaPlayer { aspect-ratio: 16 / 9; object-fit: cover; background: var(--dsl
   cursor: pointer;
 }
 .groupToggle:hover { color: var(--dsl-g-accent); }
+.groupLabel:hover { color: var(--dsl-g-accent); }
 .groupToggle:focus-visible { outline: 2px solid var(--dsl-g-accent); outline-offset: 2px; border-radius: 4px; }
+.groupLabel { position: relative; z-index: 1; display: inline-flex; vertical-align: middle; align-items: center; gap: 7px; cursor: pointer; }
 .groupChevron { color: var(--dsw-alias-label-tertiary); font-size: 11px; width: 10px; }
 .groupCount {
   padding: 0 7px;

package/src/client/artifact/ArtifactExport.module.css

@@ -8,7 +8,37 @@
   font: 12px/1.4 system-ui, sans-serif;
 }
 
-.trigger,
+/* 导出入口：无边框图标按钮。形状照项目里的 chrome 图标按钮 .panelClose
+   （26px 命中区 / 6px 圆角 / 透明底 / 无边框）。 */
+.trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+  padding: 0;
+  border: 0;
+  border-radius: 6px;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  cursor: pointer;
+}
+
+/* 悬浮沿用区块内表格行 / .tab / .accHead 那条配方（--dsl-g-hover）：主题文字色
+   4% 淡洗 + 文字色升到 label-primary。不用 rgba(255,255,255,…) 与没带兜底的
+   --dsw-alias-fill-hover —— 浅色主题下两者都看不见。 */
+.trigger:hover,
+.trigger:focus-visible {
+  background: color-mix(in srgb, var(--dsw-alias-label-primary) 4%, transparent);
+  color: var(--dsw-alias-label-primary);
+}
+
+/* 聚焦轮廓同 .panelClose。 */
+.trigger:focus-visible {
+  outline: 1px solid var(--dsw-alias-state-business-primary, #4f8ef7);
+  outline-offset: 1px;
+}
+
 .item {
   border: 1px solid var(--dsw-alias-border-l1);
   border-radius: 7px;
@@ -18,9 +48,10 @@
   cursor: pointer;
 }
 
-.trigger:hover,
+/* 菜单项沿用宿主的 fill-hover；第三方主题可能没有定义该 token（例如浅色
+   dream-skin），此时回退到区块内那条 4% 文字色淡洗，悬浮不会没有反馈。 */
 .item:hover {
-  background: var(--dsw-alias-fill-hover);
+  background: var(--dsw-alias-fill-hover, color-mix(in srgb, var(--dsw-alias-label-primary) 4%, transparent));
   color: var(--dsw-alias-label-primary);
 }