dsh-config-manager 0.1.73 → 0.1.76

package/lib/index.d.ts

@@ -78,7 +78,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.1.73";
+export declare const PLUGIN_VERSION = "0.1.76";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照

package/lib/index.js

@@ -136,7 +136,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.73';
+export const PLUGIN_VERSION = '0.1.76';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**

package/lib/sync/messages.d.ts

@@ -57,6 +57,7 @@ export declare const zh: {
     readonly 'sync.backupHistoryDone': '{trigger}完成：{zip}';
     readonly 'sync.backupHistorySkipped': '{trigger}跳过：{reason}';
     readonly 'sync.backupHistoryFailed': '{trigger}失败';
+    readonly 'sync.pushPreviewUnpackedLocalSources': '本地源插件（link:/file:）需打包才能精确比对变更，分区 {sections} 本次按「有变化」展示';
 };
 export declare const en: Record<keyof typeof zh, string>;
 /** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */

package/lib/sync/messages.js

@@ -83,6 +83,8 @@ export const zh = {
     'sync.backupHistoryDone': '{trigger}完成：{zip}',
     'sync.backupHistorySkipped': '{trigger}跳过：{reason}',
     'sync.backupHistoryFailed': '{trigger}失败',
+    // ---------- 推送前只读预览（issue #91） ----------
+    'sync.pushPreviewUnpackedLocalSources': '本地源插件（link:/file:）需打包才能精确比对变更，分区 {sections} 本次按「有变化」展示',
 };
 export const en = {
     'sync.ancestorSnapshotIdRequired': 'loadAncestor: snapshotId must not be empty',
@@ -142,6 +144,7 @@ export const en = {
     'sync.backupHistoryDone': '{trigger} finished: {zip}',
     'sync.backupHistorySkipped': '{trigger} skipped: {reason}',
     'sync.backupHistoryFailed': '{trigger} failed',
+    'sync.pushPreviewUnpackedLocalSources': 'Local-source plugins (link:/file:) must be packed to compare changes exactly; section(s) {sections} are shown as changed',
 };
 registerMessageCatalog({ id: 'sync-domain', zh, en });
 /** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */

package/lib/sync/sync-engine.js

@@ -22,6 +22,8 @@ import path from 'node:path';
 import { createAdapters } from '../adapters/index.js';
 import { defaultSecretScanner } from '../core/exporter.js';
 import { Importer } from '../core/importer.js';
+// issue #91：只读预览与基线 hash 的口径判定（本地源插件在预览里不会被 npm pack）
+import { isLocalPluginSpec } from '../core/local-plugin-pack.js';
 import { isFileSection, SECTION_FILE_PREFIXES, SECTION_JSON_PATHS } from '../schema/config.js';
 import { buildManifest, CHECKSUMS_FILE, MANIFEST_FILE } from '../schema/manifest.js';
 import { CURRENT_SCHEMA_VERSION } from '../schema/versions.js';
@@ -83,6 +85,24 @@ const FORBIDDEN_SECTIONS = ['credentialsStatus', 'secrets'];
  * 保留导出是为了让既有调用方/测试仍能引用「缺省保留份数」这一事实，不再作为唯一判据。
  */
 export const MAX_REMOTE_SNAPSHOTS = DEFAULT_RETENTION_POLICY.keepLast;
+/**
+ * issue #91：走只读 `preview()` 拿到的产物，能否直接与该分区**基线 hash**（push 时按 export() 产物记录）比对。
+ *
+ * 为什么需要这个判定：`plugins` 适配器的 `preview()` 走 `collect(…, pack=false)` —— 刻意**不做**
+ * 本地源（`link:` / `file:`）插件的 `npm pack`。于是当 profile 里存在本地源插件时，预览产物既没有
+ * `localTarballs`、插件 spec 也保持原样（export() 会改写成 `file:<tarball>`），与基线**不同口径**：
+ * 此时既不能断言「无变化」（本地插件源码改了体积/内容，预览看不见），也不该为了比对去打包
+ * （那正是本 issue 的缺陷本身）。
+ *
+ * 返回 true = 该分区本趟**不可比** ⇒ 调用方只能保守报「有变化」并如实说明原因。
+ * 其余分区的 preview() 产物与 export() 逐字节相同（文件类分区不走 preview()，见 previewPush）。
+ */
+function previewCaliberDiffersFromExport(sectionId, data) {
+    if (sectionId !== 'plugins')
+        return false;
+    const plugins = data.plugins;
+    return Array.isArray(plugins) && plugins.some((p) => isLocalPluginSpec(p?.spec));
+}
 export class SyncEngine {
     ctx;
     transport;
@@ -516,14 +536,29 @@ export class SyncEngine {
         const targets = this.pushTargets(opts.sections, warnings);
         const plainSections = {};
         const counts = {};
+        /** issue #91：本趟只读预览省掉了本地源打包 ⇒ 与基线不可比的分区（不可断言「无变化」） */
+        const unpackedSections = new Set();
         for (const adapter of targets) {
+            const exportOptions = {
+                includeSecrets,
+                // 与 push 同口径：显式勾选清单 > 「最新 N 个」上限
+                ...this.sessionExportOptions(adapter.id, opts.sessions),
+            };
             let section;
             try {
-                section = await adapter.export(this.ctx, {
-                    includeSecrets,
-                    // 与 push 同口径：显式勾选清单 > 「最新 N 个」上限
-                    ...this.sessionExportOptions(adapter.id, opts.sessions),
-                });
+                // issue #91：**非文件类**分区优先走 adapter.preview()。只读预览必须零进程副作用，而
+                // plugins 的 export() 会对每个 `link:`/`file:` 插件真的跑一次 `npm pack`
+                // （真机 2 GB 本地源插件 = 297 s；这段时间全局写锁被该请求占满 ⇒ 界面上所有写操作静默 423）。
+                // 为什么文件类分区**不能**走 preview()：其预览产物是「无内容」形态（条目 data 为空、
+                // contentHash 为空串），既不能与基线 hash 比对，也不能进 assertNoForbiddenSections
+                // —— 那会让预览谎报「每个文件分区都变了」。
+                const summary = !isFileSection(adapter.id) && adapter.preview !== undefined
+                    ? await adapter.preview(this.ctx, exportOptions)
+                    : undefined;
+                section = summary?.section ?? await adapter.export(this.ctx, exportOptions);
+                if (summary !== undefined && previewCaliberDiffersFromExport(adapter.id, section.data)) {
+                    unpackedSections.add(adapter.id);
+                }
             }
             catch (err) {
                 warnings.push(this.msg('sync.sectionFailed', { adapter: adapter.id, reason: err instanceof Error ? err.message : String(err) }));
@@ -544,15 +579,29 @@ export class SyncEngine {
         if (!encrypted) {
             try {
                 const state = await loadSyncState(this.stateDir, this.fsx, this.msg);
-                baselineHashes = state.sections;
+                // 基线条目是 SyncSectionState（{hash, updatedAt}），**不是**裸 hash 字符串。
+                // 这里曾把整个对象 as Record<string,string> 直接比对 ⇒ 对象 !== 字符串 恒真
+                // ⇒ 预览对**每一个**分区都报「有变化」，「N 个有变化」这句永远是「全都有变化」。
+                for (const [sid, rec] of Object.entries(state.sections)) {
+                    if (rec !== undefined && typeof rec.hash === 'string')
+                        baselineHashes[sid] = rec.hash;
+                }
             }
             catch {
                 baselineHashes = {};
             }
         }
+        if (unpackedSections.size > 0) {
+            // 如实说明：本次预览没有为本地源插件执行 npm pack，故这些分区的基线比对不可得
+            warnings.push(this.msg('sync.pushPreviewUnpackedLocalSources', { sections: [...unpackedSections].join(', ') }));
+        }
         const sections = Object.keys(plainSections).map((sid) => {
             const id = sid;
-            const changed = encrypted || baselineHashes[id] === undefined || baselineHashes[id] !== hashSection(plainSections[id]);
+            const changed = encrypted
+                // issue #91：只读预览省掉了本地源打包 ⇒ 产物与基线不同口径，**绝不**据此断言「无变化」
+                || unpackedSections.has(id)
+                || baselineHashes[id] === undefined
+                || baselineHashes[id] !== hashSection(plainSections[id]);
             return { section: id, count: counts[id] ?? 0, changed };
         });
         let remoteSnapshotCount = 0;

package/lib/ui/i18n.d.ts

@@ -92,7 +92,7 @@ export declare const uiZh: {
     readonly 'error.downloadFailed': '下载失败：HTTP {status}';
     readonly 'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态';
     readonly 'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试';
-    readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态';
+    readonly 'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：过程可能仍在后台进行，请先刷新预览确认；确实未完成再重试';
     readonly 'error.settingsConflict.title': '配置已被并发修改';
     readonly 'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。';
     readonly 'error.notConfirmed.title': '导入未确认';

package/lib/ui/i18n.js

@@ -99,7 +99,7 @@ export const uiZh = {
     'error.downloadFailed': '下载失败：HTTP {status}',
     'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态',
     'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试',
-    'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态',
+    'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：过程可能仍在后台进行，请先刷新预览确认；确实未完成再重试',
     'error.settingsConflict.title': '配置已被并发修改',
     'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。',
     'error.notConfirmed.title': '导入未确认',
@@ -662,7 +662,7 @@ export const uiEn = {
     'error.downloadFailed': 'Download failed: HTTP {status}',
     'error.exportTimeout': 'Export timed out ({minutes} min): the export did not complete, please retry; if it keeps timing out, check the DSH state',
     'error.syncTimeout': 'Sync request timed out ({minutes} min): check network and repository reachability, then retry',
-    'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): the recovery did not complete, please retry; if it keeps timing out, check the DSH state',
+    'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): it may still be running in the background — refresh the preview to confirm, then retry if it did not finish',
     'error.settingsConflict.title': 'Configuration changed concurrently',
     'error.settingsConflict.action': 'This configuration on the target DSH was modified by another process during import. To avoid overwriting it, re-export or review it manually, then retry.',
     'error.notConfirmed.title': 'Import not confirmed',

package/lib/utils/bundle-scan.d.ts

@@ -31,9 +31,11 @@
  * DSH shell 把 UI 基础库作为 **static module seed** 预置在模块表里（`dsh-web-frontend` 的
  * `staticModules`：react / react-dom / cordis / client-store / ui-slots / ui-primitives / dockkit），
  * 插件 bundle 工厂拿到的 `require` 命中 seed 即可用 —— 第三方插件 dsh-better-sidebar 同样如此。
- * 本插件只用它画**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`），且**不是顶层 require**：
- * 调用点在 `src/client/chat/RollbackFileIcon.tsx` 的 `dshFileTypeIcon()` 里，外裹 try/catch ——
- * 老宿主没有这条 seed 时回落本地极简图标，绝不会因「一颗图标」打挂整个浏览器半。
+ * 本插件用它做两件事：**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`）与**用户正文投影**
+ * （`projectUserText` —— 会话引用/技能渲染成 chip，G-39 差距①②，2026-10-15）。
+ * **都不是顶层 require**：唯一入口是 `src/client/common/host-primitives.ts` 的帧内惰取门
+ * （三态缓存 + try/catch，每个进程只试一次）—— 老宿主没有这条 seed 时回落本地实现
+ * （极简图标 / 纯文本投影 / 可见的底色兜底），绝不会因一颗图标或一段正文打挂整个浏览器半。
  */
 export declare const CLIENT_BUNDLE_RUNTIME_WHITELIST: readonly string[];
 /**

package/lib/utils/bundle-scan.js

@@ -31,9 +31,11 @@
  * DSH shell 把 UI 基础库作为 **static module seed** 预置在模块表里（`dsh-web-frontend` 的
  * `staticModules`：react / react-dom / cordis / client-store / ui-slots / ui-primitives / dockkit），
  * 插件 bundle 工厂拿到的 `require` 命中 seed 即可用 —— 第三方插件 dsh-better-sidebar 同样如此。
- * 本插件只用它画**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`），且**不是顶层 require**：
- * 调用点在 `src/client/chat/RollbackFileIcon.tsx` 的 `dshFileTypeIcon()` 里，外裹 try/catch ——
- * 老宿主没有这条 seed 时回落本地极简图标，绝不会因「一颗图标」打挂整个浏览器半。
+ * 本插件用它做两件事：**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`）与**用户正文投影**
+ * （`projectUserText` —— 会话引用/技能渲染成 chip，G-39 差距①②，2026-10-15）。
+ * **都不是顶层 require**：唯一入口是 `src/client/common/host-primitives.ts` 的帧内惰取门
+ * （三态缓存 + try/catch，每个进程只试一次）—— 老宿主没有这条 seed 时回落本地实现
+ * （极简图标 / 纯文本投影 / 可见的底色兜底），绝不会因一颗图标或一段正文打挂整个浏览器半。
  */
 export const CLIENT_BUNDLE_RUNTIME_WHITELIST = [
     'react',

package/lib/utils/line-diff.d.ts

@@ -11,6 +11,12 @@
  * （maxLines / maxD）时**降级为整块替换**（全删 + 全增），保证任何输入都有确定
  * 耗时的输出 —— 大文件不会卡死宿主。
  *
+ * 预算怎么定（2026-10-15 真机实测，本仓 rollback-point.ts 的一对版本）：
+ *  · 时间是 (N+M)·D 量级：D=4000、两侧合计 ~7500 行时 ≈ 70 ms（D=8000 ≈ 115 ms）；
+ *  · 内存是 O(D²)·4B（回溯要逐轮留 V 快照）：D=2000 时 RSS +~30 MB、D=4000 +~100 MB、D=8000 +~175 MB。
+ *  ⇒ 缺省取 2000（覆盖「大文件只改了几处」这一大类）；单文件按需查看的调用方可以往上调，
+ *    到 4000 仍是一次点击可接受的开销；再大就该换线性空间算法，而不是继续加预算。
+ *
  * 行为约定：
  *  - 行尾 \r\n 归一为 \n；文本末尾的换行不产生"空行"（行数 = 换行符语义）。
  *  - 仅空白差异同样是差异（不做 ignoreWhitespace）。
@@ -48,7 +54,7 @@ export interface DiffOptions {
     context?: number;
     /** 参与 Myers 的变更区行数上限（两侧合计；超出 → 降级整块替换） */
     maxLines?: number;
-    /** Myers 最大编辑距离 D（超出 → 降级整块替换） */
+    /** Myers 最大编辑距离 D（超出 → 降级整块替换）；越大越接近最小编辑脚本，内存随 D² 增长（见文件头） */
     maxD?: number;
 }
 /** 文本 → 行数组（CRLF 归一、尾换行不产生空行）。 */

package/lib/utils/line-diff.js

@@ -11,14 +11,20 @@
  * （maxLines / maxD）时**降级为整块替换**（全删 + 全增），保证任何输入都有确定
  * 耗时的输出 —— 大文件不会卡死宿主。
  *
+ * 预算怎么定（2026-10-15 真机实测，本仓 rollback-point.ts 的一对版本）：
+ *  · 时间是 (N+M)·D 量级：D=4000、两侧合计 ~7500 行时 ≈ 70 ms（D=8000 ≈ 115 ms）；
+ *  · 内存是 O(D²)·4B（回溯要逐轮留 V 快照）：D=2000 时 RSS +~30 MB、D=4000 +~100 MB、D=8000 +~175 MB。
+ *  ⇒ 缺省取 2000（覆盖「大文件只改了几处」这一大类）；单文件按需查看的调用方可以往上调，
+ *    到 4000 仍是一次点击可接受的开销；再大就该换线性空间算法，而不是继续加预算。
+ *
  * 行为约定：
  *  - 行尾 \r\n 归一为 \n；文本末尾的换行不产生"空行"（行数 = 换行符语义）。
  *  - 仅空白差异同样是差异（不做 ignoreWhitespace）。
  *  - 完全一致时 hunks 为空、identical=true。
  */
 const DEFAULT_CONTEXT = 3;
-const DEFAULT_MAX_LINES = 6000;
-const DEFAULT_MAX_D = 400;
+const DEFAULT_MAX_LINES = 20000;
+const DEFAULT_MAX_D = 2000;
 /** 文本 → 行数组（CRLF 归一、尾换行不产生空行）。 */
 export function splitLines(text) {
     if (text === '')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.1.73",
+  "version": "0.1.76",
   "license": "MIT",
   "description": "Backup, restore, export, import, migrate and sync your DeepSeek Harness (DSH) configuration: settings, plugins, MCP servers, skills, agent presets and workspaces. One-click migration to another machine. DSH 配置一键备份、恢复、导出、导入、迁移与同步插件。",
   "icon": "./icon.svg",

package/src/client/chat/ChatEntryView.tsx

@@ -30,6 +30,7 @@ import {
   buildChatEntrySafeRow,
   buildChatEntryView,
   chatEntryButtonState,
+  projectChatEntryTextWithHost,
   chatEntryTurnPhase,
   planChatEntryAttachments,
   lookupPointForTurn,
@@ -41,6 +42,7 @@ import {
   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 type { ArchiveOutcome } from './rollback-entry-view.ts'
 import type { ChildOpenState } from './rollback-entry-view.ts'
 import type { RollbackFileIconRenderer } from './RollbackFileIcon.tsx'
@@ -93,11 +95,21 @@ export interface ChatEntryViewInjected {
  */
 export type ChatEntryViewProps = PropsRuntime<'conversation.chat.node', 'user'> & PropsLocale<'config-manager-chat'> & ChatEntryViewInjected
 
-/** 文件卡：文件名 + 扩展名徽标 + 体积（扩展名徽标 = 类型图标的诚实兜底，见能力对照表）。 */
+/**
+ * 文件卡：类型图标 + 文件名 + 体积。
+ *
+ * 类型图标**优先用宿主自己的** `FileTypeIcon`（ui-primitives，帧内惰取 —— 见 common/host-primitives.ts）；
+ * 拿不到（老宿主）才回落我们自己的**扩展名徽标**（口径与宿主 fileExtension 一致，见 fileExtensionOf）。
+ * 2026-10-15：此前一律走徽标，是因为「ui-primitives 包私有不可导入」只对**构建期 import** 成立 ——
+ * 运行期 require 是生态通行做法（dsh-reedit / dsh-better-sidebar / 本仓 RollbackFileIcon 都这么做）。
+ */
 function FileCard({ file, size }: { file: ChatEntryFile; size: string | null }) {
+  const DshIcon = hostFileTypeIcon()
   return (
     <span className={css.chatFileCard} title={file.name !== '' ? file.name : undefined}>
-      {file.ext !== null && <span className={css.chatFileExt}>{file.ext}</span>}
+      {DshIcon !== null && file.name !== ''
+        ? <DshIcon path={file.name} size={14} />
+        : 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>
@@ -145,6 +157,9 @@ function ChatEntryCopyAction({ text, t }: { text: string; t: TranslateNS<'config
 interface ChatEntryBodyProps extends ChatEntryViewInjected {
   node: unknown
   sessionId: string
+  /** 宿主的文件 / 技能打开器（给宿主正文投影的 chip 用；形态不符时投影自己会当没有）。 */
+  openFile?: unknown
+  openSkill?: unknown
   /** 宿主图片渲染位（SlotMap 的 keyProps 把返回值声明成 unknown ⇒ 用它当 `MessageImagesRenderer` 必须过一层窄化）。 */
   renderMessageImages?: unknown
   t: TranslateNS<'config-manager-chat'>
@@ -159,11 +174,12 @@ interface ChatEntryBodyProps extends ChatEntryViewInjected {
  *    （`projectChatEntryText`），且 `data.referenceLabels` 非空时渲染**宿主的引用汇总行**
  *    （见下方 `css.chatEntryReference` + `t('chat.entry.referenceSummary')` 那段，文案与宿主
  *    `引用会话 · {labels}` 逐字同义）。**仍有的差距**只有 chip 的**外观与可点开**（已追认）。
- *  · **技能（skillNames）**：**仍不渲染** —— 宿主交给 ui-primitives 的 `projectUserText` 在正文内部
- *    把它渲染成 chip（包私有、不可导入）⇒ 我们不为技能产出任何界面元素（不编造内容）。
- *  · 文件类型图标：宿主用 ui-primitives 的 FileTypeIcon（包私有）⇒ 我们用**扩展名徽标**兜底；
- *  · 气泡底色：宿主直接用 `--dsw-specific-bubble`，本仓库 token 层没有这一档 ⇒ 用 `--cm-surface-2`
- *    （亮/暗主题下都是「比底更强的面」），不改 DESIGN 体系、不新增 token。
+ *  · **技能（skillNames）与引用 chip**：2026-10-15 起正文**优先交给宿主自己的** `projectUserText`
+ *    （ui-primitives 帧内惰取，见 common/host-primitives.ts）——技能与引用渲染成 chip，`openFile` /
+ *    `openSkill` 可用时还能点开；拿不到原语（老宿主）就回落我们的纯文本投影，**不编造内容、不留空白**。
+ *  · 文件类型图标：同样优先宿主的 `FileTypeIcon`，拿不到才回落到**扩展名徽标**兜底；
+ *  · 气泡底色：`--cm-chat-bubble`（= 宿主 `--dsw-specific-bubble`，2026-10-15 之前误用 `--cm-surface-2`
+ *    ⇒ 浅色主题下与页面同色、气泡看不见；详见 DESIGN.md §15b 与 css 里那两条定义行的注释）。
  */
 /**
  * 订阅入口可见性信号（issue #88）。
@@ -177,7 +193,7 @@ function useRollbackEntryEnabled(): boolean {
   return value
 }
 
-function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, openChildSession, archiveParentSession, startFreshSession, openDiff, fileIcon }: ChatEntryBodyProps) {
+function ChatEntryBody({ node, sessionId, openFile, openSkill, renderMessageImages, t, rt, port, openChildSession, archiveParentSession, startFreshSession, openDiff, fileIcon }: ChatEntryBodyProps) {
   const view = useMemo(() => buildChatEntryView(node), [node])
   const [lookup, setLookup] = useState<ChatPointLookup | null>(null)
   /** 有界重试窗口是否还开着（**状态诚实**的唯一开关，R1）—— 由状态机的 `onState` 驱动。 */
@@ -254,6 +270,17 @@ function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, open
         : null)
     : <FileCard key={'file:' + String(item.index)} file={item.file} size={item.size} />)
   const hasAttachments = attachmentNodes.some((node) => node !== null)
+  /**
+   * 正文：**优先宿主自己的** `projectUserText`（会话引用 / 技能渲染成 chip，给了打开器就能点开），
+   * 拿不到就回落我们自己的纯文本投影（`bubble.text`，线格式也已换成 label）。
+   * 四条回落判据在纯层（`projectChatEntryTextWithHost`）；投影器**帧内惰取**（老宿主没有原语包 → null）。
+   */
+  const hostText = projectChatEntryTextWithHost(hostUserTextProjector(), bubble.rawText, {
+    sessionLabels: view.referenceLabels,
+    skillNames: view.skillNames,
+    openFile,
+    openSkill,
+  })
   const reasonKey = button.kind === 'disabled' ? button.key : null
 
   return (
@@ -267,7 +294,9 @@ function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, open
           )}
           {bubble.showBubble && (
             <div className={css.chatBubble}>
-              {bubble.text !== '' && <span className={css.chatBubbleText}>{bubble.text}</span>}
+              {bubble.text !== '' && (
+                <span className={css.chatBubbleText}>{hostText === null ? bubble.text : hostText}</span>
+              )}
               {bubble.raw.map((block) => (
                 <RawBlock
                   key={'raw-' + block.id}

package/src/client/chat/RollbackFileIcon.tsx

@@ -9,56 +9,18 @@
  *  ② **DSH 自带**：`@deepseek-ai/dsh-client-ui-primitives` 的 `FileTypeIcon` —— 这正是 DSH 左侧文件树
  *     （`dsh-client-ui-sidebar-files` 的 FilesBody）逐字使用的那颗组件（同一份按类型着色的画集）。
  *
- * ## 为什么这里是「惰取 + try/catch」而不是顶层 import（**关键**）
- * 该包由 DSH shell 的模块表作为 **static module seed** 预置（`dsh-web-frontend` 的 `staticModules`
- * 里就有它），插件 bundle 的 `require` 能直接命中 —— 第三方插件 dsh-better-sidebar 走的就是这条路。
- * 但那是**较新宿主**才有的模块表：老宿主加载本插件时 `require` 会抛（missed the module table）。
- * 顶层 `import` 会被打包器改写成**模块体顶层**的 `require`，那一刻抛错会让**整个浏览器半加载失败**
- * （设置页一起没）—— 为了「一颗图标」赔掉整插件，绝不。所以这里：
- *  · 只在**真要画 icon 时**才 require（帧内），
- *  · 拿不到 / 形态不符 / 抛错一律回落一颗**极简的本地 SVG 文件图标**（`fallbackFileGlyph`），
- *    既不打挂任何东西，也不空着。
- * 该包因此不进 bundle：源码里只有 `require` 调用（bundle 白名单在 src/utils/bundle-scan.ts 登记）。
+ * ## 惰取门在 `common/host-primitives.ts`（2026-10-15 抽出）
+ * 那颗「帧内惰取 + try/catch + 三态缓存」的门改为全仓唯一出口（同一份门现在也供聊天气泡的
+ * 正文投影使用）——本文件只保留**两级回落**：外部来源（better-sidebar）→ 宿主 FileTypeIcon
+ * → 本地极简 SVG。为什么不能顶层 import、为什么必须帧内取，见那个文件的头注释。
  */
-import type { ComponentType, ReactNode } from 'react'
+import type { ReactNode } from 'react'
 import { Icon } from '../common/Icon.tsx'
+import { hostFileTypeIcon } from '../common/host-primitives.ts'
 
 /** 装配点注入的「外部图标来源」（dsh-better-sidebar 的 `fileIcon`）；返回 null = 它不认这一条。 */
 export type RollbackFileIconRenderer = (path: string) => ReactNode | null
 
-/** `FileTypeIcon` 我们真的用到的入参面（只声明消费的字段，不复制第三方类型）。 */
-interface DshFileTypeIconProps {
-  path: string
-  size?: number
-  className?: string
-}
-
-/** 惰取结果的三态缓存（undefined = 还没试过；null = 试过了，这台宿主没有）。 */
-let cachedDshFileTypeIcon: ComponentType<DshFileTypeIconProps> | null | undefined
-
-/**
- * 惰取 DSH 自带的 `FileTypeIcon`（**每次进程只试一次**，失败就记 null 不再重试）。
- *
- * 为什么不用 `import()`：动态 import 在 cjs 产物里同样要走模块表，且会把整个包拖进 chunk；
- * 这里的 `require` 是 DSH loader 交给插件工厂的那一个（banner 里 `factory: (require) => {...}`）。
- */
-function dshFileTypeIcon(): ComponentType<DshFileTypeIconProps> | null {
-  if (cachedDshFileTypeIcon !== undefined) return cachedDshFileTypeIcon
-  cachedDshFileTypeIcon = null
-  try {
-    const loaded = (typeof require === 'function' ? require('@deepseek-ai/dsh-client-ui-primitives') : null) as
-      | { FileTypeIcon?: unknown }
-      | null
-    const icon = loaded?.FileTypeIcon
-    if (typeof icon === 'function' || typeof icon === 'object') {
-      cachedDshFileTypeIcon = icon as ComponentType<DshFileTypeIconProps>
-    }
-  } catch {
-    cachedDshFileTypeIcon = null
-  }
-  return cachedDshFileTypeIcon
-}
-
 /**
  * 最后的兜底：共享图标原语的通用「文件」图标（`common/Icon.tsx` 的 `name="file"`）。
  * 只有「没有 better-sidebar + 宿主模块表里没有 ui-primitives」两条同时成立时才会出现 ——
@@ -90,7 +52,7 @@ export function RollbackFileIcon({ path, size = 14, render }: RollbackFileIconPr
     // null / undefined / false = 这一条外部来源接不住 ⇒ 回落 DSH 自带画法（不猜、不空着）
     if (node !== null && node !== undefined && node !== false) return <>{node}</>
   }
-  const Dsh = dshFileTypeIcon()
+  const Dsh = hostFileTypeIcon()
   if (Dsh !== null) return <Dsh path={path} size={size} />
   return fallbackFileGlyph(size)
 }