dsh-config-manager 0.2.4 → 0.3.0

package/README.md

@@ -342,7 +342,7 @@ You do not have to rebuild another agent's setup by hand.
 - **What travels** — MCP servers, skills, global instructions (as `AGENTS.md`), and **chat history together with the workspaces those conversations belong to** (29 sources; conversations are re-encoded into DSH's session-log format and placed by their recorded `cwd`).
 - **What does not** — secret **values** are never read: only the key names are recorded so the plan can ask you to re-enter them. Structures DSH has no equivalent for (Claude Code hooks, slash commands, …) are reported as explicit codes rather than silently dropped.
 - **Honest skips** — a conversation with no recorded `cwd` cannot be placed and is reported as skipped (never guessed into some other project); known lossy items are listed **before** the import runs.
-- **Entry points** — Home toolbar → "Import" → **"Import from another agent"** (Home also has a direct entry), the ⌘K command, or the CLI: `dcm import --from <source> [--dry-run] [--out <path>]`.
+- **Entry points** — the **"Import from another agent"** button on the home toolbar, the ⌘K command, or the CLI: `dcm import --from <source> [--dry-run] [--out <path>]`.
 
 ### 🔒 Secrets
 

package/README.zh-CN.md

@@ -343,7 +343,7 @@ allowBuilds:
 - **会带走什么** —— MCP Servers、技能、全局指令（落成 `AGENTS.md`），以及**历史会话连同这些对话所属的工作区**（29 个来源；会话会重新编码成 DSH 的会话日志格式，并按它记录的 `cwd` 归位）。
 - **不会带走什么** —— 密钥**值**一律不读：只记录键名，由导入计划提示补录。DSH 没有对等结构的东西（Claude Code 的 hooks、斜杠命令等）会**报出明确的码**，不会静默丢掉。
 - **如实跳过** —— 没记录 `cwd` 的对话无处归位，会列为跳过（绝不猜进别的项目）；已知的有损项在导入**之前**就摆明。
-- **入口** —— 首页工具栏「导入」→ 面板里的**「从其它 agent 导入」**（首页另有直达入口）、⌘K 的「从其它 agent 导入」，或 CLI：`dcm import --from <来源> [--dry-run] [--out <路径>]`。
+- **入口** —— 首页工具栏的**「从其它 agent 导入」**按钮、⌘K 的「从其它 agent 导入」，或 CLI：`dcm import --from <来源> [--dry-run] [--out <路径>]`。
 
 ### 🔒 密钥处理
 

package/lib/adapters/self.d.ts

@@ -1,11 +1,15 @@
 /**
  * self 分区 adapter（插件自身配置，设计「self 分区」）：
  * 数据源 = $DSH_HOME/dsh-config-manager/ 下的插件自身配置文件（白名单收集，非递归）：
- *   - sync/sync-config.json     同步通道配置（git repoUrl / webdav url+username；凭据值走 credentials 槽位，不含 secret）
- *   - sync/sync-autosync.json   自动同步调度配置
  *   - sync/sync-selection.json  同步分区选择（默认/高级模式 + 勾选分区）
  *   - sync/ui-prefs.json        插件 UI 偏好（如上次选择的同步通道；从 localStorage 迁入）
+ *   - sync/backup-schedule.json 备份调度配置
  *   - market/market-config.json 配置市场配置
+ *   - exports/.backup-notes.json 导出产物备注清单
+ *
+ * **可信边界（SEC-01）**：`sync/sync-config.json` 与 `sync/sync-autosync.json` 是「同步目标」本身，
+ * 永不可由**包**决定 —— 一个把 repoUrl 指向攻击者仓库的包，导入完用户下一次同步就把家目录配置
+ * 推过去。它们不在白名单里（不导出），导入侧另由 `SELF_IMPORT_BLOCKED_RELS` 显式挡下并留 warning。
  *
  * 排除项：sync/sync-history.json（执行记录，属数据非配置）、market/cache/（缓存）、
  * snapshots/（快照）、tmp/ exports/（临时/导出产物）、rollback-points/（回滚点库——磁盘体检
@@ -44,13 +48,34 @@
  * 安全不变量：配置文件本身不含凭据值（同步凭据走 DSH credentials 槽位引用），
  * 且文件类分区不进 SecretScanner（与 pluginFiles/skills 同语义）。
  */
-import type { HostContext } from '../core/types.ts';
+import type { ApplyResult, HostContext, ImportContext, PlanItem } from '../core/types.ts';
+import type { FilesSection } from '../schema/types.ts';
 import type { AutosyncConfig } from '../sync/autosync-config.ts';
 import type { BackupScheduleConfig } from '../sync/backup-schedule-config.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
 import { FileCollectionAdapter } from './file-collection.ts';
-/** self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。 */
+/**
+ * self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。
+ *
+ * `sync/sync-config.json` 与 `sync/sync-autosync.json` **不在其中**（SEC-01）：同步目标与自动同步开关
+ * 属于「目标机自己的决定」，跨机搬运等于让包决定把本机配置推到哪里。白名单只管导出侧；
+ * 导入侧的包内容不受白名单约束，所以另有 `SELF_IMPORT_BLOCKED_RELS` 显式挡下。
+ */
 export declare const SELF_CONFIG_FILES: readonly string[];
+/**
+ * 导入侧**一律不写盘**的 rel（SEC-01）。
+ *
+ * 与白名单的关系：白名单管「导出带什么」，本清单管「包里有也绝不落地」。两者故意不共用一份
+ * 数组 —— 白名单将来若因别的理由重新收进某个文件，也不该连带解除导入侧的保护。
+ */
+export declare const SELF_IMPORT_BLOCKED_RELS: readonly string[];
+/**
+ * 拦截报告项里的**稳定机器码**前缀（`self-import-blocked:<rel>`）。
+ *
+ * 为什么要有码而不是只给文案：文案随语言/措辞变，调用方（报告、日志、将来的自动判定）需要
+ * 一个能逐字比对的判据。
+ */
+export declare const SELF_IMPORT_BLOCKED_CODE = "self-import-blocked";
 /**
  * 调度配置里「运行态字段」的**命名口径**：调度器每轮收尾都会改写的字段名形状
  * （`lastRun*` 一族 + `consecutiveFailures`）。剔除表必须覆盖两个调度配置的并集，
@@ -120,5 +145,20 @@ export declare class SelfAdapter extends FileCollectionAdapter {
      * 解析不出 JSON 时原样返回 —— 「判不出来」按整文件哈希处理，绝不猜。
      */
     protected comparableContent(relativePath: string, data: Uint8Array): Uint8Array;
+    /**
+     * 导入侧拦截（SEC-01）：包里带 `sync/sync-config.json` / `sync/sync-autosync.json` → 改判 Warning。
+     *
+     * 为什么必须在**计划阶段**改判而不是只在 applyItem 里拒绝：这两份文件是「同步目标」本身，
+     * 一个把 repoUrl 指向攻击者仓库的包，导入完用户下一次同步就会把本机配置推过去 —— 而用户
+     * 从来没被问过「要不要换同步目标」。去掉 `target` 后引擎不会为它登记快照、也不会调 applyItem；
+     * 同时留下一项 report 级 warning（带稳定码 `self-import-blocked:<rel>`），让用户看得见
+     * 「包里有这个文件、我没写」，绝不静默。
+     */
+    analyzeImport(data: FilesSection, ctx: ImportContext): Promise<PlanItem[]>;
+    /**
+     * 纵深防御（SEC-01）：即使有人绕过引擎直接把被拦项喂进 applyItem，也一字节都不写。
+     * 报 warning=true（非致命、不触发整体回滚），与计划阶段的判定同源。
+     */
+    applyItem(item: PlanItem, ctx: ImportContext): Promise<ApplyResult>;
 }
 export {};

