dsh-config-manager 0.1.65 → 0.1.66

package/README.md

@@ -1,5 +1,11 @@
 # 🎒 DSH Config Manager
 
+[![npm version](https://img.shields.io/npm/v/dsh-config-manager?label=npm)](https://www.npmjs.com/package/dsh-config-manager)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-config-manager?label=downloads%2Fmonth)](https://www.npmjs.com/package/dsh-config-manager)
+[![GitHub stars](https://img.shields.io/github/stars/xiajiajun516/dsh-config-manager?label=stars)](https://github.com/xiajiajun516/dsh-config-manager/stargazers)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/xiajiajun516/dsh-config-manager/blob/main/LICENSE)
+[![DSH plugin](https://img.shields.io/badge/DSH-plugin-blueviolet)](https://github.com/deepseek-ai/deepseek-harness)
+
 **DeepSeek Harness Backup, Restore & Migration Plugin.**
 
 Backup, restore, export, import, migrate and sync your complete DeepSeek Harness (DSH) configuration — settings, model providers, plugins, MCP servers, skills, agent presets and workspaces — and restore your whole environment on a new machine with one click.
@@ -64,6 +70,21 @@ Browse the built-in official market for ready-made configurations (model provide
 
 ---
 
+## 🆚 How it differs from the other DSH backup / sync plugins
+
+Several DSH plugins live in this space and they solve different problems — pick the one that matches your situation; they can also coexist.
+
+| Plugin | Strongest at | Where DSH Config Manager goes further |
+|---|---|---|
+| [xiaoyuyu6420/dsh-backup](https://github.com/xiaoyuyu6420/dsh-backup) | One-command `~/.dsh` snapshots from the CLI, plus session doctor / upgrade snapshots / rescue console | Review-before-write GUI flow (dry-run preview, per-item conflict decisions, automatic rollback), cross-machine path remapping, encrypted credential payload, configuration marketplace |
+| [muyifc/dsh-config-sync](https://github.com/muyifc/dsh-config-sync) | Export / import DSH configuration to a portable, password-encrypted file, callable from tool calls | 13–14 sections incl. plugins / MCP / skills / profiles / workspaces, scheduled backups, Git + WebDAV sync per channel, session migration with path rebase |
+| [dickpy/dsh-cloud-sync](https://github.com/dickpy/dsh-cloud-sync) · [weibaohui/dsh-sync](https://github.com/weibaohui/dsh-sync) | Keeping machines consistent through WebDAV / S3 or a private Git mirror | Sync is one of five capabilities here — alongside export/import, scheduling, marketplace and profile instance launch/stop |
+| `cp -r ~/.dsh` (or Git on the home dir) | Free, zero setup, fine for a purely textual config | No secret handling, no path remapping, no capture of `link:` / `file:` plugin installs, no session-log work, no conflict handling or rollback |
+
+**Short version**: for a one-command snapshot of everything, `dsh-backup` is excellent. If what you want is *move this working environment to another machine — and keep it in sync — with a review step before anything is written*, that is exactly what this plugin is for.
+
+---
+
 ## ✨ Highlights
 
 | Icon | Feature | In one line |
@@ -140,12 +161,32 @@ dsh plugin --profile web add dsh-config-manager@latest
 
 > 💡 Just copy-paste the command: `@latest` ensures you get the newest build.
 >
-> 🐛 **`@latest` installed an old version?** That's pnpm 11's `minimumReleaseAge` supply-chain policy, not a cache issue: versions published less than ~30 days ago are excluded from resolution until whitelisted. Two fixes:
-> - Install an exact version once (it auto-whitelists, then `@latest` works):
->   ```bash
->   dsh plugin --profile web add dsh-config-manager@0.1.8
->   ```
-> - Or disable the age gate with a one-liner (adds `minimumReleaseAge: 0` at the top of the profile's `pnpm-workspace.yaml`):
+> 🐛 **If `@latest` installed an old version**: that's pnpm's `minimumReleaseAge` supply-chain policy (not a cache issue). The gate is evaluated **per version, at resolution time**: a release younger than the threshold (~30 days) stays invisible to `@latest` until it ages past it — and the clock restarts for every future release. Installing an exact version once fixes *that one version only*; the next release published is invisible to `@latest` again. It is **not** a one-time fix.
+>
+> **Permanent fix (recommended)** — exempt this single package from the age gate. Add to the profile's `pnpm-workspace.yaml` (`~/.dsh/profiles/web/pnpm-workspace.yaml`):
+>
+> ```yaml
+> minimumReleaseAgeExclude:
+>   - dsh-config-manager
+> ```
+>
+> After that `@latest` resolves the newest release normally — including every future release.
+>
+> **One-off fix** — ask npm which version is actually latest and install exactly that. Repeat it each time a newer version has been published:
+>
+> ```powershell
+> # Windows (PowerShell)
+> $v = (npm view dsh-config-manager version).Trim(); dsh plugin --profile web add "dsh-config-manager@$v"
+> ```
+>
+> ```bash
+> # macOS / Linux
+> dsh plugin --profile web add "dsh-config-manager@$(npm view dsh-config-manager version)"
+> ```
+>
+> After restarting DSH, **Settings → Backup & Migration → About** shows the version you are actually running (and pops up the release notes whenever it changes).
+>
+> - Or disable the age gate entirely with a one-liner (adds `minimumReleaseAge: 0` at the top of the profile's `pnpm-workspace.yaml`):
 >   ```powershell
 >   $f = "$env:USERPROFILE\.dsh\profiles\web\pnpm-workspace.yaml"
 >   $c = Get-Content $f -Raw

package/README.zh-CN.md

@@ -1,5 +1,11 @@
 # 🎒 DSH Config Manager
 
+[![npm version](https://img.shields.io/npm/v/dsh-config-manager?label=npm)](https://www.npmjs.com/package/dsh-config-manager)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-config-manager?label=downloads%2Fmonth)](https://www.npmjs.com/package/dsh-config-manager)
+[![GitHub stars](https://img.shields.io/github/stars/xiajiajun516/dsh-config-manager?label=stars)](https://github.com/xiajiajun516/dsh-config-manager/stargazers)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/xiajiajun516/dsh-config-manager/blob/main/LICENSE)
+[![DSH plugin](https://img.shields.io/badge/DSH-plugin-blueviolet)](https://github.com/deepseek-ai/deepseek-harness)
+
 **DeepSeek Harness（DSH）配置备份、恢复与迁移插件。**
 
 DSH Config Manager 是一个 DeepSeek Harness 配置备份与迁移插件：一键备份、恢复、导出、导入和迁移完整 DSH 配置，包括——
@@ -66,6 +72,21 @@ DSH 是你的 AI 助手工作台，里面存着你的各种设置：模型配置
 
 ---
 
+## 🆚 与其它备份 / 同步插件的区别
+
+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 双通道同步、会话跨机迁移与路径重定基 |
+| [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:` 安装的本地插件、不动会话日志、没有冲突处理与回滚 |
+
+**一句话**：想要「一条命令把一切打快照」，`dsh-backup` 很好用；想要「把一整套能用的环境搬到另一台电脑、并持续同步，而且写盘前一定先给你看」，那就是本插件。
+
+---
+
 ## ✨ 核心亮点
 
 | 图标 | 功能 | 一句话说明 |
@@ -143,11 +164,31 @@ dsh plugin --profile web add dsh-config-manager@latest
 
 > 💡 照着复制就行：`@latest` 确保装到最新版。
 >
-> 🐛 **`@latest` 装到了旧版？** 这是 **pnpm 11 的 `minimumReleaseAge` 供应链发布年龄策略**（不是缓存）：发布不足约 30 天的新版本会被排除出版本解析，直到进入白名单。两种解决办法：
-> - 装一次精确版本即可自动白名单，之后 `@latest` 正常：
->   ```bash
->   dsh plugin --profile web add dsh-config-manager@0.1.8
->   ```
+> 🐛 **`@latest` 装到了旧版？** 这是 **pnpm 的 `minimumReleaseAge` 供应链发布年龄策略**（不是缓存）。这个门槛**按版本、在解析时**判定：发布不足阈值（约 30 天）的版本对 `@latest` 不可见，直到它「变老」——而**每个新版本都会重新计一次**。所以「装一次精确版本就永久正常」是错的：它只解决当时那一个版本，之后作者一发新版，`@latest` 又会装到旧版，**不是一次性修复**。
+>
+> **永久解决（推荐）**——只把这一个包排除在年龄门槛之外。在 profile 的 `pnpm-workspace.yaml`（`~/.dsh/profiles/web/pnpm-workspace.yaml`）里加上：
+>
+> ```yaml
+> minimumReleaseAgeExclude:
+>   - dsh-config-manager
+> ```
+>
+> 之后 `@latest` 会一直解析到最新发布版，包括以后再发的新版本。
+>
+> **临时解决**——先问 npm「当前真正的最新版本是多少」，再按精确版本安装；每当有新版本发布都要重跑一次：
+>
+> ```powershell
+> # Windows（PowerShell）
+> $v = (npm view dsh-config-manager version).Trim(); dsh plugin --profile web add "dsh-config-manager@$v"
+> ```
+>
+> ```bash
+> # macOS / Linux
+> dsh plugin --profile web add "dsh-config-manager@$(npm view dsh-config-manager version)"
+> ```
+>
+> 重启 DSH 后，可在 **设置 → 备份与迁移 → 关于** 看到实际运行的版本（版本变化时也会自动弹出更新内容）。
+>
 > - 或一行命令彻底关闭年龄门槛（在 profile 的 `pnpm-workspace.yaml` 顶部加 `minimumReleaseAge: 0`）：
 >   ```powershell
 >   $f = "$env:USERPROFILE\.dsh\profiles\web\pnpm-workspace.yaml"

package/lib/adapters/plugins.js

@@ -12,7 +12,7 @@
  */
 import { isDeepStrictEqual } from 'node:util';
 import { sha256Hex } from '../utils/hashing.js';
-import { installSpecFor, resolveProfileNameFromArgv } from '../core/plugin-cli.js';
+import { installSpecFor, resolveProcessProfileName } from '../core/plugin-cli.js';
 import { LOCAL_PLUGIN_DIR } from '../core/local-plugin-pack.js';
 import { msgOf, zhMsg } from '../core/messages.js';
 import { isPathSafe, normalizePath } from '../utils/paths.js';
@@ -592,7 +592,7 @@ export class PluginsAdapter {
                 }
                 // 执行日志：记录实际将发起的子进程命令行（与宿主 DshPluginsFacade 的
                 // dsh plugin --profile <p> add <spec> 一致）；仅非敏感文本，渲染前 UI 再 redact 兜底
-                ctx.onLog?.(`$ dsh plugin --profile ${ctx.target.profile ?? resolveProfileNameFromArgv()} add ${installSpecFor(name, spec)}`);
+                ctx.onLog?.(`$ dsh plugin --profile ${ctx.target.profile ?? resolveProcessProfileName()} add ${installSpecFor(name, spec)}`);
                 // 透传中止信号：用户「跳过当前插件」→ 宿主 kill 子进程 + 清半装状态 → 抛 ImportUserSkippedError
                 const result = await ctx.target.plugins.install(name, spec, ctx.signal);
                 const suffix = result.needsRestart ? msg('adapter.pluginRestartSuffix') : '';
@@ -614,7 +614,7 @@ export class PluginsAdapter {
                     warning: true,
                     // 保留 warning（§34.17 非致命）：一个装不上的插件不得拖垮已成功导入的其余配置；
                     // message 附可复制的手动安装命令（profile 解析与 M1 宿主一致）。
-                    message: (item.kind === 'Update' ? msg('adapter.pluginUpdateFailed', { name, msg: reason, profile: resolveProfileNameFromArgv() }) : msg('adapter.pluginInstallFailed', { name, msg: reason, profile: resolveProfileNameFromArgv() })),
+                    message: (item.kind === 'Update' ? msg('adapter.pluginUpdateFailed', { name, msg: reason, profile: resolveProcessProfileName() }) : msg('adapter.pluginInstallFailed', { name, msg: reason, profile: resolveProcessProfileName() })),
                 };
             }
         }

package/lib/client.d.ts

@@ -2830,6 +2830,9 @@ declare const zh$3: {
   readonly 'overview.activity.empty': '暂无操作记录（执行备份 / 导入 / 同步后在这里显示）';
   readonly 'overview.empty.title': '开始保护你的配置';
   readonly 'overview.empty.body': '创建第一个备份或快照后，这里会展示配置健康状态与最近活动。';
+  readonly 'overview.empty.step1': '创建第一份备份';
+  readonly 'overview.empty.step2': '导出 ZIP 带走';
+  readonly 'overview.empty.step3': '新机器导入回来';
   readonly 'overview.kind.import': '导入';
   readonly 'overview.kind.restore': '恢复';
   readonly 'overview.kind.rollback': '回滚';
@@ -3172,7 +3175,7 @@ declare const zh$3: {
   readonly 'about.diag.profile': 'profile：{profile}';
   readonly 'about.diag.pluginCount': '已识别插件：{count} 个';
   readonly 'about.diag.manifestUnreadable': '该目录下读不到 package.json —— 插件清单必然为空；请确认 DSH 的 profile 与 DSH_HOME 是否与此处一致。';
-  readonly 'about.diag.hint': '若与实际不符，请据此检查 DSH 启动参数 --profile 与 DSH_HOME 环境变量。';
+  readonly 'about.diag.hint': '若与实际不符，请据此检查当前档案的启动方式（宿主 profileContext / 启动参数 --profile / 环境变量 DSH_PROFILE）与 DSH_HOME 环境变量。';
   readonly 'about.releaseNotes.title': '版本更新内容';
   readonly 'about.releaseNotes.loading': '正在获取更新内容…';
   readonly 'about.releaseNotes.loadingMore': '正在加载更多版本…';