dsh-config-manager 0.1.71 → 0.1.72

package/README.zh-CN.md

@@ -60,11 +60,11 @@ DSH 是你的 AI 助手工作台，里面存着你的各种设置：模型配置
 
 ### 在多台电脑间同步 DSH 配置
 
-通过私有 Git 仓库或 WebDAV 在多台电脑间保持可移植配置同步——密钥默认不参与同步（同步载荷会被 SecretScanner 剥离）；勾选「导出密钥」并设置加密密码后，`~/.dsh/.credentials.yaml` 会以 scrypt + AES-256-GCM 密文随加密快照上行，换机后可随同步写回本机凭据，远端（Git 仓库 / WebDAV 服务商）全程只见密文。
+通过私有 Git 仓库、WebDAV、S3 兼容对象存储（AWS S3 / 阿里云 OSS / 腾讯 COS / MinIO / 七牛 Kodo）或 GitHub Gist 在多台电脑间保持可移植配置同步——密钥默认不参与同步（同步载荷会被 SecretScanner 剥离）；勾选「导出密钥」并设置加密密码后，`~/.dsh/.credentials.yaml` 会以 scrypt + AES-256-GCM 密文随加密快照上行，换机后可随同步写回本机凭据，远端（仓库 / WebDAV / 对象存储 / Gist）全程只见密文。
 
 ### 定时自动全量备份
 
-开启定时备份（6h / 12h / 24h / 7d），DSH 会在后台按固定周期悄悄保留一份全新的全量配置备份——密钥永不包含，无需密码也能安心躺在磁盘上。
+在首页的「定时备份」卡里开启（6h / 12h / 24h / 7d，或自定义「每周固定星期与时刻」），DSH 会在后台按周期悄悄保留一份全新的全量配置备份——密钥永不包含，无需密码也能安心躺在磁盘上；保留多少份由同一张卡的「保留策略」（最近 N 份 + 每月 1 份 + 每年 1 份）决定，连续失败会在卡里标红。
 
 ### 从配置市场发现并安装共享配置
 
