dsh-config-manager 0.1.14 → 0.1.16

package/README.md

@@ -184,7 +184,15 @@ Every import creates a **safety snapshot** first. If something feels off afterwa
 
 **GUI**: Settings → "Backup & Migration" → **Snapshots & Restore** tab → pick a snapshot → preview the plan (dry-run, zero writes) → confirm.
 
-**CLI** (offline, no DSH runtime needed):
+**CLI** (offline, no DSH runtime needed) — it is a standalone npm tool, **installed separately from the plugin**:
+
+```bash
+# install the CLI once on the machine where you want to restore snapshots
+# (--omit=peer: the offline CLI only needs js-yaml, not the DSH peer packages)
+npm install -g dsh-config-manager@latest --omit=peer
+```
+
+> ⚠️ Installing/updating the plugin (`dsh plugin --profile web add ...`) only enables the GUI — it does **not** create the `dsh-config-manager` command. Run the install command above, then:
 
 ```bash
 # list snapshots (newest first)

package/README.zh-CN.md

@@ -184,7 +184,15 @@ dsh plugin --profile web add dsh-config-manager@latest --config.auto-install-pee
 
 **GUI**：设置 → 「备份与迁移」→「快照恢复」tab → 选择快照 → 预览恢复计划（dry-run，零写入）→ 确认执行。
 
-**CLI**（纯离线，无需 DSH 运行时）：
+**CLI**（纯离线，无需 DSH 运行时）——它是独立的 npm 命令行工具，**需单独安装**（与插件安装是两回事）：
+
+```bash
+# 在想恢复快照的那台机器上安装一次 CLI
+# （--omit=peer：离线 CLI 只需要 js-yaml，不需要 DSH 的 peer 依赖包）
+npm install -g dsh-config-manager@latest --omit=peer
+```
+
+> ⚠️ 只安装/更新插件（`dsh plugin --profile web add ...`）只启用 GUI，**不会**产生 `dsh-config-manager` 命令。请先执行上面这条安装命令，然后：
 
 ```bash
 # 列出快照（最新在前）

package/lib/client.js

@@ -1220,17 +1220,26 @@ var RunStore = class {
 		this.state = defaultState();
 		this.load();
 	}
-	/** 订阅 store 变化（useSyncExternalStore 的 subscribe）。 */
-	subscribe(listener) {
+	/**
+	* 订阅 store 变化（useSyncExternalStore 的 subscribe）。
+	*
+	* 必须为箭头函数类字段：React 以裸引用（`runStore.subscribe`）调用它，
+	* 无接收者，若为原型方法则 `this` 为 undefined，`this.listeners` 直接崩溃。
+	*/
+	subscribe = (listener) => {
 		this.listeners.add(listener);
 		return () => {
 			this.listeners.delete(listener);
 		};
-	}
-	/** 当前完整快照（引用稳定：仅在 patch 后替换，适合 useSyncExternalStore）。 */
-	getSnapshot() {
-		return this.state;
-	}
+	};
+	/**
+	* 当前完整快照（引用稳定：仅在 patch 后替换，适合 useSyncExternalStore）。
+	*
+	* 必须为箭头函数类字段：React 以裸引用（`runStore.getSnapshot`）调用它，
+	* 无接收者，若为原型方法则 `this` 为 undefined，`this.state` 抛 TypeError，
+	* 导致整个 settings.section 槽位渲染崩溃（备份与迁移页空白）。
+	*/
+	getSnapshot = () => this.state;
 	notify() {
 		for (const listener of this.listeners) listener();
 	}
