dsh-config-manager 0.1.76 → 0.1.78

package/src/client/chat/ChatEntryView.tsx

@@ -3,9 +3,15 @@
  *
  * 为什么必须接管（而不是追加）：该 key 没有 children 表（宿主只对 turn-tail 声明了子位），
  * framework 没有「往用户消息里加 UI」的位子；唯一合法做法是 priority -1 遮蔽宿主的
- * `UserMessageNodeView`，然后在自己的渲染里把那条气泡**复刻**一遍（宿主组件 / CSS Modules
- * 全是 ui-chat 私有、不可导入 —— 外观靠本仓库 CSS 逼近，图片**必须**走 owner 给的
- * `renderMessageImages`）。
+ * `UserMessageNodeView`，然后在自己的渲染里产出那条气泡。
+ *
+ * 正文**谁来画**在 0.2.1-alpha.3 换过一代（issue #92）：宿主把图片位搬进
+ * `conversation.chat.user.content` factory 的 children，并删掉了节点 props 上的 `renderMessageImages`。
+ * 因此现在的口径是 **优先委托宿主的 content factory**（`renderFactorySlot(CHAT_USER_CONTENT_FACTORY, …)`），
+ * 只有在宿主**没有**注册那条 factory 时（≤0.2.0）才回落到自绘气泡 —— 自绘气泡同时是那次调用的
+ * `options.fallback`，所以三格（老宿主 / 新宿主 / 宿主中途撤掉 factory）都有确定行为，
+ * 不会出现空白气泡。自绘那一格图片只能走 owner 的 `renderMessageImages`（宿主的 CSS Modules 与组件
+ * 全是 ui-chat 私有、不可导入，外观靠本仓库 CSS 逼近）。
  *
  * 三件硬约束（本文件是它们的落点）：
  *  ① **用户消息绝不消失**：整个子树包在 `ChatEntryErrorBoundary` 里，抛错就降级成
@@ -36,13 +42,14 @@ import {
   lookupPointForTurn,
   rawBlockText,
   CHAT_ENTRY_WARN_PREFIX,
+  CHAT_USER_CONTENT_FACTORY,
   type ChatEntryBubbleView,
   type ChatEntryFallbackRow,
   type ChatEntryFile,
   type ChatPointLookup,
 } from './chat-entry-view.ts'
 import { ChatPointWindowController, type ChatPointWindowState } from './chat-point-window.ts'
-import { hostFileTypeIcon, hostUserTextProjector } from '../common/host-primitives.ts'
+import { hostFileTypeIcon, hostIcon, hostUserTextProjector } from '../common/host-primitives.ts'
 import type { ArchiveOutcome } from './rollback-entry-view.ts'
 import type { ChildOpenState } from './rollback-entry-view.ts'
 import type { RollbackFileIconRenderer } from './RollbackFileIcon.tsx'
@@ -62,6 +69,23 @@ const NEWLINE = String.fromCharCode(10)
  */
 export type MessageImagesRenderer = (owner: unknown) => ReactNode
 
