dsh-config-manager 0.1.2 → 0.1.4

package/README.zh-CN.md

@@ -1,252 +1,209 @@
-# DSH Config Manager
+# 🎒 DSH Config Manager
 
-**Backup · Export · Import · Migrate · Restore** —— DSH 配置备份 / 导出 / 导入 / 迁移管理器。
+**把你的 DSH 配置打包带走 —— 换台电脑，环境一键恢复。**
 
-[English](README.md) | [简体中文](README.zh-CN.md)
+[English](README.md) · [简体中文](README.zh-CN.md)
 
-在一台 DSH 中一键导出主要配置为 ZIP，在另一台 DSH 中导入并尽可能恢复原来的使用环境。
+---
+
+## 这是什么？🤔
+
+DSH 是你的 AI 助手工作台，里面存着你的各种设置：模型配置、插件、常用技能、工作区……
+
+**DSH Config Manager 就是它的「搬家工具」**：
+
+```
+┌──────────────┐   ① 一键导出    ┌─────────────────┐   ② 一键导入    ┌──────────────┐
+│   电脑 A      │ ─────────────► │  dsh-config.zip  │ ─────────────► │   电脑 B      │
+│   我的配置     │                │   （一个文件）     │                │  配置全部恢复  │
+└──────────────┘                └─────────────────┘                └──────────────┘
+```
+
+> ⚠️ **安全第一**：默认**不导出**任何密钥（API Key / Token / 密码）。详见 [安全](#-安全)。
+
+---
+
+## ✨ 核心亮点
 
-> ⚠️ **安全第一：默认不导出任何 Secret（API Key / Token / 密码）。** 详见 [Security](#security)。
+| 图标 | 功能 | 一句话说明 |
+|:---:|---|---|
+| 🚀 | **一键导出** | 点一下，把推荐配置打包成一个 ZIP |
+| 📦 | **一键导入** | 在另一台电脑点一下，环境就回来了 |
+| 👀 | **先预览再导入** | 导入前完整预览，**绝不偷偷改你的配置** |
+| ⚔️ | **冲突处理** | 遇到同名配置，让你自己选：保留现有的 / 用导入的 |
+| 🗺️ | **路径自动映射** | 换了电脑路径变了？自动检测并让你重新指定 |
+| 🔒 | **密钥安全** | API Key 默认不导出；导入后提醒你重新填写 |
+| ↩️ | **自动回滚** | 导入失败自动恢复原样，不会弄坏现有配置 |
+| 🗂️ | **配置档案 Profiles** | 保存多套配置（工作 / 个人），随时切换 |
 
 ---
 
-## What it does
+## 🔄 它是怎么工作的？
 
-DSH 的配置是「一个集中 `settings.yaml` + 多个独立文件 + 插件自有文件」的混合模型（见 `Docs/research/dsh-architecture.md`）。
-本插件**不整包复制 `~/.dsh`**，而是按真实配置类别分区收集、打包为带清单（manifest）与校验和（checksums）的 ZIP 备份，并在导入端执行
+### 导出（打包带走）
 
 ```
-Analyze → Preview → Snapshot → Apply → Validate → Rollback(if needed)
+读取你的配置 → 剔除密钥（安全） → 生成清单 → 计算校验和 → 打包成 ZIP
 ```
 
-的安全导入流程。
+### 导入（恢复环境）
 
-## Features
+每一步都先确认、先备份，**绝不直接改你的配置**：
 
-- **Export**：Quick Export（推荐配置一键导出）与按分区选择导出。
-- **Import**：ZIP 校验 → manifest 读取 → 完整性校验 → schema 检查 → 兼容性检查 → 内容扫描 → 导入计划预览 → 用户确认 → 自动快照 → 执行 → 校验 → 结果（失败自动回滚）。
-- **Dry Run / Preview**：`analyzeImport()` + `createImportPlan()` 纯计算零写入，导入前完整预览。
-- **冲突处理**：`merge`（默认）/ `replace` / `skipExisting` 全局策略 + 逐项 `Keep Current / Use Imported / Review`。
-- **路径映射**：跨设备绝对路径检测与批量前缀映射（workspace 路径 / MCP cwd / 插件配置路径）。
-- **Secret 安全**：默认剥离所有敏感字段；加密完整备份（scrypt + AES-256-GCM）为可选高级功能。
-- **自动快照与回滚**：导入前备份将被修改的目标，失败时逆序补偿恢复。
-- **Schema 版本与迁移**：`schemaVersion` 独立演进，迁移逻辑集中在 `src/migrations/`。
-- **幂等**：同一 ZIP 重复导入不产生重复数据（按 Plugin ID / MCP serverName / Prompt name / Workspace id / Credential ref 识别）。
-- **兼容性评分**：Excellent / Good / Partial / Unsupported（规则驱动）。
-- **Profiles（配置 Profile）**：保存当前配置为 Profile / 切换 / 复制 / 重命名 / 导出 / 导入 / 删除；切换带 Preview + 快照 + 回滚（`src/profiles/`）。
+```
+选择 ZIP → 校验文件 → 检查完整性 → 检查版本 → 兼容性检查
+    → 扫描内容 → 生成导入计划 → 预览确认
+    → 自动备份当前配置 → 执行导入 → 验证 → 完成
+                      │
+                      └─ 中途失败？→ 自动恢复原样（回滚）
+```
 
-## Installation
+---
 
-本插件是标准的 **DSH bundle 插件**（仿 dsh-ssh 工程范式，见研究报告 §5.1）：`package.json` 声明
-`dsh.bundle.patch`（指向 `cordis.patch.yml`，CLI 的 bundle 硬判据）与 `dsh.client`（浏览器半声明），
-`npm run build` 产出双半产物（`lib/index.js` Host 半 + `lib/client.js` 浏览器半，后者以
-`window.__ModuleLoader__.load(...)` 装载进 Web GUI）。
+## 📥 安装
 
-两种安装方式（二选一）：
+本插件是标准的 **DSH 插件**，安装只需要两步：
 
 ```bash
-# ① 推荐 —— 从 npm registry 安装
-dsh plugin --profile web add dsh-config-manager --config.auto-install-peers=false
+# ① 安装插件
+dsh plugin --profile web add dsh-config-manager@latest --config.auto-install-peers=false
 
-# ② 备选 —— 本地 tgz / 目录安装（开发与测试）
-npm run build
-npm pack                       # 产出 dsh-config-manager-0.1.0.tgz
-dsh plugin --profile web add file:/absolute/path/to/dsh-config-manager-0.1.0.tgz
+# ② 重启 DSH（设置页就会出现「备份与迁移」入口）
 ```
 
-> **`--legacy-peer-deps` 说明**：peerDependencies 中的部分 DSH 核心包（如
-> `@deepseek-ai/dsh-plugin-marketplace`、`dsh-host-plugin-inventory`）尚未发布到公共 npm registry，
-> 只在本地 DSH profile 环境存在。安装时若 npm/pnpm 尝试解析 peer 依赖并失败，请跳过 peer 自动安装：
-> - npm 直接安装：`npm install --legacy-peer-deps`
-> - `dsh plugin add`（内部转发 pnpm）：`dsh plugin --profile web add <spec> --config.auto-install-peers=false`
->
-> 运行时这些包由 DSH profile 自身提供（peerDependencies 语义），插件不重复安装。
+> 💡 照着复制就行：`--config.auto-install-peers=false` 跳过几个尚未公开发布的 DSH 核心依赖（运行时由 DSH 自己提供），`@latest` 确保装到最新版。
 
-> **本地验证提示**：可用 `$DSH_HOME=<临时目录>` 环境变量隔离测试，完全不触碰 `~/.dsh`：
-> ```bash
-> $env:DSH_HOME = "D:\tmp\dsh-home"        # Windows PowerShell
-> dsh plugin --profile test add file:<tgz> --config.auto-install-peers=false
-> dsh --profile test --dump-config | Select-String config-manager   # 应看到挂载行
-> ```
+---
 
-## Export
+## 🚀 快速上手（3 分钟体验）
 
-两种方式：
+```
+电脑 A（导出）
+  1. 打开 DSH → 设置 → 「备份与迁移」
+  2. 点「导出配置」→ 选「快速导出」
+  3. 得到一个 dsh-config-2026-08-14.zip（可确认报告里没有密钥）
+
+把 ZIP 拷到电脑 B（导入）
+  1. 打开 DSH → 「备份与迁移」→「导入配置」
+  2. 选择 ZIP → 等待分析 → 查看「导入预览」
+  3. 有路径问题？→ 选择新路径（可批量映射）
+  4. 有同名配置冲突？→ 选择 保留现有的 / 用导入的
+  5. 确认导入 → 等待完成
+  6. 按提示重新填写缺失的 API Key
+  7. ✅ 设置 / 插件 / MCP / 技能 / 工作区都回来了
+```
 
-- **Quick Export**：一键导出推荐分区（settings / ui / providers / plugins / mcp / prompts / skills / agentPresets / workspaces / credentialsStatus）。
-- **Custom Export**：按分区逐项选择（可选 `pluginFiles`、`sessions`；`sessions` 默认关闭）。
+---
 
-导出产物：`dsh-config-<yyyy-MM-dd>.zip`，含 `manifest.json` + 各分区数据 + `integrity/checksums.json`（SHA-256）。
+## 🧩 功能详解
 
-## Import
+### 📤 导出（两种方式）
 
-```
-Select ZIP → Validate ZIP → Read Manifest → Check Integrity → Check Schema
-→ Check Compatibility → Scan Contents → Generate Import Plan → Show Preview
-→ User Confirms → Create Backup (Snapshot) → Import → Validate → Show Result
-```
+| 方式 | 说明 |
+|---|---|
+| **快速导出**（推荐） | 一键导出推荐配置：设置 / UI / 模型 / 插件 / MCP / 技能 / 工作区等 |
+| **自定义导出** | 自己勾选要导出的分类 |
 
-导入流程强制：**未确认不执行任何写入**；**导入前必须生成快照**；失败按 `rollbackOnError` 决定整体回滚或单项如实记录。
+> 导出文件：`dsh-config-<日期>.zip`，内含清单 + 各分类数据 + SHA-256 校验和。
 
-## Security
+### 📥 导入（安全流程）
 
-> **默认备份不包含任何 Secret 值。** 这是硬性安全不变量，由 `Exporter` 强制：
+- **未确认不写入**：分析、预览阶段零修改
+- **先备份再导入**：执行前自动备份将被修改的配置
+- **失败自动回滚**：按你的选择整体回滚或跳过失败项继续
 
-- 所有结构化分区数据在写入 ZIP 前经过敏感字段扫描（字段名黑名单：password / token / apiKey / secret / credential / authorization / cookie / privateKey / clientSecret 等，大小写不敏感），命中即剥离。
-- `ctx.settings.describe({ redactSecrets: true })` 作为第一道防线剥离 DSH 已知秘密；敏感字段扫描器作为第二道防线兜底插件自定义字段。
-- 凭据（`.credentials.yaml`）**永不导出值**，只导出状态（`{ref, required, configured, hasValue:false}`），导入后生成「N credentials need attention」补录清单。
-- **加密完整备份（可选）**：显式勾选「Include secrets」时，要求设置备份密码，使用 `node:crypto`（scrypt 派生 + AES-256-GCM 加密），**密码绝不写入 manifest**；`secrets.enc` 只有解密后经 `ctx.credentials.set()` 写回。
-- 无加密提供者时 `includeSecrets: true` 会被拒绝（绝不明文泄密）。
-- 日志系统全部经过 redaction，Secret 值永不进入日志。
-- ZIP 属于不可信输入：防御 Zip Slip / 绝对路径 / 符号链接 / zip bomb（条目数 / 压缩体积 / 解压体积 / 压缩比上限）/ 畸形 ZIP / checksum 不匹配，任何一条触发即整体拒绝。
+### 👀 导入预览（Dry Run）
 
-## What is NOT exported
+导入前完整展示：
 
-默认**不**导出（规范 §34.19/20）：
+```
+✓ 18 项设置将被更新      ✓ 6 个插件已安装
+⚠ 2 个插件需要安装       ⚠ 3 个密钥需要重新填写
+⚠ 1 个路径需要映射        ⚠ 2 处冲突需要处理
+```
 
-- API Key / Password / Token / Cookie / Session / 认证凭据（值）
-- `~/.dsh/.anonymous-user-id`（设备唯一 ID）
-- 会话历史（`sessions/`，默认关闭；v1 仅支持文件级复制）
-- Logs / Cache / 临时文件
-- 浏览器 localStorage 中的 UI 状态（Host 侧无通道，仅导出 `uiMigrationNotes` 说明）
-- 插件二进制（绝不打包，只迁移清单并走官方安装机制）
+### ⚔️ 冲突处理
 
-## Secrets
+目标电脑已有同名配置时，让你选：
 
-| 备份类型 | 导入行为 |
+| 选项 | 含义 |
 |---|---|
-| 普通备份（无 secrets.enc） | 全部凭据 → `MissingSecret`，导入后由用户补录 |
-| 加密备份 + 正确密码 | 自动解密并经 `credentials.set()` 恢复（预览时可逐条确认） |
-| 加密备份 + 不输密码 | 同普通备份：状态补录 |
+| **保留现有的** | 不动目标电脑的原配置 |
+| **用导入的** | 用备份里的配置覆盖 |
+
+> 说明：刻意**不提供**「稍后决定 / 再看看」选项——未决的冲突会让导入无法继续，每个冲突都必须在继续前做出选择。
 
-## Compatibility
+### 🗺️ 路径映射
 
-| 状态 | 规则 |
+换了电脑，`C:\Users\alice\projects` 在另一台机器上不存在？插件会：
+1. 自动检测失效的绝对路径
+2. 让你选择新路径
+3. 支持**批量前缀映射**（如 `C:\Users\alice\` → `/Users/bob/` 一键替换所有相关路径）
+
+### 🔒 密钥处理
+
+| 场景 | 行为 |
 |---|---|
-| Excellent | 同平台、无分区缺失、schema 受支持 |
-| Good | 备份来自更旧 DSH（目标向后兼容） |
-| Partial | 跨平台 / 分区缺失 / 备份比目标新 |
-| Unsupported | schema 超出支持范围 |
+| 默认备份 | **不含任何密钥值**，只记录"哪些密钥需要填写" |
+| 加密备份（可选） | 设置密码后用 AES-256-GCM 加密，密码**绝不写入备份文件** |
+| 导入后 | 提示「3 个密钥需要重新填写」，输入后仅保存在内存中写入 |
 
-## Backup format
+### 🗂️ 配置档案（Profiles）
 
-```
-dsh-config-2026-08-14.zip
-├── manifest.json                  # schemaVersion / exporter / source / sections / security
-├── config/settings.json           # 非 UI settings namespace（redacted + revision）
-├── config/ui.json                 # UI namespace + uiMigrationNotes
-├── ai/providers.json              # llm-* providers/models（同 section 不拆分）
-├── plugins/plugins.json + patch.json
-├── mcp/servers.json               # 组合 patch 提取的 dsh-mcp-client 条目
-├── custom/prompts.json + skills/
-├── agents/presets/
-├── workspaces/workspaces.json
-├── plugin-files/                  # 可选
-├── security/credentials.json      # 凭据状态（永不含值）
-├── security/secrets.enc           # 仅加密备份
-└── integrity/checksums.json       # SHA-256
-```
+保存多套配置（如「工作」「个人」），随时切换；切换同样带预览 + 自动备份 + 回滚。
 
-## Development
+---
 
-```bash
-npm install --legacy-peer-deps   # peer 含未发布公共 registry 的 DSH 核心包，见 Installation
-npm run typecheck                # tsc --noEmit
-npm run build                    # tsc -p tsconfig.build.json（Host 半 lib/）+ tsdown（client bundle lib/client.js）
-npm run bundle                   # 仅重新构建 client bundle（tsdown）
-npm test                         # node --test "src/**/*.test.ts" "tests/**/*.test.ts"
-```
+## 🛡️ 安全
 
-架构：核心引擎（`src/core`）只依赖 `ConfigAdapter` / `HostContext` 接口（与 DSH 运行时解耦，可用内存 mock 测试）；`src/adapters` 实现各配置类别；`src/security` 提供秘密扫描 / 加密 / 完整性 / ZIP 安全 / redaction；`src/migrations` 集中 schema 迁移。
+- **默认备份不包含任何密钥值** —— 这是硬性规则，导出时强制执行
+- **不导出**：API Key / 密码 / Token / Cookie / 会话 / 设备唯一 ID / 日志缓存 / 插件二进制
+- **ZIP 是"不可信输入"**：防御 Zip Slip、恶意路径、压缩炸弹、损坏文件——任何一项触发就整体拒绝
+- **日志全程脱敏**：密钥值永不进入日志
+- **加密备份**：scrypt + AES-256-GCM，密码只在内存中，绝不写入文件
 
-## Publishing（GitHub Actions · npm Trusted Publishing / OIDC）
+---
 
-推送版本标签会触发 `.github/workflows/publish.yml` 的 CI 流水线：typecheck → 测试 → 构建 → 自动发布到 npm。发布使用 **npm Trusted Publishing（OIDC）**——仓库不存储任何长期令牌，npm CLI 通过 GitHub Actions 的 OIDC 与 registry 交换短期身份。
+## 🤝 兼容性
 
-```bash
-npm version patch          # 0.1.0 → 0.1.1（同时创建 tag）
-git push origin main --tags
-```
+| 状态 | 含义 |
+|---|---|
+| ✅ Excellent | 同平台、配置齐全、版本兼容 |
+| 👍 Good | 备份来自更旧版本的 DSH |
+| ⚠️ Partial | 跨平台 / 部分配置缺失 / 备份比当前新 |
+| ❌ Unsupported | 备份版本超出支持范围（无法导入） |
 
-npmjs.com 一次性配置（首次 OIDC 发布前必须完成）：
+---
 
-**方案 A — 网页**（有 scope 包或 UI 入口可用时）：
-1. 打开包页面：https://www.npmjs.com/package/dsh-config-manager → **Settings → Publishing access**。
-2. **Add trusted publisher**：Provider **GitHub Actions** · owner `xiajiajun516` · repository `dsh-config-manager` · workflow filename `publish.yml`。
+## ❓ 常见问题
 
-**方案 B — CLI（推荐；无 scope 包 UI 无入口时用这个）**：
-```bash
-npm logout
-npm login                                    # 网页 OAuth + 2FA 验证码
-npm trust github dsh-config-manager \
-  --file publish.yml \
-  --repo xiajiajun516/dsh-config-manager \
-  --allow-publish                            # 首次会要求输入 2FA 验证码
-npm trust list dsh-config-manager            # 验证
-```
+**Q：备份会包含我的 API Key 吗？**
+不会。默认备份**绝不包含任何密钥**，只记录哪些密钥需要重新填写。
 
-无需 `NPM_TOKEN` 仓库密钥——之前配置的令牌可以撤销（npm 也正在逐步废弃 bypass-2FA 令牌）。
+**Q：导入会不会覆盖我现有的配置？**
+不会偷偷覆盖。有冲突时让你选择：保留现有的 / 用导入的；导入前还会自动备份，失败可回滚。
 
-说明：
+**Q：换电脑（Windows → macOS）能用吗？**
+能。插件会自动检测失效的绝对路径，让你重新映射（支持批量替换）。
 
-- `package.json` 中的版本须与 tag 一致（`npm version` 会自动同步）。
-- 流水线会先升级 npm（`npm install -g npm@latest`），因为 OIDC 发布要求 npm ≥ 11.5.1。
-- 也可在 Actions 页面点 **Run workflow** 手动触发。
+**Q：导出的 ZIP 被改坏了还能导入吗？**
+不能。校验和检查不通过会直接拒绝导入（防止损坏或篡改）。
 
-## Testing
+**Q：重复导入会重复吗？**
+不会。按插件 ID / MCP 名称 / 技能名等稳定标识去重，重复导入自动跳过已有项。
 
-测试框架为 **node:test（Node 内置，零依赖）**，沿用核心模块的既有选择（不引入 vitest）。测试位于 `src/**/*.test.ts` 与 `tests/**/*.test.ts`。
+---
 
-覆盖矩阵（规范 §33 + 验收场景 A-G）：
+## 📋 已知限制（用户须知）
 
-| 组 | 覆盖 |
-|---|---|
-| Export | 正常 / 空配置 / 大配置(1MB+) / Unicode / 特殊字符 / Secret 过滤 |
-| Import | 正常 / Merge / Replace / Skip（不删目标独有 §32）/ Conflict / Missing plugin / Missing dependency / Missing secret / 未确认拒绝 |
-| Rollback（场景 E） | 多 adapter 混合中途失败 → 整体恢复（settings / 文件 blob / workspace / patch 行）；`rollbackOnError=false` 对照；部分回滚诚实报告 |
-| Migration（场景 G） | `migrateToCurrent` 机制级：同版本 / 过新 / 低于最低 / 无路径 / 注册重叠 / 链式推进（**如实说明：当前 v1 即最新，无真实 v2 可端到端验证**） |
-| Security（场景 F） | 畸形 ZIP / 超大条目数 / checksum 不匹配与缺失 / Zip Slip / 绝对路径 |
-| Cross-platform（场景 B） | win32→darwin / darwin→win32 / linux→win32 批量前缀映射 |
-| Redaction | 日志消息 / meta / 全链路不泄 Secret 值 |
-| Schema | manifest 结构校验 / 版本判定函数 |
-
-当前测试结果：**186 tests, all passing**（`npm test`），`npm run typecheck` 与 `npm run build` 均通过。
-
-## Known limitations
-
-1. **Workspace 只能建/改标题**：DSH 的 workspace 服务没有「整体覆盖」写通道——导入时可创建 workspace 与更新标题；path 与会话列表由 DSH 依真实目录自行维护，跨设备路径通过路径映射适配。
-2. **部分 DSH 核心包未发布公共 npm registry**（如 `@deepseek-ai/dsh-plugin-marketplace`、`dsh-host-plugin-inventory`）：依赖其 API 的功能只在本地 profile 环境可用；安装本插件需跳过 peer 自动安装（见 [Installation](#installation) 的 `--legacy-peer-deps` 说明）。
-3. **MCP 无管理 API**（研究报告 §4.3）：MCP 以组合 patch 行导入，需重启 DSH 生效；无增删改 API。
-4. **插件安装需重启**：`pluginMarketplace.installPlugin` 只返回 `needsRestart`，重启依赖 DSH Desktop。
-5. **浏览器 localStorage UI 状态不迁移**（任务看板数据、面板宽度等）：Host 无通道。
-6. **keybindings / workflows 配置 / commands / rules 文件**：DSH 当前无这些概念，不实现分区（不发明）。
-7. **凭据值无法回滚**：DSH 不回读凭据值，导入中覆盖的凭据在回滚时只能标记 `manualHint` 人工补录。
-8. **新建项无法删除回滚**：DSH settings 无删除语义，导入新建的 namespace 在回滚时只能人工处理（如实报告 partial）。
-9. **Schema 迁移**：v1→v2 为占位（当前 `CURRENT_SCHEMA_VERSION=1`），机制已就绪但无真实 v2 可验证。
-10. **历史会话迁移**：默认关闭，v1 仅文件级复制。
-11. **加密备份**：依赖用户设置强密码；密码丢失则 `secrets.enc` 无法解密（设计使然）。
-
-## Manual Test（最短人工测试流程）
-
-> 前提：两台 DSH（或同一台的两份配置目录）；本插件已按 [Installation](#installation) 打包并安装。
+1. **安装/更新插件或 MCP 后需重启 DSH 才生效**
+2. **部分界面状态不迁移**（如任务看板数据、面板宽度——它们存在浏览器里，不在 DSH 配置文件内）
+3. **keybindings / workflows 配置 / commands / rules**：DSH 当前没有这些概念，因此不会导出相关内容
+4. **历史会话默认不迁移**（v1 仅支持文件级复制）
+5. **加密备份**：密码丢失则无法解密（设计使然——请牢记密码）
 
-```
-DSH A
-→ 打开 Config Manager → Export Configuration
-→ 选择 Quick Export → 导出 dsh-config-<date>.zip（确认报告中 Secret 均被排除）
-→ 将 ZIP 复制到 DSH B
-
-DSH B
-→ 打开 Config Manager → Import Configuration
-→ 选择 ZIP → 等待 Analyzing... → 查看 Import Preview（分区/插件/路径映射/凭据补录清单）
-→ 如有路径问题 → 选择映射目录（批量前缀映射）
-→ 解决冲突（Keep Current / Use Imported / Review）
-→ 确认 Import → 观察进度 → 查看结果报告
-→ 补充缺失凭据（N credentials need attention）
-→ Verify：确认 settings / 插件 / MCP / Prompts / Skills / Workspaces 已恢复；
-   若导入中途失败 → 确认已自动回滚、原配置可正常使用
-```
+> 维护者与开发者：构建、测试、自动发布与完整技术说明见 [DEVELOPERS.md](DEVELOPERS.md)。
 
 ---
 
-**产品原则**：宁可少迁移一个配置，也不要破坏用户现有配置。任何 Import 都遵循 `Analyze → Preview → Backup → Modify → Validate → Rollback`；任何 Secret 都遵循 `不默认导出 / 不记日志 / 不暴露 / 不静默转移`。
+**产品原则**：宁可少迁移一个配置，也不要破坏你现有的配置。任何导入都遵循 `分析 → 预览 → 备份 → 修改 → 验证 → 回滚(如需要)`；任何密钥都遵循 `不默认导出 / 不记日志 / 不暴露 / 不静默转移`。

package/lib/client.js

@@ -559,93 +559,93 @@ if (typeof document !== "undefined" && document.querySelector("style[data-tag=\"
 	document.head.appendChild(tag);
 }
 var config_manager_module_css_default = {
+	"actionRow": "_367UGW_actionRow",
+	"formError": "_367UGW_formError",
+	"errorItem": "_367UGW_errorItem",
+	"secretFields": "_367UGW_secretFields",
+	"section": "_367UGW_section",
+	"sectionBody": "_367UGW_sectionBody",
+	"groupHeader": "_367UGW_groupHeader",
+	"fieldLabel": "_367UGW_fieldLabel",
 	"input": "_367UGW_input",
-	"dangerButton": "_367UGW_dangerButton",
-	"badgeInfo": "_367UGW_badgeInfo",
-	"errorReason": "_367UGW_errorReason",
-	"pathMappingList": "_367UGW_pathMappingList",
-	"sectionTitleBlock": "_367UGW_sectionTitleBlock",
-	"radioLabel": "_367UGW_radioLabel",
-	"modeTab": "_367UGW_modeTab",
 	"groupLabel": "_367UGW_groupLabel",
-	"actionRow": "_367UGW_actionRow",
-	"spinnerWrap": "_367UGW_spinnerWrap",
-	"groupNote": "_367UGW_groupNote",
-	"dshCmSpin": "_367UGW_dshCmSpin",
+	"radioLabel": "_367UGW_radioLabel",
+	"modeTabs": "_367UGW_modeTabs",
 	"progressMeta": "_367UGW_progressMeta",
-	"groupItems": "_367UGW_groupItems",
-	"categoryName": "_367UGW_categoryName",
-	"section": "_367UGW_section",
-	"badgeOk": "_367UGW_badgeOk",
+	"conflictHead": "_367UGW_conflictHead",
+	"conflictOptions": "_367UGW_conflictOptions",
+	"conflictId": "_367UGW_conflictId",
+	"pathIssueKind": "_367UGW_pathIssueKind",
+	"iconButton": "_367UGW_iconButton",
+	"empty": "_367UGW_empty",
+	"dshCmSpin": "_367UGW_dshCmSpin",
+	"errorActionLabel": "_367UGW_errorActionLabel",
+	"progressLabel": "_367UGW_progressLabel",
 	"errorList": "_367UGW_errorList",
-	"progressBarDone": "_367UGW_progressBarDone",
+	"conflictList": "_367UGW_conflictList",
+	"severityError": "_367UGW_severityError",
+	"banner": "_367UGW_banner",
+	"card": "_367UGW_card",
+	"pathMappingList": "_367UGW_pathMappingList",
+	"spinnerWrap": "_367UGW_spinnerWrap",
+	"badgeInfo": "_367UGW_badgeInfo",
+	"pathOld": "_367UGW_pathOld",
+	"pathRow": "_367UGW_pathRow",
+	"spinner": "_367UGW_spinner",
+	"groupItems": "_367UGW_groupItems",
+	"errorLine": "_367UGW_errorLine",
 	"conflictItem": "_367UGW_conflictItem",
-	"errorItem": "_367UGW_errorItem",
+	"progressBarDone": "_367UGW_progressBarDone",
 	"sectionTitle": "_367UGW_sectionTitle",
-	"sectionBody": "_367UGW_sectionBody",
+	"pathValue": "_367UGW_pathValue",
+	"dshCmIndeterminate": "_367UGW_dshCmIndeterminate",
 	"progressBlock": "_367UGW_progressBlock",
-	"hint": "_367UGW_hint",
+	"progressPercent": "_367UGW_progressPercent",
+	"badgeWarn": "_367UGW_badgeWarn",
+	"sectionSubtitle": "_367UGW_sectionSubtitle",
+	"conflictDetail": "_367UGW_conflictDetail",
 	"hiddenFile": "_367UGW_hiddenFile",
-	"groupList": "_367UGW_groupList",
-	"progressDetail": "_367UGW_progressDetail",
-	"conflictHead": "_367UGW_conflictHead",
-	"errorLine": "_367UGW_errorLine",
-	"optionsCard": "_367UGW_optionsCard",
 	"groupCard": "_367UGW_groupCard",
-	"card": "_367UGW_card",
+	"viewTabs": "_367UGW_viewTabs",
+	"spinnerLabel": "_367UGW_spinnerLabel",
+	"viewTab": "_367UGW_viewTab",
+	"progressIndeterminate": "_367UGW_progressIndeterminate",
+	"dangerButton": "_367UGW_dangerButton",
+	"field": "_367UGW_field",
+	"progressBar": "_367UGW_progressBar",
+	"sectionTitleBlock": "_367UGW_sectionTitleBlock",
+	"groupList": "_367UGW_groupList",
+	"progressTrack": "_367UGW_progressTrack",
+	"reportText": "_367UGW_reportText",
+	"rollbackBox": "_367UGW_rollbackBox",
+	"secretsList": "_367UGW_secretsList",
 	"warnList": "_367UGW_warnList",
-	"dshCmIndeterminate": "_367UGW_dshCmIndeterminate",
-	"reportFooter": "_367UGW_reportFooter",
-	"errorFooter": "_367UGW_errorFooter",
+	"pathNew": "_367UGW_pathNew",
+	"badgeOk": "_367UGW_badgeOk",
+	"statRow": "_367UGW_statRow",
 	"errorBanner": "_367UGW_errorBanner",
-	"groupHeader": "_367UGW_groupHeader",
+	"hint": "_367UGW_hint",
+	"sectionHeader": "_367UGW_sectionHeader",
+	"progressDetail": "_367UGW_progressDetail",
+	"reportFooter": "_367UGW_reportFooter",
+	"ghostButton": "_367UGW_ghostButton",
+	"checkboxRow": "_367UGW_checkboxRow",
+	"groupNote": "_367UGW_groupNote",
 	"categoryItem": "_367UGW_categoryItem",
 	"errorAction": "_367UGW_errorAction",
 	"categoryDesc": "_367UGW_categoryDesc",
-	"secretsList": "_367UGW_secretsList",
-	"viewTab": "_367UGW_viewTab",
-	"progressPercent": "_367UGW_progressPercent",
-	"reportView": "_367UGW_reportView",
-	"conflictDetail": "_367UGW_conflictDetail",
-	"ghostButton": "_367UGW_ghostButton",
-	"checkboxRow": "_367UGW_checkboxRow",
-	"iconButton": "_367UGW_iconButton",
 	"primaryButton": "_367UGW_primaryButton",
+	"categoryName": "_367UGW_categoryName",
+	"reportView": "_367UGW_reportView",
+	"errorFooter": "_367UGW_errorFooter",
+	"optionsCard": "_367UGW_optionsCard",
 	"errorTitle": "_367UGW_errorTitle",
-	"conflictOptions": "_367UGW_conflictOptions",
-	"sectionHeader": "_367UGW_sectionHeader",
-	"progressTrack": "_367UGW_progressTrack",
-	"progressIndeterminate": "_367UGW_progressIndeterminate",
-	"formError": "_367UGW_formError",
-	"empty": "_367UGW_empty",
-	"spinner": "_367UGW_spinner",
-	"pathRow": "_367UGW_pathRow",
-	"pathIssueKind": "_367UGW_pathIssueKind",
-	"sectionSubtitle": "_367UGW_sectionSubtitle",
 	"badgeError": "_367UGW_badgeError",
-	"conflictId": "_367UGW_conflictId",
-	"viewTabs": "_367UGW_viewTabs",
-	"modeHint": "_367UGW_modeHint",
-	"pathOld": "_367UGW_pathOld",
-	"field": "_367UGW_field",
-	"statRow": "_367UGW_statRow",
-	"banner": "_367UGW_banner",
-	"fieldLabel": "_367UGW_fieldLabel",
-	"modeTabs": "_367UGW_modeTabs",
-	"progressBar": "_367UGW_progressBar",
-	"errorActionLabel": "_367UGW_errorActionLabel",
-	"pathNew": "_367UGW_pathNew",
-	"spinnerLabel": "_367UGW_spinnerLabel",
-	"rollbackBox": "_367UGW_rollbackBox",
-	"reportText": "_367UGW_reportText",
+	"badge": "_367UGW_badge",
+	"errorReason": "_367UGW_errorReason",
+	"modeTab": "_367UGW_modeTab",
 	"viewBody": "_367UGW_viewBody",
-	"severityError": "_367UGW_severityError",
-	"conflictList": "_367UGW_conflictList",
-	"badgeWarn": "_367UGW_badgeWarn",
-	"progressLabel": "_367UGW_progressLabel",
-	"secretFields": "_367UGW_secretFields",
-	"pathValue": "_367UGW_pathValue",
-	"badge": "_367UGW_badge"
+	"modeHint": "_367UGW_modeHint"
 };
 //#endregion
 //#region src/client/common/ui.tsx
@@ -1651,23 +1651,19 @@ function nextFlowPhase(list, from) {
 * 冲突决策列表（规范 §11，绑 src/ui/conflict-view.ts 的 ConflictCollector）。
 *
 * 渲染 plan 中 kind === 'Conflict' 的项，用户逐项选择
-* Keep Current / Use Imported / Review；决策实时写入 collector，
+* Keep Current / Use Imported；决策实时写入 collector，
 * 完成时父组件调用 collector.toResolutions() → wizard.setResolutions()。
+*
+* 注意：不提供 "Review（稍后决定）" 选项——Review 会被收集器计为
+* unresolved，导致「下一步」永远禁用（死路）。要么决策，要么不进入本步。
 */
-const RESOLUTION_OPTIONS = [
-	{
-		value: "keepCurrent",
-		key: "import.conflicts.keepCurrent"
-	},
-	{
-		value: "useImported",
-		key: "import.conflicts.useImported"
-	},
-	{
-		value: "review",
-		key: "import.conflicts.review"
-	}
-];
+const RESOLUTION_OPTIONS = [{
+	value: "keepCurrent",
+	key: "import.conflicts.keepCurrent"
+}, {
+	value: "useImported",
+	key: "import.conflicts.useImported"
+}];
 /** 冲突项决策列表 */
 function ConflictList({ collector, t, onChanged }) {
 	const [tick, setTick] = (0, react.useState)(0);