@@ -1587,102 +1596,102 @@ if (typeof document !== "undefined" && document.querySelector("style[data-tag=\"
 	document.head.appendChild(tag);
 }
 var config_manager_module_css_default = {
+	"modeTab": "_367UGW_modeTab",
+	"primaryButton": "_367UGW_primaryButton",
+	"groupLabel": "_367UGW_groupLabel",
+	"formError": "_367UGW_formError",
+	"optionsCard": "_367UGW_optionsCard",
+	"viewTabs": "_367UGW_viewTabs",
+	"rowActions": "_367UGW_rowActions",
 	"groupNote": "_367UGW_groupNote",
+	"conflictHead": "_367UGW_conflictHead",
+	"progressBadge": "_367UGW_progressBadge",
+	"categoryName": "_367UGW_categoryName",
+	"snapshotRowHeader": "_367UGW_snapshotRowHeader",
+	"badgeWarn": "_367UGW_badgeWarn",
+	"input": "_367UGW_input",
+	"badgeInfo": "_367UGW_badgeInfo",
+	"progressMeta": "_367UGW_progressMeta",
+	"rollbackBox": "_367UGW_rollbackBox",
+	"progressBlock": "_367UGW_progressBlock",
+	"errorBanner": "_367UGW_errorBanner",
+	"dangerButton": "_367UGW_dangerButton",
 	"reportView": "_367UGW_reportView",
-	"categoryDesc": "_367UGW_categoryDesc",
-	"actionRow": "_367UGW_actionRow",
-	"banner": "_367UGW_banner",
-	"progressPercent": "_367UGW_progressPercent",
-	"dshCmSpin": "_367UGW_dshCmSpin",
-	"reportFooter": "_367UGW_reportFooter",
+	"modeHint": "_367UGW_modeHint",
+	"ghostButton": "_367UGW_ghostButton",
+	"progressBadgeSection": "_367UGW_progressBadgeSection",
+	"errorList": "_367UGW_errorList",
 	"conflictId": "_367UGW_conflictId",
-	"snapshotRowHeader": "_367UGW_snapshotRowHeader",
-	"card": "_367UGW_card",
+	"pathMappingList": "_367UGW_pathMappingList",
 	"sectionHeader": "_367UGW_sectionHeader",
+	"progressBarDone": "_367UGW_progressBarDone",
+	"categoryItem": "_367UGW_categoryItem",
 	"errorTitle": "_367UGW_errorTitle",
-	"primaryButton": "_367UGW_primaryButton",
+	"actionRow": "_367UGW_actionRow",
+	"statRow": "_367UGW_statRow",
+	"conflictItem": "_367UGW_conflictItem",
+	"severityError": "_367UGW_severityError",
+	"progressTrack": "_367UGW_progressTrack",
+	"badgeOk": "_367UGW_badgeOk",
+	"errorReason": "_367UGW_errorReason",
 	"conflictDetail": "_367UGW_conflictDetail",
-	"secretsList": "_367UGW_secretsList",
-	"errorList": "_367UGW_errorList",
-	"rowActions": "_367UGW_rowActions",
-	"progressBlock": "_367UGW_progressBlock",
+	"pathIssueKind": "_367UGW_pathIssueKind",
+	"warnText": "_367UGW_warnText",
 	"kindTag": "_367UGW_kindTag",
-	"reportList": "_367UGW_reportList",
-	"statRow": "_367UGW_statRow",
-	"dshCmIndeterminate": "_367UGW_dshCmIndeterminate",
-	"dangerButton": "_367UGW_dangerButton",
-	"progressBar": "_367UGW_progressBar",
-	"badgeInfo": "_367UGW_badgeInfo",
-	"groupCard": "_367UGW_groupCard",
-	"hint": "_367UGW_hint",
 	"warnList": "_367UGW_warnList",
-	"errorAction": "_367UGW_errorAction",
-	"spinnerWrap": "_367UGW_spinnerWrap",
-	"spinnerLabel": "_367UGW_spinnerLabel",
-	"warnText": "_367UGW_warnText",
-	"viewTab": "_367UGW_viewTab",
-	"errorReason": "_367UGW_errorReason",
-	"conflictOptions": "_367UGW_conflictOptions",
 	"sectionTitleBlock": "_367UGW_sectionTitleBlock",
-	"viewTabs": "_367UGW_viewTabs",
-	"progressTrack": "_367UGW_progressTrack",
-	"section": "_367UGW_section",
-	"viewBody": "_367UGW_viewBody",
-	"radioLabel": "_367UGW_radioLabel",
-	"errorBanner": "_367UGW_errorBanner",
-	"errorLine": "_367UGW_errorLine",
-	"conflictList": "_367UGW_conflictList",
-	"modeTabs": "_367UGW_modeTabs",
-	"errorFooter": "_367UGW_errorFooter",
-	"badge": "_367UGW_badge",
-	"modeTab": "_367UGW_modeTab",
-	"groupItems": "_367UGW_groupItems",
+	"sectionTitle": "_367UGW_sectionTitle",
+	"progressBadgeCount": "_367UGW_progressBadgeCount",
+	"secretsList": "_367UGW_secretsList",
+	"pathNew": "_367UGW_pathNew",
+	"spinner": "_367UGW_spinner",
+	"badgeError": "_367UGW_badgeError",
 	"groupList": "_367UGW_groupList",
-	"sectionSubtitle": "_367UGW_sectionSubtitle",
-	"secretFields": "_367UGW_secretFields",
-	"categoryName": "_367UGW_categoryName",
 	"checkboxRow": "_367UGW_checkboxRow",
-	"categoryItem": "_367UGW_categoryItem",
-	"severityError": "_367UGW_severityError",
-	"conflictItem": "_367UGW_conflictItem",
-	"snapshotList": "_367UGW_snapshotList",
-	"progressMeta": "_367UGW_progressMeta",
-	"pathValue": "_367UGW_pathValue",
-	"badgeWarn": "_367UGW_badgeWarn",
-	"progressBadge": "_367UGW_progressBadge",
-	"badgeError": "_367UGW_badgeError",
-	"modeHint": "_367UGW_modeHint",
-	"rollbackBox": "_367UGW_rollbackBox",
-	"empty": "_367UGW_empty",
-	"fieldLabel": "_367UGW_fieldLabel",
 	"reportText": "_367UGW_reportText",
-	"pathOld": "_367UGW_pathOld",
+	"errorActionLabel": "_367UGW_errorActionLabel",
+	"modeTabs": "_367UGW_modeTabs",
+	"conflictOptions": "_367UGW_conflictOptions",
+	"spinnerWrap": "_367UGW_spinnerWrap",
 	"progressLabel": "_367UGW_progressLabel",
-	"input": "_367UGW_input",
-	"field": "_367UGW_field",
-	"sectionBody": "_367UGW_sectionBody",
-	"badgeOk": "_367UGW_badgeOk",
-	"formError": "_367UGW_formError",
+	"dshCmSpin": "_367UGW_dshCmSpin",
+	"progressIndeterminate": "_367UGW_progressIndeterminate",
+	"empty": "_367UGW_empty",
+	"pathOld": "_367UGW_pathOld",
+	"card": "_367UGW_card",
+	"fieldLabel": "_367UGW_fieldLabel",
+	"groupCard": "_367UGW_groupCard",
+	"dshCmIndeterminate": "_367UGW_dshCmIndeterminate",
+	"secretFields": "_367UGW_secretFields",
+	"banner": "_367UGW_banner",
+	"viewTab": "_367UGW_viewTab",
+	"groupHeader": "_367UGW_groupHeader",
+	"errorAction": "_367UGW_errorAction",
+	"progressDetail": "_367UGW_progressDetail",
+	"pathValue": "_367UGW_pathValue",
+	"spinnerLabel": "_367UGW_spinnerLabel",
+	"categoryDesc": "_367UGW_categoryDesc",
+	"snapshotRow": "_367UGW_snapshotRow",
+	"badge": "_367UGW_badge",
+	"errorLine": "_367UGW_errorLine",
+	"errorFooter": "_367UGW_errorFooter",
 	"errorItem": "_367UGW_errorItem",
-	"pathMappingList": "_367UGW_pathMappingList",
+	"conflictList": "_367UGW_conflictList",
 	"pathRow": "_367UGW_pathRow",
-	"sectionTitle": "_367UGW_sectionTitle",
-	"snapshotRow": "_367UGW_snapshotRow",
+	"sectionBody": "_367UGW_sectionBody",
 	"hiddenFile": "_367UGW_hiddenFile",
-	"progressBarDone": "_367UGW_progressBarDone",
-	"errorActionLabel": "_367UGW_errorActionLabel",
-	"pathIssueKind": "_367UGW_pathIssueKind",
-	"conflictHead": "_367UGW_conflictHead",
-	"groupHeader": "_367UGW_groupHeader",
-	"groupLabel": "_367UGW_groupLabel",
-	"progressDetail": "_367UGW_progressDetail",
-	"spinner": "_367UGW_spinner",
-	"progressIndeterminate": "_367UGW_progressIndeterminate",
-	"progressBadgeSection": "_367UGW_progressBadgeSection",
-	"ghostButton": "_367UGW_ghostButton",
-	"progressBadgeCount": "_367UGW_progressBadgeCount",
-	"pathNew": "_367UGW_pathNew",
-	"optionsCard": "_367UGW_optionsCard"
+	"hint": "_367UGW_hint",
+	"section": "_367UGW_section",
+	"field": "_367UGW_field",
+	"reportFooter": "_367UGW_reportFooter",
+	"snapshotList": "_367UGW_snapshotList",
+	"sectionSubtitle": "_367UGW_sectionSubtitle",
+	"progressPercent": "_367UGW_progressPercent",
+	"progressBar": "_367UGW_progressBar",
+	"groupItems": "_367UGW_groupItems",
+	"reportList": "_367UGW_reportList",
+	"radioLabel": "_367UGW_radioLabel",
+	"viewBody": "_367UGW_viewBody"
 };
 //#endregion
 //#region src/client/common/ui.tsx