+/**
+ * 宿主 content factory 渲染位（0.2.1-alpha.3 起节点渲染器 props 上的 `renderFactorySlot`，
+ * 由 ui-slots 的 `PropsRenderFactories` 挂在**每一个**渲染组件上）。
+ *
+ * 为什么签名这么宽：真实类型是 `RenderFactorySlot`（按 SlotFactoryMap 泛型收窄），本仓库没有
+ * ui-chat 的类型；我们只承诺「按名字原样转发入参 + 收 `options.fallback`」，返回值当不透明 ReactNode。
+ *
+ * 注意它**在新旧宿主上都存在**（ui-renderer 的 standardKit 无条件发放）：所以「走不走委托」不能只判
+ * 它是不是函数 —— 真正的判据是宿主到底注册没注册那条 factory，由 `FactoryOutlet` 在定义缺失时
+ * 回落我们给的 fallback 来裁决（见 ChatEntryBody）。
+ */
+export type HostContentFactoryRenderer = (
+  name: string,
+  props: unknown,
+  options?: { fallback?: ReactNode },
+) => ReactNode
+
 /** 本条目经 inject 面拿到的业务能力（与回合尾入口同一个 inject 形状）。 */
 export interface ChatEntryViewInjected {
   /** 回退端口（T2 的 RecoveryApi；组件**不直接 fetch**）。 */
@@ -105,13 +129,22 @@ export type ChatEntryViewProps = PropsRuntime<'conversation.chat.node', 'user'>
  */
 function FileCard({ file, size }: { file: ChatEntryFile; size: string | null }) {
   const DshIcon = hostFileTypeIcon()
+  /**
+   * 元信息 = 宿主 `.fileMeta` 的**同一组合**：大写的扩展名（≤8 字符）+ 体积文本，空格连接。
+   * 宿主那行是「EXT SIZE」一行的次级小字（不是我们此前那个「文件名旁边挂一个体积」的排法）。
+   */
+  const meta = [file.ext === null ? '' : file.ext.toUpperCase().slice(0, 8), size ?? '']
+    .filter((part) => part !== '')
+    .join(' ')
   return (
     <span className={css.chatFileCard} title={file.name !== '' ? file.name : undefined}>
       {DshIcon !== null && file.name !== ''
-        ? <DshIcon path={file.name} size={14} />
+        ? <DshIcon path={file.name} size={28} className={css.chatFileIcon} />
         : file.ext !== null && <span className={css.chatFileExt}>{file.ext}</span>}
-      <span className={css.chatFileName}>{file.name !== '' ? file.name : '?'}</span>
-      {size !== null && <span className={css.chatFileMeta}>{size}</span>}
+      <span className={css.chatFileContent}>
+        <span className={css.chatFileName}>{file.name !== '' ? file.name : '?'}</span>
+        {meta !== '' && <span className={css.chatFileMeta}>{meta}</span>}
+      </span>
     </span>
   )
 }
@@ -141,6 +174,14 @@ function ChatEntryCopyAction({ text, t }: { text: string; t: TranslateNS<'config
     if (copied) return
     void copyTextToClipboard(text).then((ok) => { if (ok) setCopied(true) })
   }, [copied, text])
+  /**
+   * 图标 = **DSH 原生那两颗**（2026-10-17 用户要求「复制 icon 与动画都用 DSH 原生的」）：
+   * 宿主 MessageIconActions 的复制反馈就是 `IconCopyOutlineRegular → IconCheckOutlineRegular` 的
+   * **瞬时切换**（宿主 `.action svg` 没有任何 transition/animation —— 它的「动画」就是这一次换图）。
+   * 本仓库的 `CopyStateIcon`（morphicons 形变）只在**拿不到宿主图标的老宿主**上兜底。
+   */
+  const HostCopyIcon = hostIcon('IconCopyOutlineRegular')
+  const HostCheckIcon = hostIcon('IconCheckOutlineRegular')
   return (
     <button
       type="button"
@@ -148,8 +189,11 @@ function ChatEntryCopyAction({ text, t }: { text: string; t: TranslateNS<'config
       aria-label={copied ? t('chat.entry.copied') : t('chat.entry.copy')}
       title={copied ? t('chat.entry.copied') : t('chat.entry.copy')}
       onClick={onCopy}
+      data-copy-state={copied ? 'copied' : 'idle'}
     >
-      <CopyStateIcon done={copied} size={13} />
+      {HostCopyIcon !== null && HostCheckIcon !== null
+        ? (copied ? <HostCheckIcon size={15} /> : <HostCopyIcon size={15} />)
+        : <CopyStateIcon done={copied} size={15} />}
     </button>
   )
 }
@@ -162,6 +206,10 @@ interface ChatEntryBodyProps extends ChatEntryViewInjected {
   openSkill?: unknown
   /** 宿主图片渲染位（SlotMap 的 keyProps 把返回值声明成 unknown ⇒ 用它当 `MessageImagesRenderer` 必须过一层窄化）。 */
   renderMessageImages?: unknown
+  /** 宿主授权过的图片加载器（0.2.1+ 节点渲染器 props；原样转发给 content factory）。 */
+  loadImage?: unknown
+  /** 宿主 content factory 渲染位（0.2.1+；老宿主拿不到 ⇒ 直接走自绘气泡。见 HostContentFactoryRenderer）。 */
+  renderFactorySlot?: unknown
   t: TranslateNS<'config-manager-chat'>
 }
 
@@ -185,7 +233,10 @@ interface ChatEntryBodyProps extends ChatEntryViewInjected {
  * 订阅入口可见性信号（issue #88）。
  *
  * 为什么要在组件里订阅而不是把开关当 prop 往下传：入口是**遮蔽宿主渲染器**注册的（无常），
- * 开关变化时没有任何父级会重渲染它 —— DNS 状态只能靠这条信号推。订阅开销 = 一个 Set 里的回调。
+ * 开关变化时没有任何父级会重渲染它 —— 状态只能靠这条信号推。订阅开销 = 一个 Set 里的回调。
+ *
+ * 2026-10-17 起登记本身随开关撤销（关闭 ⇒ 让出 user cell、本组件直接卸载，宿主原生气泡接管回来），
+ * 所以这里是**兜底**：万一信号已翻转而本组件还活着，也绝不画出那颗按钮。
  */
 function useRollbackEntryEnabled(): boolean {
   const [value, setValue] = useState(() => isRollbackEntryEnabled())
@@ -193,7 +244,7 @@ function useRollbackEntryEnabled(): boolean {
   return value
 }
 
-function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImages, t, rt, port, openChildSession, archiveParentSession, startFreshSession, openDiff, fileIcon }: ChatEntryBodyProps) {
+function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImages, loadImage, renderFactorySlot, t, rt, port, openChildSession, archiveParentSession, startFreshSession, openDiff, fileIcon }: ChatEntryBodyProps) {
   const view = useMemo(() => buildChatEntryView(node), [node])
   const [lookup, setLookup] = useState<ChatPointLookup | null>(null)
   /** 有界重试窗口是否还开着（**状态诚实**的唯一开关，R1）—— 由状态机的 `onState` 驱动。 */
@@ -231,6 +282,7 @@ function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImag
    * 「用户再次触发」= 重新挂载（切档 / 重进会话）或会话/回合变化 ⇒ 新实例；不需要刷新页面。
    */
   // issue #88：功能关闭时连**查询都不发**（不只是不画按钮）—— 入口收起 = 这一整个入口链路停摆。
+  // 关掉功能后登记会被撤销（本组件随之卸载），这两道门因此是兜底而非唯一机制。
   const entryEnabled = useRollbackEntryEnabled()
   const canLookup = entryEnabled && turn !== null && phase === 'closed' && sessionId !== ''
   useEffect(() => {
@@ -254,10 +306,16 @@ function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImag
   }, [button])
 
   const bubble: ChatEntryBubbleView = view.bubble
+  /** 回退图标同样走宿主（`IconRefreshOutlineRegular`）：与复制图标同一套字形/描边；拿不到回落 RefreshIcon。 */
+  const HostRefreshIcon = hostIcon('IconRefreshOutlineRegular')
   /**
    * 附件按**content 原始顺序**输出（宿主 `attachments.map` 同构）：图片走 owner 的
    * `renderMessageImages`（每张一次调用），文件走文件卡 —— 两类**共用同一条序列**，
    * 绝不重排成「先图片后文件」（t4 复核 D2）。
+   *
+   * 这条自绘路径**只在宿主没有 content factory 时**才会上屏（见下面的 `content`）：
+   * 0.2.1 起 `renderMessageImages` 已不存在，此时图片位置如实显示提示文本 —— 但那一格
+   * 正常情况下走的是宿主自己的 factory，根本到不了这里。
    */
   const canRenderImages = typeof renderMessageImages === 'function'
   const attachmentNodes = planChatEntryAttachments(bubble).map((item) => item.kind === 'image'
@@ -283,43 +341,85 @@ function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImag
   })
   const reasonKey = button.kind === 'disabled' ? button.key : null
 
+  /**
+   * **自绘气泡**（= 0.2.1 之前那条路径，style 与宿主 .userStack/.bubble 逐条对齐见本文件头注释）。
+   *
+   * 两个身份：① 老宿主（≤0.2.0）没有 `conversation.chat.user.content` 这条 factory，正文由它承担；
+   * ② 新宿主上它是那次 factory 调用的 **fallback** —— 定义缺失（或宿主中途撤掉）时由
+   * `FactoryOutlet` 回落，用户消息因此**永远不会**变成空白。
+   *
+   * 图片：这条路径只能走 owner 的 `renderMessageImages`（0.2.1 起已不存在）⇒ 那一格如实显示提示文本，
+   * 而不是静默消失；新宿主正常情况下根本不会渲染到这里（走的是宿主自己的 content factory）。
+   */
+  const ownContent = (
+    <div className={css.chatEntryStack}>
+      {hasAttachments && (
+        <div className={css.chatAttachmentRow} data-message-attachments="">
+          {attachmentNodes}
+        </div>
+      )}
+      {bubble.showBubble && (
+        <div className={css.chatBubble}>
+          {bubble.text !== '' && (
+            <span className={css.chatBubbleText}>{hostText === null ? bubble.text : hostText}</span>
+          )}
+          {bubble.raw.map((block) => (
+            <RawBlock
+              key={'raw-' + block.id}
+              payload={block.payload}
+              label={t('chat.entry.extraBlock')}
+              truncatedLabel={(total) => t('chat.entry.truncated', { total })}
+            />
+          ))}
+        </div>
+      )}
+      {!canRenderImages && bubble.images.length > 0 && (
+        <div className={css.chatEntryNotice}>{t('chat.entry.noImageRenderer')}</div>
+      )}
+      {/* 引用会话汇总行：宿主在气泡下方渲染 referenceSummary（`引用会话 · {labels}`）。
+          我们复刻这一行（文案在 chat 字典里，**不依赖 ui-primitives**）；`data-ref-chip` 供探针定位。 */}
+      {view.referenceLabels.length > 0 && (
+        <div className={css.chatEntryReference} data-ref-chip="">
+          {t('chat.entry.referenceSummary', {
+            labels: view.referenceLabels.join(t('chat.entry.referenceSeparator')),
+          })}
+        </div>
+      )}
+    </div>
+  )
+
+  /**
+   * 正文 / 附件 / 引用（issue #92）：**优先委托宿主自己的 content factory**。
+   *
+   * 为什么不能再自绘：0.2.1-alpha.3 起宿主把图片位搬进 `conversation.chat.user.content` 的 children
+   * （`conversation.chat.user.images`），并在节点 props 上删掉了 `renderMessageImages` —— 自己复刻气泡
+   * 就必然拿不到图片位。委托之后，图片由 ui-attachment 在该 factory 的渲染上下文里 renderSlot，
+   * 正文/文件卡/引用/未知块也全部回到宿主实现 ⇒ 与宿主原生气泡**同构**，且以后宿主再改图片实现也不用跟。
+   *
+   * 入参逐字对齐宿主 `UserStyleBubble`（`content` / `loadImage` / `facts` / `interactive: true`），
+   * 组装全在纯层 `buildHostUserContentInput`。**判据不是 `typeof renderFactorySlot === 'function'`** ——
+   * 该席位在新旧宿主上都存在（ui-renderer 的 standardKit 无条件发放），真正的裁决点是这条 factory
+   * 注册没注册：`FactoryOutlet` 在读不到定义时渲染我们给的 `fallback`（= 上面的自绘气泡）——
+   * 于是「老宿主 ≤0.2.0」「新宿主 ≥0.2.1」「宿主中途撤掉 factory」三格都有确定行为，不必开两条发布线。
+   * 调用本身不吃任何副作用，返回不透明 ReactNode（React 元素），空定义时是 fallback 的元素包装。
+   */
+  const content = typeof renderFactorySlot === 'function'
+    ? (renderFactorySlot as HostContentFactoryRenderer)(
+      CHAT_USER_CONTENT_FACTORY,
+      {
+        content: view.hostContent.content,
+        loadImage,
+        facts: view.hostContent.facts,
+        interactive: true,
+      },
+      { fallback: ownContent },
+    )
+    : ownContent
+
   return (
     <div className={css.chatEntryScope}>
       <div className={css.chatEntryRow}>
-        <div className={css.chatEntryStack}>
-          {hasAttachments && (
-            <div className={css.chatAttachmentRow} data-message-attachments="">
-              {attachmentNodes}
-            </div>
-          )}
-          {bubble.showBubble && (
-            <div className={css.chatBubble}>
-              {bubble.text !== '' && (
-                <span className={css.chatBubbleText}>{hostText === null ? bubble.text : hostText}</span>
-              )}
-              {bubble.raw.map((block) => (
-                <RawBlock
-                  key={'raw-' + block.id}
-                  payload={block.payload}
-                  label={t('chat.entry.extraBlock')}
-                  truncatedLabel={(total) => t('chat.entry.truncated', { total })}
-                />
-              ))}
-            </div>
-          )}
-          {!canRenderImages && bubble.images.length > 0 && (
-            <div className={css.chatEntryNotice}>{t('chat.entry.noImageRenderer')}</div>
-          )}
-          {/* 引用会话汇总行：宿主在气泡下方渲染 referenceSummary（`引用会话 · {labels}`）。
-              我们复刻这一行（文案在 chat 字典里，**不依赖 ui-primitives**）；`data-ref-chip` 供探针定位。 */}
-          {view.referenceLabels.length > 0 && (
-            <div className={css.chatEntryReference} data-ref-chip="">
-              {t('chat.entry.referenceSummary', {
-                labels: view.referenceLabels.join(t('chat.entry.referenceSeparator')),
-              })}
-            </div>
-          )}
-        </div>
+        {content}
         <div className={css.chatEntryActions}>
           {/* 时间在动作行**最前**（宿主把 MessageIconActions 的 clock 设为 "start"，与它同构） */}
           {view.clock !== null && <span className={css.chatEntryTime}>{view.clock}</span>}
@@ -328,7 +428,8 @@ function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImag
               2026-10-10 用户第二条要求「回退按钮只有一个 icon 而不是一个按钮」。可见文案退到
               aria-label/title；禁用原因是原生 title 里的一句话（InfoHint 的 Portal 钉在插件设置页
               根节点，聊天区不存在）。按钮始终留在原地（禁用而不是消失）：入口可见性不随判据漂移。 */}
-          {/* 开关**关闭时整颗收起**（issue #88 明确要求「入口收起」，不是置灰）。
+          {/* 开关**关闭时整颗收起**（issue #88 明确要求「入口收起」，不是置灰；2026-10-17 起连登记
+              都会被撤销，整条气泡交回宿主原生渲染，这里只是兜底的那一层）。
               与上面那条「入口可见性不随判据漂移」不冲突：那说的是**暂时读不到点**这类判据，
               而这里是「用户把这个功能关了」——此时入口本身就不该存在。 */}
           {entryEnabled && (
@@ -343,7 +444,7 @@ function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImag
             data-chat-entry-window-open={windowOpen ? '' : undefined}
             data-chat-entry-window-closed={windowOpen ? undefined : ''}
           >
-            <RefreshIcon size={13} />
+            {HostRefreshIcon === null ? <RefreshIcon size={15} /> : <HostRefreshIcon size={15} />}
           </button>
           )}
         </div>

package/src/client/chat/chat-entry-view.test.ts

@@ -58,7 +58,12 @@ import {
   retryChatPointUntilHit,
   type ChatPointWindowState,
 } from './chat-point-window.ts'
-import { chatNodeOccupantOf, declaredSlotKind, registerChatNodeEntry } from './chat-node-registration.ts'
+import {
+  chatNodeOccupantOf,
+  declaredSlotKind,
+  registerChatNodeEntry,
+  registerChatNodeEntryWhenEnabled,
+} from './chat-node-registration.ts'
 import { en as chatEn, zh as chatZh } from './chat-locales.ts'
 import type { RollbackListResult, RollbackPointPort, RollbackPointSummary } from '../../ui/rollback-view.ts'
 
@@ -236,6 +241,95 @@ test('steering is a DIFFERENT key: we never register it (host renderer unchanged
   assert.equal(chatNodeKind(nodeOf({ kind: 'user' })), 'user')
 })
 
