dsh-config-manager 0.1.72 → 0.1.76

package/src/sync/ui-prefs.ts

@@ -21,6 +21,7 @@
  *   避免「sync/ui-prefs 写 lastSyncChannel」与「star-prompt 写弹窗状态」互相覆盖。
  */
 import fs from 'node:fs/promises';
+import fsSync from 'node:fs';
 import path from 'node:path';
 
 import { parseJsonSafe, stringifyJsonSafe } from '../utils/json.ts';
@@ -60,6 +61,18 @@ export interface UiPrefs {
    * 「用户主动改配置」或「非本插件客户端」时起作用。
    */
   sessionFormatDisposition?: SessionFormatDisposition;
+  /**
+   * 回合自动留点（回滚点）总开关。**缺省 / 任何非 true 值 = 关闭**（issue #88 / #89：
+   * 该功能与「配置备份 / 同步」是两件事，却随 bundle 默认启用且没有关闭入口；
+   * 默认启用时账本每回合整份读改写，真机上把宿主拖到 V8 heap OOM）。
+   *
+   * 关闭语义（宿主侧 gate，见 src/core/rollback-gate.ts）：
+   *  · 不订阅 `session/event`（不是「订阅了什么都不做」）；
+   *  · 不留点、不写台账；
+   *  · 聊天内的「↺ 回退」入口收起（不是置灰）。
+   * 台账 / 回退路由本身仍可用：已有回滚点仍能查看、回退、删除、清理 —— 关的是「自动留点」。
+   */
+  rollbackEnabled?: boolean;
 }
 
 /** 缺省配置（首次无文件 / 损坏 / 不支持 schema 时回退） */
@@ -118,9 +131,34 @@ export async function readUiPrefs(dir: string): Promise<UiPrefs> {
   if (disposition === 'abort' || disposition === 'skip' || disposition === 'guide') {
     prefs.sessionFormatDisposition = disposition;
   }
+  // 开关只认字面 true：false / 缺省 / 形状不符一律 = 关闭（fail-closed，绝不猜用户想开）
+  if (obj['rollbackEnabled'] === true) {
+    prefs.rollbackEnabled = true;
+  }
   return prefs;
 }
 
