dsh-config-manager 0.1.72 → 0.1.76

package/src/adapters/plugin-data.ts

@@ -0,0 +1,351 @@
+/**
+ * pluginData / pluginAssets 分区 adapter（第三方插件数据迁移）。
+ *
+ * 数据来源 = \`src/core/plugin-data-registry.ts\` 的来源注册表：内置已取证来源 + 已安装插件在
+ * 自己 package.json 里声明的 \`dsh.dataDirs\`。每个「区域（area）」在备份里是**一个可勾选单元**，
+ * 单元 id = 区域的 home 相对 POSIX 路径（如 \`.dsh-wallpaper-engine/uploads\`）——
+ * 用户能在导出选择器里逐区域看到「几个文件 / 多大」，也能只带走配置、不带几百 MB 的上传壁纸。
+ *
+ * 为什么两个分区而不是一个：
+ *  - \`pluginData\` = 配置与轻量状态；\`pluginAssets\` = 大体积用户数据（上传的壁纸、本地数据库）；
+ *  - 「默认不勾选大资产」在既有 UI 选择模型里**只有分区级开关**这一条可靠通道（单元级只有
+ *    「默认全选 + 稀疏排除」，没有「默认排除」的概念）—— 拆成两个分区后，「可见但默认不勾选」
+ *    就是既有的 \`defaultIncluded=false\` 语义，不需要动共享选择模型，也不会与导入/市场两处选择语义打架。
+ *
+ * 实现：继承 FileCollectionAdapter（baseDir = ''，即 home 根；与 agentInstructions 同一形态），
+ * 复用它的单元分组 / 单分区字节闸门 / 预览-导出一致性 / 幂等哈希比对；只覆写三处：
+ *  ① \`listRelPaths()\` —— 清单来自来源注册表（并如实记录被环境变量覆盖而跳过的区域）；
+ *  ② \`unitIdOf()\` —— 单元 = 区域（最长前缀归属）；
+ *  ③ \`analyzeImport() / applyItem()\` —— **写入路径白名单**（见下）。
+ *
+ * 安全不变量（本分区是全仓唯一「按 home 相对路径任意写」的分区，必须自己守住）：
+ *  - **导入白名单**：只有「本机内置来源的区域」与「本机已安装插件声明的区域」之下的路径才允许写。
+ *    恶意/损坏的包想把 \`.credentials.yaml\` 或 \`AGENTS.md\` 塞进来，在这里被判 Error（计划里可见，
+ *    执行期不写）；applyItem 再查一遍（纵深防御），内层还有基类的 control-plane namespace 拒绝。
+ *  - **缓存永不收录**：role === 'cache' 的区域不属于任何分区，导出时根本不进清单。
+ *  - **环境变量覆盖即跳过**：区域声明的 env 存在且解析结果与默认位置不同 → 报码跳过，绝不猜新位置。
+ *  - **不产生用户可见散文**：告警与计划项文案一律走消息目录（i18n 铁律）。
+ */
+import { normalizePath } from '../utils/paths.ts';
+import { engineMsg } from './messages.ts';
+import { listFilesDetailed } from './link-report.ts';
+import type { RecursiveListing } from '../utils/recursive-walk.ts';
+import { sectionMeta } from '../schema/section-registry.ts';
+import {
+  BUILTIN_PLUGIN_DATA_SOURCES, areaOfPath, areasForSection, isExcludedRel, normalizeHomeRel,
+  parseDeclaredDataDirs,
+} from '../core/plugin-data-registry.ts';
+import type { PluginDataArea, PluginDataSource, PluginDataSection } from '../core/plugin-data-registry.ts';
+import { osHomeDirOf } from '../core/backup.ts';
+import { FileCollectionAdapter } from './file-collection.ts';
+import type { FilesSection } from '../schema/types.ts';
+import type {
+  ApplyResult, ExportOptions, ExportSection, FileSystemFacade, HostContext, ImportContext, PlanItem,
+  SectionPreview,
+} from '../core/types.ts';
+
+/** 区域条目（来源 + 区域），编译期与运行期唯一的区域表示 */
+export type PluginDataEntry = { source: PluginDataSource; area: PluginDataArea };
+
+/** 声明来源缓存的 TTL（毫秒）：一次导出/导入/执行里会多次解析，逐次读 15+ 个 package.json 是净开销 */
+const DECLARED_TTL_MS = 5_000;
+
+/** 单次解析里最多读取多少个已安装插件的 manifest（防御性上限：profile 依赖数量异常时不无限读） */
+const MAX_DECLARED_PACKAGES = 300;
+
+export interface PluginDataAdapterOptions {
+  /** 内置来源（缺省 = BUILTIN_PLUGIN_DATA_SOURCES；测试注入假来源） */
+  readonly sources?: readonly PluginDataSource[];
+  /** 自述声明缓存 TTL；测试可传 0 关闭缓存 */
+  readonly declaredTtlMs?: number;
+  /**
+   * 环境变量快照（缺省 process.env）。
+   *
+   * 为什么走构造参数而不是 HostContext：HostContext 上没有 env（它是宿主门面的集合），
+   * 而「区域被环境变量搬走」这件事必须在**同一次调用**里可判定、可注入测试值 ——
+   * 直接读 process.env 会让单测无法造「被覆盖」的场景（本机若恰好设了该变量，测试还会 flaky）。
+   */
+  readonly env?: Readonly<Record<string, string | undefined>>;
+}
+
+export class PluginDataAdapter extends FileCollectionAdapter {
+  readonly id: PluginDataSection;
+  readonly displayName: string;
+  readonly defaultIncluded = false;
+  readonly portability = 'deviceSpecific' as const;
+  /** home 根（相对路径 = home 相对路径，与 agentInstructions 同形） */
+  readonly baseDir = '';
+
+  private readonly builtin: readonly PluginDataSource[];
+  private readonly declaredTtlMs: number;
+  private readonly env: Readonly<Record<string, string | undefined>>;
+  /**
+   * 自述声明缓存。**必须带 ctx 键**（homeDir + profile）：这台机器装了某插件，不代表另一台装了 ——
+   * 缓存若按实例共享，导入到「没装该插件」的目标机时会拿源机的声明去放行写入，
+   * 白名单就变成了「谁先导入谁说了算」。
+   */
+  private declaredMemo: { key: string; at: number; sources: PluginDataSource[] } | undefined;
+  /** 本轮清单（listRelPaths 写入；unitIdOf 是同步纯函数，只能从这里拿区域表） */
+  private active: readonly PluginDataEntry[] | undefined;
+  /** 本轮告警（环境变量覆盖跳过等；export/preview 收尾合并进返回的 warnings） */
+  private pendingWarnings: string[] = [];
+
+  constructor(section: PluginDataSection, options: PluginDataAdapterOptions = {}) {
+    super();
+    this.id = section;
+    this.displayName = sectionMeta(section).displayName;
+    this.builtin = options.sources ?? BUILTIN_PLUGIN_DATA_SOURCES;
+    this.declaredTtlMs = options.declaredTtlMs ?? DECLARED_TTL_MS;
+    this.env = options.env ?? process.env;
+  }
+
+  /** 本分区可收集区域（内置 + 自述声明） */
+  private async allowedEntries(ctx: HostContext): Promise<readonly PluginDataEntry[]> {
+    const sources = await this.allSources(ctx);
+    return areasForSection(sources, this.id);
+  }
+
+  private async allSources(ctx: HostContext): Promise<readonly PluginDataSource[]> {
+    const declared = await this.declaredSources(ctx);
+    return [...this.builtin, ...declared];
+  }
+
+  /**
+   * 已安装插件的自述声明（dsh.dataDirs）。
+   *
+   * 为什么读 profile 的 node_modules 而不是全局目录：DSH 的插件装在 \`profiles/<profile>/node_modules\`
+   * 下（pnpm 隔离布局），且同一个包在不同 profile 可以是不同版本 —— 声明必须取**本 profile 实际装的**那份。
+   *
+   * 读不到（未安装 / 无声明 / 形状非法）一律跳过：本机制是**附加**信息，绝不因为一个包读不出来
+   * 就影响内置来源或整次导出。
+   */
+  private async declaredSources(ctx: HostContext): Promise<PluginDataSource[]> {
+    const now = Date.now();
+    const profile = ctx.profile !== undefined && ctx.profile !== '' ? ctx.profile : 'web';
+    const memoKey = ctx.homeDir + '|' + profile;
+    if (
+      this.declaredMemo !== undefined
+      && this.declaredMemo.key === memoKey
+      && now - this.declaredMemo.at < this.declaredTtlMs
+    ) {
+      return this.declaredMemo.sources;
+    }
+    const base = 'profiles/' + profile;
+    const out: PluginDataSource[] = [];
+    let deps: string[] = [];
+    try {
+      const raw = await ctx.fs.readFile(base + '/package.json');
+      const parsed: unknown = JSON.parse(new TextDecoder().decode(raw));
+      const dep = (parsed as { dependencies?: unknown } | null)?.dependencies;
+      if (dep !== null && typeof dep === 'object') deps = Object.keys(dep).slice(0, MAX_DECLARED_PACKAGES);
+    } catch {
+      deps = [];
+    }
+    for (const name of deps) {
+      try {
+        const raw = await ctx.fs.readFile(base + '/node_modules/' + name + '/package.json');
+        const manifest: unknown = JSON.parse(new TextDecoder().decode(raw));
+        const source = parseDeclaredDataDirs(name, manifest);
+        if (source !== null) out.push(source);
+      } catch {
+        // 未安装 / 无 manifest → 无声明，跳过
+      }
+    }
+    this.declaredMemo = { key: memoKey, at: now, sources: out };
+    return out;
+  }
+
+  /**
+   * 区域是否被环境变量覆盖（覆盖 → 返回变量名；未覆盖 / 未声明 → null）。
+   *
+   * 判定口径：变量**存在且解析结果与默认位置不同**才算覆盖 —— 仅仅 \`DSH_WE_DATA_DIR=~/.dsh-wallpaper-engine\`
+   * 这种「设成同一个值」的写法不该让区域凭空消失（那会让用户以为「没有数据」）。
+   * 解析只做 \`~\` 展开与分隔符归一（不做 realpath：不读盘、不猜）。
+   */
+  private envOverrideOf(ctx: HostContext, area: PluginDataArea): string | null {
+    for (const name of area.envOverrides ?? []) {
+      const raw = this.env[name];
+      if (raw === undefined || raw.trim() === '') continue;
+      const normalized = raw.trim().replace(/\\/g, '/').replace(/\/+$/, '');
+      // 默认位置以**系统 home** 为根（本分区的根；见 core/backup.ts 的 OS_HOME_FILE_SECTIONS）
+      const home = osHomeDirOf(ctx).replace(/\\/g, '/').replace(/\/+$/, '');
+      const expanded = normalized.startsWith('~/') ? home + normalized.slice(1) : normalized;
+      const defaultAbs = home + '/' + area.relPath;
+      if (expanded !== defaultAbs) return name;
+    }
+    return null;
+  }
+
+  /**
+   * 区域是否是**普通文件**（而不是目录 / 不存在）。
+   *
+   * 判据顺序为什么是这样：`statSize` 对「非普通文件」与「不存在」都返回 null，无法单独区分
+   * 目录与缺失；所以先判「是文件」，其余一律按目录走遍历 —— 目录不存在时遍历返回空，
+   * 结果同样是「没有内容」，不会把缺失误报成文件，也不会把目录误读成空内容而静默丢数据。
+   * 门面未实现 statSize（旧宿主）时退回读一次内容：读得出来就是文件。
+   */
+  private async isRegularFile(fsFacade: FileSystemFacade, rel: string): Promise<boolean> {
+    if (fsFacade.statSize !== undefined) {
+      try {
+        return (await fsFacade.statSize(rel)) !== null;
+      } catch {
+        return false;
+      }
+    }
+    try {
+      await fsFacade.readFile(rel);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  private static emptyListing(): RecursiveListing {
+    return { paths: [], skippedLinks: [], skippedDepDirs: [], followedLinks: 0, unreadableDirs: [] };
+  }
+
+  /**
+   * 清单枚举 = 来源注册表的区域（覆写基类的目录递归；baseDir='' 时基类实现会递归**整个 home**）。
+   *
+   * **必须覆写**：home 根上递归会遍历 profiles/ sessions/ attachments/ 等全部内容（本机实测
+   * 4000+ 文件 / 数百 MB），既慢又会把无关目录当成该分区的「可勾选单元」。
+   */
+  protected override async listRelPaths(ctx: HostContext): Promise<RecursiveListing> {
+    // 本分区的根是**系统 home**（~/.dsh-wallpaper-engine、~/.mnemon …），不是 $DSH_HOME ——
+    // 内容 I/O 一律走 homeFs；宿主没提供就什么都不收集，并如实报码（绝不退回 $DSH_HOME 去读错位置）。
+    const homeFs = ctx.homeFs;
+    if (homeFs === undefined) {
+      this.active = [];
+      this.pendingWarnings = [engineMsg('adapter.pluginDataNoOsHome')];
+      return PluginDataAdapter.emptyListing();
+    }
+    const entries = await this.allowedEntries(ctx);
+    this.active = entries;
+    const warnings: string[] = [];
+    const paths: string[] = [];
+    const listing = PluginDataAdapter.emptyListing();
+    for (const entry of entries) {
+      const rel = entry.area.relPath;
+      const env = this.envOverrideOf(ctx, entry.area);
+      if (env !== null) {
+        warnings.push(engineMsg('adapter.pluginDataEnvOverridden', { path: rel, env }));
+        continue;
+      }
+      if (await this.isRegularFile(homeFs, rel)) {
+        paths.push(rel);
+        continue;
+      }
+      let sub: RecursiveListing;
+      try {
+        sub = await listFilesDetailed(homeFs, rel);
+      } catch {
+        // 目录不存在 / 读不到 → 视为无内容（存在的空目录与缺失在这里同义：都没有文件可带）
+        continue;
+      }
+      listing.skippedLinks.push(...sub.skippedLinks);
+      listing.skippedDepDirs.push(...sub.skippedDepDirs);
+      listing.unreadableDirs.push(...sub.unreadableDirs);
+      listing.followedLinks += sub.followedLinks;
+      for (const p of sub.paths) {
+        if (isExcludedRel(entry.area, p)) continue;
+        paths.push(p);
+      }
+    }
+    listing.paths = paths;
+    this.pendingWarnings = warnings;
+    return listing;
+  }
+
+  /**
+   * 单元 = 区域（最长前缀归属）。
+   *
+   * 用「本轮清单写入的区域表」而不是重新解析：listRelPaths 与本函数在同一次 collect 里成对调用，
+   * 重算会让两次解析结果不一致时出现「单元 id 不在清单里」（选择器勾不上）。测试/异常路径下
+   * \`active\` 可能是 undefined（例如直接调 listUnits），此时退回**内置来源**的最长前缀 —— 与清单口径同源。
+   */
+  protected override unitIdOf(relativePath: string): string {
+    const entries = this.active ?? areasForSection(this.builtin, this.id);
+    const hit = areaOfPath(entries, normalizePath(relativePath));
+    return hit === null ? normalizePath(relativePath) : hit.area.relPath;
+  }
+
+  /**
+   * 读一个成员文件：**换根到系统 home 门面**（基类的其余逻辑 —— 体积、哈希、字节闸门 —— 一字不动）。
+   *
+   * 能走到这里说明 listRelPaths 产出过条目（缺门面时它不产出任何路径），因此缺门面即**抛错**，
+   * 不再造一个「空文件」出来（那会把缺通道伪装成空内容）。
+   */
+  protected override async readMember(
+    ctx: HostContext, rel: string, mode: 'content' | 'size', statTimes?: Map<string, number>,
+  ): Promise<{ data: Uint8Array; sizeBytes: number; contentHash: string }> {
+    const homeFs = ctx.homeFs;
+    if (homeFs === undefined) throw new Error(engineMsg('adapter.pluginDataNoOsHome'));
+    return super.readMember({ ...ctx, fs: homeFs }, rel, mode, statTimes);
+  }
+
+  override async export(ctx: HostContext, options: ExportOptions): Promise<ExportSection<FilesSection>> {
+    this.pendingWarnings = [];
+    const out = await super.export(ctx, options);
+    return { ...out, warnings: [...out.warnings, ...this.pendingWarnings] };
+  }
+
+  override async preview(ctx: HostContext, options: ExportOptions): Promise<SectionPreview<FilesSection>> {
+    this.pendingWarnings = [];
+    const out = await super.preview(ctx, options);
+    return {
+      ...out,
+      section: { ...out.section, warnings: [...out.section.warnings, ...this.pendingWarnings] },
+    };
+  }
+
+  /**
+   * 导入分析 + **写入路径白名单**（本分区唯一的越界防线）。
+   *
+   * 判据：路径必须是本机可解析的某个区域（内置来源，或已安装插件的自述声明）之下，且未被该区域
+   * 的 excludeRel 排除。不满足 → Error（计划里可见、执行期不写），绝不「尽力而为」地写出去。
+   */
+  override async analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]> {
+    // 宿主没有系统 home 门面（旧宿主）→ 白名单为空 + 目标读也换不了根：**全部拒绝**并说明原因。
+    // 绝不退回 $DSH_HOME 的 ctx.fs 去比对/写入（那会落到错误位置）。
+    const homeFs = ctx.target.homeFs;
+    const entries = homeFs === undefined ? [] : await this.allowedEntries(ctx.target);
+    const items = await super.analyzeImport(
+      data,
+      homeFs === undefined ? ctx : { ...ctx, target: { ...ctx.target, fs: homeFs } },
+    );
+    return items.map((item) => {
+      const ref = item.target?.ref;
+      if (ref === undefined) return item;
+      const rel = normalizeHomeRel(ref);
+      if (rel !== null && areaOfPath(entries, rel) !== null) return item;
+      return {
+        id: item.id,
+        ...(item.unitId !== undefined ? { unitId: item.unitId } : {}),
+        kind: 'Error',
+        adapter: this.id,
+        description: engineMsg(
+          homeFs === undefined ? 'adapter.pluginDataNoOsHome' : 'adapter.pluginDataPathNotAllowed',
+          { path: ref },
+        ),
+        severity: 'error',
+      };
+    });
+  }
+
+  /** 应用前再查一遍白名单（纵深防御：plan 可能来自消费者手工构造/缓存反序列化） */
+  override async applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult> {
+    const homeFs = ctx.target.homeFs;
+    if (homeFs === undefined) {
+      return { ok: false, message: engineMsg('adapter.pluginDataNoOsHome') };
+    }
+    const ref = item.target?.ref;
+    if (ref !== undefined) {
+      const rel = normalizeHomeRel(ref);
+      const entries = await this.allowedEntries(ctx.target);
+      if (rel === null || areaOfPath(entries, rel) === null) {
+        return { ok: false, message: engineMsg('adapter.pluginDataPathNotAllowed', { path: ref }) };
+      }
+    }
+    return super.applyItem(item, { ...ctx, target: { ...ctx.target, fs: homeFs } });
+  }
+}

package/src/adapters/self.ts

@@ -42,6 +42,7 @@
  */
 import type { HostContext } from '../core/types.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
+import { sectionMeta } from '../schema/section-registry.ts';
 import { FileCollectionAdapter } from './file-collection.ts';
 
 /** self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。 */
@@ -109,7 +110,7 @@ function canonicalizeWithoutRunState(raw: Uint8Array): Uint8Array | null {
 
 export class SelfAdapter extends FileCollectionAdapter {
   readonly id = 'self' as const;
-  readonly displayName = 'Plugin Self Config';
+  readonly displayName = sectionMeta('self').displayName;
   readonly defaultIncluded = true;
   readonly portability = 'portable' as const;
   /** 插件自身配置目录（相对 homeDir；宿主按 dataDir 解析注入，缺省 dsh-config-manager） */

package/src/adapters/test-helpers.ts

@@ -265,6 +265,20 @@ export class MockHostContext implements HostContext {
   sessions?: HostContext['sessions'];
   /** 可选（issue #71）：技能服务端口；测试按需注入（缺省 = 退回纯目录扫描）。 */
   skills?: HostContext['skills'];
+  /**
+   * 可选（第三方插件数据）：系统 home 与它的文件门面。缺省 undefined = **旧宿主形态**
+   * （pluginData / pluginAssets 不收集也不写入，如实报码）；需要它们的测试自行注入，
+   * 或用 withOsHome() 把系统 home 指向本夹具自己的根。
+   */
+  osHomeDir?: string;
+  homeFs?: HostContext['homeFs'];
+
+  /** 测试助手：把「系统 home」指向本上下文的根（两分区在本夹具里即可直接用） */
+  withOsHome(): this {
+    this.osHomeDir = this.homeDir;
+    this.homeFs = this.fs;
+    return this;
+  }
   constructor(platform: string, homeDir: string, profile?: string) {
     this.platform = platform;
     this.homeDir = homeDir;
@@ -289,6 +303,7 @@ export function makeManifest(platform = 'win32'): Manifest {
       settings: false, ui: false, providers: false, plugins: false, mcp: false, prompts: false,
       skills: false, agentPresets: false, agentInstructions: false, workspaces: false, pluginFiles: false,
       credentialsStatus: false, secrets: false, sessions: false, self: false,
+      pluginData: false, pluginAssets: false,
     },
     security: { containsSecrets: false, encrypted: false, encryption: null },
   };

package/src/client/chat/ChatEntryView.tsx

@@ -22,6 +22,7 @@ import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots
 import type { TranslateNS } from '../client-types.ts'
 import type { RollbackPointPort } from '../../ui/rollback-view.ts'
 import { CopyStateIcon, RefreshIcon } from '../common/Icon.tsx'
+import { isRollbackEntryEnabled, subscribeRollbackEntryEnabled } from '../recovery/rollback-enabled.ts'
 import { copyTextToClipboard } from '../common/clipboard.ts'
 import { RollbackReviewDialog } from './RollbackReviewDialog.tsx'
 import type { RollbackDiffOpenResult } from './rollback-diff-tab.ts'
@@ -29,6 +30,7 @@ import {
   buildChatEntrySafeRow,
   buildChatEntryView,
   chatEntryButtonState,
+  projectChatEntryTextWithHost,
   chatEntryTurnPhase,
   planChatEntryAttachments,
   lookupPointForTurn,
@@ -40,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'
@@ -92,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>
@@ -144,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'>
@@ -158,13 +174,26 @@ 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）。
+ *
+ * 为什么要在组件里订阅而不是把开关当 prop 往下传：入口是**遮蔽宿主渲染器**注册的（无常），
+ * 开关变化时没有任何父级会重渲染它 —— DNS 状态只能靠这条信号推。订阅开销 = 一个 Set 里的回调。
  */
-function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, openChildSession, archiveParentSession, startFreshSession, openDiff, fileIcon }: ChatEntryBodyProps) {
+function useRollbackEntryEnabled(): boolean {
+  const [value, setValue] = useState(() => isRollbackEntryEnabled())
+  useEffect(() => subscribeRollbackEntryEnabled(() => { setValue(isRollbackEntryEnabled()) }), [])
+  return value
+}
+
+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` 驱动。 */
@@ -201,7 +230,9 @@ function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, open
    * 只在「回合已收尾」时才读 —— 收尾未知/未结束的回合注定没有点，不浪费这次请求（按钮此时已如实禁用）。
    * 「用户再次触发」= 重新挂载（切档 / 重进会话）或会话/回合变化 ⇒ 新实例；不需要刷新页面。
    */
-  const canLookup = turn !== null && phase === 'closed' && sessionId !== ''
+  // issue #88：功能关闭时连**查询都不发**（不只是不画按钮）—— 入口收起 = 这一整个入口链路停摆。
+  const entryEnabled = useRollbackEntryEnabled()
+  const canLookup = entryEnabled && turn !== null && phase === 'closed' && sessionId !== ''
   useEffect(() => {
     if (!canLookup || turn === null) return undefined
     const controller = new ChatPointWindowController({
@@ -239,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 (
@@ -252,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}
@@ -284,6 +328,10 @@ function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, open
               2026-10-10 用户第二条要求「回退按钮只有一个 icon 而不是一个按钮」。可见文案退到
               aria-label/title；禁用原因是原生 title 里的一句话（InfoHint 的 Portal 钉在插件设置页
               根节点，聊天区不存在）。按钮始终留在原地（禁用而不是消失）：入口可见性不随判据漂移。 */}
+          {/* 开关**关闭时整颗收起**（issue #88 明确要求「入口收起」，不是置灰）。
+              与上面那条「入口可见性不随判据漂移」不冲突：那说的是**暂时读不到点**这类判据，
+              而这里是「用户把这个功能关了」——此时入口本身就不该存在。 */}
+          {entryEnabled && (
           <button
             type="button"
             className={css.chatActionBtn}
@@ -297,6 +345,7 @@ function ChatEntryBody({ node, sessionId, renderMessageImages, t, rt, port, open
           >
             <RefreshIcon size={13} />
           </button>
+          )}
         </div>
       </div>
       {dialogTurn !== null && (

package/src/client/chat/RollbackDiffTab.tsx

@@ -11,8 +11,10 @@ import { useEffect, useState } from 'react'
 import type { TranslateNS } from '../client-types.ts'
 import type { RollbackFileDiffResult, RollbackPointPort } from '../../ui/rollback-view.ts'
 import { Empty } from '../common/ui.tsx'
-import { parseRollbackDiffAddress } from './rollback-diff-tab.ts'
+import { parseRollbackDiffAddress, rollbackDiffBaseName } from './rollback-diff-tab.ts'
+import { RollbackFileIcon, type RollbackFileIconRenderer } from './RollbackFileIcon.tsx'
 import { RollbackDiffPane, type RollbackDiffState } from '../recovery/RollbackDiffPane.tsx'
+import css from '../config-manager.module.css'
 
 /** 装配点注入面（端口的读差异方法 + recovery 字典）。 */
 export interface RollbackDiffTabInjected {
@@ -57,5 +59,50 @@ export function RollbackDiffTab({ port, rt, useTabInfo }: RollbackDiffTabProps)
     return () => { alive = false }
   }, [port, contentId])
   if (target === null) return <Empty>{rt('rollback.diff.failed')}</Empty>
-  return <RollbackDiffPane state={state} rt={rt} />
+  // 侧栏标签页的空间里没有别处写路径（标签标题会被截断），文件头由差异表自己画；
+  // fill：正文是这一屏的唯一内容 ⇒ 撑满宿主高度（用户 2026-10-14：不要自己再留一道滚动条）
+  return <RollbackDiffPane state={state} rt={rt} title={target.path} fill />
+}
+/** 芯片位的注入面（只有文件类型图标的外部来源）。 */
+export interface RollbackDiffTabTitleInjected {
+  /** 文件类型图标的外部来源（装了 dsh-better-sidebar 时由装配点注入）；缺省回落 DSH 自带的画法。 */
+  fileIcon?: RollbackFileIconRenderer
+}
+
+/** 芯片位的完整 props：注入面 + 侧栏 seat 给的 tab 信息钩子（可能不存在）。 */
+export type RollbackDiffTabTitleProps = RollbackDiffTabTitleInjected & {
+  useTabInfo?: () => { tab?: { title?: unknown; contentId?: unknown } }
+}
+
+/** 从 seat 的 tab 信息钩子里读「宿主给的标题 + 资源地址」（钩子缺失 / 抛错一律当读不到，不猜）。 */
+function readTab(useTabInfo: RollbackDiffTabTitleProps['useTabInfo']): { title: string; contentId: unknown } | null {
+  if (typeof useTabInfo !== 'function') return null
+  try {
+    const tab = useTabInfo()?.tab
+    if (tab === null || tab === undefined) return null
+    return { title: typeof tab.title === 'string' ? tab.title : '', contentId: tab.contentId }
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 右侧栏标签页的**芯片标题**：[文件类型图标] + 文件名（与 DSH 自己的文件标签同一个观感）。
+ *
+ * 为什么要有这个组件：宿主的 tab 类型定义**没有 icon 字段** —— 芯片只由 title 文字画出来，
+ * 芯片内容属于 `sidebar.right.pane.tab.title` 这个 keyed 位（dsh-better-sidebar 的自述注释写明）。
+ * 地址读不出来 / 不是本类型的地址：退回宿主给的那串标题文字，绝不空着、也不自己编一个名字。
+ */
+export function RollbackDiffTabTitle({ fileIcon, useTabInfo }: RollbackDiffTabTitleProps) {
+  const info = readTab(useTabInfo)
+  const target = parseRollbackDiffAddress(info?.contentId)
+  if (target === null) return <>{info?.title ?? ''}</>
+  return (
+    <>
+      <span className={css.rollbackTabIcon} aria-hidden="true">
+        <RollbackFileIcon path={target.path} size={14} render={fileIcon} />
+      </span>
+      {rollbackDiffBaseName(target.path)}
+    </>
+  )
 }