+
+test('gate: 关闭时一次都不注册；打开即登记；关掉立刻撤销；再打开再登记', () => {
+  let enabled = false
+  const listeners = new Set<() => void>()
+  const disposed: number[] = []
+  let registrations = 0
+  let live = 0
+  const teardown = registerChatNodeEntryWhenEnabled({
+    probe: { spec: () => ({ kind: 'keyed', scope: 'session' }) },
+    register: () => {
+      registrations += 1
+      live += 1
+      const id = registrations
+      return () => { disposed.push(id); live -= 1 }
+    },
+    isEnabled: () => enabled,
+    subscribe: (listener) => { listeners.add(listener); return () => { listeners.delete(listener) } },
+    warn: () => {},
+  })
+  const flip = (value: boolean): void => {
+    enabled = value
+    for (const listener of [...listeners]) listener()
+  }
+
+  assert.equal(registrations, 0, '缺省关闭：绝不接管 user cell（气泡留给宿主原生渲染）')
+  assert.equal(listeners.size, 1, '无论开关如何都要订阅，否则功能打开时补不上登记')
+
+  flip(true)
+  assert.equal(registrations, 1)
+  assert.equal(live, 1)
+  flip(true)
+  assert.equal(registrations, 1, '重复通知必须幂等（同一时间只能有一条登记）')
+
+  flip(false)
+  assert.equal(live, 0, '关闭 = 撤销登记 ⇒ cell 回到宿主 priority 0')
+  assert.deepEqual(disposed, [1])
+
+  flip(true)
+  assert.equal(registrations, 2, '重新打开必须当场补登记（不重载插件）')
+  assert.equal(live, 1)
+
+  teardown()
+  assert.equal(live, 0, '装配卸载必须撤销登记，不留悬挂注册')
+  assert.equal(listeners.size, 0, '装配卸载必须解绑订阅')
+  assert.deepEqual(disposed, [1, 2])
+})
+
+test('gate: 一直关闭时卸载是安全的（没有登记可撤）', () => {
+  let unsubscribed = 0
+  const teardown = registerChatNodeEntryWhenEnabled({
+    probe: { spec: () => ({ kind: 'keyed', scope: 'session' }) },
+    register: () => { throw new Error('must not register while disabled') },
+    isEnabled: () => false,
+    subscribe: () => () => { unsubscribed += 1 },
+    warn: () => {},
+  })
+  teardown()
+  assert.equal(unsubscribed, 1)
+})
+
+test('gate: 让位时登记返回的 no-op 也照样能撤销，且不重复探测', () => {
+  const warns: string[] = []
+  let enabled = true
+  let registrations = 0
+  const teardown = registerChatNodeEntryWhenEnabled({
+    probe: {
+      spec: () => ({ kind: 'keyed', scope: 'session' }),
+      entriesOfSlot: () => [{ options: { key: 'user', priority: -2 }, registrant: '@someone/other-rewind' }],
+    },
+    register: () => { registrations += 1; return () => {} },
+    isEnabled: () => enabled,
+    subscribe: () => () => {},
+    warn: (message) => { warns.push(message) },
+  })
+  assert.equal(registrations, 0, '别的插件以更低优先级占着 user cell：让位')
+  assert.ok(warns.some((line) => line.startsWith(CHAT_NODE_YIELD_WARN_PREFIX)))
+  enabled = false
+  teardown()
+  assert.equal(registrations, 0)
+})
+
+test('装配点：user cell 的登记走开关闸门（不是无条件遮蔽宿主渲染器）', () => {
+  const src = readFileSync(join(HERE, '..', 'index.ts'), 'utf8')
+  assert.match(src, /ctx\.slots\.inject\(CHAT_NODE_SLOT, \(\) => registerChatNodeEntryWhenEnabled\(\{/)
+  assert.match(src, /isEnabled: isRollbackEntryEnabled/)
+  assert.match(src, /subscribe: subscribeRollbackEntryEnabled/)
+  assert.doesNotMatch(src, /ctx\.slots\.inject\(CHAT_NODE_SLOT, \(\) => registerChatNodeEntry\(/)
+})
+
 const HERE = fileURLToPath(new URL('.', import.meta.url))
 
 /** 读一个组件源码（*.tsx 不能在 node 下 type-strip 加载，故走源码级断言）。 */
@@ -317,6 +411,118 @@ test('文件卡描边与宿主同档：.5px + --cm-line-2（不是更淡的 --cm
   assert.match(scope, /--cm-line-2:\s*var\(--dsw-alias-border-l2\)/, '.chatEntryScope 必须就地重声明 --cm-line-2')
 })
 
+/**
+ * 字号 / 行高 / 限宽必须跟随宿主的「内容字号」（2026-10-17 修 issue #93）。
+ *
+ * 背景：接管 user 渲染器后我们把气泡正文基准写死 `--cm-fs-base: 12.5px`（= §1 的面板基准），
+ * 而宿主的 `.bubble` 写的是 `var(--dsh-content-font-size,14px)` —— 于是 DSH 的「内容字号」
+ * （10–22）**在用户自己的消息上完全失效**：真机内容字号 21 时助手正文字形高 19px、
+ * 气泡 11px（同一张截图，比例 0.58）。宿主口径（本机 app.asar 抽出）：
+ *   · `--dsh-content-font-size` 由 ui-layout 的 ThemePresenter 写在 **body** 上；
+ *   · `--dsh-content-font-delta` = 内容字号 − 14px，由 ui-theme 定义在 body；
+ *   · `--dsh-chat-content-width` 定义在 ui-conversation 的聊天 body（.body / .embeddedBody）。
+ */
+test('气泡字号/行高/限宽跟随宿主内容字号（不得再写死 12.5px 与固定 620px）', () => {
+  const cssSheet = readFileSync(join(HERE, '..', 'config-manager.module.css'), 'utf8')
+  // 注释里会引用这些取值（解释为什么改），负向断言必须先剥注释 —— 与 css-token-guard.test.ts 同法
+  const noComment = cssSheet.replace(/\/\*[\s\S]*?\*\//g, '')
+  const scope = noComment.match(/\.chatEntryScope\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(scope, '', '必须能定位 .chatEntryScope 规则块（扫描失效时本用例不得静默通过）')
+  // ① 正文基准 = 宿主的活值 + 兜底 14px（宿主同一条气泡的兜底；不许兜回 12.5px —— 那是面板档）
+  assert.match(scope, /--cm-fs-base:\s*var\(--dsh-content-font-size,\s*14px\)/, '.chatEntryScope 的 --cm-fs-base 必须跟随 --dsh-content-font-size（兜底 14px）')
+  assert.doesNotMatch(scope, /--cm-fs-base:\s*12\.5px/, '不得再把气泡正文写死 12.5px')
+  // ② 行高 = 宿主同一条公式（只改字号会让 21px 下比正文松 2.5px/行）
+  assert.match(scope, /--cm-lh-base:\s*calc\(22px \+ var\(--dsh-content-font-delta,\s*0px\)\)/, '行高必须用宿主同一条公式')
+  assert.match(scope, /font-size:\s*var\(--cm-fs-base\)/, '作用域字号必须消费 --cm-fs-base')
+  assert.match(scope, /line-height:\s*var\(--cm-lh-base\)/, '作用域行高必须消费 --cm-lh-base')
+  // ③ 只改聊天这一处：§1 body 的面板基准仍是 12.5px（动它会全站字号地震）
+  const bodyBlock = noComment.match(/body\s*\{[\s\S]*?\n\}/)?.[0] ?? ''
+  assert.match(bodyBlock, /--cm-fs-base:\s*12\.5px/, '§1 body 的面板基准必须保持 12.5px')
+  // ④ 限宽 = 宿主 .userStack 同一条公式；--cm-fs-meta 保持 11px 档（时间戳/动作标签不跟着放大）
+  assert.doesNotMatch(noComment, /min\(620px,\s*82%\)/, '气泡限宽不得再用固定 620px 近似')
+  const stack = noComment.match(/\.chatEntryStack\s*\{[^}]*\}/)?.[0] ?? ''
+  const notice = noComment.match(/\.chatEntryNotice\s*\{[^}]*\}/)?.[0] ?? ''
+  const WIDTH_FORMULA = /max-width:\s*min\(calc\(var\(--dsh-chat-content-width,\s*748px\) \* \.702\),\s*82%\)/
+  for (const [name, block] of [['.chatEntryStack', stack], ['.chatEntryNotice', notice]] as [string, string][]) {
+    assert.notEqual(block, '', '必须能定位 ' + name + ' 规则块（扫描失效时本用例不得静默通过）')
+    assert.match(block, WIDTH_FORMULA, name + ' 限宽必须与宿主同一条公式')
+  }
+  assert.match(scope, /--cm-fs-meta:\s*11px/, '--cm-fs-meta 保持 11px 档（时间戳/动作标签不跟着放大）')
+})
+
+/**
+ * 2026-10-17（用户要求「复制 icon 和 icon 动画也使用 DSH 原生的」）：动作行图标必须走宿主
+ * ui-primitives 的原生图标集，且**必须保留回落**（老宿主没有那份模块表 ⇒ hostIcon() 回 null）。
+ * 宿主口径（app.asar 抽出，ui-primitives/lib/index.js）：`IconCopyOutlineRegular` / `IconCheckOutlineRegular`
+ * / `IconRefreshOutlineRegular`，都是普通 `(props) => svg` 组件（size 缺省 16、Regular 档 1px 描边、
+ * 颜色 currentColor）；宿主的复制反馈是**直接换图**（`.action svg` 没有任何 transition/animation）。
+ */
+test('动作行图标走宿主原生（复制 → 对勾 → 回退），拿不到宿主图标时必须回落本仓库图标', () => {
+  const entry = sourceOf('ChatEntryView.tsx')
+  for (const name of ['IconCopyOutlineRegular', 'IconCheckOutlineRegular', 'IconRefreshOutlineRegular']) {
+    assert.match(entry, new RegExp("hostIcon\\('" + name + "'\\)"), '动作行图标必须按名字取宿主的 ' + name)
+  }
+  assert.match(entry, /<CopyStateIcon done=\{copied\} size=\{15\} \/>/, '拿不到宿主图标时必须回落 morphicons 的 CopyStateIcon（不能变成空白按钮）')
+  assert.match(entry, /<RefreshIcon size=\{15\} \/>/, '拿不到宿主图标时必须回落本仓库的 RefreshIcon')
+  assert.match(entry, /copied \? <HostCheckIcon size=\{15\} \/> : <HostCopyIcon size=\{15\} \/>/, '复制反馈必须是宿主的**换图**（不是形变动画）')
+  // 闸门只有一处：宿主图标必须经 common/host-primitives.ts 的 hostIcon（不许在组件里裸 require）
+  assert.doesNotMatch(entry, /require\(['"]@deepseek-ai/, '组件里不得裸 require 宿主包（唯一出口 = host-primitives.ts）')
+  const gate = readFileSync(join(HERE, '..', 'common', 'host-primitives.ts'), 'utf8')
+  assert.match(gate, /export function hostIcon\(name: DshIconName\)/, 'hostIcon 必须按闭集名字取图标')
+  assert.match(gate, /type DshIconName = 'IconCopyOutlineRegular' \| 'IconCheckOutlineRegular' \| 'IconRefreshOutlineRegular'/, '闭集必须逐字列这三颗，不搬整张图标表')
+})
+
+/**
+ * 2026-10-17（用户要求「与 DSH 原生气泡完全一致」）：§15b 的几何/字号必须与宿主
+ * MessageItem + MessageIconActions 的**同一条取值**逐字同式（宿主产物抽出的取值清单见
+ * docs/spec/known-gaps.md 的「G-39 增量（八）」）。这张用例是那条口径的源级护栏：
+ * 谁把圆角/内边距/动作行/文件卡改回「近似档」，这里立刻红。
+ */
+test('气泡与动作行逐值对齐宿主：圆角 xl(20px) / 内边距 10·16 / 动作行 28+delta / 文件卡 240·64', () => {
+  const cssSheet = readFileSync(join(HERE, '..', 'config-manager.module.css'), 'utf8')
+  // 注释里会引用这些取值（解释为什么改），负向断言必须先剥注释 —— 与 css-token-guard 同法
+  const noComment = cssSheet.replace(/\/\*[\s\S]*?\*\//g, '')
+  const scope = noComment.match(/\.chatEntryScope\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(scope, '', '必须能定位 .chatEntryScope 规则块（扫描失效时本用例不得静默通过）')
+  // ① 镜像 token：宿主 radius xl=20（气泡/文件卡）、sm=8（动作按钮）、动作行与图标跟着 delta 长
+  assert.match(scope, /--cm-r-chat:\s*var\(--dsw-radius-xl,\s*20px\)/, '气泡/文件卡圆角必须镜像宿主 --dsw-radius-xl（20px）')
+  assert.match(scope, /--cm-r-act:\s*var\(--dsw-radius-sm,\s*8px\)/, '动作按钮圆角必须镜像宿主 --dsw-radius-sm（8px）')
+  assert.match(scope, /--cm-chat-action:\s*calc\(28px \+ var\(--dsh-content-font-delta,\s*0px\)\)/, '动作行高度/触达区必须与宿主同式（28px + delta）')
+  assert.match(scope, /--cm-chat-glyph:\s*calc\(15px \+ var\(--dsh-content-font-delta,\s*0px\)\)/, '动作图标必须与宿主同式（15px + delta）')
+
+  // ② 气泡：宿主 .bubble 是**块**（尺寸 100% / 内边距 10px 16px / 圆角 xl）
+  const bubble = noComment.match(/\.chatBubble\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(bubble, '', '必须能定位 .chatBubble 规则块')
+  assert.match(bubble, /max-width:\s*100%/)
+  assert.match(bubble, /padding:\s*var\(--cm-sp-5\) var\(--cm-sp-8\)/, '内边距必须等于宿主的 10px 16px')
+  assert.match(bubble, /border-radius:\s*var\(--cm-r-chat\)/, '.chatBubble 必须消费 --cm-r-chat')
+  assert.doesNotMatch(bubble, /display:\s*flex/, '宿主 .bubble 是块级：不得再用 flex 列（技能/引用 chip 会被挤成独立一行）')
+
+  // ③ 动作行：宿主 MessageIconActions（gap 8 / 高 28+delta）+ MessageItem 的 4px / -6px 外边距
+  const actions = noComment.match(/\.chatEntryActions\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(actions, '', '必须能定位 .chatEntryActions 规则块')
+  assert.match(actions, /gap:\s*var\(--cm-sp-4\)/, '动作行 gap 必须等于宿主的 8px')
+  assert.match(actions, /height:\s*var\(--cm-chat-action\)/, '动作行高度必须跟随宿主的 28px + delta')
+  assert.match(actions, /margin-top:\s*var\(--cm-sp-2\)/, '动作行上方必须留宿主的 4px')
+  assert.match(actions, /margin-left:\s*calc\(-1 \* var\(--cm-sp-3\)\)/, '动作行必须用宿主同一条负外边距（-6px）对齐气泡右缘')
+
+  // ④ 时刻与文件卡
+  const time = noComment.match(/\.chatEntryTime\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(time, '', '必须能定位 .chatEntryTime 规则块')
+  assert.match(time, /font-size:\s*var\(--cm-fs-second\)/, '时刻必须用宿主的次级字号镜像（13px 档）')
+  assert.match(time, /padding-right:\s*var\(--cm-sp-6\)/, '时刻右侧必须留宿主的 12px')
+  const card = noComment.match(/\.chatFileCard\s*\{[^}]*\}/)?.[0] ?? ''
+  assert.notEqual(card, '', '必须能定位 .chatFileCard 规则块')
+  assert.match(card, /width:\s*240px/, '文件卡宽度必须等于宿主的 240px')
+  assert.match(card, /min-height:\s*64px/, '文件卡最小高度必须等于宿主的 64px')
+  assert.match(card, /gap:\s*var\(--cm-sp-5\)/, '文件卡内图标与文字间距必须等于宿主的 10px')
+  assert.match(card, /border-radius:\s*var\(--cm-r-chat\)/, '文件卡圆角必须与气泡同一档（宿主 xl）')
+
+  // ⑤ 动作行的显现语义：宿主靠 data-chat-flow-kind + :has(~ …) 表达「后面还有用户消息就藏起来」
+  assert.match(noComment, /data-chat-flow-kind='user'/, '显现语义必须复用宿主自己的 data-chat-flow-kind 属性')
+  assert.match(noComment, /:has\(~ :is\(\[data-chat-flow-kind='user'\]/, '必须与宿主同一条「后面还有用户/steering 消息 ⇒ 动作行默认隐藏」的规则')
+})
+
 /**
  * 宿主正文投影（2026-10-15）：气泡正文优先交给宿主自己的 projectUserText（会话引用/技能 → chip）。
  * 四条回落判据必须逐条可证 —— 任一条不成立都回落我们自己的纯文本投影（绝不空白、绝不抛）。
@@ -1161,6 +1367,76 @@ test('attachments: one ordered list in content order + compact counts ALL attach
   assert.deepEqual(mixed.images.map((image) => image.attachment), [{ id: 'i1' }, { id: 'i2' }])
 })
 
+test('issue #92：hostAttachments 保留宿主原始载荷、顺序与 content 一致（我们的 ChatEntryFile 拼不回来）', () => {
+  const image = { id: 'i1', width: 10 }
+  const fileRef = { id: 'f1', name: 'a.txt', bytes: 3, mimeType: 'text/plain' }
+  const view = buildChatEntryBubble([
+    { type: 'file', attachment: fileRef },
+    { type: 'image', attachment: image },
+    { type: 'file', attachment: { name: 'b.txt', bytes: 4 } },
+  ])
+  // 宿主 contentParts 的形状逐字：image 包一层 { attachment }，file 是原始 FileAttachmentRef
+  assert.deepEqual(view.hostAttachments, [
+    { type: 'file', file: fileRef },
+    { type: 'image', image: { attachment: image } },
+    { type: 'file', file: { name: 'b.txt', bytes: 4 } },
+  ])
+  assert.equal(view.hostAttachments.length, view.attachments.length, '两份列表同趟走查、同序（不得只算一半）')
+  // 没有 attachment 的块照旧只进 rest：两份列表都不许凭空多一项
+  assert.deepEqual(view.hostAttachments.filter((item) => item.type === 'image').length, 1)
+  const hostile = buildChatEntryBubble([{ type: 'image' }, { type: 'file' }])
+  assert.equal(hostile.hostAttachments.length, 0)
+  assert.equal(hostile.raw.length, 2)
+  // 非数组 / 字符串 content 的安全值里也必须带着这个字段（渲染层会直接读它）
+  assert.deepEqual(buildChatEntryBubble('hi').hostAttachments, [])
+  assert.deepEqual(buildChatEntryBubble(undefined).hostAttachments, [])
+})
+
+test('issue #92：content factory 入参 = 宿主 UserStyleBubble 的 prepared/facts（原文 + rest + 字段存在性）', () => {
+  const content = [
+    { type: 'text', text: 'see @[S](dsh-session:1)' },
+    { type: 'image', attachment: { id: 'i1' } },
+    { type: 'mystery', payload: { deep: 1 } },
+  ]
+  const bare = buildChatEntryView({ kind: 'user', location: { kind: 'step', turn: { turn: 1, status: 'closed' } }, data: { content } })
+  // text 必须是**未投影**的原文（chip 由宿主 factory 内部投影），attachments/extraBlocks 逐字带过去
+  assert.equal(bare.hostContent.content.text, 'see @[S](dsh-session:1)')
+  assert.deepEqual(bare.hostContent.content.attachments, [{ type: 'image', image: { attachment: { id: 'i1' } } }])
+  assert.deepEqual(bare.hostContent.content.extraBlocks, [{ type: 'mystery', payload: { deep: 1 } }])
+  // 宿主用「字段是否存在」区分「没带」与「空」⇒ 没带时两个对象里都不许出现这三个键
+  assert.equal('referenceLabels' in bare.hostContent.content, false)
+  assert.equal('sessionLabels' in bare.hostContent.facts, false)
+  assert.equal('skillNames' in bare.hostContent.facts, false)
+
+  const withData = buildChatEntryView({
+    kind: 'user',
+    location: { kind: 'step', turn: { turn: 1, status: 'closed' } },
+    data: { content: [{ type: 'text', text: 'q' }], referenceLabels: ['s-a', 7], skillNames: ['changelog-writing'] },
+  })
+  assert.deepEqual(withData.hostContent.content.referenceLabels, ['s-a'], '非字符串项照旧被剔除')
+  assert.deepEqual(withData.hostContent.facts.sessionLabels, ['s-a'])
+  assert.deepEqual(withData.hostContent.facts.skillNames, ['changelog-writing'])
+  // 空数组是**真的带了空**（与「没带」不同）
+  const emptyLabels = buildChatEntryView({
+    kind: 'user',
+    location: { kind: 'step', turn: { turn: 1, status: 'closed' } },
+    data: { content: [{ type: 'text', text: 'q' }], referenceLabels: [], skillNames: [] },
+  })
+  assert.deepEqual(emptyLabels.hostContent.content.referenceLabels, [])
+  assert.deepEqual(emptyLabels.hostContent.facts.sessionLabels, [])
+})
+
+test('issue #92：组件把正文委托给宿主 content factory，并把自绘气泡当 fallback（双栈，不在注册期赌形态）', () => {
+  const src = sourceOf('ChatEntryView.tsx')
+  assert.match(src, /CHAT_USER_CONTENT_FACTORY/, '必须按名字委托宿主的 content factory')
+  assert.match(src, /typeof renderFactorySlot === 'function'/, '委托前必须探测该席位是否存在（老宿主没有）')
+  assert.match(src, /fallback:\s*ownContent/, '自绘气泡必须是那次调用的 fallback（factory 缺失时不许出空白气泡）')
+  assert.match(src, /interactive:\s*true/, '宿主对用户消息传 interactive: true，必须同构')
+  assert.match(src, /loadImage,/, '宿主授权过的图片加载器必须原样转发')
+  // 反向：图片**不许**再由我们自己 renderMessageImages 一途承载（0.2.1 起该 props 已不存在）
+  assert.match(src, /const content = typeof renderFactorySlot/, '正文/附件渲染的唯一出口是这一处三元')
+})
+
 test('bubble file cards: file name + extension + size; a missing byte count stays unknown (no fake 0 B)', () => {
   const view = buildChatEntryBubble([
     { type: 'file', attachment: { name: 'C:/tmp/report.final.PDF', bytes: 1536 } },