@@ -83,7 +83,7 @@ DSH 生态里这个方向有几个插件，它们解决的问题并不相同—
 | 插件 | 最擅长 | 本插件更进一步的地方 |
 |---|---|---|
 | [xiaoyuyu6420/dsh-backup](https://github.com/xiaoyuyu6420/dsh-backup) | 一条命令从 CLI 给整个 `~/.dsh` 打快照，另有会话体检 / 升级快照 / 救援控制台 | 写盘前可审阅的 GUI 流程（dry-run 预览、冲突逐项决策、失败自动回滚）、跨机路径重映射、加密凭据载荷、配置市场 |
-| [muyifc/dsh-config-sync](https://github.com/muyifc/dsh-config-sync) | 把 DSH 配置导出/导入成可移植的密码加密文件，可被工具调用 | 13–14 个分区（插件 / MCP / 技能 / 工作区 / 会话日志 …）、定时备份、Git + WebDAV 双通道同步、会话跨机迁移与路径重定基 |
+| [muyifc/dsh-config-sync](https://github.com/muyifc/dsh-config-sync) | 把 DSH 配置导出/导入成可移植的密码加密文件，可被工具调用 | 13–14 个分区（插件 / MCP / 技能 / 工作区 / 会话日志 …）、定时备份、四条同步通道（Git / WebDAV / 对象存储 / Gist）、会话跨机迁移与路径重定基 |
 | [dickpy/dsh-cloud-sync](https://github.com/dickpy/dsh-cloud-sync) · [weibaohui/dsh-sync](https://github.com/weibaohui/dsh-sync) | 通过 WebDAV / S3 或私有 Git 镜像让多台机器保持一致 | 同步只是本插件五项能力之一——另有导出/导入、定时备份、配置市场与档案实例启停 |
 | `cp -r ~/.dsh`（或给 home 目录挂 Git） | 免费、零配置，纯文本配置够用 | 不处理密钥、不做路径重映射、抓不到 `link:` / `file:` 安装的本地插件、不动会话日志、没有冲突处理与回滚 |
 
@@ -95,24 +95,24 @@ DSH 生态里这个方向有几个插件，它们解决的问题并不相同—
 
 | 图标 | 功能 | 一句话说明 |
 |:---:|---|---|
-| 🚀 | **一键导出** | 点一下，把推荐配置打包成一个 ZIP |
+| 🚀 | **一键导出** | 打开导出流程，默认已勾好推荐分区，点一下打包成 ZIP（可逐分区 / 逐条目调整） |
 | 📦 | **一键导入** | 在另一台电脑点一下，环境就回来了 |
-| 👀 | **先预览再导入** | 导入前完整预览，**绝不偷偷改你的配置** |
-| ⚔️ | **冲突处理** | 遇到同名配置，让你自己选：保留现有的 / 用导入的 |
+| 👀 | **先预览再导入** | 先看「迁移前咨询」的结论与依据，再逐项选内容、逐项解决冲突，**绝不偷偷改你的配置** |
+| ⚔️ | **冲突处理** | 遇到同名配置，让你自己选：保留当前 / 使用备份（可批量） |
 | 🗺️ | **路径自动映射** | 换了电脑路径变了？自动检测并让你重新指定 |
 | 🔒 | **密钥安全** | API Key 默认不导出；非加密导入后提醒重新填写，加密备份用密码解锁恢复 |
 | ↩️ | **自动回滚** | 导入失败自动恢复原样，不会弄坏现有配置 |
-| 📸 | **快照恢复** | 撤销一次导入：整文件还原 + 卸载新增插件（CLI 与 GUI 均支持） |
-| 🔄 | **远程同步** | 通过 **Git 私有仓库或 WebDAV** 推送 / 拉取可移植配置（密钥默认不参与同步；加密快照可选携带密文凭据） |
-| ⏰ | **定时全量备份** | 按固定周期（6h / 12h / 24h / 7d）自动全量备份，一劳永逸，密钥永不包含 |
-| 🛒 | **配置市场** | 浏览并一键安装社区分享的配置——供应链警示 + 逐项内容选择（可就地看到改动与高风险分区） |
-| 🗂️ | **档案 Profiles（DSH profile）** | 直接管理 `$DSH_HOME/profiles/<name>`：列表 / 新建（官方模板）/ 重命名 / 物理删除 / **启动该档案（独立实例）** / **停止实例**（行内按钮按运行状态在「启动 ↔ 停止」间切换） |
+| 📸 | **快照恢复** | 在产物库对某份导入前快照点「恢复」：先看逐行对照的恢复计划，确认后整文件还原 + 卸载新增插件（CLI 与 GUI 均支持） |
+| 🔄 | **远程同步** | 通过 **Git 私有仓库 / WebDAV / S3 兼容对象存储 / GitHub Gist** 推送 / 拉取可移植配置，四条通道各配各的（密钥默认不参与同步；加密快照可选携带密文凭据） |
+| ⏰ | **定时全量备份** | 按固定周期（6h / 12h / 24h / 7d 或自定义每周固定时刻）自动全量备份，一劳永逸，密钥永不包含 |
+| 🛒 | **配置市场** | 浏览并一键安装社区分享的配置——供应链警示 + 逐项内容选择（可就地看到改动与高风险分区）；入口在产物库底栏「逛市场 / 发布到市场」或 ⌘K |
+| 🗂️ | **档案 Profiles（DSH profile）** | 在「环境 → 档案」里直接管理 `$DSH_HOME/profiles/<name>`：列表 / 新建（官方模板）/ 重命名 / 物理删除 / **启动该档案（独立实例）** / **停止实例**（行内按钮按运行状态在「启动 ↔ 停止」间切换） |
 | 🧩 | **本地插件随备份迁移** | `link:` / `file:` 安装的本地开发插件会被打包进备份，换机不再丢失 |
 | 🗄️ | **保留策略可配（GFS 分层）** | 「最近 N 份 + 每月留 1 份 + 每年留 1 份」，默认值等价旧行为 |
 | 🌐 | **双语界面** | 界面、报告与错误详情跟随 DSH 应用语言（中文 / English） |
 | 🤖 | **Agent 工具** | Agent 会话内直接备份 / 快照 / 恢复 / 同步 |
-| 💾 | **磁盘占用体检** | 备份页逐项列出本插件自身占了多少盘（备份 / 快照 / 同步副本 / 缓存 / 暂存），三档回收策略一目了然；**一键清理只碰可重建缓存与过期备份**，快照与同步数据永不在此删除 |
-| ⬆️ | **版本更新检查** | 「关于」页只读探测 npm 上的最新版本（缓存 10 分钟）；有新版本时既给可复制的升级命令，也提供一键**立即更新**（按该精确版本安装）——之后需重启 DSH 才生效，插件绝不代你重启；离线失败如实显示，不影响其它功能 |
+| 💾 | **磁盘占用体检** | 「环境 → 维护与诊断」逐项列出本插件自身占了多少盘（备份 / 快照 / 同步副本 / 缓存 / 暂存），三档回收策略一目了然；**一键清理只碰可重建缓存与过期备份**，快照与同步数据永不在此删除 |
+| ⬆️ | **版本更新检查** | 「关于」面板（导航右上角的图标）只读探测 npm 上的最新版本（缓存 10 分钟）；有新版本时既给可复制的升级命令，也提供一键**立即更新**（按该精确版本安装）——之后需重启 DSH 才生效，插件绝不代你重启；离线失败如实显示，不影响其它功能 |
 | 🧭 | **兼容性讲清楚** | 导入前显示「来源 DSH 版本 / 平台 → 本机」，并用**结构化原因**解释评分（跨平台 / 分区缺失 / 版本超前…），而不是只丢一句「部分兼容」 |
 | 🧳 | **从其它 AI Agent 导入** | 读取本机 Claude Code / Cursor / Codex / Hermes / Antigravity 等的配置**与历史会话**，翻译成标准 bundle，再走既有的预览 / 冲突 / 回滚流程导入 |
 
@@ -120,21 +120,13 @@ DSH 生态里这个方向有几个插件，它们解决的问题并不相同—
 
 ## 📸 功能截图
 
-| 总览 | 备份与快照 |
+| 首页 | 产物库 |
 |:---:|:---:|
-| ![总览](assets/screenshot-overview-zh.png) | ![备份与快照](assets/screenshot-backups-zh.png) |
+| ![首页](assets/screenshot-overview-zh.png) | ![产物库](assets/screenshot-backups-zh.png) |
 
-| 导出备份 | 导入预览 |
+| 同步（四条通道卡） | 环境 · 档案 |
 |:---:|:---:|
-| ![一键导出](assets/screenshot-export-zh.png) | ![导入预览](assets/screenshot-import-zh.png) |
-
-| 远程同步 | 配置市场 |
-|:---:|:---:|
-| ![远程同步](assets/screenshot-sync-zh.png) | ![配置市场](assets/screenshot-market-zh.png) |
-
-| 档案 Profiles |
-|:---:|
-| ![档案 Profiles](assets/screenshot-profiles-zh.png) |
+| ![同步](assets/screenshot-sync-zh.png) | ![环境 · 档案](assets/screenshot-profiles-zh.png) |
 
 ---
 
@@ -152,10 +144,11 @@ DSH 生态里这个方向有几个插件，它们解决的问题并不相同—
 
 ```
 选择 ZIP → 校验文件 → 检查完整性 → 检查版本 → 兼容性检查
-    → 扫描内容 → 生成导入计划 → 预览确认
-    → 自动备份当前配置 → 执行导入 → 验证 → 完成
+    → 扫描内容 → 生成导入计划 → 迁移前咨询（结论 + 依据）
+    → 选择要导入的内容 → 冲突逐项决策 → 路径映射 / 补录密钥
+    → 确认导入 → 自动备份当前配置 → 执行导入 → 验证 → 完成
                       │
-                      └─ 中途失败？→ 自动恢复原样（回滚）
+                      └─ 中途失败？→ 自动恢复原样（回滚，可在确认页关闭）
 ```
 
 ---
@@ -196,7 +189,7 @@ dsh plugin --profile web add dsh-config-manager@latest
 > dsh plugin --profile web add "dsh-config-manager@$(npm view dsh-config-manager version)"
 > ```
 >
-> 重启 DSH 后，可在 **设置 → 备份与迁移 → 关于** 看到实际运行的版本（版本变化时也会自动弹出更新内容）。
+> 重启 DSH 后，可在 **设置 → 备份与迁移 → 导航右上角的「关于」图标** 看到实际运行的版本（版本变化时也会自动弹出更新内容）。
 
 ### 从 GitHub 源码安装（`git+https://...`）
 
@@ -248,40 +241,53 @@ allowBuilds:
 
 ## 🚀 快速上手（3 分钟体验）
 
+> **界面速览**：一级只有 4 页 —— **首页**（这台机器现在怎么样 + 立即备份 / 导出 / 导入 / 远程同步四个动作）、**产物库**（本机快照 / 备份文件 / 远端快照 / 市场配置，所有「东西」都在这张列表里）、**同步**（Git / WebDAV / 对象存储 / Gist 四张通道卡）、**环境**（档案 / 维护与诊断）。**导出、导入、逛市场、发布到市场**是**流程面板**：从首页工具栏或产物库底栏打开，切到别的页就收起、切回来接着做。导航右上角四个图标分别是 ⌘K 命令面板、活动记录、迁移历史、关于。
+
 ```
 电脑 A（导出）
-  1. 打开 DSH → 设置 → 「备份与迁移」
-  2. 点「导出配置」→ 选「快速导出」
-  3. 得到一个 dsh-config-2026-08-14.zip（可确认报告里没有密钥）
+  1. 打开 DSH → 设置 → 「备份与迁移」→ 首页
+  2. 点工具栏「导出」→ 面板里默认已勾好推荐分区（要改就点「选择要导出的内容」逐分区 / 逐条目调整）
+  3. 点「开始导出」→ 完成后自动下载得到 dsh-config-<日期>-<随机后缀>.zip（报告里可确认没有密钥）
 
 把 ZIP 拷到电脑 B（导入）
-  1. 打开 DSH → 「备份与迁移」→「导入配置」
-  2. 选择 ZIP → 等待分析 → 查看「导入预览」
-  3. 有路径问题？→ 选择新路径（可批量映射）
-  4. 有同名配置冲突？→ 选择 保留现有的 / 用导入的
-  5. 确认导入 → 等待完成
-  6. 按提示重新填写缺失的 API Key
-  7. ✅ 设置 / 插件 / MCP / 技能 / 工作区 / 全局指令（AGENTS.md）都回来了
+  1. 打开 DSH → 「备份与迁移」→ 首页点「导入」（或产物库底栏「从文件导入」）
+  2. 选择 ZIP → 等待分析 → 先读「迁移前咨询」的结论与依据 → 点「下一步：选择要导入的内容」
+  3. 逐项勾选要导入的内容（不勾选的既不导入、也不进快照）
+  4. 有路径问题？→ 在「路径映射」里填新路径（支持批量前缀映射）
+  5. 有同名配置冲突？→ 逐项选「保留当前 / 使用备份」（可一键全选其一）
+  6. 「确认导入」→ 等待执行（执行前自动创建安全快照；「失败时整体回滚」可在确认页关闭）
+  7. 按提示补录缺失的 API Key
+  8. ✅ 设置 / 插件 / MCP / 技能 / 工作区 / 全局指令（AGENTS.md）都回来了
 ```
 
 ---
 
 ## 🧩 功能详解
 
-### 📤 导出（两种方式）
+### 📤 导出（一个流程 + 内容选择器）
+
+打开「导出」流程面板（首页工具栏「导出」，或产物库底栏「手动导出」），一屏完成：
 
-| 方式 | 说明 |
+| 区域 | 说明 |
 |---|---|
-| **快速导出**（推荐） | 一键导出推荐配置：设置 / UI / 模型 / 插件 / MCP / 技能 / Agent 预设 / 全局指令（AGENTS.md）/ 工作区等 |
-| **自定义导出** | 自己勾选要导出的分类 |
+| 选择要导出的内容 | 打开内容选择器：**分区 → 最小可拆单元**逐项勾选；默认已勾好推荐分区（可移植、非设备专属），随时可改 |
+| 安全选项 | 「加密备份」（scrypt + AES-256-GCM）与「导出密钥」两个独立开关；勾选导出密钥会自动联动加密（密钥绝不明文） |
+| 文件名与备注 | 自定义文件名与备注（备注让你在产物库里搜得到），非法字符由字段错误提示当场指出 |
+| 本次将导出 | 恒常显示的构成卡：真正会进包的每个分区与条目数、合计大小；**读不到的分区如实显示「读取中 / 读取失败」，不伪报 0** |
+| 结果 | 完成后**自动下载**到浏览器下载目录（报告里也可再下载）；报告逐条列出分区与告警 |
+
+> 导出只读、不写任何配置。文件内含清单 + 各分区数据 + SHA-256 校验和，默认命名 `dsh-config-<日期>-<6 位随机>.zip`（撞名自动递进，不覆盖已有备份）。
 
-> 导出文件：`dsh-config-<日期>.zip`，内含清单 + 各分类数据 + SHA-256 校验和。
+**导出补充：**
+- **导出前就能看**：构成卡在导出之前就给出会进包的分区与预估体积（不含密钥），不必先导出再翻报告
+- **自定义文件名与备注**：文件名默认自动生成，也可自己起名；备注会显示在产物库的**「备份文件」**列表里（备注随 `self` 分区一起被备份 / 同步带走）
 
 ### 📥 导入（安全流程）
 
 - **未确认不写入**：分析、预览阶段零修改
 - **先备份再导入**：执行前自动备份将被修改的配置
 - **失败自动回滚**：按你的选择整体回滚或跳过失败项继续
+- **导入后的下一步清单**：结果页会列出需要重启 DSH 的项（按插件 / MCP）、待补录的凭据，以及可重试的失败 / 跳过项
 
 ### 👀 导入预览（Dry Run）
 
@@ -299,8 +305,10 @@ allowBuilds:
 
 | 选项 | 含义 |
 |---|---|
-| **保留现有的** | 不动目标电脑的原配置 |
-| **用导入的** | 用备份里的配置覆盖 |
+| **保留当前** | 不动目标机现有的配置 |
+| **使用备份** | 用备份里的配置覆盖 |
+
+列表顶部还有「全部保留当前配置 / 全部使用备份配置」两个批量按钮。
 
 > 说明：刻意**不提供**「稍后决定 / 再看看」选项——未决的冲突会让导入无法继续，每个冲突都必须在继续前做出选择。
 
@@ -320,7 +328,7 @@ allowBuilds:
 - **会带走什么** —— MCP Servers、技能、全局指令（落成 `AGENTS.md`），以及**历史会话连同这些对话所属的工作区**（29 个来源；会话会重新编码成 DSH 的会话日志格式，并按它记录的 `cwd` 归位）。
 - **不会带走什么** —— 密钥**值**一律不读：只记录键名，由导入计划提示补录。DSH 没有对等结构的东西（Claude Code 的 hooks、斜杠命令等）会**报出明确的码**，不会静默丢掉。
 - **如实跳过** —— 没记录 `cwd` 的对话无处归位，会列为跳过（绝不猜进别的项目）；已知的有损项在导入**之前**就摆明。
-- **入口** —— 设置 →「备份与迁移」→ 导入 → **「从其它 agent 导入」**、⌘K 命令，或 CLI：`dcm import --from <来源> [--dry-run] [--out <路径>]`。
+- **入口** —— 首页工具栏「导入」→ 面板里的**「从其它 agent 导入」**（首页另有直达入口）、⌘K 的「从其它 agent 导入」，或 CLI：`dcm import --from <来源> [--dry-run] [--out <路径>]`。
 
 ### 🔒 密钥处理
 
@@ -331,27 +339,32 @@ allowBuilds:
 | 加密备份导入 | 必须输入导出时的加密密码解锁：输入→验证密码→凭据自动恢复，**无密码无法导入** |
 | 非加密导入后 | 提示「3 个密钥需要重新填写」，输入后仅保存在内存中写入 |
 
-### 🔄 远程同步（Git / WebDAV）
+### 🔄 远程同步（四条通道）
 
-通过**两种通道之一**在机器间推送 / 拉取可移植配置——除传输方式外，使用方式完全一致：
+「同步」页把每条通道列成一张卡，**四张恒显示**（未配置的是矮态，点卡里的按钮配置）——Git 私有仓库 / WebDAV 服务器 / 对象存储（S3 兼容：AWS S3、阿里云 OSS、腾讯 COS、MinIO、七牛 Kodo）/ GitHub Gist：
 
-| | Git 私有仓库 | WebDAV |
+| 通道 | 端点（非密字段） | 凭据（只进 DSH credentials，绝不回读） |
 |:---:|---|---|
-| **端点** | `repoUrl` | `webdav.url` |
-| **凭据** | 认证 token 存入 DSH credentials（`DSH_CONFIG_MANAGER_SYNC_TOKEN`） | `username` 存配置、可在界面回显；**密码永不同步、永不记日志**——存入 DSH credentials `DSH_CONFIG_MANAGER_SYNC_WEBDAV_PASSWORD` |
-
-- **远端保留跟本地同一套策略**：两通道都按你的备份计划保留——默认最新 **10** 个快照，可另设「每月 1 份 / 每年 1 份」分层；刚推上去的那份恒保留，更旧的自动删除。
-- **切换通道重新开始**：Git 与 WebDAV 的快照 / 共同祖先**互不共享**。切换通道后，同步从新远端的空基线重新开始——请先推送一个新快照。
+| **Git 私有仓库** | `repoUrl`（可直接从当前 token 可见的**私有**仓库里选，或就地新建一个私有仓库） | 访问令牌 → `DSH_CONFIG_MANAGER_SYNC_TOKEN` |
+| **WebDAV** | `webdav.url` | `username` 存配置、可在界面回显；**密码永不同步、永不记日志** → `DSH_CONFIG_MANAGER_SYNC_WEBDAV_PASSWORD` |
+| **对象存储（S3 兼容）** | 端点 / region / bucket / 对象键前缀 / AccessKey ID（标识符，可回显） | AccessKey Secret → 该通道自己的凭据槽位（同步文件里只留「已配置」标记） |
+| **GitHub Gist** | gist id / API 根 / 文件名前缀 | Gist token → 该通道自己的凭据槽位 |
+
+- **每条通道各配各的**：同步分区、自动同步（开关 + 兜底轮询间隔）、加密与「导出密钥」、远端快照、加密 / 解密密码都**按通道独立**，在它自己那张卡内配置（已配置的卡可折叠，免得 4 张全展开撑爆画布）。
+- **远端保留跟本地同一套策略**：按你的备份计划保留——默认最新 **10** 个快照，可另设「每月 1 份 / 每年 1 份」分层；刚推上去的那份恒保留，更旧的自动删除。
+- **切换通道重新开始**：各通道的远端快照 / 共同祖先**互不共享**。换一条通道（或断开重配）就是从新远端的空基线重新开始——请先推送一个新快照。
 - **WebDAV 认证**采用 HTTP Basic：`username` 存配置、可在界面回显；`password` 则实时从 DSH credentials 槽位 `DSH_CONFIG_MANAGER_SYNC_WEBDAV_PASSWORD` 读取——绝不出现于任何同步文件或日志。
-- **插件自动安装**：拉取差异时，备份里新增的插件会在确认导入时**自动安装**，无需在差异列表里逐项手动勾选；只有**版本冲突**的插件仍需要你决定「保留当前 / 采用备份」。
+- **插件自动安装**：拉取差异时，备份里新增的插件会在确认导入时**自动安装**，无需在差异列表里逐项手动勾选；只有**版本冲突**的插件仍需要你决定「保留当前 / 使用备份」。
+- **推送前先预览**：「推送」按钮先给出只读预览（分区 + 各分区条目数 + 相对基线的改动标记；没有基线时提示这是首个基线），确认后才真正写远端。
 - **密钥默认不同步**：同步载荷逐分区过 `SecretScanner`（敏感字段值剥离），凭据分区结构性排除。勾选「导出密钥」并设置加密密码后，`~/.dsh/.credentials.yaml` 以 scrypt + AES-256-GCM 密文作为**独立凭据载荷**随加密快照上行（不放进任何分区）；拉取侧解密后生成逐条「凭据迁移」项，你确认采纳才写回本机凭据（`credentials.set`）。加密/解密密码保存在本机 DSH 凭据库（`~/.dsh/.credentials.yaml` 的独立槽位）：勾选「加密备份」后自动记住（输入框留空即沿用），取消勾选或点「删除已保存密码」即清除 —— 密码绝不写入同步文件、响应、日志或导出备份，也绝不回传浏览器；解密密码只在拉取的快照确实加密时才会被使用。**自动同步恒不含凭据**（无密码可用，遇到加密快照会跳过）。
 
 ### 🛒 配置市场（Marketplace）
 
-浏览并一键安装社区分享的现成配置（模型 / Provider、插件、MCP、技能、Agent 预设……）：
+浏览并一键安装社区分享的现成配置（模型 / Provider、插件、MCP、技能、Agent 预设……）。入口在**产物库底栏的「逛市场 / 发布到市场」**（也可用 ⌘K）——它是**流程面板**，不是一级页面：
 
 - **内置官方市场**——只读、绑定官方公开仓库（官方徽章，不可编辑）；首次打开自动刷新，也支持手动拉取最新
-- **搜索与筛选**——关键词搜索、类别过滤、来源筛选（官方 / 个人）、排序（最近更新 / ⭐ 最多 / 名称 A–Z），并显示**来源仓库**的 ⭐ star 数（匿名查询，不触碰任何 token）
+- **搜索与筛选**——关键词搜索（匹配名称 / 描述 / 作者 / **分类**）、类别过滤、**分区筛选**（已下载过的条目会列出自己的分区，其余条目标注提示后排除）、来源筛选（官方 / 个人）、排序（最近更新 / ⭐ 最多 / 名称 A–Z），并显示**来源仓库**的 ⭐ star 数（匿名查询，不触碰任何 token）
+- **影响预览**——详情页在确认之前就列出「装它会改什么」（更新项 / 一致项 / 冲突项 / 待补录密钥 / 需要重启 DSH）
 - **供应链警示恒展示**——来源仓库 URL +「未经官方审核」+ 下载时间；**逐项内容选择**——选择页列出每个单元「本次将改动什么」并就地标出高风险分区（默认勾选，取消勾选即不导入、也不进快照）；历史会话 / 任意文件类高风险内容仍直接禁止上架
 - **安装复用安全导入管道**——分析 → 预览 → 自动备份 → 执行 → 回滚；确认前零写入
 - **「我的配置」**——GitHub 登录（device flow）后一键上传到**你自己的公开仓库**，并自动向官方市场仓库提交**收录 PR**；管理已上传条目（收录状态徽章：未收录 / PR 待审核 / 已收录）、一键更新、装回本地、删除（自动下架 PR）
@@ -359,7 +372,7 @@ allowBuilds:
 ### 🗂️ 档案（Profiles = DSH 自带 profile）
 
 「档案」就是 DSH 自己的 profile（`$DSH_HOME/profiles/<name>`）——一套**插件组合（bundles）+ 依赖 + patch 层**，
-用 `dsh --profile <name>` 启动。本页直接读写这个目录，不再自建一套「配置快照」：
+用 `dsh --profile <name>` 启动。「环境 → 档案」直接读写这个目录，不再自建一套「配置快照」：
 
 | 动作 | 说明 |
 |---|---|
@@ -369,11 +382,11 @@ allowBuilds:
 | 删除 | **物理删除整个目录**（含 node_modules）；当前运行中的档案需额外勾选确认 |
 | 启动该档案 | **真正可用的切换**：以该档案另起一个**独立 DSH 实例**（自动挑空闲端口 + 自动打开浏览器），当前实例与正在跑的任务不受影响；只支持 **web 形态**档案：非 web 形态（如 base 模板）没有浏览器界面，点击后给出终端命令而不是静默失败 |
 | 停止实例 | 该档案有实例在跑时，行内「启动」自动变成「停止」（运行状态卡里也有一个）；先请它自己退出（优雅期），超时才结束进程树，并如实告诉你是哪种；**实例运行中拒绝物理删除该档案** |
-| 不会重复启动 | 「哪些档案在跑」= 本插件启动的实例台账 ∪ **每个实例自报的心跳**（`<dataDir>/running/<profile>.json`，只含 pid/端口，**不含认证 token**）→ 哪怕某个档案是你手动 `dsh web` 起来的，本页也不会再启动第二个同名实例（明确提示已在运行）；**当前这个实例本身**不给停止按钮（停自己会把你自己杀掉——请关窗口/终端，或到启动它的那个实例里停止） |
+| 不会重复启动 | 「哪些档案在跑」= 本插件启动的实例台账 ∪ **每个实例自报的心跳**（`<dataDir>/running/<profile>.json`，只含 pid/端口，**不含认证 token**）→ 哪怕某个档案是你手动 `dsh web` 起来的，「档案」子视图也不会再启动第二个同名实例（明确提示已在运行）；**当前这个实例本身**不给停止按钮（停自己会把你自己杀掉——请关窗口/终端，或到启动它的那个实例里停止） |
 
 > **为什么没有「设为下次启动」**（2026-09 该按钮与标记一并移除）：DSH **没有「默认 / 下次启动 profile」这种状态** ——
 > profile 只由启动参数决定（`dsh <名>` / `--profile <名>`，`dsh web` 是硬编码别名），任何「下次启动用哪个」的标记
-> **都没有消费者**：你自己敲的 `dsh web` 重启后当然还是 web。真正可用的切换只有两种：① 本页的「启动该档案」
+> **都没有消费者**：你自己敲的 `dsh web` 重启后当然还是 web。真正可用的切换只有两种：① 「环境 → 档案」里的「启动该档案」
 > 另起一个实例（不打断当前会话，随时可停）；② 把启动命令/快捷方式换成 `dsh --profile <名>`
 > （生态里的 dshm、DSH Launcher 也都是「外部启动器 spawn 实例」这一条路）。
 > 本插件启动的实例记在 `<dataDir>/launches.json`（pid/端口/日志），所以**关得掉**；
@@ -390,14 +403,26 @@ allowBuilds:
 | 文件补偿 | skills / agentPresets / agentInstructions / pluginFiles / sessions 的 blob 写回原路径 |
 | 凭据 | DSH 不回读凭据值——只提示人工重新填写 |
 
-**GUI**：设置 → 「备份与迁移」→「快照恢复」tab → 选择快照 → 预览恢复计划（dry-run，零写入）→ 确认执行。
+**GUI**：产物库 → 源筛选切到**「本机快照」**→ 行内 ⋯ → **「恢复」**→ 先看恢复计划（dry-run，零写入；git 风格的逐行对照）→ 确认执行。行内还有「查看与对比 / 迁移前咨询 / 置顶 / 删除」等能力，按该行是什么产物给。
+
+**快照管理**：
+
+- **保留份数可见**：保留多少份由你的**保留策略**决定（首页「定时备份」卡；默认保留最新 **10** 份），列表里有提示
+- **置顶重要快照**：置顶的快照豁免自动清理，只能手动删除
+- **手动删除**：不再需要这个回滚点时可直接删除（危险操作，有二次确认）
+
+**备份文件**（产物库 → **「备份文件」**来源）：
+
+- 列出 `exports/` 里每一份导出 ZIP（手动导出 + 定时备份），带来源徽章、体积、时间与你写的**备注**
+- 按文件名或备注**搜索**
+- **查看与对比**：导入前先只读预览它包含什么（分区 + 各分区条目数）以及与当前配置的差异（零写入）
+- 下载、直接导入恢复、删除
 
-**备份文件与磁盘占用**：「备份与迁移」→「快照恢复」tab 下的**「备份文件」**子页统一管理 `exports/` 里的导出产物
-（手动导出 + 定时备份）——可下载、直接导入恢复、查看内容、删除，并按文件名/备注搜索。
-同页的**「磁盘占用」卡**会逐项列出本插件自己占用的空间（导出备份 / 导入前快照 / 同步配置与 Git 工作副本 /
-市场缓存 / 临时暂存 / 日志 / 事务日志 …），标注每项的回收策略：**可随时重建**（缓存与暂存）、
-**有保留期**（导出产物 7 天、定时备份保留最近 N 个）、**用户数据 / 安全网**（快照与同步，永不自动清理）。
-需要腾空间时点**「立即清理」**：默认只清可重建的缓存与暂存；要回收过期备份文件需显式勾选（并二次确认）。
+**磁盘占用**：在**环境 → 维护与诊断**的**「磁盘占用」卡**里，逐项列出本插件自己占用的空间
+（导出备份 / 导入前快照 / 同步配置与工作副本 / 市场缓存 / 临时暂存 / 日志 / 事务日志 …），
+标注每项的回收策略：**可随时重建**（缓存与暂存）、**有保留期**（导出产物 7 天、定时备份保留最近 N 个）、
+**用户数据 / 安全网**（快照与同步，永不自动清理）。需要腾空间时点**「立即清理」**：
+默认只清可重建的缓存与暂存；要回收过期备份文件需显式勾选「同时回收过期备份文件」（并二次确认）。
 **快照与同步数据永远不会被这个按钮删掉**；目录读不到时如实显示「未统计」，不会伪报 0 字节。
 
 ---
@@ -415,19 +440,40 @@ npm install -g dsh-config-manager@latest --omit=peer
 
 > ⚠️ 只安装/更新插件（`dsh plugin --profile web add ...`）只启用 GUI，**不会**产生 `dsh-config-manager` 命令。请先执行上面这条安装命令，然后使用下面任意命令。
 
-全部命令（`dsh-config-manager help` 也会列出）：
+全部命令（`dsh-config-manager help` 也会按风险分组列出；`dsh-config-manager <命令> --help` 打印该命令的参数、退出码与示例）：
 
 ```text
-dsh-config-manager help                                        # 列出全部命令与参数
+# 离线救急台（本机网页，最省打字）
+dsh-config-manager web [--port <n>] [--no-open] [--home <dir>]
+                       [--data-root <dir>] [--idle-timeout <min>]
+
+# 只读检查（绝不改你的配置）
 dsh-config-manager snapshots [--data-dir <dir>]                # 列出快照（最新在前）
-dsh-config-manager restore [--id <id>] [--dry-run]
+dsh-config-manager verify [<文件|路径>] [--json]                 # 只读自检备份 ZIP
+                           [--data-dir <dir>]
+dsh-config-manager sessions list   [--home <dir>] [--json]     # 列出本机会话
+dsh-config-manager sessions doctor [--home <dir>] [--json]     # 会话体检 + 建议
+
+# 备份与迁移（只写新文件）
+dsh-config-manager backup [--sections <a,b,c>] [--out <path>]  # 离线文件级备份
+                          [--dry-run] [--data-dir <dir>]
+dsh-config-manager import --from <来源> [--dry-run]              # 外部 agent 配置 → bundle ZIP
+                           [--out <路径>] [--cwd <dir>] [--data-dir <dir>]
+
+# 修复（会写本机 —— 先用 --dry-run 预览）
+dsh-config-manager restore [--id <id>] [--dry-run]             # 回滚到某份导入前快照
+                           [--data-dir <dir>] [--data-root <dir>]
                            [--profile <name>] [--settings <path>]
+dsh-config-manager sessions repair [--home <dir>] [--fix]      # 离线会话布局归位
+                                   [--keep <dir>] [--map old=new]...
+dsh-config-manager recover-stale-lock [--data-dir <dir>]       # 回收残留锁（见下）
+
+# 危险（改 DSH 安装本体 / 可能清数据）
 dsh-config-manager reinstall [--version <v>] [--yes] [--list]
-                             [--wipe-config] [--dry-run]       # 一键重装 DSH 程序本体
-dsh-config-manager verify [--id <文件|路径>] [--json]          # 只读自检备份 ZIP
-                          [--data-dir <dir>]
-dsh-config-manager backup [--sections <a,b,c>] [--out <path>] # 离线文件级备份
-                          [--dry-run] [--data-dir <dir>]
+                             [--wipe-config] [--dry-run] [--data-root <dir>]
+
+# 帮助
+dsh-config-manager help [command]                              # 总览 / 单条命令详情
 ```
 
 **`reinstall` —— DSH 损坏时的救急重装。** 跨平台一键重装 `@deepseek-ai/dsh` 启动器（按操作系统自动选用正确命令：Windows 走 PowerShell、Unix 走 bash）。默认重装启动器 + 清全局残留缓存；交互式多选会询问是否勾选**危险**清理项（设置 / 插件 / 会话与凭据）——这些**默认不勾选**，且只要涉及删数据的动作，执行前都必须**二次确认输入 `YES`**。清空 `~/.dsh` 数据前会先做一份 `.reinstall-backup` 紧急备份（`snapshots/` 目录按设计绝不触碰）。
@@ -498,6 +544,42 @@ dsh-config-manager backup --sections skills,self          # 收窄范围
 
 **典型救急流程**（DSH 起不来时）：① `dsh-config-manager reinstall` 先把启动器重装回来（必要时顺带清理），② 若 DSH 报会话日志错误（`corrupt session log` / `duplicate JSONL session id`），先跑 `dsh-config-manager sessions repair --fix` 把日志目录离线归位，③ `dsh web` 重新启动 DSH，④ 从仓库装回插件，⑤ 从远程仓库拉取快照（或执行 `dsh-config-manager restore`）把配置恢复回来。整个流程中 CLI 全程可用，与 DSH 是否健康无关。
 
+**`recover-stale-lock` —— 每次操作都突然失败时用这个。** 动你的配置之前，插件会先占一把小的环境锁（记录谁在操作 + 心跳），让两个操作永远不可能同时写配置。如果某个 `dsh web` 进程被**强杀**（任务管理器 / `kill -9`），锁文件会带着一个已经死掉的持有者留在盘上：下一次操作被拒，而且**重试多少次、重启 DSH 都没用** —— 因为插件刻意从不自行删锁（猜错就会把正在进行的操作踢掉）。
+
+症状与修法：
+
+| 症状 | 含义 | 修法 |
+|---|---|---|
+| 「另一个任务正在运行，请稍后重试。」 | 有活着的操作持锁 | 等一会儿，它会自己清 |
+| 「检测到上次异常退出残留的配置锁…重试或重启 DSH 均无效」（日志里是 `自动同步已跳过`） | 持有者进程**已被证明死亡**（残留锁） | 跑下面这条命令，或用 GUI **事故恢复 → 回收残留锁** |
+| 同一句提示，但持有者 PID 被一个无关进程**复用**了（Windows 常见） | 心跳已陈旧很久，锁仍被判成残留 | 同样的修法 —— 心跳陈旧时间远超阈值后即可回收 |
+
+```bash
+# 安全：先检查，证明持有者已死才回收（活着的锁绝不碰）
+dsh-config-manager recover-stale-lock
+```
+
+**`sessions repair` —— DSH 因为会话日志起不来时用这个。** DSH 校验每条会话日志必须正好待在自己 header 声明的目录里：`corrupt session log … header id and cwd identify …`，或 `duplicate JSONL session id … in multiple project directories`。这时插件帮不上忙（它只在 DSH *内部*加载），而这是唯一能在 DSH 停着时工作的修复路径。它读每条会话首帧的 cwd，把会话目录搬到 `projectKeyOf(cwd)` —— 位置从日志本身推导，绝不猜。
+
+- **默认 dry run**（零写入）；`--fix` 才真的搬。退出码：dry run 恒 0，`--fix` 有任何失败 / 冲突 / 回滚则 1。
+- **`--map old=new`**（可重复）用于跨机恢复：前缀命中时先改写首帧 cwd 再搬目录（其余帧逐字节拷贝）。目标已存在时绝不覆盖。
+- **`--keep <dir>`** 解决重复 id：你点名的副本保留，其余移入 `sessions/.cm-repair-quarantine-<时间戳>/` —— 只移动、绝不删除。不给 `--keep` 时只报告重复、不动。
+
+```bash
+# 先看会搬什么（完全不写盘）
+dsh-config-manager sessions repair
+# 执行，并把源机前缀映射到本机
+dsh-config-manager sessions repair --fix --map 'C:/Users/alice=D:/Work'
+```
+
+两台机器的 **DSH 基础路径不同**时（如 `/opt/dsh/.dsh` 对 Windows 盘符路径），备份里记着源机基础路径，导入会**自动重定基**：把它下面所有路径（会话 cwd、工作区路径…）落到你本机的路径上 —— 不用手填映射。用户映射仍在其后生效，可覆盖任何一条。
+
+在内容选择器里，勾选会话会连带勾选拥有它们的工作区（取消勾选工作区也会取消它的会话）。
+
+跨机恢复在 GUI 里不需要额外步骤：**导出会话现在会连带带上拥有它们的工作区**，导入向导里填的路径映射会同时改写工作区路径与会话首帧 cwd（并相应搬目录），然后才把这些会话登记到那些工作区上。
+
+**插件装好了但备份看不到？** 检查 **设置 → 备份与迁移 → 导航右上角的「关于」图标**：它会显示插件清单是从哪个目录 / profile 读的、识别到几个插件。清单来自 `$DSH_HOME/profiles/<profile>/package.json` → `dependencies`（外加 `dsh.profile.bundles` 里声明、但不是依赖的项），`<profile>` 按 `config.profile` → `--profile` → `web` 解析。如果显示的路径不是你装插件的那个 profile（桌面端可能用别的 profile 或别的 `DSH_HOME`），那就是原因 —— 把 `--profile` / `DSH_HOME` 对齐即可。
+
 **`web` —— 离线救急台（不想在终端里敲命令时用这个）。** 它在本机起一个**只绑 127.0.0.1** 的小网页，
 把上面的诊断信息与救急动作都摊在浏览器里：
 
@@ -506,12 +588,43 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
 ```
 
 - **只读部分**：实例心跳 / SAFE MODE / 残留锁 / 快照 / 导出产物（可一键自检）/ 磁盘占用 / 会话体检 / 档案与实例状态。
-- **写动作（都要在网页里显式确认）**：会话布局归位、清理可重建缓存与过期导出产物、回收残留环境锁、
-启动/停止某个档案的独立实例。它们调用的是与命令行**同一套实现**，结果页逐条如实回执。
+- **写动作（每个都要在网页里显式确认，且都调用与命令行同一套实现）**：① 会话布局归位 ② 清理可重建缓存与过期导出产物
+③ 回收残留环境锁 ④ 启动 / 停止某个档案的独立实例 ⑤ **解锁加密备份**（只在内存里解密、只列条目，绝不写盘）
+⑥ **恢复快照**（先看逐条计划，零写入；恢复前先把当前文件复制到 `<snapshot>/pre-restore/`）⑦ **离线导出**（文件类分区，落盘后立即自检）
+⑧ **重装 DSH**（卸载 + 重装全局 CLI，**要求输入只打印在终端里的 6 位校验码**）。结果页逐条如实回执。
 - **安全**：只绑回环地址；启动时生成一次性 token（只打印在终端），换成一个 HttpOnly + SameSite=Strict 的
 会话 cookie，用过即废；页面零脚本、零外链。`Ctrl+C` 或空闲超时（缺省 30 分钟）即退出。
-- **门槛**：会话归位需要 DSH 已停止；有 SAFE MODE 未结案时写动作一律被拒（页面会写明原因）。
-  恢复快照（`restore`）与重装（`reinstall`）**不在网页里** —— 它们需要更强的确认，留在命令行/GUI。
+- **门槛**：会话归位与恢复快照需要 DSH 已停止；有 SAFE MODE 未结案或残留环境锁时写动作一律被拒（页面会写明原因）。
+  **导入**（把 bundle 写回本机）留在 GUI/CLI —— 结构化分区需要 DSH 服务层在线。
+
+### 🌐 走代理？(GitHub 登录 / 同步)
+
+Node 内置的 `fetch()` 默认**不读** `HTTP_PROXY` / `HTTPS_PROXY`，所以在「GitHub 只能经本地代理访问」的网络里，「用 GitHub 登录」以前会直接失败：`请求 GitHub 设备码失败：fetch failed` —— 哪怕你的浏览器和 `git` 都正常。
+
+**现在插件会把自己的出站请求自动走你的代理** —— 只要保证代理环境变量对 DSH 进程可见：
+
+```bash
+# macOS / Linux —— 启动 dsh 之前
+export HTTPS_PROXY=http://127.0.0.1:7897
+export NO_PROXY=localhost,127.0.0.1
+dsh web
+```
+
+```powershell
+# Windows PowerShell
+$env:HTTPS_PROXY='http://127.0.0.1:7897'; dsh web
+```
+
+行为细节：
+
+- **覆盖插件全部出站**：GitHub API + device flow 登录（`fetch`）与 WebDAV 同步（原生 `http`/`https`），`https` 目标含 `CONNECT` 隧道；
+- **没配代理就零影响** —— 没有代理变量时行为一字不变；
+- **尊重 `NO_PROXY`**（`*`、精确主机、`example.com` 后缀、可选 `:port`）；
+- **`DSH_CONFIG_MANAGER_PROXY=off`** 强制直连（即使有代理变量）；
+- URL 里的代理凭据只用于 `Proxy-Authorization`，且**绝不记日志**；启动日志会打印一份脱敏的代理摘要，便于确认路由是否生效；
+- 这是**插件私有**行为：绝不改全局 / 进程级网络设置（不同于 `NODE_USE_ENV_PROXY`，那会影响整个宿主进程，包括模型 API 调用）。
+
+替代方案（宿主级）：在启动 DSH **之前**设 `NODE_USE_ENV_PROXY=1`（Node 24+）；注意这会把宿主自己的出站流量也一起走代理，不只是本插件。
 
 ### 🤖 Agent 可调用的模型工具
 
@@ -556,7 +669,7 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
 默认不会。默认备份**绝不包含任何密钥**，只记录哪些密钥需要重新填写。若你显式选择**加密备份**，密钥才会包含在内，但仅以 scrypt + AES-256-GCM 密文存在（每次导出随机 salt 与 IV）——绝不明文。
 
 **Q：导入会不会覆盖我现有的配置？**
-不会偷偷覆盖。有冲突时让你选择：保留现有的 / 用导入的；导入前还会自动备份，失败可回滚。
+不会偷偷覆盖。有冲突时让你逐项选择：保留当前 / 使用备份（可批量）；导入前还会自动创建安全快照，失败可回滚。
 
 **Q：换电脑（Windows → macOS）能用吗？**
 能。插件会自动检测失效的绝对路径，让你重新映射（支持批量替换）。
@@ -565,7 +678,7 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
 不能。校验和检查不通过会直接拒绝导入（防止损坏或篡改）。
 
 **Q：重复导入会重复吗？**
-不会。按插件 ID / MCP 名称 / 技能名等稳定标识配对：完全一致的跳过，与目标机有差异的会列为**冲突由你决定**（保留本机 / 用导入的），不会静默覆盖。
+不会。按插件 ID / MCP 名称 / 技能名等稳定标识配对：完全一致的跳过，与目标机有差异的会列为**冲突由你决定**（保留当前 / 使用备份），不会静默覆盖。
 
 **Q：加密备份导入时需要密码吗？**
 需要。导入向导会要求输入导出时设置的加密密码并验证通过后才能继续执行；密码仅存于内存、绝不保存。密码错误或缺失都会阻止导入（密码正确时凭据直接从备份解密恢复，无需重新填写）。
@@ -580,7 +693,7 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
 1. **安装/更新插件或 MCP 后需重启 DSH 才生效**
 2. **部分界面状态不迁移**（如任务看板数据、面板宽度——它们存在浏览器里，不在 DSH 配置文件内）
 3. **keybindings / workflows 配置 / commands**：DSH 当前没有这些概念，因此不会导出相关内容。全局 agent 规则已由**全局指令（Agent Instructions）**承接（`~/.dsh/AGENTS.md`，注入每个会话）；项目级 `AGENTS.md` / `CLAUDE.md` 属于各项目仓库本身，不在个人配置迁移范围内
-4. **历史会话是显式可选项** —— DSH 自己的会话只有在导出 / 同步时**显式勾选 `sessions` 分区**才会带走（同步通道还要求两侧都放行）；**其它 Agent 的历史会话在你选中那个来源时迁移**。DSH 会话格式里没有位置的对话状态（模型思考过程、图片、压缩检查点）一律**如实计数并报告**，绝不伪造
+4. **历史会话是显式可选项** —— DSH 自己的会话只有在导出 / 同步时**显式勾选 `sessions` 分区**才会带走（同步通道还要求两侧都放行）；**MCP 服务器是另一个显式可选的同步分区**——`mcp` 分区是 `platformSpecific`，永不进默认同步集合，要在同步分区弹窗里勾选 **MCP Servers** 才会带走（自动同步跟着走，但拉取侧的 mcp 变更仍会落进差异确认，它是 medium 风险分区）。`command` / `cwd` 是绝对路径、或目标机缺运行时（npx / uvx / pipx）的服务器，会由导入分析给出提示——配置照常写入；**其它 Agent 的历史会话在你选中那个来源时迁移**。DSH 会话格式里没有位置的对话状态（模型思考过程、图片、压缩检查点）一律**如实计数并报告**，绝不伪造
 5. **加密备份**：密码丢失则无法解密（设计使然——请牢记密码）
 6. **快照恢复是离线的、诚实的**：离线引擎无法恢复的条目（快照无整文件备份时的 settings namespace / patch 行、存在 DSH storages 里的 workspace 记录）会如实列为跳过并指向在线回滚；凭据**值**绝不自动改写（只提示人工补录）；无插件基线的旧快照只提示人工核对新增插件
 7. **从其它 Agent 导入有两处已知空白**：**Copilot 不支持导入历史会话**（其会话格式在本机无法取证，只导入它的配置）；Cursor 的项目历史要靠它自己的目录 slug 反解，个别项目可能对不上。用**旧版本**导入过的会话请先删掉再重导（同一 id 二次导入会如实报**跳过** `session-id-conflict`，不会合并）
@@ -598,7 +711,7 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
 | 💬 **不确定是不是 Bug，想先问问** | [Discussions](https://github.com/xiajiajun516/dsh-config-manager/discussions) |
 | 🔒 **安全问题 / 密钥泄露** | [私密安全公告](https://github.com/xiajiajun516/dsh-config-manager/security/advisories/new)（请不要开公开 issue） |
 
-**在插件里就地反馈**：设置 → 备份与迁移 → **关于** → 「反馈问题」；或点「关于」里的**复制环境信息**按钮，插件版本 / DSH 版本 / 平台会自动带上，粘进 issue 即可 —— 不用手抄版本号。
+**在插件里就地反馈**：设置 → 备份与迁移 → 导航右上角的**「关于」图标** → 「反馈问题」；或点那里的**复制环境信息**按钮，插件版本 / DSH 版本 / 平台会自动带上，粘进 issue 即可 —— 不用手抄版本号。
 
 **每条都会跟进**：新 issue 会立刻收到一条回复并打上 `needs-triage`，处理进度体现在标签上（`needs-info` → `confirmed` → `fixed`）。修好的问题会出现在 [CHANGELOG.md](CHANGELOG.md) 的对应版本条目里，带 issue 编号（例：#38 / #43 / #45）—— 这就是一条反馈最终的落地记录。
 
@@ -616,8 +729,16 @@ dsh-config-manager web            # 启动并自动打开浏览器（终端里
   36×36 无底框的 `icon.svg`（issue #61，对齐官方插件图标约定）。反馈自带上游取证（宿主图位 48/36 与 40/30、
   官方随包发布的图标形态与官方 fixture），PR 里附 16/30/36/48 × 深浅双主题实况图，并对「不换成品牌蓝」写了
   可复核的理由（后片若同色，深色模式下两层会融成一块、16px 读不出前后关系）。
-- **问题报告**：`zhyx1996`（#38 同步「导出密钥」未生效）、`IPF-Sinon`（#39 凭据 `refs:` 块未被识别，并在自己的 fork
-  上完成实现与真机验证）、`zerginlaw`（#43「立即备份」空转却提示成功）—— 这三条报告各自驱动了一个修复。
+- **iuuuuuuuu** —— [PR #67](https://github.com/xiajiajun516/dsh-config-manager/pull/67)（合并提交 `780af10`）、
+  [PR #68](https://github.com/xiajiajun516/dsh-config-manager/pull/68)（`16e13c1`）、
+  [PR #72](https://github.com/xiajiajun516/dsh-config-manager/pull/72)（`6e552a0`）：① git 同步通道有了**仓库选择器** ——
+  从当前 token 可见的**私有**仓库里选（按最近更新排序，公开仓库不进列表），或就地新建私有仓库并自动选中；新建请求体
+  根本不带 `private`，客户端连表达「公开」的途径都没有，安全约束落在宿主侧；顺带修掉链接跟随边界判定的 `realpath` 口径
+  （Windows 8.3 短名与 macOS `/var` → `/private/var` 曾被误判 `outside-home`，备份报成功却静默丢内容）。
+  ② 「总览」首屏不再等一次全量预览：`plugins` 分区补上 `preview()`（不再逐个 spawn `npm pack`），`settings` 与
+  `credentialsStatus` 一次读回全部 namespace 而不是逐个 `describe`（真机 24 个 namespace × 12 个本地源插件，
+  全量预览 27.6 s）。③ 修 issue #71「外壳里配好的 MCP 与 Skills 备份不到」：patch 行按层读取、写回原层，技能改经
+  外壳的 `skills` 服务收编。三个 PR 均带单测与路由 / 源码级守卫。
 
 > 维护者与开发者：构建、测试、自动发布与完整技术说明见 [DEVELOPERS.md](DEVELOPERS.md)。
 

package/lib/adapters/agent-instructions.js

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

package/lib/adapters/file-collection.js

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

package/lib/adapters/index.d.ts

@@ -40,7 +40,7 @@ export declare function createAdapters(options?: AdapterRegistryOptions): Config
 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';

package/lib/adapters/index.js

@@ -38,7 +38,7 @@ export function createAdapters(options = {}) {
     return adapters;
 }
 export { SettingsAdapter } from './settings.js';
-export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, UI_MIGRATION_NOTES } from './ui.js';
+export { UiAdapter, isUiNamespace, KNOWN_UI_NAMESPACE_PREFIXES, uiMigrationNotes } from './ui.js';
 export { ProvidersAdapter, DEFAULT_PROVIDER_NAMESPACES } from './providers.js';
 export { PluginsAdapter, USER_PATCH_FILE } from './plugins.js';
 export { McpAdapter, extractMcpServers, buildMcpPatchLine } from './mcp.js';

package/lib/adapters/link-report.d.ts

@@ -9,6 +9,7 @@
  */
 import type { FileSystemFacade } from '../core/types.ts';
 import type { MsgFunc } from '../core/messages.ts';
+import './messages.ts';
 import type { RecursiveListing } from '../utils/recursive-walk.ts';
 /** 取遍历结果：宿主未实现 listRecursiveDetailed（旧版/测试 mock）时回退，行为与旧版一致。 */
 export declare function listFilesDetailed(fs: FileSystemFacade, dir: string): Promise<RecursiveListing>;