dsh-config-manager 0.1.71 → 0.1.73

package/src/client/sync/sync-view.ts

@@ -16,10 +16,14 @@ import type {
 } from './sync-api.ts';
 // 通道枚举的唯一声明处（**零依赖**，可被浏览器半运行时 import）：加一条通道只改这里一处。
 import { SYNC_CHANNELS } from '../../utils/shared-constants.ts';
-import type { SyncKey } from './sync-locales.ts';
+// zh 源目录按**值**引入：本文件的渲染模型（UiT 字典不含 syncflow.* 键）需要为「回滚未完成」
+// 这类 sync 命名空间文案取词；组件可经 syncText 参数注入自己的翻译器（缺省 = zh 源）。
+import { en as syncEnCatalog, zh as syncZhCatalog, type SyncKey } from './sync-locales.ts';
+// 跳过原因码 → 字典键的唯一映射（与同步历史共用；绝不各自维护一份 switch）
+import { skipReasonKey } from './history-model.ts';
 import type { CloudConfigIssueCode } from '../../ui/sync-settings-view.ts';
 import type { S3CompatProvider } from '../../sync/sync-config.ts';
-import { zhUiT, type UiT } from '../../ui/i18n.ts';
+import { currentUiLanguage, type UiT } from '../../ui/i18n.ts';
 
 /* ---------------------------------------------------------------- 私有仓库提示 */
 
@@ -37,7 +41,7 @@ export function needsGitToken(repoUrl: string): boolean {
   return /^https?:\/\//i.test(repoUrl.trim());
 }
 
