@changfenhuang/dsh-genui 0.11.4 → 0.12.0

package/src/client/i18n/en.ts

@@ -288,6 +288,10 @@ export const EN = {
   // ------------------------------------------------- component chrome
   'block.copyMarkdown': 'Copy Markdown',
   'block.copyCsv': 'Copy CSV',
+  'block.table.expandDetails': 'Expand details for {label}',
+  'block.table.collapseDetails': 'Collapse details for {label}',
+  'block.table.expandGroup': 'Expand group {label}',
+  'block.table.collapseGroup': 'Collapse group {label}',
   'block.total': 'Total',
   'block.filteredRows': '{visible} / {total} rows after filtering',
   'block.filterMatch': '{shown} / {total} matched',
@@ -303,7 +307,7 @@ export const EN = {
   'block.svgPreview': 'Preview',
   'block.svgSource': 'Source',
   'block.svgError': 'SVG could not be displayed — showing the source instead',
-  'block.mermaidError': 'Invalid diagram syntax — showing the source instead',
+  'block.mermaidError': 'Diagram rendering failed — showing the source instead',
   'block.mermaidLoading': 'Rendering…',
   'block.scene3dLoading': 'Loading 3D scene…',
   'block.scene3dError': '3D rendering failed',

package/src/client/i18n/zh.ts

@@ -283,6 +283,10 @@ export const ZH: Record<keyof typeof EN, string> = {
   // ------------------------------------------------- component chrome
   'block.copyMarkdown': '复制 Markdown',
   'block.copyCsv': '复制 CSV',
+  'block.table.expandDetails': '展开 {label} 的明细',
+  'block.table.collapseDetails': '收起 {label} 的明细',
+  'block.table.expandGroup': '展开分组 {label}',
+  'block.table.collapseGroup': '收起分组 {label}',
   'block.total': '合计',
   'block.filteredRows': '筛选后 {visible} / {total} 行',
   'block.filterMatch': '匹配 {shown} / {total} 项',
@@ -298,7 +302,7 @@ export const ZH: Record<keyof typeof EN, string> = {
   'block.svgPreview': '预览',
   'block.svgSource': '源码',
   'block.svgError': 'SVG 无法显示，已降级显示源码',
-  'block.mermaidError': '图语法有误，已降级显示源码',
+  'block.mermaidError': '图表渲染失败，已显示源码',
   'block.mermaidLoading': '渲染中…',
   'block.scene3dLoading': '加载 3D 场景…',
   'block.scene3dError': '3D 渲染失败',

package/src/client/index.tsx

@@ -26,9 +26,11 @@ import type {} from '@deepseek-ai/dsh-api-session-controller/client'
 import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
 import type { SessionId } from '@deepseek-ai/dsh-session/types'
 import type { IConversation } from '@deepseek-ai/dsh-client-ui-conversation/client'
-import type { Key, ReactNode } from 'react'
+import { createElement, type Key, type ReactNode } from 'react'
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client'
 import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
 import { installDomFenceRenderer } from './dom-fence.tsx'
+import { createFileLinkAvailability, withFileLinkContext, type FileLinkCordisContext } from './file-link-context.tsx'
 import { renderGenuiFence, type GenuiFenceContext } from './fence-render.tsx'
 import { renderSvgFence } from './svg-fence.tsx'
 import { createPanelSlashSource } from './panel-command.ts'
@@ -151,11 +153,18 @@ export function apply(ctx: Context): () => void {
   const localeDispose = bridgeHostLocale(ctx)
   const registerFn = (primitives as unknown as HostFenceExt).registerFenceRenderer
   const useRegistry = typeof registerFn === 'function' && !forcedDomChannel()
+  const fileLinkAvailability = createFileLinkAvailability(ctx as unknown as FileLinkCordisContext)
   const channel = useRegistry ? 'registry' : 'dom'
   console.info(`[genui] client active; fence-channel=${channel}`)
   const disposers: Array<() => void> = useRegistry
-    ? [localeDispose, registerFn!('dsh-ui', renderGenuiFence), registerFn!('svg', renderSvgFence)]
-    : [localeDispose, installDomFenceRenderer(ctx, (sessionId, action, payload) => sendInlineGenuiAction(ctx, sessionId, action, payload))]
+    ? [localeDispose, registerFn!('dsh-ui', (raw, key, context) => withFileLinkContext(
+      ctx as unknown as FileLinkCordisContext,
+      fileLinkAvailability,
+      context?.sessionId,
+      context?.source === undefined,
+      renderGenuiFence(raw, key, context),
+    )), registerFn!('svg', renderSvgFence)]
+    : [localeDispose, installDomFenceRenderer(ctx, (sessionId, action, payload) => sendInlineGenuiAction(ctx, sessionId, action, payload), fileLinkAvailability)]
   // Idle prefetch of the lazy engine assets: the browser downloads them at
   // LOW priority whenever the page is idle, so the first mermaid/3D node in
   // a session usually hits a warm cache instead of paying the fetch on first
@@ -170,7 +179,13 @@ export function apply(ctx: Context): () => void {
   disposers.push(ctx.slots.inject('tool.call.toolview', () => ctx.slots.register({
     name: 'tool.call.toolview',
     key: 'render_ui',
-  }, GenuiToolView)))
+  }, (props: ToolCallViewProps) => withFileLinkContext(
+    ctx as unknown as FileLinkCordisContext,
+    fileLinkAvailability,
+    props.sessionId,
+    false,
+    createElement(GenuiToolView, props),
+  ))))
   // Session panel dock: a session-scoped, always-present seat above the
   // composer (TodoDock posture). Renders the session's latest render_ui
   // spec in place; absent spec = no panel.
@@ -178,7 +193,10 @@ export function apply(ctx: Context): () => void {
     name: 'conversation.input.dock',
     id: 'genui-panel',
     order: 50,
-    inject: (sessionId: SessionId): GenuiPanelInjected => panelActionSend(ctx, sessionId),
+    inject: (sessionId: SessionId): GenuiPanelInjected => ({
+      ...panelActionSend(ctx, sessionId),
+      fileLinkContext: { ctx: ctx as unknown as FileLinkCordisContext, availability: fileLinkAvailability },
+    }),
   }, GenuiPanel)))
   // /panel slash command: a deterministic, client-side entry point that
   // opens the panel dock (publishes the default spec + expand request),

