dsh-config-manager 0.1.76 → 0.1.77

package/src/adapters/plugins.ts

@@ -28,8 +28,11 @@ import { parsePnpmPatchedDependencies, sanitizePnpmWorkspacePatches } from './pn
 import type { LocalPluginTarball, PatchLine, PluginEntry, PluginsSection, PnpmPatchFile } from '../schema/types.ts';
 import type {
   ApplyResult, ConfigAdapter, ExportOptions, ExportSection, ExportUnit, HostContext,
-  ImportContext, PlanItem, SectionPreview, ValidationResult,
+  ImportContext, PlanItem, PluginAreaRef, SectionPreview, ValidationResult,
 } from '../core/types.ts';
+import { BUILTIN_PLUGIN_DATA_SOURCES, areasForSection } from '../core/plugin-data-registry.ts';
+import type { PluginDataSource } from '../core/plugin-data-registry.ts';
+import { declaredProfileName, scanDeclaredDataSources } from './plugin-data-declared.ts';
 import { sectionMeta } from '../schema/section-registry.ts';
 import { validateJsonSection } from './json-section.ts';
 
@@ -156,6 +159,68 @@ function entriesOfRaw(raw: unknown): { config?: unknown }[] {
  */
 const previewTarballBytes = new WeakMap<object, Map<string, number>>();
 
+/**
+ * 「插件包名 → 它声明的数据区域」映射（只有 \`plugin:<包名>\` 单元用；导出选择器「按插件看」的树骨架）。
+ *
+ * 为什么挂 WeakMap 而不是给 PluginsSection 加字段：这是**展示用旁路信息** —— 既不是备份格式的
+ * 一部分（schema 校验与市场防线都不该看见它），也与「导出真的带什么」无关；挂在载荷对象上随对象
+ * 一起回收，载荷本身逐字节不变（与 previewTarballBytes 同一套理由）。
+ */
+const relatedAreasByData = new WeakMap<object, Map<string, PluginAreaRef[]>>();
+
+/** 内置来源 + 自述声明的扫描缓存（TTL 内的同一 home/profile 只扫一次；/export-preview 一趟会问两次） */
+const declaredSourcesMemo: { key: string; at: number; sources: readonly PluginDataSource[] } =
+  { key: '', at: 0, sources: [] };
+const DECLARED_MEMO_TTL_MS = 5_000;
+
+/**
+ * 本机可归属的插件数据来源 = 内置来源表 + 已安装插件自述声明。
+ *
+ * 缓存键必须带 homeDir + profile：同一台机器换 profile 就是另一批已安装插件，拿旧声明画树
+ * 会让用户看到不属于当前 profile 的数据区域。
+ */
+async function pluginDataSources(ctx: HostContext): Promise<readonly PluginDataSource[]> {
+  const key = ctx.homeDir + '|' + declaredProfileName(ctx.profile);
+  const now = Date.now();
+  if (declaredSourcesMemo.key === key && now - declaredSourcesMemo.at < DECLARED_MEMO_TTL_MS) {
+    return declaredSourcesMemo.sources;
+  }
+  const sources = [...BUILTIN_PLUGIN_DATA_SOURCES, ...await scanDeclaredDataSources(ctx)];
+  declaredSourcesMemo.key = key;
+  declaredSourcesMemo.at = now;
+  declaredSourcesMemo.sources = sources;
+  return sources;
+}
+
+/**
+ * 包名 → 该插件的数据区域引用。
+ *
+ * 口径与 pluginData / pluginAssets 的收集面**同源**（同一个 areasForSection）：role=config 进
+ * pluginData、role=assets 进 pluginAssets；role=cache 的区域不属于任何分区，因此**绝不进树**
+ * （缓存是可再生产物，列出来只会诱导用户把它带走）。
+ *
+ * 只产出「注册表说它应该在哪儿」，不代表磁盘上真有 —— 界面必须把两者分开渲染。
+ */
+async function relatedAreasOf(ctx: HostContext): Promise<Map<string, PluginAreaRef[]>> {
+  const sources = await pluginDataSources(ctx);
+  const map = new Map<string, PluginAreaRef[]>();
+  for (const source of sources) {
+    const refs: PluginAreaRef[] = [];
+    for (const section of ['pluginData', 'pluginAssets'] as const) {
+      for (const entry of areasForSection([source], section)) {
+        refs.push({ section, relPath: entry.area.relPath, role: entry.area.role === 'assets' ? 'assets' : 'config' });
+      }
+    }
+    if (refs.length === 0) continue;
+    for (const pkg of source.packages) {
+      const cur = map.get(pkg);
+      if (cur === undefined) map.set(pkg, [...refs]);
+      else cur.push(...refs);
+    }
+  }
+  return map;
+}
+
 /**
  * 零 spawn 推导本地源插件的体积（预览专用）。
  *
@@ -208,7 +273,11 @@ async function measureLocalSources(plugins: PluginEntry[], ctx: HostContext): Pr
  * `tarballBytes` = 预览路径登记到的本地源体积（见 measureLocalSources，0 = 体积未知但仍随包携带）；
  * 缺省时体积与文件数完全按导出产物里的 base64 计算 —— 与改造前逐字一致。
  */
-function unitsOf(data: PluginsSection, tarballBytes?: Map<string, number>): ExportUnit[] {
+function unitsOf(
+  data: PluginsSection,
+  tarballBytes?: Map<string, number>,
+  related?: Map<string, PluginAreaRef[]>,
+): ExportUnit[] {
   const wsId = 'plugins:pnpm-workspace';
   const patchFileIds = (data.patchFiles ?? []).map((pf) => `plugins:patch:${normalizePath(pf.relativePath)}`);
   const group = [wsId, ...patchFileIds];
@@ -216,6 +285,7 @@ function unitsOf(data: PluginsSection, tarballBytes?: Map<string, number>): Expo
   for (const pl of data.plugins) {
     const tarball = tarballOf(data, pl.name);
     const measured = tarballBytes?.get(pl.name);
+    const areas = related?.get(pl.name);
     units.push({
       id: `plugin:${pl.name}`,
       label: pl.name,
@@ -223,6 +293,8 @@ function unitsOf(data: PluginsSection, tarballBytes?: Map<string, number>): Expo
       // base64 长度 → 原始字节数（仅用于展示体积，不求精确）；预览路径没有字节，用 stat 量到的源体积
       sizeBytes: tarball !== undefined ? Math.floor((tarball.base64.length * 3) / 4) : measured ?? 0,
       ...(tarball !== undefined || measured !== undefined ? { fileCount: 1 } : {}),
+      // 「按插件看」的树骨架：该插件声明的数据区域（零数据目录 I/O）
+      ...(areas !== undefined && areas.length > 0 ? { relatedAreas: areas } : {}),
     });
   }
   for (const line of data.patch) {
@@ -291,7 +363,7 @@ export class PluginsAdapter implements ConfigAdapter<PluginsSection> {
       section: collected,
       // 与 src/index.ts 对 JSON 分区现算体积的口径一致（utf8 字节数）
       sizeBytes: new TextEncoder().encode(stringifyJsonSafe(data)).length,
-      items: unitsOf(data, tarballBytes),
+      items: unitsOf(data, tarballBytes, relatedAreasByData.get(data)),
     };
   }
 
@@ -432,16 +504,28 @@ export class PluginsAdapter implements ConfigAdapter<PluginsSection> {
       const alive = new Set(keptPlugins.map((pl) => pl.name));
       keptTarballs = localTarballs?.filter((t) => alive.has(t.packageName));
     }
+    const data: PluginsSection = {
+      version: 1,
+      plugins: keptPlugins,
+      patch: keptPatch,
+      pnpmWorkspace: keptWorkspace,
+      ...(keptTarballs !== undefined ? { localTarballs: keptTarballs } : {}),
+      ...(keptPatchFiles !== undefined ? { patchFiles: keptPatchFiles } : {}),
+    };
+    /**
+     * 「按插件看」的树骨架（导出选择器）：登记每个插件声明的数据区域。
+     * 只登记「至少有一个区域」的插件 —— 其余插件单元保持无该字段，界面据此不显示空壳节点。
+     * 归属信息是**附加**信息：扫描失败不得影响导出/预览本身（与 pluginData 同一纪律）。
+     */
+    try {
+      const related = await relatedAreasOf(ctx);
+      if (related.size > 0) relatedAreasByData.set(data, related);
+    } catch {
+      // 读不到声明就不登记（界面按「没有已知关联」渲染，绝不猜）
+    }
     return {
       sectionId: 'plugins',
-      data: {
-        version: 1,
-        plugins: keptPlugins,
-        patch: keptPatch,
-        pnpmWorkspace: keptWorkspace,
-        ...(keptTarballs !== undefined ? { localTarballs: keptTarballs } : {}),
-        ...(keptPatchFiles !== undefined ? { patchFiles: keptPatchFiles } : {}),
-      },
+      data,
       counts: {
         plugins: keptPlugins.length,
         patchLines: keptPatch.length,
@@ -461,8 +545,9 @@ export class PluginsAdapter implements ConfigAdapter<PluginsSection> {
    * 由选择模型保证勾选/取消同步。
    */
   listUnits(section: ExportSection<PluginsSection>): ExportUnit[] {
-    // 预览产物没有 tarball 字节，体积来自 measureLocalSources 挂上的统计（导出产物走 base64 分支）
-    return unitsOf(section.data, previewTarballBytes.get(section.data));
+    // 预览产物没有 tarball 字节，体积来自 measureLocalSources 挂上的统计（导出产物走 base64 分支）；
+    // 「按插件看」的数据区域骨架同样由 collect() 登记在载荷对象上（两条路径逐字一致，units.test 钉住）
+    return unitsOf(section.data, previewTarballBytes.get(section.data), relatedAreasByData.get(section.data));
   }
 
   /**

package/src/adapters/units.test.ts

@@ -147,6 +147,32 @@ test('plugins：按包名过滤，cordis 补丁行独立成单元', async () =>
   assert.deepEqual(filtered.data.patch, [], '未勾选的补丁行不得被带出');
 });
 
+test('plugins：「按插件看」的树骨架 —— 单元带上它声明的数据区域（内置来源表，缓存永不进树）', async () => {
+  const ctx = makeContext('win32', HOME);
+  // 内置来源表：dsh-mnemon → runtime(config) + data/documents(assets)；
+  // dsh-plugin-wallpaper-engine → 数据目录(config) + uploads(assets) + cache(**不属于任何分区**)
+  ctx.plugins.installed.set('dsh-mnemon', { name: 'dsh-mnemon', version: '1.0.0', enabled: true });
+  ctx.plugins.installed.set('dsh-plugin-wallpaper-engine', {
+    name: 'dsh-plugin-wallpaper-engine', version: '1.0.0', enabled: true,
+  });
+  ctx.plugins.installed.set('pkg-a', { name: 'pkg-a', version: '1.0.0', enabled: true });
+  const adapter = new PluginsAdapter();
+
+  const previewed = await adapter.preview(ctx, { includeSecrets: false });
+  assert.deepEqual(previewed.items.find((u) => u.id === 'plugin:dsh-mnemon')?.relatedAreas, [
+    { section: 'pluginData', relPath: '.mnemon/runtime', role: 'config' },
+    { section: 'pluginAssets', relPath: '.mnemon/data', role: 'assets' },
+    { section: 'pluginAssets', relPath: '.mnemon/documents', role: 'assets' },
+  ]);
+  const we = previewed.items.find((u) => u.id === 'plugin:dsh-plugin-wallpaper-engine')?.relatedAreas ?? [];
+  assert.deepEqual(we.map((r) => r.relPath), ['.dsh-wallpaper-engine', '.dsh-wallpaper-engine/uploads'],
+    'cache 区域可再生产物、不属于任何分区，绝不进树');
+  // 没有声明的插件不得凭空带上区域（不猜）
+  assert.equal(previewed.items.find((u) => u.id === 'plugin:pkg-a')?.relatedAreas, undefined);
+  // 预览与导出两条路径的单元清单必须逐项相同（本文件既有纪律）
+  assert.deepEqual(previewed.items, adapter.listUnits(previewed.section));
+});
+
 test('plugins：pnpm-workspace.yaml ↔ patch 文件是原子组（lockedWith 双向声明）', () => {
   const adapter = new PluginsAdapter();
   const section: ExportSection<PluginsSection> = {

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>