dsh-config-manager 0.1.71 → 0.1.73

package/lib/schema/manifest.js

@@ -5,6 +5,7 @@
 import { parseJsonSafe } from '../utils/json.js';
 import { CURRENT_SCHEMA_VERSION } from './versions.js';
 import { SECTION_IDS } from './config.js';
+import { schemaMsg } from './messages.js';
 export const MANIFEST_FILE = 'manifest.json';
 export const CHECKSUMS_FILE = 'integrity/checksums.json';
 export const EXPORTER_NAME = 'DSH Config Manager';
@@ -38,7 +39,7 @@ export function parseManifest(raw) {
     const issues = validateManifest(parsed);
     const errors = issues.filter((i) => i.severity === 'error');
     if (errors.length > 0) {
-        throw new Error(`manifest.json 无效: ${errors.map((e) => e.message).join('; ')}`);
+        throw new Error(schemaMsg('schema.manifestInvalid', { issues: errors.map((e) => e.message).join('; ') }));
     }
     return parsed;
 }
@@ -46,63 +47,63 @@ export function parseManifest(raw) {
 export function validateManifest(m) {
     const issues = [];
     if (m === null || typeof m !== 'object') {
-        return [{ path: '$', message: 'manifest 必须是对象', severity: 'error' }];
+        return [{ path: '$', message: schemaMsg('schema.manifestMustBeObject'), severity: 'error' }];
     }
     const obj = m;
     if (typeof obj['schemaVersion'] !== 'number') {
-        issues.push({ path: 'schemaVersion', message: 'schemaVersion 必须是数字', severity: 'error' });
+        issues.push({ path: 'schemaVersion', message: schemaMsg('schema.schemaVersionMustBeNumber'), severity: 'error' });
     }
     const exporter = obj['exporter'];
     if (!exporter || typeof exporter !== 'object') {
-        issues.push({ path: 'exporter', message: 'exporter 缺失', severity: 'error' });
+        issues.push({ path: 'exporter', message: schemaMsg('schema.exporterMissing'), severity: 'error' });
     }
     else {
         if (typeof exporter['name'] !== 'string')
-            issues.push({ path: 'exporter.name', message: 'exporter.name 必须是字符串', severity: 'error' });
+            issues.push({ path: 'exporter.name', message: schemaMsg('schema.exporterNameMustBeString'), severity: 'error' });
         if (typeof exporter['version'] !== 'string')
-            issues.push({ path: 'exporter.version', message: 'exporter.version 必须是字符串', severity: 'error' });
+            issues.push({ path: 'exporter.version', message: schemaMsg('schema.exporterVersionMustBeString'), severity: 'error' });
     }
     const source = obj['source'];
     if (!source || typeof source !== 'object') {
-        issues.push({ path: 'source', message: 'source 缺失', severity: 'error' });
+        issues.push({ path: 'source', message: schemaMsg('schema.sourceMissing'), severity: 'error' });
     }
     else {
         if (typeof source['dshVersion'] !== 'string')
-            issues.push({ path: 'source.dshVersion', message: 'source.dshVersion 必须是字符串', severity: 'error' });
+            issues.push({ path: 'source.dshVersion', message: schemaMsg('schema.sourceDshVersionMustBeString'), severity: 'error' });
         if (typeof source['platform'] !== 'string')
-            issues.push({ path: 'source.platform', message: 'source.platform 必须是字符串', severity: 'error' });
+            issues.push({ path: 'source.platform', message: schemaMsg('schema.sourcePlatformMustBeString'), severity: 'error' });
         if (typeof source['arch'] !== 'string')
-            issues.push({ path: 'source.arch', message: 'source.arch 必须是字符串', severity: 'error' });
+            issues.push({ path: 'source.arch', message: schemaMsg('schema.sourceArchMustBeString'), severity: 'error' });
     }
     if (typeof obj['exportedAt'] !== 'string' || Number.isNaN(Date.parse(obj['exportedAt']))) {
-        issues.push({ path: 'exportedAt', message: 'exportedAt 必须是合法 ISO-8601 时间', severity: 'error' });
+        issues.push({ path: 'exportedAt', message: schemaMsg('schema.exportedAtInvalid'), severity: 'error' });
     }
     const sections = obj['sections'];
     if (!sections || typeof sections !== 'object') {
-        issues.push({ path: 'sections', message: 'sections 缺失', severity: 'error' });
+        issues.push({ path: 'sections', message: schemaMsg('schema.sectionsMissing'), severity: 'error' });
     }
     else {
         for (const key of Object.keys(sections)) {
             if (!SECTION_IDS.includes(key)) {
-                issues.push({ path: `sections.${key}`, message: `未知分区 "${key}"`, severity: 'warning' });
+                issues.push({ path: `sections.${key}`, message: schemaMsg('schema.unknownSection', { section: key }), severity: 'warning' });
             }
             if (typeof sections[key] !== 'boolean') {
-                issues.push({ path: `sections.${key}`, message: `sections.${key} 必须是布尔`, severity: 'error' });
+                issues.push({ path: `sections.${key}`, message: schemaMsg('schema.sectionFlagMustBeBoolean', { section: key }), severity: 'error' });
             }
         }
     }
     const security = obj['security'];
     if (!security || typeof security !== 'object') {
-        issues.push({ path: 'security', message: 'security 缺失', severity: 'error' });
+        issues.push({ path: 'security', message: schemaMsg('schema.securityMissing'), severity: 'error' });
     }
     else {
         if (typeof security['containsSecrets'] !== 'boolean')
-            issues.push({ path: 'security.containsSecrets', message: 'containsSecrets 必须是布尔', severity: 'error' });
+            issues.push({ path: 'security.containsSecrets', message: schemaMsg('schema.containsSecretsMustBeBoolean'), severity: 'error' });
         if (typeof security['encrypted'] !== 'boolean')
-            issues.push({ path: 'security.encrypted', message: 'encrypted 必须是布尔', severity: 'error' });
+            issues.push({ path: 'security.encrypted', message: schemaMsg('schema.encryptedMustBeBoolean'), severity: 'error' });
         const enc = security['encryption'];
         if (enc !== null && (typeof enc !== 'object' || enc === undefined)) {
-            issues.push({ path: 'security.encryption', message: 'encryption 必须是对象或 null', severity: 'error' });
+            issues.push({ path: 'security.encryption', message: schemaMsg('schema.encryptionMustBeObjectOrNull'), severity: 'error' });
         }
     }
     return issues;

package/lib/schema/messages.d.ts

@@ -0,0 +1,47 @@
+import type { MsgParams } from '../core/msg-types.ts';
+export declare const zh: {
+    readonly 'schema.sectionDataInvalid': '分区 {section} 数据无效: {issues}';
+    readonly 'schema.sectionDataMustBeObject': '分区 {section} 数据必须是对象';
+    readonly 'schema.sectionUnregistered': '未注册分区 {section}：拒绝校验（新增分区须在 schema/section-registry.ts 注册）';
+    readonly 'schema.namespacesMissing': '分区 {section} 缺少 namespaces 对象';
+    readonly 'schema.namespaceRecordMustBeObject': 'namespace 记录必须是对象';
+    readonly 'schema.revisionMustBeNumber': 'revision 必须是数字';
+    readonly 'schema.valueMissing': '缺少 value';
+    readonly 'schema.secretsMustBeArray': 'secrets 必须是数组';
+    readonly 'schema.objectMissing': '缺少 {key} 对象';
+    readonly 'schema.keyMustBeArray': '{key} 必须是数组';
+    readonly 'schema.patchFileEntryMustBeObject': 'patch 文件条目必须是对象';
+    readonly 'schema.patchFilePathUnsafe': 'patch 文件路径必须是安全的相对路径（不得为绝对路径或含 ..）';
+    readonly 'schema.patchFileContentMustBeBase64': 'patch 文件内容必须是 base64 字符串';
+    readonly 'schema.fileEntryMustBeObject': '文件条目必须是对象';
+    readonly 'schema.filePathUnsafe': '文件路径必须是安全的相对路径（不得为绝对路径或含 ..）';
+    readonly 'schema.sectionNoJsonPayload': '分区 {section} 无 JSON 载荷（凭据值走独立加密容器，不参与分区 JSON 校验）';
+    readonly 'schema.unhandledPayloadKind': '未处理的分区载荷形态 {payload}';
+    readonly 'schema.manifestInvalid': 'manifest.json 无效: {issues}';
+    readonly 'schema.manifestMustBeObject': 'manifest 必须是对象';
+    readonly 'schema.schemaVersionMustBeNumber': 'schemaVersion 必须是数字';
+    readonly 'schema.exporterMissing': 'exporter 缺失';
+    readonly 'schema.exporterNameMustBeString': 'exporter.name 必须是字符串';
+    readonly 'schema.exporterVersionMustBeString': 'exporter.version 必须是字符串';
+    readonly 'schema.sourceMissing': 'source 缺失';
+    readonly 'schema.sourceDshVersionMustBeString': 'source.dshVersion 必须是字符串';
+    readonly 'schema.sourcePlatformMustBeString': 'source.platform 必须是字符串';
+    readonly 'schema.sourceArchMustBeString': 'source.arch 必须是字符串';
+    readonly 'schema.exportedAtInvalid': 'exportedAt 必须是合法 ISO-8601 时间';
+    readonly 'schema.sectionsMissing': 'sections 缺失';
+    readonly 'schema.unknownSection': '未知分区 "{section}"';
+    readonly 'schema.sectionFlagMustBeBoolean': 'sections.{section} 必须是布尔';
+    readonly 'schema.securityMissing': 'security 缺失';
+    readonly 'schema.containsSecretsMustBeBoolean': 'containsSecrets 必须是布尔';
+    readonly 'schema.encryptedMustBeBoolean': 'encrypted 必须是布尔';
+    readonly 'schema.encryptionMustBeObjectOrNull': 'encryption 必须是对象或 null';
+    readonly 'schema.versionTooNew': 'schema v{version}（高于当前 {current}，需升级插件）';
+    readonly 'schema.versionNeedsMigration': 'schema v{version}（旧版，将迁移到 v{current}）';
+    readonly 'schema.versionCurrent': 'schema v{version}（当前版本）';
+    readonly 'schema.versionBelowMinimum': 'schema v{version}（低于最低支持 {minimum}，不受支持）';
+    readonly 'schema.sectionDataVersionMismatch': '分区 {section} 的 version 必须为 {expected}（收到 {actual}）';
+    readonly 'schema.sectionNotRegistered': '未注册分区「{section}」：拒绝按其它分区语义处理；新增分区必须在 src/schema/section-registry.ts 注册';
+};
+export declare const en: Record<keyof typeof zh, string>;
+/** 本域翻译器：key 受目录约束（拼错键 = 编译错误），语言按 engineMsg 的活语言解析。 */
+export declare function schemaMsg(key: keyof typeof zh, params?: MsgParams): string;

package/lib/schema/messages.js

@@ -0,0 +1,110 @@
+/**
+ * schema 层的领域消息目录（zh 源 / en 镜像）—— 经 engineMsg 取「调用期」语言文案。
+ *
+ * 为什么是本域独立目录：src/schema/** 的写作用域不含 src/core/messages.ts（既有键有冻结指纹），
+ * 所以本域的键用 registerMessageCatalog 在**模块加载时**注册进引擎目录，查找顺序见
+ * src/core/engine-locale.ts（基础目录 → 注册目录 → 键名）。
+ *
+ * 纪律（与 src/core/messages.ts 同口径）：
+ *  - zh 值 = 迁移前的既有中文文案**逐字不变**（既有测试断言依赖）；
+ *  - en 类型为 Record<keyof typeof zh, string> —— 缺键/多键即编译错误；
+ *  - {param} 插值与缺参保留由 engineMsg 负责；
+ *  - 只追加键，不改既有键。
+ */
+import { engineMsg, registerMessageCatalog } from '../core/engine-locale.js';
+export const zh = {
+    // ---------- 分区 JSON 结构校验（config.ts） ----------
+    'schema.sectionDataInvalid': '分区 {section} 数据无效: {issues}',
+    'schema.sectionDataMustBeObject': '分区 {section} 数据必须是对象',
+    'schema.sectionUnregistered': '未注册分区 {section}：拒绝校验（新增分区须在 schema/section-registry.ts 注册）',
+    'schema.namespacesMissing': '分区 {section} 缺少 namespaces 对象',
+    'schema.namespaceRecordMustBeObject': 'namespace 记录必须是对象',
+    'schema.revisionMustBeNumber': 'revision 必须是数字',
+    'schema.valueMissing': '缺少 value',
+    'schema.secretsMustBeArray': 'secrets 必须是数组',
+    'schema.objectMissing': '缺少 {key} 对象',
+    'schema.keyMustBeArray': '{key} 必须是数组',
+    'schema.patchFileEntryMustBeObject': 'patch 文件条目必须是对象',
+    'schema.patchFilePathUnsafe': 'patch 文件路径必须是安全的相对路径（不得为绝对路径或含 ..）',
+    'schema.patchFileContentMustBeBase64': 'patch 文件内容必须是 base64 字符串',
+    'schema.fileEntryMustBeObject': '文件条目必须是对象',
+    'schema.filePathUnsafe': '文件路径必须是安全的相对路径（不得为绝对路径或含 ..）',
+    'schema.sectionNoJsonPayload': '分区 {section} 无 JSON 载荷（凭据值走独立加密容器，不参与分区 JSON 校验）',
+    'schema.unhandledPayloadKind': '未处理的分区载荷形态 {payload}',
+    // ---------- manifest 结构校验（manifest.ts） ----------
+    'schema.manifestInvalid': 'manifest.json 无效: {issues}',
+    'schema.manifestMustBeObject': 'manifest 必须是对象',
+    'schema.schemaVersionMustBeNumber': 'schemaVersion 必须是数字',
+    'schema.exporterMissing': 'exporter 缺失',
+    'schema.exporterNameMustBeString': 'exporter.name 必须是字符串',
+    'schema.exporterVersionMustBeString': 'exporter.version 必须是字符串',
+    'schema.sourceMissing': 'source 缺失',
+    'schema.sourceDshVersionMustBeString': 'source.dshVersion 必须是字符串',
+    'schema.sourcePlatformMustBeString': 'source.platform 必须是字符串',
+    'schema.sourceArchMustBeString': 'source.arch 必须是字符串',
+    'schema.exportedAtInvalid': 'exportedAt 必须是合法 ISO-8601 时间',
+    'schema.sectionsMissing': 'sections 缺失',
+    'schema.unknownSection': '未知分区 "{section}"',
+    'schema.sectionFlagMustBeBoolean': 'sections.{section} 必须是布尔',
+    'schema.securityMissing': 'security 缺失',
+    'schema.containsSecretsMustBeBoolean': 'containsSecrets 必须是布尔',
+    'schema.encryptedMustBeBoolean': 'encrypted 必须是布尔',
+    'schema.encryptionMustBeObjectOrNull': 'encryption 必须是对象或 null',
+    // ---------- 版本描述（versions.ts） ----------
+    'schema.versionTooNew': 'schema v{version}（高于当前 {current}，需升级插件）',
+    'schema.versionNeedsMigration': 'schema v{version}（旧版，将迁移到 v{current}）',
+    'schema.versionCurrent': 'schema v{version}（当前版本）',
+    'schema.versionBelowMinimum': 'schema v{version}（低于最低支持 {minimum}，不受支持）',
+    'schema.sectionDataVersionMismatch': '分区 {section} 的 version 必须为 {expected}（收到 {actual}）',
+    // ---------- 分区注册表（section-registry.ts） ----------
+    'schema.sectionNotRegistered': '未注册分区「{section}」：拒绝按其它分区语义处理；新增分区必须在 src/schema/section-registry.ts 注册',
+};
+export const en = {
+    'schema.sectionDataInvalid': 'Section {section} has invalid data: {issues}',
+    'schema.sectionDataMustBeObject': 'Section {section} data must be an object',
+    'schema.sectionUnregistered': 'Unregistered section {section}: refusing validation (register new sections in schema/section-registry.ts)',
+    'schema.namespacesMissing': 'Section {section} is missing the namespaces object',
+    'schema.namespaceRecordMustBeObject': 'Namespace record must be an object',
+    'schema.revisionMustBeNumber': 'revision must be a number',
+    'schema.valueMissing': 'missing value',
+    'schema.secretsMustBeArray': 'secrets must be an array',
+    'schema.objectMissing': 'missing {key} object',
+    'schema.keyMustBeArray': '{key} must be an array',
+    'schema.patchFileEntryMustBeObject': 'patch file entry must be an object',
+    'schema.patchFilePathUnsafe': 'patch file path must be a safe relative path (no absolute paths, no ..)',
+    'schema.patchFileContentMustBeBase64': 'patch file content must be a base64 string',
+    'schema.fileEntryMustBeObject': 'file entry must be an object',
+    'schema.filePathUnsafe': 'file path must be a safe relative path (no absolute paths, no ..)',
+    'schema.sectionNoJsonPayload': 'Section {section} has no JSON payload (credential values use a separate encrypted container and are not part of section JSON validation)',
+    'schema.unhandledPayloadKind': 'Unhandled section payload kind {payload}',
+    'schema.manifestInvalid': 'manifest.json is invalid: {issues}',
+    'schema.manifestMustBeObject': 'manifest must be an object',
+    'schema.schemaVersionMustBeNumber': 'schemaVersion must be a number',
+    'schema.exporterMissing': 'exporter is missing',
+    'schema.exporterNameMustBeString': 'exporter.name must be a string',
+    'schema.exporterVersionMustBeString': 'exporter.version must be a string',
+    'schema.sourceMissing': 'source is missing',
+    'schema.sourceDshVersionMustBeString': 'source.dshVersion must be a string',
+    'schema.sourcePlatformMustBeString': 'source.platform must be a string',
+    'schema.sourceArchMustBeString': 'source.arch must be a string',
+    'schema.exportedAtInvalid': 'exportedAt must be a valid ISO-8601 time',
+    'schema.sectionsMissing': 'sections is missing',
+    'schema.unknownSection': 'Unknown section "{section}"',
+    'schema.sectionFlagMustBeBoolean': 'sections.{section} must be a boolean',
+    'schema.securityMissing': 'security is missing',
+    'schema.containsSecretsMustBeBoolean': 'containsSecrets must be a boolean',
+    'schema.encryptedMustBeBoolean': 'encrypted must be a boolean',
+    'schema.encryptionMustBeObjectOrNull': 'encryption must be an object or null',
+    'schema.versionTooNew': 'schema v{version} (newer than the current {current}; update the plugin)',
+    'schema.versionNeedsMigration': 'schema v{version} (old version, will be migrated to v{current})',
+    'schema.versionCurrent': 'schema v{version} (current version)',
+    'schema.versionBelowMinimum': 'schema v{version} (below the minimum supported {minimum}; unsupported)',
+    'schema.sectionDataVersionMismatch': 'Section {section} version must be {expected} (got {actual})',
+    'schema.sectionNotRegistered': 'Unregistered section "{section}": refusing to treat it as another section; new sections must be registered in src/schema/section-registry.ts',
+};
+registerMessageCatalog({ id: 'schema', zh, en });
+/** 本域翻译器：key 受目录约束（拼错键 = 编译错误），语言按 engineMsg 的活语言解析。 */
+export function schemaMsg(key, params) {
+    return engineMsg(key, params);
+}
+//# sourceMappingURL=messages.js.map

package/lib/schema/section-registry.d.ts

@@ -16,7 +16,7 @@
  *        此前写死的注册表锚点已与实测不符、复核后纠正；实测命令见下）：
  *        - `schema/section-registry.ts` 的 `SECTION_REGISTRY: Record<SectionId, SectionMeta>`（报错落在该声明处）——
  *          缺 id → TS2741；该条目需逐项填 displayName / group / payload（zipPath 或 filePrefix）/ dataVersion /
- *          applyOrder / portability / optInSync / defaultIncluded / **riskTier** / **configSnapshot**；
+ *          applyOrder / portability / syncOptIn / defaultIncluded / **riskTier** / **configSnapshot**；
  *        - `core/backup.ts` 的 `const unhandled: never = target.adapter` 穷尽 switch → TS2322；
  *        - `client/common/section-labels.ts` 的 `SECTION_LABEL_KEY: Record<SectionId, ConfigManagerKey>` i18n 标签 → TS2741；
  *        - `ui/export-flow.ts` 的 `CATEGORY_DESCRIPTIONS: Record<Exclude<SectionId,'secrets'>, string>` → TS2741；
@@ -42,8 +42,10 @@
  *     `PORTABLE_SECTION_IDS` / … / sync/risk.ts 的 `SECTION_RISK_TIER`）；
  *     同一事实只允许存在一份字面量（载荷版本收敛为 `SECTION_DATA_VERSION`，
  *     风险分级收敛为各条目的 `riskTier`）；
- *  e. **未注册分区不静默**：`sectionMetaOf` / `requireSectionMeta` 让运行期拿到未注册 id 时
- *     显式失败（`validateSectionData` 已按此实现），绝不落到某个 default 分支按其它分区语义处理
+ *  e. **未注册分区不静默**：`sectionMetaOf`（本文件）与 `requireSectionMeta`（t7 起迁到
+ *     `config.ts` —— 用户可见文案必须走消息目录，而本文件受「只 import 一个类型」的零依赖铁律约束）
+ *     让运行期拿到未注册 id 时显式失败（`validateSectionData` 已按此实现），
+ *     绝不落到某个 default 分支按其它分区语义处理
  *     （历史缺陷在 `core/backup.ts` 的 `engineSnapshotEntry` default 分支；
  *     修复与回归用例见 `core/config-snapshot.ts:430` 附近与 `core/config-snapshot.test.ts`）。
  *
@@ -51,13 +53,15 @@
  *  - 需要「分区集合」→ `SECTION_IDS`（按 applyOrder 升序，与历史数组逐项一致）；
  *  - 需要 ZIP 路径 → `jsonPathOf(id)`（null = 该分区无 JSON 载荷）或 `SECTION_JSON_PATHS`；
  *  - 需要文件类目录前缀 → `filePrefixOf(id)`（null = 非文件类）或 `SECTION_FILE_PREFIXES`；
- *  - 需要 portability → `sectionMeta(id).portability`；需要同步可选分区 → `OPT_IN_SYNC_SECTION_IDS`；
+ *  - 需要 portability → `sectionMeta(id).portability`；需要同步可选分区 → `OPT_IN_SYNC_SECTION_IDS`
+ *    （其中允许自动同步的子集 → `AUTO_SYNC_OPT_IN_SECTION_IDS`）；
  *  - 需要「快速导出默认勾选」→ `DEFAULT_INCLUDED_SECTION_IDS`；
  *  - 需要灾备（配置状态快照）采集口径 → `CONFIG_SNAPSHOT_SECTION_IDS`；
  *  - 需要风险等级 → `sectionMeta(id).riskTier`（sync 侧经 `riskTierOf(id)`；未注册 → undefined → 待审）；
  *  - 需要校验分区载荷 version → `versions.ts` 的 `isSupportedSectionDataVersion` /
  *    `sectionDataVersionIssue`（唯一校验函数），或直接比对 `sectionMeta(id).dataVersion`；
- *  - 需要「拿不到就显式报错」→ `requireSectionMeta(id)`（throw）/ `sectionMetaOf(value)`（null）。
+ *  - 需要「拿不到就显式报错」→ `requireSectionMeta(id)`（throw；t7 起由 `config.ts` 导出）/
+ *    `sectionMetaOf(value)`（null）。
  *
  * 注意：本模块的分区 id 联合仍在 `types.ts`（保持对既有 import 路径零破坏）；本文件只依赖它的类型。
  */
@@ -70,6 +74,12 @@ export type SectionPortability = 'portable' | 'deviceSpecific' | 'platformSpecif
  * 这是**产品决策**，因此与其它分区事实一样必须逐分区显式表态（t34 起并入 SectionMeta）。
  */
 export type SectionRiskTier = 'low' | 'medium' | 'high';
+/**
+ * 同步准入档位（见 \`SectionMeta.syncOptIn\`）：
+ * 'off' = 不进同步通道；'manual' = 显式勾选且**只跟随手动 push/pull**；
+ * 'auto' = 显式勾选后手动与自动同步都带。
+ */
+export type SectionSyncOptIn = 'off' | 'manual' | 'auto';
 /**
  * 分区载荷形态（决定 ZIP 内表示 + 结构校验方式）。
  * 判别联合 + 穷尽 switch = 新增载荷形态会在编译期被 `validateSectionData` 发现。
@@ -134,8 +144,16 @@ export interface SectionMeta {
     readonly applyOrder: number;
     /** 可移植性（同步/分享/市场据此过滤） */
     readonly portability: SectionPortability;
-    /** 同步「可选分区」：永不默认进入同步通道，必须推/拉两侧显式放行（当前仅 sessions） */
-    readonly optInSync: boolean;
+    /**
+     * 同步准入档位（非 portable 分区的显式准入；portable 分区恒为 'off'，走默认通道）。
+     *  - 'off'    = 永不进入同步通道；
+     *  - 'manual' = 必须用户在同步分区弹窗里显式勾选，且**只跟随用户驱动的手动 push/pull**；
+     *               自动同步永不带（内容隐私 / 设备相关，例如 sessions）；
+     *  - 'auto'   = 用户显式勾选后，手动与自动同步都带（内容可跨机，只是命令 / 路径可能与
+     *               目标机不同，例如 mcp）。
+     * **必填**（Record<SectionId, SectionMeta> 强制）：新增分区漏填即 tsc 报错。
+     */
+    readonly syncOptIn: SectionSyncOptIn;
     /** 快速导出（Quick Export）默认勾选（deviceSpecific 分区即使 true 也不会被推荐） */
     readonly defaultIncluded: boolean;
     /**
@@ -154,7 +172,7 @@ export interface SectionMeta {
      */
     readonly configSnapshot: boolean;
 }
-/** 分区载荷版本：当前 15 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
+/** 分区载荷版本：当前 17 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
 export declare const SECTION_DATA_VERSION: 1;
 /**
  * 分区注册表（**Record<SectionId, SectionMeta>**：漏注册/写错 id → 编译失败）。
@@ -164,7 +182,9 @@ export declare const SECTION_DATA_VERSION: 1;
  *  - `portability` / `defaultIncluded` ← 各 adapter 的 `portability` / `defaultIncluded`，
  *    以及 `ui/export-flow.ts` 的内置目录、`market/prepare.ts` 的 SECTION_PORTABILITY
  *    （三者此前必须人工保持一致，现以本表为源）；
- *  - `optInSync` ← `sync/sync-selection.ts` 的 OPT_IN_SYNC_SECTIONS（当前仅 sessions）；
+ *  - `syncOptIn` ← **本表声明**（mcp='auto' / sessions='manual' / 其余 'off'），
+ *    `sync/sync-selection.ts` 的 OPT_IN_SYNC_SECTIONS 与 `AUTO_SYNC_OPT_IN_SECTION_IDS` 都是它的派生视图
+ *    （此前是两份手写字面量、零护栏 —— issue #78 收敛为单一事实源）；
  *  - `applyOrder` ← 历史 SECTION_IDS 数组顺序（1 起，连续）。
  */
 export declare const SECTION_REGISTRY: Record<SectionId, SectionMeta>;
@@ -174,11 +194,6 @@ export declare const SECTION_IDS: readonly SectionId[];
 export declare function sectionMetaOf(value: unknown): SectionMeta | null;
 /** 类型安全的元数据读取（id 已是 SectionId） */
 export declare function sectionMeta(id: SectionId): SectionMeta;
-/**
- * 拿不到元数据就**显式失败**（绝不让未注册分区按其它分区语义继续）。
- * core 侧修正「未知分区静默记成 settingsNamespace」时用它替代 default 分支。
- */
-export declare function requireSectionMeta(id: string): SectionMeta;
 /** 该 id 是否是已注册分区（运行期守卫；配合 manifest 的未知键告警使用） */
 export declare function isSectionId(value: unknown): value is SectionId;
 /** ZIP 内 JSON 分区路径（null = 该分区无 JSON 载荷：文件类分区 / secrets） */
@@ -193,8 +208,20 @@ export declare const SECTION_JSON_PATHS: Partial<Record<SectionId, string>>;
 export declare const SECTION_FILE_PREFIXES: Partial<Record<SectionId, string>>;
 /** 可移植分区（同步/分享默认候选） */
 export declare const PORTABLE_SECTION_IDS: readonly SectionId[];
-/** 同步「可选分区」：永不默认进入同步通道，必须推/拉两侧显式放行（当前仅 sessions） */
+/**
+ * 同步「可选分区」：非 portable、必须推/拉两侧显式放行的分区（syncOptIn !== 'off'）。
+ * 当前 = ['mcp', 'sessions']。**顺序按 applyOrder**（mcp=5 在 sessions=14 之前）。
+ */
 export declare const OPT_IN_SYNC_SECTION_IDS: readonly SectionId[];
+/**
+ * 「可选分区」里**允许参与自动同步**的子集（syncOptIn === 'auto'）。
+ *
+ * 为什么必须单独一档：可选分区的准入理由不同 ——
+ *  - sessions 是**内容隐私 / 设备相关**（high 风险，自动同步绝不带，绝不悄悄下行会话）；
+ *  - mcp 只是**命令 / 路径可能与目标机不同**（medium 风险，用户勾了就该跟着自动同步走）。
+ * 用一个布尔没法表达这层差别，会退化成「勾了 mcp 顺带放行 sessions」。
+ */
+export declare const AUTO_SYNC_OPT_IN_SECTION_IDS: readonly SectionId[];
 /** 快速导出默认勾选的分区（deviceSpecific 仍需 UI 就地警示，见 export-flow） */
 export declare const DEFAULT_INCLUDED_SECTION_IDS: readonly SectionId[];
 /**

package/lib/schema/section-registry.js

@@ -1,4 +1,4 @@
-/** 分区载荷版本：当前 15 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
+/** 分区载荷版本：当前 17 个分区统一为 1（唯一字面量；分区可独立升级时只改对应条目的引用） */
 export const SECTION_DATA_VERSION = 1;
 /**
  * 分区注册表（**Record<SectionId, SectionMeta>**：漏注册/写错 id → 编译失败）。
@@ -8,7 +8,9 @@ export const SECTION_DATA_VERSION = 1;
  *  - `portability` / `defaultIncluded` ← 各 adapter 的 `portability` / `defaultIncluded`，
  *    以及 `ui/export-flow.ts` 的内置目录、`market/prepare.ts` 的 SECTION_PORTABILITY
  *    （三者此前必须人工保持一致，现以本表为源）；
- *  - `optInSync` ← `sync/sync-selection.ts` 的 OPT_IN_SYNC_SECTIONS（当前仅 sessions）；
+ *  - `syncOptIn` ← **本表声明**（mcp='auto' / sessions='manual' / 其余 'off'），
+ *    `sync/sync-selection.ts` 的 OPT_IN_SYNC_SECTIONS 与 `AUTO_SYNC_OPT_IN_SECTION_IDS` 都是它的派生视图
+ *    （此前是两份手写字面量、零护栏 —— issue #78 收敛为单一事实源）；
  *  - `applyOrder` ← 历史 SECTION_IDS 数组顺序（1 起，连续）。
  */
 export const SECTION_REGISTRY = {
@@ -21,7 +23,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 1,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -34,7 +36,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 2,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -47,7 +49,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 3,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -63,7 +65,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 4,
         riskTier: 'medium',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -76,7 +78,10 @@ export const SECTION_REGISTRY = {
         applyOrder: 5,
         riskTier: 'medium',
         portability: 'platformSpecific',
-        optInSync: false,
+        // issue #78：MCP 行只写 patch 行（导入期按层写回），按包安装的 stdio server
+        // （npx / uvx / pipx）配置本身可跨机 —— 只是命令 / cwd 可能与目标机不同，
+        // 由导入分析期 warning 提示。用户显式勾选后，手动与自动同步都带。
+        syncOptIn: 'auto',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -89,7 +94,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 6,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -102,7 +107,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 7,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -115,7 +120,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 8,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -128,7 +133,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 9,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -141,20 +146,20 @@ export const SECTION_REGISTRY = {
         applyOrder: 10,
         riskTier: 'medium',
         portability: 'platformSpecific',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
     pluginFiles: {
         id: 'pluginFiles',
-        displayName: 'Plugin Files',
+        displayName: "Other Plugins' Loose Files",
         group: 'extensions',
         payload: { kind: 'files', filePrefix: 'plugin-files/' },
         dataVersion: SECTION_DATA_VERSION,
         applyOrder: 11,
         riskTier: 'high',
         portability: 'deviceSpecific',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: false,
         configSnapshot: true,
     },
@@ -167,7 +172,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 12,
         riskTier: 'high',
         portability: 'deviceSpecific',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
@@ -181,7 +186,7 @@ export const SECTION_REGISTRY = {
         applyOrder: 13,
         riskTier: 'high',
         portability: 'deviceSpecific',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: false,
         configSnapshot: false,
     },
@@ -194,23 +199,52 @@ export const SECTION_REGISTRY = {
         applyOrder: 14,
         riskTier: 'high',
         portability: 'deviceSpecific',
-        optInSync: true,
+        syncOptIn: 'manual',
         defaultIncluded: false,
         configSnapshot: false,
     },
     self: {
         id: 'self',
-        displayName: 'Plugin Self Config',
+        displayName: "This Plugin's Own Config",
         group: 'extensions',
         payload: { kind: 'files', filePrefix: 'self/' },
         dataVersion: SECTION_DATA_VERSION,
         applyOrder: 15,
         riskTier: 'low',
         portability: 'portable',
-        optInSync: false,
+        syncOptIn: 'off',
         defaultIncluded: true,
         configSnapshot: true,
     },
+    pluginData: {
+        id: 'pluginData',
+        displayName: "Other Plugins' Data",
+        group: 'extensions',
+        payload: { kind: 'files', filePrefix: 'plugin-data/' },
+        dataVersion: SECTION_DATA_VERSION,
+        applyOrder: 16,
+        riskTier: 'high',
+        // 第三方插件的数据目录不在 DSH 的三个核心存储里：路径是「机器的 home 布局」而非配置内容，
+        // 换机后可能整个目录不存在（未安装该插件）→ deviceSpecific + 不参与自动同步。
+        portability: 'deviceSpecific',
+        syncOptIn: 'off',
+        defaultIncluded: false,
+        // 体量由用户数据主导（可能几百 MB），与 sessions 同理不进「配置状态」采集口径
+        configSnapshot: false,
+    },
+    pluginAssets: {
+        id: 'pluginAssets',
+        displayName: "Other Plugins' Large Files",
+        group: 'extensions',
+        payload: { kind: 'files', filePrefix: 'plugin-assets/' },
+        dataVersion: SECTION_DATA_VERSION,
+        applyOrder: 17,
+        riskTier: 'high',
+        portability: 'deviceSpecific',
+        syncOptIn: 'off',
+        defaultIncluded: false,
+        configSnapshot: false,
+    },
 };
 /** 分区 id（按 applyOrder 升序）——历史上与 SECTION_IDS 数组逐项一致 */
 export const SECTION_IDS = Object.keys(SECTION_REGISTRY)
@@ -227,17 +261,6 @@ export function sectionMetaOf(value) {
 export function sectionMeta(id) {
     return SECTION_REGISTRY[id];
 }
-/**
- * 拿不到元数据就**显式失败**（绝不让未注册分区按其它分区语义继续）。
- * core 侧修正「未知分区静默记成 settingsNamespace」时用它替代 default 分支。
- */
-export function requireSectionMeta(id) {
-    const meta = sectionMetaOf(id);
-    if (meta === null) {
-        throw new Error(`未注册分区「${id}」：拒绝按其它分区语义处理；新增分区必须在 src/schema/section-registry.ts 注册`);
-    }
-    return meta;
-}
 /** 该 id 是否是已注册分区（运行期守卫；配合 manifest 的未知键告警使用） */
 export function isSectionId(value) {
     return sectionMetaOf(value) !== null;
@@ -266,8 +289,20 @@ export const SECTION_FILE_PREFIXES = Object.fromEntries(SECTION_IDS
     .filter((entry) => entry[1] !== null));
 /** 可移植分区（同步/分享默认候选） */
 export const PORTABLE_SECTION_IDS = SECTION_IDS.filter((id) => SECTION_REGISTRY[id].portability === 'portable');
-/** 同步「可选分区」：永不默认进入同步通道，必须推/拉两侧显式放行（当前仅 sessions） */
-export const OPT_IN_SYNC_SECTION_IDS = SECTION_IDS.filter((id) => SECTION_REGISTRY[id].optInSync);
+/**
+ * 同步「可选分区」：非 portable、必须推/拉两侧显式放行的分区（syncOptIn !== 'off'）。
+ * 当前 = ['mcp', 'sessions']。**顺序按 applyOrder**（mcp=5 在 sessions=14 之前）。
+ */
+export const OPT_IN_SYNC_SECTION_IDS = SECTION_IDS.filter((id) => SECTION_REGISTRY[id].syncOptIn !== 'off');
+/**
+ * 「可选分区」里**允许参与自动同步**的子集（syncOptIn === 'auto'）。
+ *
+ * 为什么必须单独一档：可选分区的准入理由不同 ——
+ *  - sessions 是**内容隐私 / 设备相关**（high 风险，自动同步绝不带，绝不悄悄下行会话）；
+ *  - mcp 只是**命令 / 路径可能与目标机不同**（medium 风险，用户勾了就该跟着自动同步走）。
+ * 用一个布尔没法表达这层差别，会退化成「勾了 mcp 顺带放行 sessions」。
+ */
+export const AUTO_SYNC_OPT_IN_SECTION_IDS = SECTION_IDS.filter((id) => SECTION_REGISTRY[id].syncOptIn === 'auto');
 /** 快速导出默认勾选的分区（deviceSpecific 仍需 UI 就地警示，见 export-flow） */
 export const DEFAULT_INCLUDED_SECTION_IDS = SECTION_IDS.filter((id) => SECTION_REGISTRY[id].defaultIncluded);
 /**

package/lib/schema/types.d.ts

@@ -11,7 +11,7 @@ export type Platform = 'win32' | 'darwin' | 'linux' | 'freebsd' | 'openbsd' | 'a
  * 明确不实现的分区（keybindings/workflows/commands）不在此列；
  * rules 已由 agentInstructions（~/.dsh/AGENTS.md，dsh-agent-instructions 全局指令）承接。
  */
-export type SectionId = 'settings' | 'ui' | 'providers' | 'plugins' | 'mcp' | 'prompts' | 'skills' | 'agentPresets' | 'agentInstructions' | 'workspaces' | 'pluginFiles' | 'credentialsStatus' | 'secrets' | 'sessions' | 'self';
+export type SectionId = 'settings' | 'ui' | 'providers' | 'plugins' | 'mcp' | 'prompts' | 'skills' | 'agentPresets' | 'agentInstructions' | 'workspaces' | 'pluginFiles' | 'credentialsStatus' | 'secrets' | 'sessions' | 'self' | 'pluginData' | 'pluginAssets';
 /** 加密备份的算法参数（非秘密：salt/iv/authTag 仅用于解密与完整性校验） */
 export interface EncryptionInfo {
     algorithm: 'aes-256-gcm';