dsh-config-manager 0.1.71 → 0.1.73

package/lib/utils/zip.js

@@ -17,6 +17,7 @@ import path from 'node:path';
 import zlib from 'node:zlib';
 import { parseJsonSafe } from './json.js';
 import { isPathSafe, isSameOrChild } from './paths.js';
+import { utilsMsg } from './messages-utils.js';
 export const DEFAULT_ZIP_SAFETY_LIMITS = {
     maxEntries: 10_000,
     maxTotalBytes: 500 * 1024 * 1024,
@@ -78,7 +79,7 @@ export function assertZipEntryCount(count, limits = {}) {
     const readSideMax = DEFAULT_ZIP_SAFETY_LIMITS.maxEntries;
     const max = Math.min(limits.maxEntries ?? readSideMax, readSideMax, ZIP_MAX_WRITABLE_ENTRIES);
     if (count > max) {
-        throw new ZipSafetyError(`ZIP 条目数 ${count} 超过上限 ${max}（导出上限与读取上限一致；请缩小导出分区范围后重试）`);
+        throw new ZipSafetyError(utilsMsg('utils.zip.entryCountWriteExceeded', { count, max }));
     }
 }
 /* ---------------- 写出侧布局片段（zipToBuffer 与 writeZip 共用，避免两份布局漂移） ----------------
@@ -171,7 +172,7 @@ export function zipToBuffer(entries, limits = {}) {
     const { time, date } = dosDateTime();
     for (const entry of entries) {
         if (!isPathSafe(entry.name)) {
-            throw new ZipSafetyError(`拒绝写入不安全的条目名: ${entry.name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.unsafeEntryNameWrite', { name: entry.name }));
         }
         const nameBuf = Buffer.from(entry.name, 'utf8');
         const data = Buffer.isBuffer(entry.data) ? entry.data : Buffer.from(entry.data);
@@ -206,7 +207,7 @@ export async function writeZip(zipPath, entries, limits = {}) {
     // 先全量校验条目名：不安全的名字在**落任何字节之前**拒绝（与 zipToBuffer 的拒绝顺序一致）
     const prepared = entries.map((entry) => {
         if (!isPathSafe(entry.name))
-            throw new ZipSafetyError(`拒绝写入不安全的条目名: ${entry.name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.unsafeEntryNameWrite', { name: entry.name }));
         return {
             nameBuf: Buffer.from(entry.name, 'utf8'),
             data: Buffer.isBuffer(entry.data) ? entry.data : Buffer.from(entry.data),
@@ -342,11 +343,11 @@ export class ZipArchive {
                 out = zlib.inflateRawSync(raw, { maxOutputLength: this.limits.maxSingleBytes });
             }
             catch (err) {
-                throw new ZipSafetyError(`条目 "${name}" 解压失败: ${err instanceof Error ? err.message : String(err)}`);
+                throw new ZipSafetyError(utilsMsg('utils.zip.entryInflateFailed', { name, reason: err instanceof Error ? err.message : String(err) }));
             }
         }
         else {
-            throw new ZipSafetyError(`条目 "${name}" 使用未知压缩方法 ${meta.method}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.unknownCompression', { name, method: meta.method }));
         }
         return this.accept(name, meta, out);
     }
@@ -372,11 +373,11 @@ export class ZipArchive {
                 out = await inflateRawAsync(raw, this.limits.maxSingleBytes);
             }
             catch (err) {
-                throw new ZipSafetyError(`条目 "${name}" 解压失败: ${err instanceof Error ? err.message : String(err)}`);
+                throw new ZipSafetyError(utilsMsg('utils.zip.entryInflateFailed', { name, reason: err instanceof Error ? err.message : String(err) }));
             }
         }
         else {
-            throw new ZipSafetyError(`条目 "${name}" 使用未知压缩方法 ${meta.method}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.unknownCompression', { name, method: meta.method }));
         }
         return this.accept(name, meta, out);
     }
@@ -384,7 +385,7 @@ export class ZipArchive {
     metaOf(name) {
         const meta = this.metas.find((m) => m.name === name);
         if (!meta)
-            throw new ZipSafetyError(`ZIP 中不存在条目: ${name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.entryMissing', { name }));
         return meta;
     }
     /** 本地文件头校验 + 定位压缩字节区间（越界 → 抛错）。 */
@@ -392,32 +393,32 @@ export class ZipArchive {
         const lhOffset = meta.localOffset;
         const lh = this.buf.subarray(lhOffset, lhOffset + 30);
         if (lh.length < 30 || lh.readUInt32LE(0) !== LOCAL_SIG) {
-            throw new ZipSafetyError(`条目 "${name}" 的本地文件头损坏`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.localHeaderCorrupt', { name }));
         }
         const nameLen = lh.readUInt16LE(26);
         const extraLen = lh.readUInt16LE(28);
         const dataStart = lhOffset + 30 + nameLen + extraLen;
         if (dataStart + meta.compressedSize > this.buf.length) {
-            throw new ZipSafetyError(`条目 "${name}" 数据越界`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.dataOutOfRange', { name }));
         }
         return this.buf.subarray(dataStart, dataStart + meta.compressedSize);
     }
     /** 解压后的验收：尺寸 → CRC32 → 解压总量预算 → 压缩比（zip bomb）。两处解压路径共用同一套判据。 */
     accept(name, meta, out) {
         if (out.length !== meta.uncompressedSize) {
-            throw new ZipSafetyError(`条目 "${name}" 解压尺寸不符（${out.length} ≠ ${meta.uncompressedSize}）`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.sizeMismatch', { name, actual: out.length, expected: meta.uncompressedSize }));
         }
         if (crc32(out) !== meta.crc32) {
-            throw new ZipSafetyError(`条目 "${name}" CRC32 校验失败（ZIP 已损坏）`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.crcMismatch', { name }));
         }
         this.totalUncompressed += out.length;
         if (this.totalUncompressed > this.limits.maxTotalBytes) {
-            throw new ZipSafetyError('ZIP 解压总字节数超过上限');
+            throw new ZipSafetyError(utilsMsg('utils.zip.totalUncompressedExceeded'));
         }
         if (meta.compressedSize > 0) {
             const ratio = out.length / meta.compressedSize;
             if (ratio > this.limits.maxRatio) {
-                throw new ZipSafetyError(`条目 "${name}" 压缩比 ${ratio.toFixed(1)} 超过上限（疑似 zip bomb）`);
+                throw new ZipSafetyError(utilsMsg('utils.zip.ratioExceeded', { name, ratio: ratio.toFixed(1) }));
             }
         }
         return out;
@@ -440,19 +441,19 @@ export function parseZip(buf, limits = {}) {
     const merged = { ...DEFAULT_ZIP_SAFETY_LIMITS, ...limits };
     const b = Buffer.isBuffer(buf) ? buf : Buffer.from(buf);
     if (b.length < 22)
-        throw new ZipSafetyError('不是合法的 ZIP 文件（体积过小）');
+        throw new ZipSafetyError(utilsMsg('utils.zip.tooSmall'));
     const eocdIdx = b.lastIndexOf(EOCD_SIG);
     if (eocdIdx < 0 || eocdIdx + 22 > b.length) {
-        throw new ZipSafetyError('不是合法的 ZIP 文件（缺少中央目录结束记录）');
+        throw new ZipSafetyError(utilsMsg('utils.zip.missingEocd'));
     }
     const totalEntries = b.readUInt16LE(eocdIdx + 10);
     const cdSize = b.readUInt32LE(eocdIdx + 12);
     const cdOffset = b.readUInt32LE(eocdIdx + 16);
     if (cdOffset + cdSize > b.length) {
-        throw new ZipSafetyError('中央目录越界（ZIP 损坏）');
+        throw new ZipSafetyError(utilsMsg('utils.zip.centralDirOutOfRange'));
     }
     if (totalEntries > merged.maxEntries) {
-        throw new ZipSafetyError(`ZIP 条目数 ${totalEntries} 超过上限 ${merged.maxEntries}`);
+        throw new ZipSafetyError(utilsMsg('utils.zip.entryCountReadExceeded', { count: totalEntries, max: merged.maxEntries }));
     }
     const metas = [];
     /** 已见条目名：重复条目会让「按名读取」产生歧义（读取到哪一个取决于遍历顺序） */
@@ -461,9 +462,9 @@ export function parseZip(buf, limits = {}) {
     let compressedTotal = 0;
     for (let i = 0; i < totalEntries; i++) {
         if (pos + 46 > cdOffset + cdSize)
-            throw new ZipSafetyError('中央目录条目越界（ZIP 损坏）');
+            throw new ZipSafetyError(utilsMsg('utils.zip.centralEntryOutOfRange'));
         if (b.readUInt32LE(pos) !== CENTRAL_SIG)
-            throw new ZipSafetyError('中央目录签名损坏');
+            throw new ZipSafetyError(utilsMsg('utils.zip.centralSignatureCorrupt'));
         const method = b.readUInt16LE(pos + 10);
         const crc = b.readUInt32LE(pos + 16);
         const compSize = b.readUInt32LE(pos + 20);
@@ -475,21 +476,21 @@ export function parseZip(buf, limits = {}) {
         const localOffset = b.readUInt32LE(pos + 42);
         const name = b.subarray(pos + 46, pos + 46 + nameLen).toString('utf8');
         if (!isPathSafe(name))
-            throw new ZipSafetyError(`ZIP 条目名不安全: ${name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.unsafeEntryName', { name }));
         // —— 以下三项原属 security/zip-security.ts 的 parseZipHardened，现并入默认解析器 ——
         // （默认值即最严：未注入 parseZipOverride 的调用方不再拿到「弱版」）
         if (seenNames.has(name))
-            throw new ZipSafetyError(`ZIP 条目名重复: ${name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.duplicateEntryName', { name }));
         seenNames.add(name);
         if (((externalAttrs >>> 16) & S_IFMT) === S_IFLNK) {
-            throw new ZipSafetyError(`ZIP 含符号链接条目，已拒绝: ${name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.symlinkEntryRejected', { name }));
         }
         if (localOffset + 30 > b.length) {
-            throw new ZipSafetyError(`条目 "${name}" 本地文件头越界`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.localHeaderOutOfRange', { name }));
         }
         compressedTotal += compSize;
         if (compressedTotal > merged.maxCompressedBytes) {
-            throw new ZipSafetyError('ZIP 压缩数据总量超过上限');
+            throw new ZipSafetyError(utilsMsg('utils.zip.compressedTotalExceeded'));
         }
         metas.push({
             name,
@@ -518,7 +519,7 @@ export async function safeExtract(zipPath, destDir, limits = {}) {
             continue;
         const target = path.join(destDir, ...meta.name.split('/'));
         if (!isSameOrChild(target, destDir)) {
-            throw new ZipSafetyError(`解压目标越界: ${meta.name}`);
+            throw new ZipSafetyError(utilsMsg('utils.zip.extractTargetOutOfRange', { name: meta.name }));
         }
         await fs.mkdir(path.dirname(target), { recursive: true });
         await fs.writeFile(target, archive.readEntry(meta.name));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.1.71",
+  "version": "0.1.73",
   "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",
@@ -99,8 +99,10 @@
     "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.6 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.6 <0.3.0-0",
+    "@deepseek-ai/dsh-commands": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-credentials": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-home-paths": ">=0.1.0-rc.6 <0.3.0-0",
     "@deepseek-ai/dsh-host-plugin-inventory": ">=0.1.0-rc.6 <0.3.0-0",
@@ -125,12 +127,18 @@
     "@deepseek-ai/dsh-client-runtime": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-ui-settings": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-slots": {
       "optional": true
     },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-credentials": {
       "optional": true
     },
@@ -167,8 +175,10 @@
     "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "^0.2.0-rc.2",
     "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-host-plugin-inventory": "^0.1.0-rc.6",

package/src/adapters/agent-instructions.ts

@@ -40,7 +40,7 @@ export class AgentInstructionsAdapter extends FileCollectionAdapter {
    * （单文件代价可忽略，且 `collect` 之后还要读它）。读不到 → 空清单（与「文件不存在 = 空分区」同语义）。
    */
   protected override async listRelPaths(ctx: HostContext): Promise<RecursiveListing> {
-    const empty: RecursiveListing = { paths: [], skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+    const empty: RecursiveListing = { paths: [], skippedLinks: [], skippedDepDirs: [], followedLinks: 0, unreadableDirs: [] };
     const rel = AgentInstructionsAdapter.FILE;
     try {
       if (ctx.fs.statSize !== undefined) {

package/src/adapters/file-collection.test.ts

@@ -152,6 +152,7 @@ test('字节闸门：单元的成员在遍历结果里不连续时同样整块
   ctx.fs.listRecursiveDetailed = async () => ({
     paths: ['skills/a/1.md', 'skills/b/1.md', 'skills/a/2.md'],
     skippedLinks: [],
+    skippedDepDirs: [],
     followedLinks: 0,
     unreadableDirs: [],
   });

package/src/adapters/file-collection.ts

@@ -191,7 +191,7 @@ export abstract class FileCollectionAdapter implements ConfigAdapter<FilesSectio
     // issue #37：用「跟随 junction/符号链接」的遍历，并把跟随/跳过的链接写进告警——
     // 此前链接目录及其全部内容被静默排除，备份仍报成功。
     // 枚举走 listRelPaths 钩子（单文件分区覆写它，避免对 home 根整目录递归）。
-    let listing: RecursiveListing = { paths: [], skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+    let listing: RecursiveListing = { paths: [], skippedLinks: [], skippedDepDirs: [], followedLinks: 0, unreadableDirs: [] };
     try {
       listing = await this.listRelPaths(ctx);
     } catch {

package/src/adapters/files.test.ts

@@ -215,6 +215,7 @@ test('issue #37: skills 导出把「跟随/跳过的链接」写进 warnings（
   src.fs.listRecursiveDetailed = async () => ({
     paths: ['skills/coding.md', 'skills/shared/inner.md'],
     skippedLinks: [{ path: 'skills/broken', reason: 'broken' }],
+    skippedDepDirs: [],
     followedLinks: 1,
     unreadableDirs: [],
   });
@@ -225,6 +226,32 @@ test('issue #37: skills 导出把「跟随/跳过的链接」写进 warnings（
   assert.equal(out.warnings.some((w) => w.includes('skills/broken')), true, '必须点名被跳过的链接');
 });
 
+test('issue #76: skills 导出跳过 node_modules 依赖目录，并在导出报告里说明（不静默）', async () => {
+  const src = makeContext('win32', 'C:\\Users\\alice');
+  await src.fs.writeFile('skills/md2pdf/SKILL.md', Buffer.from('# md2pdf\n', 'utf8'));
+  await src.fs.writeFile('skills/md2pdf/package.json', Buffer.from('{"name":"md2pdf"}\n', 'utf8'));
+  // 宿主枚举已按 issue #76 排除依赖树，并把它带回来（真实 walk 的形态）
+  src.fs.listRecursiveDetailed = async () => ({
+    paths: ['skills/md2pdf/SKILL.md', 'skills/md2pdf/package.json'],
+    skippedLinks: [],
+    skippedDepDirs: [{ path: 'skills/md2pdf/node_modules', files: 11625 }],
+    followedLinks: 0,
+    unreadableDirs: [],
+  });
+
+  const out = await new SkillsAdapter().export(src, { includeSecrets: false });
+  assert.deepEqual(
+    out.data.files.map((f) => f.relativePath).sort(),
+    ['md2pdf/SKILL.md', 'md2pdf/package.json'],
+    '依赖树不得进包，技能本体与 package.json 必须进',
+  );
+  const line = out.warnings.find((w) => w.includes('运行时依赖目录')) ?? '';
+  assert.ok(line.length > 0, '缺依赖目录告警: ' + out.warnings.join(' | '));
+  assert.match(line, /11625 个文件/);
+  assert.match(line, /未进备份/);
+  assert.doesNotMatch(line, /链接/, '依赖目录不是链接问题，措辞不得混淆');
+});
+
 test('agentPresets: 目录 bundle 文件收集与写入（.agent-presets 基准目录）', async () => {
   const src = makeContext('win32', 'C:\\Users\\alice');
   await src.fs.writeFile('.agent-presets/work/agent.cordis.yml', Buffer.from('services:\n  - name: work\n', 'utf8'));

package/src/adapters/index.ts

@@ -22,6 +22,7 @@ import { CredentialsAdapter, type CredentialRefsProvider } from './credentials.t
 import { PluginFilesAdapter } from './plugin-files.ts';
 import { SessionsAdapter } from './sessions.ts';
 import { SelfAdapter } from './self.ts';
+import { PluginDataAdapter } from './plugin-data.ts';
 
 export interface AdapterRegistryOptions {
   /** settings namespace 清单（宿主从 settings.yaml 顶层 key 解析注入；缺省 [] → settings/ui/credentials 为空） */
@@ -64,6 +65,9 @@ export function createAdapters(options: AdapterRegistryOptions = {}): ConfigAdap
     new WorkspacesAdapter(),
     new CredentialsAdapter({ namespaces, refs: options.credentialsRefs }),
     new PluginFilesAdapter(options.pluginFiles, options.pluginFilesDir),
+    // 第三方插件数据（两个分区：配置类 / 大资产类；均 defaultIncluded=false，用户显式勾选）
+    new PluginDataAdapter('pluginData'),
+    new PluginDataAdapter('pluginAssets'),
   ];
   // self 分区：插件自身配置（同步/市场/偏好），portable 默认包含；'' = 不挂载
   if (options.selfDir !== '') {
@@ -77,7 +81,7 @@ export type { NamespaceProvider } from './settings.ts';
 export type { CredentialRefsProvider } from './credentials.ts';
 
 export { SettingsAdapter } from './settings.ts';
-export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, UI_MIGRATION_NOTES } from './ui.ts';
+export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, uiMigrationNotes } from './ui.ts';
 export { ProvidersAdapter, DEFAULT_PROVIDER_NAMESPACES, type ProviderExportEntry, type ProviderExportSection } from './providers.ts';
 export { PluginsAdapter, USER_PATCH_FILE } from './plugins.ts';
 export type { LocalPluginPackHook } from './plugins.ts';
@@ -91,6 +95,7 @@ export { CredentialsAdapter, defaultCredentialRefs } from './credentials.ts';
 export { PluginFilesAdapter, DEFAULT_PLUGIN_FILE_WHITELIST } from './plugin-files.ts';
 export { SessionsAdapter } from './sessions.ts';
 export { SelfAdapter, SELF_CONFIG_FILES } from './self.ts';
+export { PluginDataAdapter, type PluginDataAdapterOptions, type PluginDataEntry } from './plugin-data.ts';
 export { FileCollectionAdapter } from './file-collection.ts';
 /* JSON 分区共享校验骨架（本导出是其接入点）。收敛轨迹：
  *  · t31 抽出骨架，settings / ui / providers / plugins / mcp / prompts / credentials /

package/src/adapters/link-report.test.ts

@@ -8,7 +8,7 @@ import { zhMsg } from '../core/messages.ts';
 import type { FileSystemFacade } from '../core/types.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
 
-const clean: RecursiveListing = { paths: ['skills/a.md'], skippedLinks: [], followedLinks: 0, unreadableDirs: [] };
+const clean: RecursiveListing = { paths: ['skills/a.md'], skippedLinks: [], skippedDepDirs: [], followedLinks: 0, unreadableDirs: [] };
 
 test('linkWarnings：无链接 → 零告警（不制造噪音）', () => {
   assert.deepEqual(linkWarnings(zhMsg, 'Skills', clean), []);
@@ -26,6 +26,7 @@ test('linkWarnings：跳过项按原因归并，给出数量、原因与路径',
   const out = linkWarnings(zhMsg, 'Skills', {
     paths: [],
     followedLinks: 1,
+    skippedDepDirs: [],
     unreadableDirs: [],
     skippedLinks: [
       { path: 'skills/self', reason: 'loop' },
@@ -48,7 +49,7 @@ test('linkWarnings：跳过项按原因归并，给出数量、原因与路径',
 
 test('linkWarnings：目录读取失败也必须告警（其内容同样未进备份）', () => {
   const out = linkWarnings(zhMsg, 'Skills', {
-    paths: [], followedLinks: 0, skippedLinks: [], unreadableDirs: ['skills/locked', 'skills/denied'],
+    paths: [], followedLinks: 0, skippedLinks: [], skippedDepDirs: [], unreadableDirs: ['skills/locked', 'skills/denied'],
   });
   assert.equal(out.length, 1);
   assert.match(out[0]!, /2 个目录读取失败/);
@@ -61,5 +62,24 @@ test('listFilesDetailed：宿主未实现 detailed 时回退到 listRecursive（
   const listing = await listFilesDetailed(fs, 'skills');
   assert.deepEqual(listing.paths, ['skills/x.md']);
   assert.deepEqual(listing.skippedLinks, []);
+  assert.deepEqual(listing.skippedDepDirs, []);
   assert.equal(listing.followedLinks, 0);
 });
+
+test('issue #76：跳过的 node_modules 依赖目录必须告警（点名路径 + 文件数 + 可重建说明）', () => {
+  const out = linkWarnings(zhMsg, 'Skills', {
+    ...clean,
+    skippedDepDirs: [
+      { path: 'skills/md2pdf/node_modules', files: 11625 },
+      { path: 'skills/other/node_modules', files: null },
+    ],
+  });
+  assert.equal(out.length, 1, '汇总成一条，不逐目录刷屏');
+  const line = out[0]!;
+  assert.match(line, /2 个运行时依赖目录/);
+  assert.match(line, /未进备份/);
+  assert.match(line, /skills\/md2pdf\/node_modules/);
+  assert.match(line, /11625 个文件/);
+  assert.match(line, /文件数未统计/, '计数预算耗尽时不得猜一个数（更不得写成 0）');
+  assert.match(line, /重新安装依赖/);
+});

package/src/adapters/link-report.ts

@@ -9,7 +9,9 @@
  */
 import type { FileSystemFacade } from '../core/types.ts';
 import type { MsgFunc } from '../core/messages.ts';
-import type { RecursiveListing, SkippedLink } from '../utils/recursive-walk.ts';
+// t6：注册 adapters 域追加目录（本模块只消费注入的 msg，故只引它的注册副作用）。
+import './messages.ts';
+import type { RecursiveListing, SkippedDepDir, SkippedLink } from '../utils/recursive-walk.ts';
 
 /** 跳过原因 → 消息 key（与 SkippedLink.reason 一一对应，穷尽映射） */
 const REASON_KEY: Record<SkippedLink['reason'], string> = {
@@ -23,10 +25,27 @@ const REASON_KEY: Record<SkippedLink['reason'], string> = {
 /** 单条原因下最多列出的路径数（其余折叠为计数，避免把报告撑爆） */
 const MAX_PATHS_PER_REASON = 5
 
+/**
+ * 被跳过的依赖目录 → 详情片段（路径 + 文件数，issue #76）。
+ *
+ * 文件数是**量级说明**而非完整性判据：计数预算耗尽时如实写「未统计」，绝不猜一个数
+ * （把未知写成 0 会被读成「这个目录是空的」）。
+ */
+function depDirDetail(msg: MsgFunc, dirs: SkippedDepDir[]): string {
+  const shown = dirs.slice(0, MAX_PATHS_PER_REASON).map((dir) => {
+    const files = dir.files === null
+      ? msg('adapter.depsDirFilesUnknown')
+      : msg('adapter.depsDirFiles', { count: String(dir.files) })
+    return msg('adapter.linkDirEntry', { path: dir.path, files })
+  })
+  const more = dirs.length - shown.length
+  return (more > 0 ? [...shown, `(+ ${more})`] : shown).join(', ')
+}
+
 /** 取遍历结果：宿主未实现 listRecursiveDetailed（旧版/测试 mock）时回退，行为与旧版一致。 */
 export async function listFilesDetailed(fs: FileSystemFacade, dir: string): Promise<RecursiveListing> {
   if (fs.listRecursiveDetailed !== undefined) return fs.listRecursiveDetailed(dir)
-  return { paths: await fs.listRecursive(dir), skippedLinks: [], followedLinks: 0, unreadableDirs: [] }
+  return { paths: await fs.listRecursive(dir), skippedLinks: [], skippedDepDirs: [], followedLinks: 0, unreadableDirs: [] }
 }
 
 /** 把遍历结果转成告警行（无链接时返回空数组 —— 不制造噪音）。 */
@@ -45,8 +64,8 @@ export function linkWarnings(msg: MsgFunc, type: string, listing: RecursiveListi
     const detail = [...byReason.entries()].map(([reason, paths]) => {
       const shown = paths.slice(0, MAX_PATHS_PER_REASON).join(', ')
       const more = paths.length > MAX_PATHS_PER_REASON ? ` (+ ${paths.length - MAX_PATHS_PER_REASON})` : ''
-      return `${msg(REASON_KEY[reason])} ${paths.length} 个: ${shown}${more}`
-    }).join('；')
+      return msg('adapter.linkSkipLine', { reason: msg(REASON_KEY[reason]), count: paths.length, paths: shown, more })
+    }).join(msg('adapter.listSeparator'))
     out.push(msg('adapter.linksSkipped', { type, count: String(listing.skippedLinks.length), detail }))
   }
   if (listing.unreadableDirs.length > 0) {
@@ -57,5 +76,11 @@ export function linkWarnings(msg: MsgFunc, type: string, listing: RecursiveListi
       type, count: String(listing.unreadableDirs.length), detail: `${shown}${more}`,
     }))
   }
+  // issue #76：运行时依赖目录整棵跳过（内容未进备份）——与链接/不可读目录同等对待：必须可见，绝不静默。
+  if (listing.skippedDepDirs.length > 0) {
+    out.push(msg('adapter.depsDirsSkipped', {
+      type, count: String(listing.skippedDepDirs.length), detail: depDirDetail(msg, listing.skippedDepDirs),
+    }))
+  }
   return out
 }

package/src/adapters/messages.ts

@@ -0,0 +1,61 @@
+/**
+ * adapters 域（src/adapters/**）的追加消息目录（zh 源 / en 镜像），归 t6 作用域。
+ *
+ * 为什么不在 \`src/core/messages.ts\` 追加：该文件不在本作用域的 inScope 内，且既有 372 键有冻结指纹。
+ * 本模块经 \`registerMessageCatalog\` 注册**追加目录**：engineMsg / makeMsg 的查找顺序是
+ * 「既有目录 → en 下回退既有 zh → 注册目录 → 键名」，所以本域新键只在既有目录未命中时生效，
+ * 不可能遮蔽 core 的既有 adapter.* 键。
+ *
+ * 纪律：zh 值 = 改动前的既有中文文案**逐字原样**；en 为 \`Record<keyof typeof zh, string>\`（缺键即编译错）。
+ * **导入本模块即完成注册**：本域消费面是注入的 ctx.msg（MsgFunc）与 engineMsg，两者都查注册目录。
+ */
+import { engineMsg as engineMsgOf, registerMessageCatalog } from '../core/engine-locale.ts';
+import type { MsgFunc } from '../core/msg-types.ts';
+
+export const zh = {
+  // ---------- 链接 / 依赖目录报告（issue #37 / #76）----------
+  'adapter.linkDirEntry': '{path}（{files}）',
+  'adapter.linkSkipLine': '{reason} {count} 个: {paths}{more}',
+  'adapter.listSeparator': '；',
+  // ---------- pluginFiles / tarball ----------
+  'adapter.pluginFilesCollectDirInvalid': 'pluginFiles collectDir 非法（须为相对 ~/.dsh 根的安全路径）: {dir}',
+  'adapter.tarballRelPathInvalid': '非法 tarball 相对路径: {path}',
+  'adapter.localTarballUnpackFailed': '本地插件 {name} 的 tarball 解包失败，回退原始 spec：{err}',
+  // ---------- prompts 计划项明细 ----------
+  'adapter.promptDiffDetail': '行 {line} current={current} imported={imported}',
+  // ---------- 会话连带失败明细 ----------
+  'adapter.sessionUncoupledNote': '{id}（{reason}）',
+  // ---------- 工作区告警拼接 ----------
+  'adapter.workspaceNotesParen': '（{notes}）',
+  // ---------- localStorage 等 Host 无通道的 UI 状态说明 ----------
+  'adapter.uiLocalStorageTaskBoard': '任务看板数据存于浏览器 localStorage，Host 侧无访问通道，需在目标机器重新配置',
+  'adapter.uiLocalStoragePanel': '面板宽度/折叠状态存于浏览器 localStorage，Host 侧无访问通道，需在目标机器重新配置',
+  'adapter.uiLocalStorageGeneric': '浏览器端 UI 状态无法经 Host API 迁移',
+  // ---------- pluginData / pluginAssets（第三方插件数据迁移） ----------
+  'adapter.pluginDataEnvOverridden': '{path} 的位置被环境变量 {env} 覆盖，本次已跳过（不猜它指向哪里）',
+  'adapter.pluginDataPathNotAllowed': '路径不在第三方插件数据的允许范围内，已拒绝写入: {path}',
+  'adapter.pluginDataNoOsHome': '第三方插件的数据在系统主目录下，但当前宿主没有提供该目录的文件通道（旧版本宿主）：本次不读取也不导入 / third-party plugin data lives under the system home directory, but this host offers no file channel for it (older host): nothing is read or imported this time',
+} as const;
+
+export const en: Record<keyof typeof zh, string> = {
+  'adapter.linkDirEntry': '{path} ({files})',
+  'adapter.linkSkipLine': '{reason} {count} item(s): {paths}{more}',
+  'adapter.listSeparator': '; ',
+  'adapter.pluginFilesCollectDirInvalid': 'pluginFiles collectDir is invalid (must be a safe path relative to the ~/.dsh root): {dir}',
+  'adapter.tarballRelPathInvalid': 'Invalid relative tarball path: {path}',
+  'adapter.localTarballUnpackFailed': 'Failed to unpack the tarball of local plugin {name}; falling back to the original spec: {err}',
+  'adapter.promptDiffDetail': 'line {line} current={current} imported={imported}',
+  'adapter.sessionUncoupledNote': '{id} ({reason})',
+  'adapter.workspaceNotesParen': ' ({notes})',
+  'adapter.uiLocalStorageTaskBoard': 'Task-board data lives in the browser localStorage and the host has no access path; reconfigure it on the target machine',
+  'adapter.uiLocalStoragePanel': 'Panel width/collapsed state lives in the browser localStorage and the host has no access path; reconfigure it on the target machine',
+  'adapter.uiLocalStorageGeneric': 'Browser-side UI state cannot be migrated through the host API',
+  'adapter.pluginDataEnvOverridden': "the location of {path} is overridden by the {env} environment variable; skipped this time (the new location is never guessed)",
+  'adapter.pluginDataPathNotAllowed': 'the path is outside the range allowed for third-party plugin data and was refused: {path}',
+  'adapter.pluginDataNoOsHome': 'third-party plugin data lives under the system home directory, but this host offers no file channel for it (older host): nothing is read or imported this time',
+};
+
+registerMessageCatalog({ id: 'adapters-domain', zh, en });
+
+/** 本域活翻译器（与 core 的 engineMsg 同一实现；导入本模块即完成目录注册）。 */
+export const engineMsg: MsgFunc = engineMsgOf;