package/src/client/inline.ts

@@ -2,7 +2,8 @@
 import { createElement, useLayoutEffect, useRef, type ReactNode } from 'react'
 import katex from 'katex'
 import css from './GenuiBlock.module.css'
-import { safeHref } from './genui-runtime/value-utils.ts'
+import { classifyLinkTarget } from './file-link.ts'
+import { FileLink } from './file-link-context.tsx'
 
 /** KaTeX owns this span's children; React owns the span and its lifecycle.
  * The host's ui-primitives already supplies KaTeX CSS/fonts, including embeds. */
@@ -35,7 +36,7 @@ export function hasInlineMarkup(text: string): boolean {
 }
 
 /** Render safe phrasing content, usable in headings, buttons and labels too. */
-export function renderInline(text: string, allowLinks = true, depth = 0): ReactNode {
+export function renderInline(text: string, allowLinks: boolean | 'file' = true, depth = 0): ReactNode {
   if (typeof text !== 'string' || text === '' || !hasInlineMarkup(text) || depth >= 8) return text
   const segments: ReactNode[] = []
   let fenceEnd = 0
@@ -93,10 +94,20 @@ export function renderInline(text: string, allowLinks = true, depth = 0): ReactN
       if (parts === null) {
         out.push(token)
       } else {
-        const href = safeHref(parts[2])
-        out.push(href === undefined || !allowLinks ? renderInline(parts[1]!, false, depth + 1) : createElement('a', {
-          key: key++, className: css.inlineLink, href, target: '_blank', rel: 'noreferrer noopener',
-        }, renderInline(parts[1]!, false, depth + 1)))
+        const target = classifyLinkTarget(parts[2])
+        const label = renderInline(parts[1]!, false, depth + 1)
+        if (target.type === 'external' && allowLinks === true) {
+          out.push(createElement('a', {
+            key: key++, className: css.inlineLink, href: target.href, target: '_blank', rel: 'noreferrer noopener',
+          }, label))
+        } else if (target.type === 'file' && allowLinks !== false) {
+          out.push(createElement(FileLink, {
+            key: key++, path: target.file.path, label: parts[1]!,
+            ...(target.file.line === undefined ? {} : { line: target.file.line }),
+          }, label))
+        } else {
+          out.push(label)
+        }
       }
     }
     last = index + token.length

package/src/client/mermaid-colors.ts

@@ -0,0 +1,39 @@
+/** Resolve host CSS colors before passing them to Mermaid's limited parser. */
+export function readMermaidThemeColor(name: string, fallback: string): string {
+  if (typeof document === 'undefined' || document.body === null) return fallback
+  const value = getComputedStyle(document.body).getPropertyValue(name).trim()
+  if (value === '') return fallback
+
+  // Computed custom properties still contain calc(), unlike computed color.
+  // A real color property also resolves currentColor and inherited variables.
+  const probe = document.createElement('span')
+  probe.style.setProperty('color', value, 'important')
+  if (probe.style.color === '') return fallback
+  probe.style.setProperty('display', 'none', 'important')
+  document.body.appendChild(probe)
+  let color: string
+  try {
+    color = getComputedStyle(probe).color
+  } finally {
+    probe.remove()
+  }
+  if (/^rgba?\([\d.,\s]+\)$/i.test(color)) return color
+
+  // Modern colors such as oklch() and color-mix() may remain in those formats
+  // after style resolution. Canvas converts them to the sRGB Mermaid accepts.
+  const canvas = document.createElement('canvas')
+  canvas.width = canvas.height = 1
+  const context = canvas.getContext('2d')
+  if (context === null) return fallback
+  context.fillStyle = '#010203'
+  const initialFillStyle = context.fillStyle
+  context.fillStyle = color
+  if (context.fillStyle === initialFillStyle) return fallback
+  try {
+    context.fillRect(0, 0, 1, 1)
+    const [r, g, b, a] = context.getImageData(0, 0, 1, 1).data
+    return `rgba(${r}, ${g}, ${b}, ${a! / 255})`
+  } catch {
+    return fallback
+  }
+}

package/src/client/mermaid-core.ts

@@ -16,6 +16,7 @@
  * @module @changfenhuang/dsh-genui/client/mermaid-core
  */
 import { assertSafeSvg, ensureFlowchartKind, repairMermaidSource } from './mermaid-safe.ts'
+import { readMermaidThemeColor } from './mermaid-colors.ts'
 
 let mermaidPromise: Promise<typeof import('mermaid')> | null = null
 
@@ -30,10 +31,13 @@ function loadMermaid(): Promise<typeof import('mermaid')> {
     // strokes and their own font, which sat next to our components as a
     // visibly foreign object. `base` + themeVariables is the supported way to
     // drive every colour (the dark/light branch is gone with it).
+    const colors = new Map<string, string>()
     const token = (name: string, fallback: string): string => {
-      if (typeof document === 'undefined') return fallback
-      const value = getComputedStyle(document.body).getPropertyValue(name).trim()
-      return value === '' ? fallback : value
+      const cached = colors.get(name)
+      if (cached !== undefined) return cached
+      const color = readMermaidThemeColor(name, fallback)
+      colors.set(name, color)
+      return color
     }
     api.initialize({
       startOnLoad: false,

package/src/client/panel.tsx

@@ -26,6 +26,7 @@
 import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from 'react'
 import type {} from '@deepseek-ai/dsh-client-ui-session/client'
 import { GenuiActionContext, type GenuiActionHandler } from './action-context.ts'
+import { withFileLinkContext, type FileLinkAvailability, type FileLinkCordisContext } from './file-link-context.tsx'
 import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
 import { ExportableGenuiBlock } from './artifact/ExportableGenuiBlock.tsx'
 import { ErrorBoundary } from './ErrorBoundary.tsx'
@@ -50,6 +51,7 @@ import { recordPanel, recordTemplateUse } from './achievement-store.ts'
 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
@@ -63,7 +65,7 @@ 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 function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate }: GenuiPanelProps) {
+export function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate, fileLinkContext }: GenuiPanelProps) {
   const t = useT()
   const spec = useSyncExternalStore(subscribePanel, () => getPanelSpec(sessionId))
   const expandToken = useSyncExternalStore(subscribePanelExpand, () => getPanelExpandToken(sessionId))
@@ -271,10 +273,21 @@ export function GenuiPanel({ sessionId, sendGenuiAction, insertTemplate }: Genui
             />
           ) : spec !== null ? (
             <GenuiActionContext.Provider value={sendGenuiAction}>
-              <ErrorBoundary label={t('panel.boundary')}>
-                {/* content-fingerprinted: same panel spec re-published restores its state */}
-                <ExportableGenuiBlock spec={spec} stateKey={panelStateKey(sessionId, JSON.stringify(spec))} />
-              </ErrorBoundary>
+              {fileLinkContext === undefined
+                ? <ErrorBoundary label={t('panel.boundary')}>
+                  {/* content-fingerprinted: same panel spec re-published restores its state */}
+                  <ExportableGenuiBlock spec={spec} stateKey={panelStateKey(sessionId, JSON.stringify(spec))} />
+                </ErrorBoundary>
+                : withFileLinkContext(
+                  fileLinkContext.ctx,
+                  fileLinkContext.availability,
+                  sessionId,
+                  false,
+                  <ErrorBoundary label={t('panel.boundary')}>
+                    {/* content-fingerprinted: same panel spec re-published restores its state */}
+                    <ExportableGenuiBlock spec={spec} stateKey={panelStateKey(sessionId, JSON.stringify(spec))} />
+                  </ErrorBoundary>,
+                )}
             </GenuiActionContext.Provider>
           ) : null}
         </div>

package/src/plugin/fence-feedback.ts

@@ -123,9 +123,10 @@ export function fenceFailures(text: string): FenceFailure[] {
 
 /** `null` when this fence renders; otherwise the reason it does not. */
 function fenceFailureDetail(fence: ExtractedFence): string | null {
-  if (!fence.closed) return 'error=unterminated_fence\nrequired=closing_fence'
   const resolution = resolveFence(fence.raw, { settled: true })
   if (resolution.spec !== null) return null
+  // 缺少 Markdown 收尾不等于渲染失败；先复用 renderer 判断，避免把已显示的卡片重发（#288）。
+  if (!fence.closed) return 'error=unterminated_fence\nrequired=closing_fence'
   if (resolution.processed !== null) {
     const dropped = droppedNodeFailure(resolution.processed, resolution.value)
     return dropped?.join('\n')
@@ -243,6 +244,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. */
@@ -289,7 +292,12 @@ export function planFenceFeedback(input: FenceFeedbackPlanInput): FenceFeedbackP
   // then delivered nothing, remind the model once for this turn.
   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), fingerprints: [], turn: input.turn, kind: 'delivery' }
+  return {
+    text: missingBodyCorrectionText(input.turn, used + 1, input.renderUiToolEnabled ?? true),
+    fingerprints: [],
+    turn: input.turn,
+    kind: 'delivery',
+  }
 }
 
 /**
@@ -298,12 +306,14 @@ export function planFenceFeedback(input: FenceFeedbackPlanInput): FenceFeedbackP
  *
  * @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 function missingBodyCorrectionText(turn: number, attempt = 1): string {
+export function missingBodyCorrectionText(turn: number, attempt = 1, renderUiToolEnabled = true): string {
   const head = `${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`
   const emphasis = attempt <= 1 ? '' : `（第 ${attempt} 次提醒）`
-  return `${head}本轮尚未产生正式回答，也没有通过支持的通道交付结果${emphasis}。请根据用户当前请求完成正式答复；需要 UI 时，在回答正文输出你最终选定的 dsh-ui 围栏，或明确调用 render_ui。可以修改或放弃此前候选；不能完成时，请在正文说明原因。\n`
+  const renderUiInstruction = renderUiToolEnabled ? '，或明确调用 render_ui' : ''
+  return `${head}本轮尚未产生正式回答，也没有通过支持的通道交付结果${emphasis}。请根据用户当前请求完成正式答复；需要 UI 时，在回答正文输出你最终选定的 dsh-ui 围栏${renderUiInstruction}。可以修改或放弃此前候选；不能完成时，请在正文说明原因。\n`
 }
 
 /**
@@ -471,8 +481,9 @@ function isFeedbackSource(source: { kind?: unknown; plugin?: unknown } | undefin
  *
  * @param ctx - 宿主 Context。
  * @param enabled - 是否启用同回合围栏修正。
+ * @param renderUiToolEnabled - 是否已注册 `render_ui` 工具。
  */
-export function installFenceFeedback(ctx: Context, enabled: boolean): void {
+export function installFenceFeedback(ctx: Context, enabled: boolean, renderUiToolEnabled = true): void {
   const sessions = new Map<string, SessionFeedback>()
   const stateOf = (sessionId: string): SessionFeedback => {
     let state = sessions.get(sessionId)
@@ -637,6 +648,7 @@ export function installFenceFeedback(ctx: Context, enabled: boolean): void {
       aborted: signal.aborted,
       correctionsThisTurn: usedThisTurn,
       correctionsTurn: state.correctionsTurn,
+      renderUiToolEnabled,
     })
     if (plan === null) return
     // Account BEFORE sending: a re-entrant boundary must not deliver twice.

package/src/plugin/index.ts

@@ -83,6 +83,8 @@ async function serveGenuiAsset(req: IncomingMessage, res: ServerResponse): Promi
   }
 }
 
+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
@@ -123,7 +125,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 字内确认。`
 
@@ -189,21 +191,29 @@ export interface GenuiPluginConfig {
    * 每回合和每个围栏正文最多请求一次，子代理不触发，每次修正请求会消耗模型步数。
    */
   fenceFeedback?: boolean
+
+  /**
+   * 是否注册 render_ui 模型工具。默认开启，设置为 false 时关闭；不影响 validate_dsh_ui 和 dsh-ui 围栏渲染。
+   */
+  renderUiTool?: boolean
 }
 
 export function apply(ctx: Context, config?: GenuiPluginConfig): void {
+  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)
   // Hosts without tool access keep the fence channel. The dependency fiber
   // starts whenever tools becomes available and unloads its registrations
   // before either the service or this plugin is replaced.
   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/src/plugin/tool.ts

@@ -162,6 +162,9 @@ function formatProcessWarnings(processed: GenuiProcessResult): string[] {
         ? `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)}`
   })
 }
@@ -260,6 +263,7 @@ const VALIDATE_DESCRIPTION =
   + '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: Record<string, unknown> = {
@@ -368,6 +372,7 @@ export function createValidateDshUiTool(): ToolDefinition {
           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',
@@ -377,7 +382,7 @@ export function createValidateDshUiTool(): ToolDefinition {
               ...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\`\`\``
           }
         }