+/**
+ * 同步读取「回滚点开关」（启动期专用）。
+ *
+ * 为什么必须有同步版本：宿主 `apply()` 是同步函数（`src/index.ts`），而开关必须在
+ * **注册订阅之前**就定下来 —— 否则「关闭」只等于「订阅了什么都不做」，与 issue 要求的
+ * 「关闭后不再订阅 `session/event`」不符。读一个几百字节的小文件，启动期一次，代价可忽略。
+ *
+ * 任何异常（不存在 / 损坏 / 形状不符）一律回 false = 关闭。
+ */
+export function readRollbackEnabledSync(dir: string): boolean {
+  try {
+    const raw = fsSync.readFileSync(path.join(dir, UI_PREFS_FILE), 'utf8');
+    const parsed: unknown = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) return false;
+    const obj = parsed as Record<string, unknown>;
+    return obj['schemaVersion'] === UI_PREFS_SCHEMA_VERSION && obj['rollbackEnabled'] === true;
+  } catch {
+    return false;
+  }
+}
+
 /** 写入 UI 偏好（原子写：临时文件 + rename；自动创建目录）。 */
 export async function writeUiPrefs(dir: string, prefs: UiPrefs): Promise<void> {
   await fs.mkdir(dir, { recursive: true });
@@ -133,6 +171,7 @@ export async function writeUiPrefs(dir: string, prefs: UiPrefs): Promise<void> {
     ...(prefs.releaseNotesLastSeenVersion !== undefined ? { releaseNotesLastSeenVersion: prefs.releaseNotesLastSeenVersion } : {}),
     ...(prefs.releaseNotesDismissed === true ? { releaseNotesDismissed: true } : {}),
     ...(prefs.sessionFormatDisposition !== undefined ? { sessionFormatDisposition: prefs.sessionFormatDisposition } : {}),
+    ...(prefs.rollbackEnabled === true ? { rollbackEnabled: true } : {}),
   };
   const target = path.join(dir, UI_PREFS_FILE);
   const data = stringifyJsonSafe(payload, { space: 2 });

package/src/ui/diff-view.test.ts

@@ -5,7 +5,7 @@ import test from 'node:test';
 import assert from 'node:assert/strict';
 
 import { diffLines } from '../utils/line-diff.ts';
-import { countSideRows, hunkHeader, maxLineDigits, toSideBySide } from './diff-view.ts';
+import { countSideRows, diffLineCounts, hunkHeader, maxLineDigits, toSideBySide } from './diff-view.ts';
 
 test('V-01 成对修改：3 删 1 增 → 1 个 change 行对 + 2 个 del 行对（左有右空）', () => {
   const r = diffLines('a\nX1\nX2\nX3\nb', 'a\nY1\nb', { context: 1 });
@@ -56,6 +56,14 @@ test('V-06 行对总数 = 上下文 + 成对/单侧行', () => {
   assert.equal(countSideRows(groups), 3, 'context 1 + 1 + context 1');
 });
 
+test('V-08 diffLineCounts：只数增删行（上下文不计），口径与 git 的 +A −R 一致', () => {
+  const r = diffLines('a\nX1\nX2\nX3\nb', 'a\nY1\nb', { context: 1 });
+  assert.deepEqual(diffLineCounts(r.hunks), { added: 1, removed: 3 });
+  assert.deepEqual(diffLineCounts([]), { added: 0, removed: 0 }, '无差异 → 两个 0');
+  const only = diffLines('a\nb', 'a\nNEW\nb');
+  assert.deepEqual(diffLineCounts(only.hunks), { added: 1, removed: 0 }, '纯新增不计删除');
+});
+
 test('V-07 maxLineDigits：按实际出现的最大行号取位数（列宽档位依据）', () => {
   assert.equal(maxLineDigits([]), 1, '空 hunks → 至少 1 位');
   const small = diffLines('a\nb\nc', 'a\nX\nc', { context: 1 });

package/src/ui/diff-view.ts

@@ -89,3 +89,25 @@ export function maxLineDigits(hunks: readonly DiffHunk[]): number {
 export function countSideRows(groups: readonly SideBySideHunk[]): number {
   return groups.reduce((sum, group) => sum + group.rows.length, 0);
 }
+
+/** 增删行数（编辑器式文件头的 `+A` / `−R` 用；上下文行不计）。 */
+export interface DiffLineCounts {
+  added: number
+  removed: number
+}
+
+/**
+ * 一侧的行数统计：**只数 unidiff 语义的增删行**（与 git 的 `+A −R` 同口径）。
+ * 成对修改在 unidiff 里本来就是「一删一增」，所以这里不需要按行对再折算。
+ */
+export function diffLineCounts(hunks: readonly DiffHunk[]): DiffLineCounts {
+  let added = 0
+  let removed = 0
+  for (const hunk of hunks) {
+    for (const line of hunk.lines) {
+      if (line.kind === 'add') added += 1
+      else if (line.kind === 'del') removed += 1
+    }
+  }
+  return { added, removed }
+}

package/src/ui/export-flow.ts

@@ -105,6 +105,8 @@ const CATEGORY_DESCRIPTION_KEY: Record<Exclude<SectionId, 'secrets'>, UiTextKey>
   ui: 'export.category.ui',
   credentialsStatus: 'export.category.credentialsStatus',
   sessions: 'export.category.sessions',
+  pluginData: 'export.category.pluginData',
+  pluginAssets: 'export.category.pluginAssets',
 };
 
 /** 需在 UI 标注安全提示、但绝不显示值的分区（凭据状态只有 configured 标记） */

package/src/ui/i18n.ts

@@ -100,7 +100,7 @@ export const uiZh = {
   'error.downloadFailed': '下载失败：HTTP {status}',
   'error.exportTimeout': '导出超时（{minutes} 分钟）：导出过程未完成，请重试；若反复超时请检查 DSH 状态',
   'error.syncTimeout': '同步请求超时（{minutes} 分钟）：请检查网络与仓库可达性后重试',
-  'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：恢复过程未完成，请重试；若反复超时请检查 DSH 状态',
+  'error.recoveryTimeout': '恢复请求超时（{minutes} 分钟）：过程可能仍在后台进行，请先刷新预览确认；确实未完成再重试',
   'error.settingsConflict.title': '配置已被并发修改',
   'error.settingsConflict.action': '目标 DSH 的该配置在导入期间被其他进程修改，为避免覆盖请重新导出或手动核对后再试。',
   'error.notConfirmed.title': '导入未确认',
@@ -173,7 +173,7 @@ export const uiZh = {
   'sync.kind.skip': '跳过',
   'sync.kind.conflict': '冲突',
   'sync.kind.install': '安装',
-  'sync.kind.missingSecret': '缺密钥',
+  'sync.kind.missingSecret': '凭据迁移',
   'sync.kind.missingDependency': '缺依赖',
   'sync.kind.pathMapping': '路径映射',
   'sync.kind.warning': '警告',
@@ -548,8 +548,10 @@ export const uiZh = {
   'export.category.settings': 'DSH 全局设置（namespace 分区，redacted）',
   'export.category.providers': 'LLM Provider / Model / 默认模型 / BaseURL',
   'export.category.plugins': '已安装插件清单与启用状态（不含二进制）',
-  'export.category.pluginFiles': '插件自有配置文件（白名单 + plugin-config/ 目录，整文件复制）',
+  'export.category.pluginFiles': '其他插件放在 ~/.dsh 根下的零散配置文件（白名单 + plugin-config/ 目录，整文件复制）',
   'export.category.self': '本插件自身配置（同步/自动同步/分区选择/UI 偏好/市场；sync-*.json 等，不含凭据值）',
+  'export.category.pluginData': '其他插件在系统主目录下的数据（如 ~/.dsh-wallpaper-engine、~/.mnemon 的配置与状态；可再生成缓存绝不收录）',
+  'export.category.pluginAssets': '其他插件的大体积文件（上传的壁纸、本地数据库等；默认不勾选）',
   'export.category.mcp': 'MCP 服务器组合配置（需重启生效）',
   'export.category.prompts': 'System Prompt / Plan Mode 提示',
   'export.category.skills': '用户技能文件（~/.dsh/skills）',
@@ -664,7 +666,7 @@ export const uiEn: Record<UiTextKey, string> = {
   'error.downloadFailed': 'Download failed: HTTP {status}',
   'error.exportTimeout': 'Export timed out ({minutes} min): the export did not complete, please retry; if it keeps timing out, check the DSH state',
   'error.syncTimeout': 'Sync request timed out ({minutes} min): check network and repository reachability, then retry',
-  'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): the recovery did not complete, please retry; if it keeps timing out, check the DSH state',
+  'error.recoveryTimeout': 'Recovery request timed out ({minutes} min): it may still be running in the background — refresh the preview to confirm, then retry if it did not finish',
   'error.settingsConflict.title': 'Configuration changed concurrently',
   'error.settingsConflict.action': 'This configuration on the target DSH was modified by another process during import. To avoid overwriting it, re-export or review it manually, then retry.',
   'error.notConfirmed.title': 'Import not confirmed',
@@ -734,7 +736,7 @@ export const uiEn: Record<UiTextKey, string> = {
   'sync.kind.skip': 'Skip',
   'sync.kind.conflict': 'Conflict',
   'sync.kind.install': 'Install',
-  'sync.kind.missingSecret': 'Secret',
+  'sync.kind.missingSecret': 'Credential',
   'sync.kind.missingDependency': 'Dependency',
   'sync.kind.pathMapping': 'Path',
   'sync.kind.warning': 'Warning',
@@ -1095,8 +1097,10 @@ export const uiEn: Record<UiTextKey, string> = {
   'export.category.settings': 'Global DSH settings (namespace sections, redacted)',
   'export.category.providers': 'LLM providers / models / default model / base URL',
   'export.category.plugins': 'Installed plugin list and enablement (binaries excluded)',
-  'export.category.pluginFiles': "Plugins' own config files (allowlist + plugin-config/, copied whole)",
+  'export.category.pluginFiles': "Other plugins' loose config files at the ~/.dsh root (allowlist + plugin-config/, copied whole)",
   'export.category.self': "This plugin's own config (sync / autosync / section selection / UI prefs / market; sync-*.json etc., no credential values)",
+  'export.category.pluginData': "Other plugins' data under the system home directory (e.g. the config/state of ~/.dsh-wallpaper-engine and ~/.mnemon; regenerable caches are never included)",
+  'export.category.pluginAssets': "Other plugins' large files (uploaded wallpapers, local databases, ...; not selected by default)",
   'export.category.mcp': 'MCP server composition (restart required)',
   'export.category.prompts': 'System prompt / Plan Mode prompts',
   'export.category.skills': 'Your skill files (~/.dsh/skills)',

package/src/ui/rollback-view.test.ts

@@ -53,6 +53,7 @@ import {
   rollbackRowHasSessionCursor,
   rollbackModeKey,
   rollbackModeSegments,
+  rollbackEntryVisible,
   rollbackOutcome,
   rollbackPointRows,
   rollbackPreviewGuidance,
@@ -817,3 +818,19 @@ test('E1 类型与引擎逐字同形（源码级）：五字段 + 三种 status
   assert.match(chat, /type RollbackPreviewFile\b/, '复用必须来自 src/ui 的类型导入（不是又抄一份字段表）')
 })
 
+/**
+ * issue #88：聊天内「↺ 回退」入口的可见性判据。三条口径缺一不可：
+ *  ① **明确 false = 收起**（用户把这个功能关了，入口本身就不该存在）；
+ *  ② **明确 true = 显示**；
+ *  ③ **字段缺失 = 按「默认开」** —— 老宿主的语义就是默认启用，此时藏掉入口会让用户
+ *     「有点但没有入口」（那比多画一颗按钮更糟）。
+ */
+test('issue #88：rollbackEntryVisible —— false 收起 / true 显示 / 缺字段按默认开', () => {
+  assert.equal(rollbackEntryVisible({ available: true, rollbackEnabled: false }), false, '明确关闭必须收起')
+  assert.equal(rollbackEntryVisible({ available: true, rollbackEnabled: true }), true)
+  assert.equal(rollbackEntryVisible({ available: true }), true, '老宿主没有该字段 = 那一版默认开')
+  assert.equal(rollbackEntryVisible(null), false, '还没读到状态时不画入口（缺省关闭）')
+  assert.equal(rollbackEntryVisible(undefined), false)
+})
+
+

package/src/ui/rollback-view.ts

@@ -147,6 +147,8 @@ export const ROLLBACK_CODES: readonly string[] = [
   'session-out-of-root',
   'session-too-large',
   'session-active',
+  // 子代理会话（origin=subagent）：**不自动留点** —— 出现即代表该会话被有意跳过（宿主日志留痕）
+  'subagent-session',
   'session-fork-unavailable',
   'fork-failed',
   // 自动留点（工作区快照）
@@ -320,12 +322,53 @@ export interface RollbackPointSummary {
   segments?: RollbackSegmentSummary[]
 }
 
+/**
+ * 台账占用（issue #89 P2：可观测）。
+ * `bytes` = records/ + payloads/ 的实际字节数；`budgetBytes` = 触发淘汰的字节预算；
+ * `evicted` = 本进程内被预算淘汰的自动点累计数。缺省（老宿主没这个字段）= 界面不渲染这一行。
+ */
+export interface RollbackLedgerStatus {
+  records: number
+  bytes: number
+  budgetBytes: number
+  evicted: number
+  /**
+   * 已超预算且**无处可淘汰**（典型：单条点本身就大于预算）。
+   * 老宿主没有这个字段 ⇒ `undefined` 与 `false` 同义，绝不因为读不到就报警。
+   */
+  overBudget?: boolean
+}
+
 export interface RollbackStorageStatus {
   available: boolean
   root?: string
   detail?: string
   guidance?: RollbackGuidance[]
   requirements?: readonly string[]
+  /** 磁盘偏好：回合自动留点开关（缺省 / false = 关闭） */
+  rollbackEnabled?: boolean
+  /** 本进程此刻是否真的在留点（关闭后订阅已解绑）。与 rollbackEnabled 正常一致 */
+  rollbackActive?: boolean
+  /** 台账占用（老宿主没有这个字段） */
+  ledger?: RollbackLedgerStatus
+}
+
+/** 开关读 / 写的结果（POST 成功才会改进程 gate）。 */
+export interface RollbackPrefsResult {
+  ok: boolean
+  rollbackEnabled: boolean
+  rollbackActive?: boolean
+}
+
+/** 台账清理结果（只删自动点；guard 与 protected 保留）。 */
+export interface RollbackPurgeResult {
+  ok: boolean
+  code?: string
+  detail?: string
+  removedRecords?: number
+  removedPayloads?: number
+  removedObjects?: number
+  bytes?: number
 }
 
 export interface RollbackListResult {
@@ -585,6 +628,29 @@ export interface RollbackPointPort {
   rollbackPointFileDiff?(id: string, path: string): Promise<RollbackFileDiffResult>
   restoreRollbackPoint(id: string, opts: RollbackRewindOptions): Promise<RollbackRewindResult>
   removeRollbackPoint(id: string, userConfirmed: boolean): Promise<RollbackRemoveResult>
+  /**
+   * 回合自动留点开关（issue #88：它跟配置备份/同步是两件事，必须能关）。
+   * 可选实现：端口缺失时界面**不渲染**开关（绝不给一个点了没反应的入口）。
+   */
+  rollbackPrefs?(): Promise<RollbackPrefsResult>
+  setRollbackEnabled?(enabled: boolean): Promise<RollbackPrefsResult>
+  /**
+   * 清理台账（issue #89 P1/P2：把已经涨上去的占用收回来）。
+   * **只删自动点**；`includeGuards` 为 true 时连 guard 也删，protected 永不删。
+   */
+  purgeRollbackPoints?(opts: { includeGuards: boolean }): Promise<RollbackPurgeResult>
+}
+
+/**
+ * 聊天内「↺ 回退」入口是否可见（issue #88：关闭后**收起**入口，不是置灰）。
+ *
+ * 判据只有一条：**宿主回传的开关**。老宿主（storage 响应里没有 `rollbackEnabled` 字段）按
+ * 「未提供 = 功能默认开」处理 —— 那一版的语义就是默认启用，此时把入口藏起来会让用户
+ * 「有点但没有入口」。形状不符（不是布尔）同样按「未提供」处理，绝不因为一个坏字段藏掉入口。
+ */
+export function rollbackEntryVisible(storage: RollbackStorageStatus | null | undefined): boolean {
+  if (storage === undefined || storage === null) return false
+  return storage.rollbackEnabled !== false
 }
 
 /* ------------------------------------------------------------ 内部小工具 */

package/src/ui/test-helpers.ts

@@ -21,6 +21,7 @@ export function makeManifest(): Manifest {
       settings: true, ui: false, providers: false, plugins: false, mcp: false, prompts: false,
       skills: false, agentPresets: false, agentInstructions: false, workspaces: false, pluginFiles: false,
       credentialsStatus: false, secrets: false, sessions: false, self: false,
+      pluginData: false, pluginAssets: false,
     },
     security: { containsSecrets: false, encrypted: false, encryption: null },
   };
@@ -106,7 +107,7 @@ export function makePlan(overrides: Partial<ImportPlan> = {}): ImportPlan {
     estimatedActions: {
       settings: 2, ui: 0, providers: 0, plugins: 1, mcp: 1, prompts: 1,
       skills: 0, agentPresets: 0, agentInstructions: 0, workspaces: 0, pluginFiles: 0,
-      credentialsStatus: 0, secrets: 0, sessions: 0, self: 0,
+      credentialsStatus: 0, secrets: 0, sessions: 0, self: 0, pluginData: 0, pluginAssets: 0,
     },
     ...overrides,
   };

package/src/utils/bundle-scan.ts

@@ -32,9 +32,11 @@
  * DSH shell 把 UI 基础库作为 **static module seed** 预置在模块表里（`dsh-web-frontend` 的
  * `staticModules`：react / react-dom / cordis / client-store / ui-slots / ui-primitives / dockkit），
  * 插件 bundle 工厂拿到的 `require` 命中 seed 即可用 —— 第三方插件 dsh-better-sidebar 同样如此。
- * 本插件只用它画**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`），且**不是顶层 require**：
- * 调用点在 `src/client/chat/RollbackFileIcon.tsx` 的 `dshFileTypeIcon()` 里，外裹 try/catch ——
- * 老宿主没有这条 seed 时回落本地极简图标，绝不会因「一颗图标」打挂整个浏览器半。
+ * 本插件用它做两件事：**文件类型图标**（DSH 文件树同一颗 `FileTypeIcon`）与**用户正文投影**
+ * （`projectUserText` —— 会话引用/技能渲染成 chip，G-39 差距①②，2026-10-15）。
+ * **都不是顶层 require**：唯一入口是 `src/client/common/host-primitives.ts` 的帧内惰取门
+ * （三态缓存 + try/catch，每个进程只试一次）—— 老宿主没有这条 seed 时回落本地实现
+ * （极简图标 / 纯文本投影 / 可见的底色兜底），绝不会因一颗图标或一段正文打挂整个浏览器半。
  */
 export const CLIENT_BUNDLE_RUNTIME_WHITELIST: readonly string[] = [
   'react',

package/src/utils/line-diff.test.ts

@@ -150,6 +150,18 @@ test('D-12 重复行不误判（LCS 而非逐行对齐）', () => {
   assert.ok(r.added + r.removed <= 2, '相同行的移动不应产生大量伪变更');
 });
 
+test('D-14 缺省预算够到「大文件改多处」：旧口径 400 会降级，缺省 2000 给最小脚本（2026-10-15）', () => {
+  const before = Array.from({ length: 1200 }, (_, i) => `line ${i}`).join('\n');
+  const after = Array.from({ length: 1200 }, (_, i) => (i % 3 === 0 ? `changed ${i}` : `line ${i}`)).join('\n');
+  const old = diffLines(before, after, { maxD: 400 });
+  assert.equal(old.degraded, true, '旧口径（400）在这份输入上会退化成整块替换 —— 那正是用户看到的提示');
+  const now = diffLines(before, after);
+  assert.equal(now.degraded, false, '缺省预算必须能求出最小编辑脚本');
+  assert.equal(now.added, 400);
+  assert.equal(now.removed, 400);
+  assert.equal(apply(before, now), norm(after), '非降级路径同样要能回放重建新侧');
+});
+
 test('D-13 looksBinary：NUL 字节判定；纯文本与空串为 false', () => {
   assert.equal(looksBinary('plain text\nwith lines'), false);
   assert.equal(looksBinary(''), false);

package/src/utils/line-diff.ts

@@ -11,6 +11,12 @@
  * （maxLines / maxD）时**降级为整块替换**（全删 + 全增），保证任何输入都有确定
  * 耗时的输出 —— 大文件不会卡死宿主。
  *
+ * 预算怎么定（2026-10-15 真机实测，本仓 rollback-point.ts 的一对版本）：
+ *  · 时间是 (N+M)·D 量级：D=4000、两侧合计 ~7500 行时 ≈ 70 ms（D=8000 ≈ 115 ms）；
+ *  · 内存是 O(D²)·4B（回溯要逐轮留 V 快照）：D=2000 时 RSS +~30 MB、D=4000 +~100 MB、D=8000 +~175 MB。
+ *  ⇒ 缺省取 2000（覆盖「大文件只改了几处」这一大类）；单文件按需查看的调用方可以往上调，
+ *    到 4000 仍是一次点击可接受的开销；再大就该换线性空间算法，而不是继续加预算。
+ *
  * 行为约定：
  *  - 行尾 \r\n 归一为 \n；文本末尾的换行不产生"空行"（行数 = 换行符语义）。
  *  - 仅空白差异同样是差异（不做 ignoreWhitespace）。
@@ -53,13 +59,13 @@ export interface DiffOptions {
   context?: number;
   /** 参与 Myers 的变更区行数上限（两侧合计；超出 → 降级整块替换） */
   maxLines?: number;
-  /** Myers 最大编辑距离 D（超出 → 降级整块替换） */
+  /** Myers 最大编辑距离 D（超出 → 降级整块替换）；越大越接近最小编辑脚本，内存随 D² 增长（见文件头） */
   maxD?: number;
 }
 
 const DEFAULT_CONTEXT = 3;
-const DEFAULT_MAX_LINES = 6000;
-const DEFAULT_MAX_D = 400;
+const DEFAULT_MAX_LINES = 20000;
+const DEFAULT_MAX_D = 2000;
 
 /** 文本 → 行数组（CRLF 归一、尾换行不产生空行）。 */
 export function splitLines(text: string): string[] {