package/lib/adapters/self.js

@@ -1,9 +1,13 @@
 import { sectionMeta } from '../schema/section-registry.js';
 import { FileCollectionAdapter } from './file-collection.js';
-/** self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。 */
+/**
+ * self 分区白名单文件（相对 baseDir，即 $DSH_HOME/dsh-config-manager/）。
+ *
+ * `sync/sync-config.json` 与 `sync/sync-autosync.json` **不在其中**（SEC-01）：同步目标与自动同步开关
+ * 属于「目标机自己的决定」，跨机搬运等于让包决定把本机配置推到哪里。白名单只管导出侧；
+ * 导入侧的包内容不受白名单约束，所以另有 `SELF_IMPORT_BLOCKED_RELS` 显式挡下。
+ */
 export const SELF_CONFIG_FILES = [
-    'sync/sync-config.json',
-    'sync/sync-autosync.json',
     'sync/sync-selection.json',
     'sync/ui-prefs.json',
     'sync/backup-schedule.json',
@@ -12,6 +16,23 @@ export const SELF_CONFIG_FILES = [
     // 换机器后备份列表仍能看到手动导出时填写的备注
     'exports/.backup-notes.json',
 ];
+/**
+ * 导入侧**一律不写盘**的 rel（SEC-01）。
+ *
+ * 与白名单的关系：白名单管「导出带什么」，本清单管「包里有也绝不落地」。两者故意不共用一份
+ * 数组 —— 白名单将来若因别的理由重新收进某个文件，也不该连带解除导入侧的保护。
+ */
+export const SELF_IMPORT_BLOCKED_RELS = [
+    'sync/sync-config.json',
+    'sync/sync-autosync.json',
+];
+/**
+ * 拦截报告项里的**稳定机器码**前缀（`self-import-blocked:<rel>`）。
+ *
+ * 为什么要有码而不是只给文案：文案随语言/措辞变，调用方（报告、日志、将来的自动判定）需要
+ * 一个能逐字比对的判据。
+ */
+export const SELF_IMPORT_BLOCKED_CODE = "self-import-blocked";
 /**
  * 调度配置里的**运行态字段**：每次执行收尾都会被调度器改写，不属于「配置身份」。
  * 仅比对时剔除（见 comparableContent）；写盘仍写完整文件。
@@ -149,5 +170,44 @@ export class SelfAdapter extends FileCollectionAdapter {
         // 回落原引用（解析失败 / 非对象）：走整文件哈希，且不额外重算包内哈希
         return canonicalizeWithoutRunState(data) ?? data;
     }
+    /**
+     * 导入侧拦截（SEC-01）：包里带 `sync/sync-config.json` / `sync/sync-autosync.json` → 改判 Warning。
+     *
+     * 为什么必须在**计划阶段**改判而不是只在 applyItem 里拒绝：这两份文件是「同步目标」本身，
+     * 一个把 repoUrl 指向攻击者仓库的包，导入完用户下一次同步就会把本机配置推过去 —— 而用户
+     * 从来没被问过「要不要换同步目标」。去掉 `target` 后引擎不会为它登记快照、也不会调 applyItem；
+     * 同时留下一项 report 级 warning（带稳定码 `self-import-blocked:<rel>`），让用户看得见
+     * 「包里有这个文件、我没写」，绝不静默。
+     */
+    async analyzeImport(data, ctx) {
+        const items = await super.analyzeImport(data, ctx);
+        return items.map((item) => {
+            const rel = item.target?.ref;
+            if (rel === undefined || !SELF_IMPORT_BLOCKED_RELS.includes(rel))
+                return item;
+            const blocked = {
+                id: item.id,
+                kind: 'Warning',
+                adapter: this.id,
+                description: ctx.msg('adapter.selfImportBlocked', { path: rel }),
+                detail: `${SELF_IMPORT_BLOCKED_CODE}:${rel}`,
+                severity: 'warning',
+            };
+            if (item.unitId !== undefined)
+                blocked.unitId = item.unitId;
+            return blocked;
+        });
+    }
+    /**
+     * 纵深防御（SEC-01）：即使有人绕过引擎直接把被拦项喂进 applyItem，也一字节都不写。
+     * 报 warning=true（非致命、不触发整体回滚），与计划阶段的判定同源。
+     */
+    async applyItem(item, ctx) {
+        const ref = item.target?.ref;
+        if (ref !== undefined && SELF_IMPORT_BLOCKED_RELS.includes(ref)) {
+            return { ok: false, message: ctx.msg('adapter.selfImportBlocked', { path: ref }), warning: true };
+        }
+        return super.applyItem(item, ctx);
+    }
 }
 //# sourceMappingURL=self.js.map