@@ -409,9 +414,10 @@ export function createValidateDshUiTool(): ToolDefinition {
       }
       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(): GenericCallView | undefined {

package/src/shared/fence-repair.ts

@@ -51,6 +51,7 @@ export 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
@@ -92,6 +93,29 @@ function isJsonSpace(ch: string | undefined): boolean {
   return ch === ' ' || ch === '\t' || ch === '\n' || ch === '\r'
 }
 
+/** Skip only complete, valueless object keys followed by a valued member. */
+function skipValuelessKeys(raw: string, start: number, limit = raw.length): { start: number; repairs: number } | null {
+  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
@@ -130,6 +154,10 @@ function quoteCanClose(raw: string, index: number, key: boolean, scopes: JsonSco
   if (raw[cursor] === scope.closer) return true // a removable trailing comma
   if (scope.closer === ']') return /["[{tfn\-0-9]/.test(raw[cursor]!)
   if (raw[cursor] !== '"') return false
+  // A valueless sibling is removable; it must not make a real value's
+  // closing quote absorb that sibling into the preceding string.
+  const valueless = skipValuelessKeys(raw, cursor, limit)
+  if (valueless !== null) cursor = valueless.start
   // An object comma must be followed by a quoted key and its colon. Escapes
   // in that key are skipped without changing them.
   cursor++
@@ -205,6 +233,14 @@ function scanFenceCandidate(raw: string, complete: boolean, contentQuotes: Reado
     }
     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

package/tsdown.config.ts

@@ -245,19 +245,15 @@ function assetConfig(name: 'mermaid' | 'three' | 'echarts', entry: string): User
 
 const libConfig: UserConfig = {
   name: ID,
-  // Named entries keep the published layout stable (lib/index.js +
-  // lib/invariant.js) while src/index.ts becomes the canonical bundle
-  // source entry that plugin_check's tool-bundle contract expects.
-  entry: { index: 'src/index.ts', invariant: 'src/plugin/invariant.ts' },
+  // Keep the root plugin bundle at lib/index.js, built from src/index.ts.
+  entry: { index: 'src/index.ts' },
   outDir: 'lib',
   format: ['esm'],
   platform: 'node',
   target: 'es2024',
   fixedExtension: false,
   dts: false,
-  // Flatten entry outputs to lib/<basename>.js so package exports keep the
-  // stable paths lib/index.js + lib/invariant.js (a directory-mirroring
-  // default would emit lib/plugin/invariant.js).
+  // Keep the output name aligned with the package's root export.
   outputOptions: { entryFileNames: '[name].js' },
   // Cleanup happens in the build script (`rm -rf lib` before tsc): tsdown
   // must never wipe lib/types (tsc's declaration output) mid-pipeline.

package/lib/invariant.js

@@ -1,19 +0,0 @@
-//#region src/plugin/invariant.ts
-const PACKAGE_NAME = "@changfenhuang/dsh-genui";
-/** Cordis companion plugin name. */
-const name = "genui-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: this host plugin only registers a static prompt
-* section; the section text is pinned by its own tests.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

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

@@ -1,15 +0,0 @@
-/**
- * Package-owned invariant companion for `@changfenhuang/dsh-genui`.
- * @module @changfenhuang/dsh-genui/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "genui-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;

package/src/plugin/invariant.ts

@@ -1,30 +0,0 @@
-/**
- * Package-owned invariant companion for `@changfenhuang/dsh-genui`.
- * @module @changfenhuang/dsh-genui/invariant
- */
-
-/* jscpd:ignore-start */
-import type { Context } from '@deepseek-ai/cordis'
-import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
-
-const PACKAGE_NAME = '@changfenhuang/dsh-genui'
-
-/** Cordis companion plugin name. */
-export const name = 'genui-invariant'
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants']
-
-/**
- * No runtime invariant: this host plugin only registers a static prompt
- * section; the section text is pinned by its own tests.
- */
-const install: InvariantInstaller = () => {}
-
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export const apply = (ctx: Context): Promise<() => void> =>
-  Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
-/* jscpd:ignore-end */