-export function privateRepoHint(t: UiT = zhUiT): string {
+export function privateRepoHint(t: UiT): string {
   return t('sync.privateRepoHint');
 }
 
@@ -62,14 +66,15 @@ export interface SyncSectionOption {
 /** host 目录（SyncSectionInfo[]）→ UI 勾选项（保留 id 顺序）。
  *  同步分区必为导出目录（DEFAULT_CATEGORIES）的可移植子集：分组/描述从导出目录
  *  补充（单一事实源，与「导出备份·自定义模式」的目录保持一致），未命中 id 兜底。 */
-export function syncSectionOptions(info: readonly SyncSectionInfo[]): SyncSectionOption[] {
+export function syncSectionOptions(info: readonly SyncSectionInfo[], t: UiT): SyncSectionOption[] {
   const meta = new Map(DEFAULT_CATEGORIES.map((c) => [c.id, c]));
   return info.map((s) => {
     const cat = meta.get(s.id);
     return {
       id: s.id,
       label: s.displayName,
-      description: cat?.description ?? '',
+      // 描述是**字典键**（英文界面零中文）：在这里按当前语言解析，渲染层直接显示
+      description: cat !== undefined ? t(cat.descriptionKey) : '',
       group: cat?.group ?? 'general',
       portability: s.portability,
       defaultIncluded: s.defaultIncluded,
@@ -79,7 +84,7 @@ export function syncSectionOptions(info: readonly SyncSectionInfo[]): SyncSectio
 
 /** 高级模式勾选目录 → 按导出分组（EXPORT_GROUPS）投影：与「导出备份·自定义模式」同构，
  *  空分组省略；UI 直接渲染 groupCard。 */
-export function syncSectionGroups(options: readonly SyncSectionOption[]): {
+export function syncSectionGroups(options: readonly SyncSectionOption[], t: UiT): {
   group: ExportGroup;
   label: string;
   note?: string;
@@ -89,7 +94,7 @@ export function syncSectionGroups(options: readonly SyncSectionOption[]): {
     .map((g) => ({
       group: g.id,
       label: g.label,
-      ...(g.note !== undefined ? { note: g.note } : {}),
+      ...(g.noteKey !== undefined ? { note: t(g.noteKey) } : {}),
       items: options.filter((o) => o.group === g.id),
     }))
     .filter((g) => g.items.length > 0);
@@ -167,7 +172,7 @@ export function summarizePullChanges(changes: readonly PullChange[]): PullChange
 }
 
 /** PlanItemKind → 短标签（列表徽章） */
-export function kindLabel(kind: PlanItemKind, t: UiT = zhUiT): string {
+export function kindLabel(kind: PlanItemKind, t: UiT): string {
   switch (kind) {
     case 'Create': return t('sync.kind.create');
     case 'Update': return t('sync.kind.update');
@@ -184,7 +189,7 @@ export function kindLabel(kind: PlanItemKind, t: UiT = zhUiT): string {
 }
 
 /** severity → 短标签 */
-export function severityLabel(severity: PlanItem['severity'], t: UiT = zhUiT): string {
+export function severityLabel(severity: PlanItem['severity'], t: UiT): string {
   switch (severity) {
     case 'error': return t('sync.severity.error');
     case 'warning': return t('sync.severity.warning');
@@ -286,6 +291,26 @@ export function cloudIssueKey(code: string): SyncKey | null {
     : null;
 }
 
+/* ------------------------------------------------ G-34：gist 通道不适合大分区 */
+
+/**
+ * G-34（docs/spec/known-gaps.md）：gist 通道**刻意不做内容寻址外置** —— 一次 GET 把全部
+ * 文件内容取回、单文件内容超限会被截断、文件数还有上限，因此会话这类大分区不适合走 gist。
+ *
+ * 本常量 = 「gist 表单」常驻提示的字典键（组件按它取 sync 字典文案渲染 hint）。
+ */
+export const GIST_LARGE_SECTION_HINT_KEY: SyncKey = 'cloud.gistLargeSectionHint'
+
+/**
+ * 「通道 = gist 且勾选 sessions」时的风险提示键；不满足 → null。
+ *
+ * 只做判定、不渲染、**不改选择器逻辑**（不阻止勾选、不动勾选集合）—— 组件拿到非 null 时
+ * 用 sync 字典渲染一条 warn Banner（复用既有 hint / Banner 机制，不新增设置项与样式）。
+ */
+export function gistSessionsRiskKey(channel: SyncChannel, sections: readonly SectionId[]): SyncKey | null {
+  return channel === 'gist' && sections.includes('sessions') ? 'mode.gistSessionsWarn' : null
+}
+
 /**
  * 按通道构造 `Record<SyncChannel, T>`（缺省值由 `make` 给出）。
  *
@@ -424,10 +449,11 @@ function browserStorage(): Pick<Storage, 'getItem' | 'setItem'> | null {
 
 /* ---------------------------------------------------------------- WebDAV 预设 */
 
-/** 常见 WebDAV 服务器预设：label 展示名 + url 模板（含 <占位> 待用户替换）。 */
+/** 常见 WebDAV 服务器预设：labelKey 展示名键 + url 模板（含 <占位> 待用户替换）。 */
 export interface WebDavPreset {
   id: string;
-  label: string;
+  /** 展示名的**字典键**（sync 命名空间；与 SYNC_CHANNEL_LABEL_KEY / S3_PROVIDER_LABEL_KEY 同口径） */
+  labelKey: SyncKey;
   /** url 模板；可能含 <server>/<user> 占位符，用户需替换为真实地址 */
   url: string;
   /** 是否需要用户替换占位符 */
@@ -436,13 +462,13 @@ export interface WebDavPreset {
 
 /** 内置常见 WebDAV 服务器（预设下拉数据源；第一项为自定义）。 */
 export const WEBDAV_PRESETS: readonly WebDavPreset[] = [
-  { id: 'custom', label: 'Custom URL', url: '', hasPlaceholder: false },
-  { id: 'jianguoyun', label: '坚果云 (Jianguoyun)', url: 'https://dav.jianguoyun.com/dav/', hasPlaceholder: false },
-  { id: 'nextcloud', label: 'Nextcloud', url: 'https://<server>/remote.php/dav/files/<user>/', hasPlaceholder: true },
-  { id: 'owncloud', label: 'ownCloud', url: 'https://<server>/remote.php/dav/files/<user>/', hasPlaceholder: true },
-  { id: 'seafile', label: 'Seafile', url: 'https://<server>/seafdav/', hasPlaceholder: true },
-  { id: 'synology', label: 'Synology NAS (WebDAV)', url: 'https://<nas-ip>:5006/', hasPlaceholder: true },
-  { id: 'box', label: 'Box', url: 'https://dav.box.com/dav/', hasPlaceholder: false },
+  { id: 'custom', labelKey: 'webdav.preset.custom', url: '', hasPlaceholder: false },
+  { id: 'jianguoyun', labelKey: 'webdav.preset.jianguoyun', url: 'https://dav.jianguoyun.com/dav/', hasPlaceholder: false },
+  { id: 'nextcloud', labelKey: 'webdav.preset.nextcloud', url: 'https://<server>/remote.php/dav/files/<user>/', hasPlaceholder: true },
+  { id: 'owncloud', labelKey: 'webdav.preset.owncloud', url: 'https://<server>/remote.php/dav/files/<user>/', hasPlaceholder: true },
+  { id: 'seafile', labelKey: 'webdav.preset.seafile', url: 'https://<server>/seafdav/', hasPlaceholder: true },
+  { id: 'synology', labelKey: 'webdav.preset.synology', url: 'https://<nas-ip>:5006/', hasPlaceholder: true },
+  { id: 'box', labelKey: 'webdav.preset.box', url: 'https://dav.box.com/dav/', hasPlaceholder: false },
 ];
 
 /** 默认预设（自定义）对应的 id。 */
@@ -484,7 +510,7 @@ export interface SyncButtons {
  * - 活动通道远端地址未就绪（remoteReady=false）→ 禁用（无从同步）；
  * - busy 时按钮文案切换为「正在推送/拉取…」（配 Spinner）。
  */
-export function computeSyncButtons(busy: 'sync' | 'push' | 'pull' | 'apply' | 'rollback' | null, remoteReady: boolean, t: UiT = zhUiT): SyncButtons {
+export function computeSyncButtons(busy: 'sync' | 'push' | 'pull' | 'apply' | 'rollback' | null, remoteReady: boolean, t: UiT): SyncButtons {
   const idle = busy === null;
   const enabled = idle && remoteReady;
   return {
@@ -509,7 +535,7 @@ export function computeSyncStatus(
   statusInfo: SyncStatusResponse | null,
   loading: boolean,
   error: string | null,
-  t: UiT = zhUiT,
+  t: UiT,
 ): SyncStatusSummary {
   if (loading) return { kind: 'loading', text: t('sync.statusLoading') };
   if (error !== null) return { kind: 'error', text: error };
@@ -543,7 +569,7 @@ export function formatDateTime(iso: string): string {
 }
 
 /** 上次同步时间的展示文本（'' / undefined = 从未同步） */
-export function formatLastSync(iso: string | undefined, t: UiT = zhUiT): string {
+export function formatLastSync(iso: string | undefined, t: UiT): string {
   if (iso === undefined || iso === '') return t('sync.neverSyncedShort');
   return formatDateTime(iso);
 }
@@ -558,7 +584,7 @@ export interface PushReportView {
 }
 
 /** push 报告 → 渲染模型（ok 头部带快照 id；失败显示引擎 message；分区与告警透传） */
-export function pushReportView(report: SyncPushReport | null, t: UiT = zhUiT): PushReportView | null {
+export function pushReportView(report: SyncPushReport | null, t: UiT): PushReportView | null {
   if (report === null) return null;
   if (!report.ok) {
     return { kind: 'error', headline: report.message ?? t('sync.pushFailed'), sections: report.sections, warnings: report.warnings };
@@ -576,7 +602,8 @@ export function pushReportView(report: SyncPushReport | null, t: UiT = zhUiT): P
 export interface PushPreviewView {
   ok: boolean;
   /** 将推送的分区行（含计数 + 是否相对基线有变化） */
-  rows: { section: string; count: number; changed: boolean }[];
+  /** 分区 id 来自宿主 SyncPushPreviewSection.section（SectionId）——写 string 会让渲染侧被迫转型 */
+  rows: { section: SectionId; count: number; changed: boolean }[];
   /** 变更分区数（要展示「新增/更新 N 个分区」） */
   changedCount: number;
   /** 远端现有快照数（0 = 首次推送创建首个基线） */
@@ -592,7 +619,7 @@ export interface PushPreviewView {
 }
 
 /** push 预览 → 渲染模型（P0-②）：列分区 + 变更计数 + 远端基线提示。 */
-export function pushPreviewView(preview: SyncPushPreview | null, t: UiT = zhUiT): PushPreviewView | null {
+export function pushPreviewView(preview: SyncPushPreview | null, t: UiT): PushPreviewView | null {
   if (preview === null) return null;
   if (!preview.ok) {
     return {
@@ -627,7 +654,7 @@ export interface PullReportView {
 }
 
 /** pull 报告 → 渲染模型（差异预览；empty = 无变更；error = 拉取失败） */
-export function pullReportView(report: SyncPullReport | null, t: UiT = zhUiT): PullReportView | null {
+export function pullReportView(report: SyncPullReport | null, t: UiT): PullReportView | null {
   if (report === null) return null;
   if (!report.ok) {
     return { kind: 'error', headline: report.message ?? t('sync.pullFailed'), summary: null, previewHint: '' };
@@ -677,7 +704,7 @@ export function computeGithubLoginView(
   userCode: string,
   verificationUri: string,
   error: string | null,
-  t: UiT = zhUiT,
+  t: UiT,
 ): GithubLoginView {
   const inFlight = phase === 'starting' || phase === 'waiting' || phase === 'polling';
   let statusText: string;
@@ -716,7 +743,7 @@ export function computeGithubLoginView(
 }
 
 /** 轮询终止态 → 用户可读消息（pending 不是终止态，返回空串；成功/拒绝/过期/错误给出明确文案） */
-export function githubPollMessage(poll: GithubPollResponse, t: UiT = zhUiT): string {
+export function githubPollMessage(poll: GithubPollResponse, t: UiT): string {
   switch (poll.status) {
     case 'success':
       return t('sync.github.pollSuccess');
@@ -895,6 +922,7 @@ export function buildAdoptions(
   items: readonly SyncConfirmItem[],
   adopted: ReadonlyMap<string, boolean>,
   resolutions: ReadonlyMap<string, SyncConflictResolution>,
+  t: UiT,
 ): SyncItemAdoption[] {
   const out: SyncItemAdoption[] = [];
   for (const it of items) {
@@ -903,7 +931,7 @@ export function buildAdoptions(
     if (it.kind === 'Conflict') {
       const resolution = resolutions.get(it.itemId);
       if (resolution === undefined) {
-        throw new Error(`冲突项 ${it.itemId} 必须先选择解决方式（保留当前 / 使用导入）`);
+        throw new Error(t('sync.conflictUnresolved', { id: it.itemId }));
       }
       adoption.resolution = resolution;
     }
@@ -919,7 +947,21 @@ export function buildAdoptions(
  * `ok` 因此仍为 true；用户看到「已导入 N 个分区」就以为全部成功，
  * 而排在插件之后的步骤（凭据写入）根本没执行 —— 真机表现就是「模型列表同步过来了、密钥没进来」。
  */
-export type ApplyItemsViewKind = 'ok' | 'partial' | 'failed' | 'rolledBack';
+export type ApplyItemsViewKind = 'ok' | 'partial' | 'failed' | 'rolledBack' | 'rollbackIncomplete';
+
+/** sync 命名空间的取词器（缺省 = 该字典的 zh 源；组件可注入自己的 t 以本地化）。 */
+export type SyncTextFn = (key: SyncKey, params?: Record<string, unknown>) => string
+// **活**取词器（不是 zh 快照）：sync 命名空间的 zh/en 目录都在手边，按当前语言取词 ——
+// 否则英文界面上「回滚未完成」这类只住在 sync 字典的文案会原样透出中文。
+const defaultSyncText: SyncTextFn = (key, params) => {
+  const raw = (currentUiLanguage() === 'zh' ? syncZhCatalog : syncEnCatalog)[key]
+  if (params === undefined) return raw
+  // 与字典的 {param} 口径一致（缺参原样保留，便于排查）
+  return raw.replace(/\{(\w+)\}/g, (m, name: string) => {
+    const value = params[name]
+    return value === undefined ? m : String(value)
+  })
+}
 
 export interface ApplyItemsView {
   kind: ApplyItemsViewKind;
@@ -930,30 +972,45 @@ export interface ApplyItemsView {
   ineffective: { itemId: string; adapter: string; message?: string }[];
   restoreId: string;
   needsRestart: boolean;
+  /**
+   * 整体回滚是否**完整**（诚实性，2026-10）：`rolledBack=true` 只说明触发了整体回滚，
+   * 不代表每一项都补偿成功（凭据原本存在 → DSH 不可回读，无法自动恢复）。
+   * false 时 kind='rollbackIncomplete' —— **绝不**渲染成「已整体回滚」。
+   * 旧宿主不返回 → 字段缺席（按旧的「已整体回滚」处理，不误报）。
+   */
+  rollbackFull?: boolean;
 }
 
-/** apply-items 执行结果 → 渲染模型（ok / failed / 整体回滚）。 */
+/** apply-items 执行结果 → 渲染模型（ok / partial / failed / 整体回滚 / 回滚未完成）。 */
 export function applyItemsReportView(
   report: ApplyItemsResponse | null,
-  t: UiT = zhUiT,
+  t: UiT,
+  syncText: SyncTextFn = defaultSyncText,
 ): ApplyItemsView | null {
   if (report === null) return null;
   const failedOnly = report.failed.length > 0 && !report.ok;
   // 旧宿主不返回 ineffective → 空数组（按「无未生效项」处理，绝不据此误报部分成功）
   const ineffective = report.ineffective ?? [];
-  const kind: ApplyItemsViewKind = !report.ok && report.rolledBack
-    ? 'rolledBack'
-    : failedOnly
-      ? 'failed'
-      : ineffective.length > 0
-        ? 'partial'
-        : 'ok';
+  const kind: ApplyItemsViewKind = !report.ok && report.rollbackFull === false
+    // 回滚**未完成**优先于「已整体回滚」：半回滚态的配置可能停在中间状态，必须单独成态
+    ? 'rollbackIncomplete'
+    : !report.ok && report.rolledBack
+      ? 'rolledBack'
+      : failedOnly
+        ? 'failed'
+        : ineffective.length > 0
+          ? 'partial'
+          : 'ok';
   const headline = kind === 'ok'
     ? t('sync.importDone', { n: String(report.applied.length) })
     : kind === 'partial'
       // 不用「失败」措辞：这次同步**大部分成功**，只是有 N 项没生效 —— 措辞必须与事实同强度
       ? t('sync.importPartial', { n: String(ineffective.length) })
-      : t('sync.importFailed');
+      // 回滚未完成：UiT 字典没有这个键（'sync.importFailed' 的文案断言「已整体回滚」），
+      // 取 sync 字典的专用文案 —— 措辞与事实同强度，绝不把半回滚说成已回滚
+      : kind === 'rollbackIncomplete'
+        ? syncText('syncflow.importRollbackIncomplete')
+        : t('sync.importFailed');
   return {
     kind,
     headline,
@@ -962,6 +1019,7 @@ export function applyItemsReportView(
     ineffective,
     restoreId: report.restoreId,
     needsRestart: report.needsRestart,
+    ...(report.rollbackFull !== undefined ? { rollbackFull: report.rollbackFull } : {}),
   };
 }
 
@@ -990,7 +1048,7 @@ export function computeAutosyncCountdown(elapsedMs: number, intervalMs: number):
  * 剩余时长 → 可读文案（向上取整，避免出现「0 分钟」；≤0 视为 1 分钟兜底）。
  * 例：4 分钟 →「4 分钟」；90 分钟 →「2 小时」；30 小时 →「2 天」。
  */
-export function formatIntervalDuration(ms: number, t: UiT = zhUiT): string {
+export function formatIntervalDuration(ms: number, t: UiT): string {
   const totalMinutes = Math.max(1, Math.ceil(ms / 60000));
   if (totalMinutes < 60) return t('sync.duration.min', { n: totalMinutes });
   const totalHours = Math.ceil(totalMinutes / 60);
@@ -999,8 +1057,33 @@ export function formatIntervalDuration(ms: number, t: UiT = zhUiT): string {
   return t('sync.duration.day', { n: totalDays });
 }
 
+/**
+ * 自动同步状态行的「本轮跳过原因」明细（issue #79）。
+ *
+ * 为什么单独成行而不是塞进状态徽章：跳过原因可能带数量（远端另有 N 个分区待确认），
+ * 徽章会挤成两行；且用户最需要的信息正是「为什么没同步」——改造前它只进 info 级日志
+ * （默认日志级别 warn），界面完全看不到。
+ *
+ * 未知码回退宿主原串（与同步历史同口径，不吞信息，也绝不渲染裸回调码当文案）。
+ */
+export function autosyncSkipDetail(
+  status: AutosyncStatusResponse,
+  syncText: SyncTextFn = defaultSyncText,
+): string | null {
+  const reason = status.lastRunSkipReason
+  if (reason === undefined || reason === '') return null
+  const key = skipReasonKey(reason)
+  // 未知码：给可读兜底，**绝不**把裸码渲染成文案（历史行保留原串以便排查，状态行只要可读）
+  const label = key === null ? syncText('history.autosyncReasonUnknown') : syncText(key)
+  // 冲突：补一句「远端另有 N 个分区待确认」（数量来自宿主的结构化字段，不是从文案里抠）
+  if (reason === 'conflict' && status.lastRunSkipCount !== undefined && status.lastRunSkipCount > 0) {
+    return syncText('autosync.skipReasonConflictCount', { reason: label, n: String(status.lastRunSkipCount) })
+  }
+  return label
+}
+
 /** 自动同步状态行的可读文案（未运行 / 上次状态 / 连续失败计数）。 */
-export function autosyncStatusText(status: AutosyncStatusResponse, t: UiT = zhUiT): string {
+export function autosyncStatusText(status: AutosyncStatusResponse, t: UiT): string {
   if (status.lastRunAt === undefined || status.lastRunAt === '' || status.lastRunStatus === undefined) {
     return t('sync.autosyncNever');
   }

package/src/core/analyzer.ts

@@ -26,7 +26,7 @@ import type { FilesSection, Manifest, SectionId } from '../schema/types.ts';
 import { loadTombstones, isTombstoned } from '../schema/tombstones.ts';
 import type { Tombstone, TombstoneKind } from '../schema/tombstones.ts';
 import { DEFAULT_SENSITIVE_RELS, restoreVaultFiles } from '../security/vault.ts';
-import { createSnapshot, planItemWritesTarget, resolveFileTarget, resolveFileTargetRel } from './backup.ts';
+import { createSnapshot, fsForSection, planItemWritesTarget, resolveFileTarget, resolveFileTargetRel } from './backup.ts';
 import { isCredentialConfigured } from './credential-status.ts';
 import { rollback } from './rollback.ts';
 import { compatibilityReasons, computeCompatibility } from './validator.ts';
@@ -37,7 +37,7 @@ import {
   ImportNotConfirmedError, ImportUserSkippedError, type ApplyResult, type ConfigAdapter,
   type ExecutedItem, type HostContext, type ImportAnalysis, type ImportContext,
   type ImportDecisions, type ImportPlan, type ImportResult, type PathIssue,
-  type PathMapping, type PlanItem, type SessionFormatProbeResult, type SkippedTombstone,
+  type FileSystemFacade, type PathMapping, type PlanItem, type SessionFormatProbeResult, type SkippedTombstone,
   type Snapshot, type SnapshotStore, type TransactionSnapshotContext,
 } from './types.ts';
 
@@ -953,7 +953,7 @@ export class Analyzer {
         let beforeFp: string | null = null;
         if (Analyzer.fileRelFor(item, importCtx.target.profile) !== null) {
           rel = Analyzer.fileRelFor(item, importCtx.target.profile) as string;
-          beforeFp = await this.fileFp(importCtx, rel);
+          beforeFp = await this.fileFp(importCtx, item);
         }
         beforeFpByItem.set(item.id, beforeFp);
         await sb.recordStep({
@@ -1055,7 +1055,7 @@ export class Analyzer {
           const rel = Analyzer.fileRelFor(item, importCtx.target.profile);
           let afterFp: string | null = null;
           if (rel !== null && outcome.executed.status === 'ok') {
-            afterFp = await this.fileFp(importCtx, rel);
+            afterFp = await this.fileFp(importCtx, item);
           }
           await sb.recordStep({
             id: item.id,
@@ -1382,7 +1382,7 @@ export class Analyzer {
     return planItemWritesTarget(item);
   }
 
-  /** 文件类且可指纹 → 返回 home-relative 目标路径（posix）；否则 null（不可指纹外部项）。
+  /** 文件类且可指纹 → 返回「根相对路径」（journal 的 ref 身份）；否则 null（不可指纹外部项）。
    *  profile 必须传入：plugins 分区的 pnpm-workspace.yaml / patch 文件位于
    *  `profiles/<profile>/` 下，缺了它算出的相对路径不存在 → 指纹恒 null（issue #35）。 */
   private static fileRelFor(item: PlanItem, profile?: string): string | null {
@@ -1392,11 +1392,33 @@ export class Analyzer {
     return resolveFileTargetRel(item.adapter, ref, profile);
   }
 
-  /** 读目标文件算 sha256（home-relative；经 HostContext.fs 使测试 mock 可注入）。失败返回 null。 */
-  private async fileFp(ctx: ImportContext, rel: string): Promise<string | null> {
+  /**
+   * 文件类且可指纹 → 返回「该分区自己的门面 + 绝对路径」。
+   *
+   * 为什么不能只拿 home-relative 路径去读：`pluginData` / `pluginAssets` 的根是**系统 home**
+   * （见 `core/backup.ts` 的 `fsForSection`），用 `ctx.fs` 读会落到 $DSH_HOME 下的错误位置
+   * 或被越界守卫拦下 —— 指纹会静默变成「读不到」，reconcile 因此永远判不出是否已应用。
+   * 宿主未提供该门面 / 路径不可解析 → null（保守：不可证明）。
+   */
+  private static fileTargetFor(
+    ctx: ImportContext, item: PlanItem,
+  ): { fs: FileSystemFacade; abs: string } | null {
+    if (!isFileSection(item.adapter)) return null;
+    const ref = item.target?.ref;
+    if (ref === undefined || ref === '') return null;
+    try {
+      return { fs: fsForSection(ctx.target, item.adapter), abs: resolveFileTarget(ctx.target, item.adapter, ref) };
+    } catch {
+      return null;
+    }
+  }
+
+  /** 读目标文件算 sha256（经该分区自己的门面，测试 mock 可注入）。失败返回 null。 */
+  private async fileFp(ctx: ImportContext, item: PlanItem): Promise<string | null> {
+    const target = Analyzer.fileTargetFor(ctx, item);
+    if (target === null) return null;
     try {
-      const data = await ctx.target.fs.readFile(rel);
-      return sha256Hex(data);
+      return sha256Hex(await target.fs.readFile(target.abs));
     } catch {
       return null;
     }

package/src/core/backup-plan.test.ts

@@ -16,7 +16,8 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import {
-  DEFAULT_BACKUP_SECTIONS, OFFLINE_BACKUP_SECTIONS, OFFLINE_UNAVAILABLE_SECTIONS, OPT_IN_BACKUP_SECTIONS,
+  DEFAULT_BACKUP_SECTIONS, OFFLINE_BACKUP_SECTIONS, OFFLINE_EXCLUDED_SECTIONS, OFFLINE_UNAVAILABLE_SECTIONS,
+  OPT_IN_BACKUP_SECTIONS,
   buildSectionFlags,
 } from './backup-plan.ts';
 import { APPLY_ORDER } from './analyzer.ts';
@@ -105,20 +106,34 @@ test('离线分区清单：注册表所有分区都必须显式归类（可收
   // 「明确不参与离线」：sessions 体量巨大且属用户数据（GUI 侧单独 opt-in）、secrets 无分区载荷
   // （凭据值走独立加密容器）。二者都不在 CLI 离线备份的目标集合内 —— 但必须**显式**列出，
   // 否则新增分区会被静默漏收/漏报。
-  const NOT_OFFLINE_APPLICABLE: readonly SectionId[] = ['sessions', 'secrets'];
+  // pluginData / pluginAssets 也在此列（第三方插件数据的收集依赖 adapter 的来源注册表；
+  // 见 backup-plan.ts 的 OFFLINE_EXCLUDED_SECTIONS —— 直接引用产品常量，避免测试与实现各抄一份）
+  const NOT_OFFLINE_APPLICABLE: readonly SectionId[] = [
+    'sessions', 'secrets', ...OFFLINE_EXCLUDED_SECTIONS,
+  ];
   const classified = new Set<string>([...OFFLINE_BACKUP_SECTIONS, ...OFFLINE_UNAVAILABLE_SECTIONS, ...NOT_OFFLINE_APPLICABLE]);
   assert.deepEqual([...classified].sort(), [...SECTION_IDS].sort(), '新增分区必须在 backup-plan 里显式归类');
 });
 
 /* ------------------------------------------------------------ FILE_BASES */
 
-test('resolveFileTarget：文件类分区都有明确基准目录（除两个 home 根分区外不得落 homeDir 根）', () => {
-  // 只有这两个分区的文件**本来就在** $DSH_HOME 根（AGENTS.md / 插件自有文件白名单）
+test('resolveFileTarget：文件类分区都有明确根（$DSH_HOME 内，或系统 home 根的那两个分区）', () => {
+  // 文件本来就在 $DSH_HOME 根的分区：AGENTS.md / 插件自有文件白名单
   const HOME_ROOT_SECTIONS: readonly SectionId[] = ['agentInstructions', 'pluginFiles'];
-  const ctx = { homeDir: path.join('C:', 'home', '.dsh'), profile: 'web' } as unknown as HostContext;
+  // **系统 home 为根**的分区（第三方插件数据）：$DSH_HOME 之外的第二个根，见 backup.ts 的 fsForSection
+  const OS_HOME_SECTIONS: readonly SectionId[] = ['pluginData', 'pluginAssets'];
+  const ctx = {
+    homeDir: path.join('C:', 'home', '.dsh'),
+    osHomeDir: path.join('C:', 'home'),
+    profile: 'web',
+  } as unknown as HostContext;
   const atHomeRoot = path.join(ctx.homeDir, 'probe.txt');
   for (const id of SECTION_IDS.filter((s) => isFileSection(s))) {
     const target = resolveFileTarget(ctx, id, 'probe.txt');
+    if (OS_HOME_SECTIONS.includes(id)) {
+      assert.equal(target, path.join(ctx.osHomeDir as string, 'probe.txt'), `${id} 的根必须是系统 home`);
+      continue;
+    }
     assert.ok(target.startsWith(ctx.homeDir), `${id} 的目标必须在 homeDir 下: ${target}`);
     if (HOME_ROOT_SECTIONS.includes(id)) {
       assert.equal(target, atHomeRoot, `${id} 是 home 根分区`);
@@ -169,8 +184,36 @@ test('t37 skippedLinks 措辞：普通目录超深不得被描述成「链接」
     assert.match(depthLine, /层级超过上限/, '普通目录超深的原因必须指向层级上限，实际：' + depthLine);
     assert.doesNotMatch(depthLine, /链接未进备份/, '普通目录超深不得被描述成链接问题，实际：' + depthLine);
     assert.match(linkLine, /链接未进备份/, '链接类跳过仍必须是链接措辞，实际：' + linkLine);
+    // issue #76 附带修正：内核返回的已是 homeDir 相对路径，**不得再叠一层分区前缀**（曾打印成 skills/skills/outlink）
+    assert.match(linkLine, /skills\/outlink（/, '路径必须只出现一次且为 homeDir 相对形态，实际：' + linkLine);
+    assert.doesNotMatch(linkLine, /skills\/skills\//, '不得叠加分区前缀（skills/skills/…），实际：' + linkLine);
   } finally {
     await fs.rm(home, { recursive: true, force: true });
     await fs.rm(outside, { recursive: true, force: true });
   }
 });
+
+test('issue #76：离线备份跳过 skills 下的 node_modules，并在 warnings 里说明（真机形态）', async () => {
+  const os = await import('node:os');
+  const { collectBackupEntries } = await import('./backup-plan.ts');
+  const home = await fs.mkdtemp(path.join(os.tmpdir(), 'dcm-bp-deps-'));
+  try {
+    const nm = path.join(home, 'skills', 'md2pdf', 'node_modules', 'marked');
+    await fs.mkdir(nm, { recursive: true });
+    await fs.writeFile(path.join(home, 'skills', 'md2pdf', 'SKILL.md'), 'S');
+    await fs.writeFile(path.join(home, 'skills', 'md2pdf', 'package.json'), '{}');
+    await fs.writeFile(path.join(nm, 'index.js'), 'M');
+    await fs.writeFile(path.join(nm, 'extra.js'), 'M');
+
+    const plan = await collectBackupEntries(home, ['skills']);
+    const names = plan.entries.map((e) => e.name);
+    assert.ok(names.some((n) => n.endsWith('md2pdf/SKILL.md')), '技能本体必须进归档: ' + names.join(','));
+    assert.ok(names.some((n) => n.endsWith('md2pdf/package.json')), 'package.json 必须进归档（目标机据此重建依赖）');
+    assert.deepEqual(names.filter((n) => n.includes('node_modules/')), [], '依赖树不得进归档: ' + names.join(','));
+    const line = plan.warnings.find((w) => w.includes('运行时依赖目录')) ?? '';
+    assert.ok(line.length > 0, '缺依赖目录告警: ' + plan.warnings.join(' | '));
+    assert.match(line, /2 个文件/, '必须报出被跳过的文件数量级');
+  } finally {
+    await fs.rm(home, { recursive: true, force: true });
+  }
+});