package/lib/client.d.ts

@@ -5019,6 +5019,7 @@ declare const zh$4: {
   readonly 'overview.health.noBackup': '尚无任何备份';
   readonly 'overview.health.scheduleFailed': '上次定时备份失败，建议检查备份设置';
   readonly 'overview.health.recovery': '存在未解决的恢复事项，需要处理';
+  readonly 'overview.health.autoBackupOff': '自动备份已关闭，目前只有手动备份';
   readonly 'overview.health.recoveryAction': '前往「事故恢复」处理';
   readonly 'overview.metric.backups': '备份文件';
   readonly 'overview.metric.snapshots': '安全快照';
@@ -5048,6 +5049,10 @@ declare const zh$4: {
   readonly 'overview.quick.backupSkippedOther': '已跳过：备份服务当前无法执行（详情见宿主日志）';
   readonly 'overview.quick.backupFailed': '备份失败：{message}';
   readonly 'overview.activity.title': '最近活动';
+  readonly 'overview.activity.colTime': '时间';
+  readonly 'overview.activity.colEvent': '动作';
+  readonly 'overview.activity.colDetail': '详情';
+  readonly 'overview.activity.colResult': '结果';
   readonly 'overview.activity.empty': '暂无操作记录';
   readonly 'overview.activity.unavailable': '活动记录读取失败（这不是「没有记录」）';
   readonly 'overview.loadFailed': '有 {count} 项数据读取失败：{message} —— 下面的指标可能不完整';
@@ -5417,6 +5422,7 @@ declare const zh$4: {
   readonly 'profiles.running.port': '端口 {port}';
   readonly 'profiles.running.open': '打开';
   readonly 'profiles.running.badge': ':{port} 运行中';
+  readonly 'profiles.running.portBadge': ':{port}';
   readonly 'profiles.running.originCurrent': '当前实例';
   readonly 'profiles.running.originOwned': '本插件启动';
   readonly 'profiles.running.originExternal': '其他实例';
@@ -5712,6 +5718,7 @@ declare const zh$4: {
   readonly 'library.remoteDeleteBaseline': '注意：这是当前的同步基线（本机上次同步到的那份）。删除不会改动本机配置，但下次同步会重新比对远端最新快照。';
   readonly 'library.remoteDeleted': '已删除远端快照';
   readonly 'library.summary.count': '共 {count} 个';
+  readonly 'library.summary.filtered': '{shown} / {total} 个';
   readonly 'library.new.export': '手动导出';
   readonly 'library.new.import': '从文件导入';
   readonly 'library.new.market': '逛市场';
@@ -5830,7 +5837,7 @@ declare const zh$3: {
   readonly 'channel.s3': '对象存储（S3 兼容）';
   readonly 'channel.gist': 'GitHub Gist';
   readonly 'channel.perChannelHint': '每条通道（Git / WebDAV / 对象存储 / Gist）的自动同步、同步模式、加密与远端快照各自独立配置。';
-  readonly 'channel.open': '配置…';
+  readonly 'channel.open': '配置';
   readonly 'channel.openHint': '远程同步通过「同步通道」进行：Git 私有仓库或 WebDAV 服务器。';
   readonly 'channel.expand': '展开通道详情';
   readonly 'channel.collapse': '收起通道详情';
@@ -5897,7 +5904,7 @@ declare const zh$3: {
   readonly 'repoPicker.empty': '没有可用的私有仓库';
   readonly 'repoPicker.loadFailed': '仓库列表加载失败，可重试或直接手填地址。';
   readonly 'repoPicker.updatedAt': '更新于 {time}';
-  readonly 'repoPicker.create': '＋ 新建私有仓库…';
+  readonly 'repoPicker.create': '＋ 新建私有仓库';
   readonly 'repoPicker.createTitle': '新建私有仓库';
   readonly 'repoPicker.name': '仓库名';
   readonly 'repoPicker.namePlaceholder': '如 dsh-configs';
@@ -5959,7 +5966,7 @@ declare const zh$3: {
   readonly 'syncflow.remoteEmptyGuide': '远端还没有任何快照：这是首次同步，先点「推送到远端」把本机配置推上去（推送会创建第一个快照），之后才能拉取。';
   readonly 'mode.title': '同步分区';
   readonly 'mode.hint': '同步范围 = 勾选的分区集合（默认已勾选推荐分区，可随时改）。';
-  readonly 'mode.selectedCount': '已勾选 {n} 个';
+  readonly 'mode.selectedCount': '已勾选 {n} / {total}';
   readonly 'mode.sectionsHint': '默认可同步的是可移植分区；平台相关分区（MCP 服务器）与设备相关分区（插件文件、凭据状态、历史会话）只有你在这里主动勾选才参与同步。';
   readonly 'mode.atLeastOne': '请至少勾选一个同步分区';
   readonly 'mode.sectionPortable': '可移植';
@@ -5977,7 +5984,7 @@ declare const zh$3: {
   readonly 'mode.sessionsWorkspaceWarn': '已勾选历史对话，但没有勾选「工作区」分区：目标机上这些对话可能归属不到任何工作区而显示不出来。建议一并勾选「工作区」。';
   readonly 'mode.gistSessionsWarn': '当前通道是 GitHub Gist，且勾选了「历史会话」：gist 会一次取回全部文件内容、单文件超限即截断、文件数还有上限，大分区同步可能失败或内容被截断。建议改用 Git / WebDAV / 对象存储通道同步历史会话，或取消勾选该分区。';
   readonly 'mode.persistHint': '分区选择已保存到本机：自动同步和手动推送都会使用此配置（重启后仍生效）。';
-  readonly 'mode.choose': '选择…';
+  readonly 'mode.choose': '选择';
   readonly 'mode.pickerTitle': '选择同步分区';
   readonly 'mode.pickerHint': '改动即时生效并保存（关闭弹窗即完成）。';
   readonly 'mode.pickerBack': '返回分区列表';
@@ -7052,8 +7059,6 @@ interface ExportViewProps {
 interface ImportWizardViewProps {
   api: ConfigManagerApi;
   t: TranslateNS<'config-manager'>;
-  uiT?: UiT;
-  onOpenForeignImport?: () => void;
 }
 interface SyncPanelProps {
   api: SyncApi;