dsh-recall-plugin 1.5.1 → 1.6.1

package/lib/index.js

@@ -12,10 +12,11 @@
  * 文件拆分见 lib/ 下各模块头注释；本文件只做接线，不承载业务逻辑。
  */
 
-import { createConfig } from './config.js'
+import { createConfig, Config } from './config.js'
 import { createRuntime } from './store.js'
 import { createSnapshots } from './snapshots.js'
 import { createMaintenance } from './maintenance.js'
+import { installSettingsSection } from '@deepseek-ai/dsh-settings'
 
 export const name = 'dsh-recall-plugin'
 
@@ -23,8 +24,13 @@ export const name = 'dsh-recall-plugin'
 // webServer（Client 半的 HTTP API 通道）。其余服务按需 ctx.get。
 export const inject = ['shell', 'sessions', 'webServer']
 
-// config 由 cordis.patch.yml 的 insert 行 config 键下发，用户在 profile 层
-// 按 id: recall 重述该行即可覆盖默认值（见 config.js 头注释）
+// 入口配置 schema：cordis 加载器据此校验 insert 行 config 并填充默认值，
+// 非法配置在插件加载时响亮失败（官方「插件配置」文档要求）。
+export { Config }
+
+// config 由 cordis.patch.yml 的 insert 行 config 键下发（schema 默认值兜底），
+// 设置页「插件配置」卡片的用户覆盖经 settings namespace 热更新进 cfg
+// （见下方 installSettingsSection 接线）
 export function apply(ctx, config) {
   const webServer = ctx.webServer
 
@@ -34,6 +40,27 @@ export function apply(ctx, config) {
   const maint = createMaintenance(ctx, rt, snaps, cfg)
   const state = rt.state
 
+  // ---- settings namespace「dsh-recall」：设置页「插件配置」分区正规接入 ----
+  // installSettingsSection（dsh-settings 官方辅助）：settings 服务挂载后以
+  // 真 Config schema 注册 namespace、组合 base 取入口 config；服务卸载时
+  // 源回退入口 config。解析层 = schema 默认 → 组合 base → 用户文档（设置
+  // 卡片写入、dsh-settings 持久化），变更经 watch 热更新进运行中的 cfg
+  // （Object.assign 原地改，各域按调用时读取立即生效）。环境变量仍最高
+  // 优先（createConfig 内处理）。settings 服务未组装（非 web 部署）时
+  // 整段静默不运行，插件照常以入口配置工作。
+  let readSettings = () => config
+  function applyResolvedConfig(resolved) {
+    Object.assign(cfg, createConfig(resolved && typeof resolved === 'object' ? resolved : {}))
+  }
+  try {
+    installSettingsSection(ctx, 'dsh-recall', Config, config, {
+      setSource: (fn) => { readSettings = fn },
+      onChange: () => applyResolvedConfig(readSettings()),
+    })
+  } catch (error) {
+    rt.recordError('recall settings namespace skipped: ' + String(error))
+  }
+
   // 平台门控：win32 走 PowerShell 模板，linux/darwin 走 bash 模板
   // （ctx.shell 由 DSH 平台层单选挂载 pwsh/bash 执行器，见 dsh-shell README）。
   // 其余平台干净短路：init 返回 unsupported，Client 弹一次性提示；
@@ -389,6 +416,83 @@ export function apply(ctx, config) {
     return deleted
   }
 
+  // 删除所有工作区的全部快照。树形管理的「工作区/会话」批量删除以
+  // index.json 中的记录为目标，适合保留其他节点；但「全部删除」必须把 git
+  // tag 当作真相源：index 可能因旧版/崩溃/手动修复而为空或过期，不能因为
+  // 索引里没有条目就漏删真实快照。磁盘枚举到的 store 即使 root.txt 丢失也
+  // 直接按目录操作，避免 resolveStore 新建同 root 的另一个空 store。
+  async function deleteAllSnapshots() {
+    return enqueue(async () => {
+      const stores = new Map()
+      for (const [root, store] of state.stores.entries()) {
+        if (store && store.dir) stores.set(store.dir, { store, root })
+      }
+      const dump = await dumpStores()
+      for (const [dir, info] of dump.entries()) {
+        const known = stores.get(dir)
+        if (known) {
+          if (!known.root && info.root) known.root = info.root
+          known.entries = info.entries || []
+        } else {
+          stores.set(dir, {
+            // 全局删除只动该目录下的 git/index；不必、也不能依赖可反解的 root。
+            store: rt.storeFromDir(dir, false),
+            root: info.root || null,
+            entries: info.entries || []
+          })
+        }
+      }
+
+      if (stores.size === 0) return { deleted: 0, stores: 0, failed: 0 }
+
+      const gitExe = await rt.resolveGit()
+      if (!gitExe) {
+        const message = '未检测到 git CLI，无法验证并删除快照 tag'
+        rt.recordError('recall delete all failed: ' + message)
+        return { deleted: 0, stores: 0, failed: stores.size || 1, message }
+      }
+
+      let deleted = 0
+      let clearedStores = 0
+      let failed = 0
+      for (const { store, root } of stores.values()) {
+        try {
+          // 先列出实际 tag；不要使用 entries 推导 tag，entries 是可丢失缓存。
+          const output = await rt.runShell(rt.scripts.listTagsScript(store, gitExe), { timeoutMs: 120000, stdoutMaxBytes: 4194304 })
+          const tags = rt.scripts.stripBom(output).split(/\r?\n/).map((tag) => tag.trim()).filter((tag) => tag.indexOf('snap-') === 0)
+          for (let i = 0; i < tags.length; i += 100) {
+            await rt.runShell(rt.scripts.purgeTagsScript(store, gitExe, tags.slice(i, i + 100)), { timeoutMs: 120000, stdoutMaxBytes: 4096 })
+          }
+          // purgeTagsScript 为幂等 best-effort，故必须回读校验，避免脚本吞掉
+          // 个别失败后仍错误地把 index.json 清空。
+          const remainedOutput = await rt.runShell(rt.scripts.listTagsScript(store, gitExe), { timeoutMs: 120000, stdoutMaxBytes: 4194304 })
+          const remained = rt.scripts.stripBom(remainedOutput).split(/\r?\n/).map((tag) => tag.trim()).filter((tag) => tag.indexOf('snap-') === 0)
+          if (remained.length) throw new Error('仍有 ' + remained.length + ' 个快照 tag 未删除')
+
+          // tag 清理被确认后才清空索引。直接写已枚举的 store，兼容 root.txt
+          // 缺失/错位的旧仓库；不能调用 saveIndex(root)，后者会重新按 root 寻址。
+          await rt.writeTextViaShell(store.dir + (rt.isWin ? '\\' : '/') + 'index.json', '[]')
+          for (const tag of tags) state.snapshots.delete(tag.slice('snap-'.length))
+          if (root) {
+            for (const [id, snap] of state.snapshots.entries()) {
+              if (snap && snap.root === root) state.snapshots.delete(id)
+            }
+            state.indexLoaded.add(root)
+          }
+          deleted += tags.length
+          clearedStores += 1
+        } catch (error) {
+          failed += 1
+          rt.recordError('recall delete all failed for ' + store.dir + ': ' + String(error))
+        }
+      }
+      // list 既合并内存也 dump 磁盘；无论完全/部分完成都必须失效，才能让
+      // 成功删除的 store 立即从树上消失，而失败 store 仍保留供用户重试。
+      listCache.payload = null
+      return { deleted, stores: clearedStores, failed }
+    })
+  }
+
   const endpoints = {
     'init': async (args) => {
       if (!supported) {
@@ -412,7 +516,9 @@ export function apply(ctx, config) {
           homeFallback: store ? !store.home : false
         }
       }
-      return { ok: Boolean(root), root: root || null, notice }
+      // 顺带下发客户端行为开关（fillDraft 等）：Client 无须为读配置单开请求，
+      // init 是每会话必经的预热通道
+      return { ok: Boolean(root), root: root || null, notice, config: { refillDraft: cfg.refillDraft } }
     },
 
     'snapshot-info': async (args) => {
@@ -493,6 +599,68 @@ export function apply(ctx, config) {
       return { ok: true }
     },
 
+    // 设置页「插件配置」卡片读配置：resolved 全量值 + 用户已覆盖字段（来自
+    // settings.describe 的 user 层，字段在层里出现即用户覆盖）+ env 锁定
+    // 字段（环境变量优先级最高，设置改不动）+ 可写性（只读 provider 禁存）。
+    'config-get': async () => {
+      const envLocks = {
+        gcSnaps: Boolean(process.env && process.env.DSH_RECALL_GC_SNAPS),
+        gcHours: Boolean(process.env && process.env.DSH_RECALL_GC_HOURS),
+      }
+      let overridden = {}
+      let writable = false
+      try {
+        const settings = ctx.get('settings')
+        if (settings && typeof settings.describe === 'function') {
+          const list = settings.describe()
+          const ours = (Array.isArray(list) ? list : []).find((d) => d && d.ns === 'dsh-recall')
+          if (ours && ours.user && typeof ours.user === 'object') overridden = ours.user
+          writable = settings.writable !== false
+        }
+      } catch (error) { /* describe 不可用按「无覆盖」处理 */ }
+      return {
+        ok: true,
+        values: {
+          gcSnaps: cfg.gcSnaps,
+          gcHours: cfg.gcHours,
+          maxFileBytes: cfg.maxFileBytes,
+          baseExcludes: cfg.baseExcludes.slice(),
+          refillDraft: cfg.refillDraft,
+        },
+        overridden,
+        envLocks,
+        writable,
+      }
+    },
+
+    // 设置页「插件配置」卡片存配置：白名单字段 + 类型清洗后经 settings.update
+    // 写进用户层（schema 校验失败会在持久化前 reject，错误信息回显卡片），
+    // watch 链路把新值热更新进 cfg，无需重启。
+    'config-set': async (args) => {
+      const patch = args && args.patch && typeof args.patch === 'object' ? args.patch : {}
+      const clean = {}
+      if (patch.gcSnaps !== undefined) clean.gcSnaps = Number(patch.gcSnaps)
+      if (patch.gcHours !== undefined) clean.gcHours = Number(patch.gcHours)
+      if (patch.maxFileBytes !== undefined) clean.maxFileBytes = Number(patch.maxFileBytes)
+      if (patch.refillDraft !== undefined) clean.refillDraft = Boolean(patch.refillDraft)
+      if (patch.baseExcludes !== undefined) {
+        if (!Array.isArray(patch.baseExcludes)) return { ok: false, code: 'BAD_TYPE', message: 'baseExcludes 必须是字符串数组' }
+        clean.baseExcludes = patch.baseExcludes.filter((p) => typeof p === 'string' && p.trim())
+      }
+      if (!Object.keys(clean).length) return { ok: false, code: 'EMPTY_PATCH', message: '没有可写入的配置字段' }
+      let settings = null
+      try { settings = ctx.get('settings') } catch (error) { settings = null }
+      if (!settings || typeof settings.update !== 'function') {
+        return { ok: false, code: 'SETTINGS_UNAVAILABLE', message: '设置服务不可用：请在 profile 的 cordis.patch.yml 按 id: recall 覆盖配置' }
+      }
+      try {
+        await settings.update('dsh-recall', clean)
+      } catch (error) {
+        return { ok: false, code: 'SETTINGS_WRITE_FAILED', message: '配置写入失败：' + String(error && error.message ? error.message : error) }
+      }
+      return { ok: true }
+    },
+
     // 设置页「快照管理」卡片：列表 / 磁盘占用 / 单条删除 / 手动 gc。
     // 全部走串行队列——删除 tag 与 gc 与快照争的是同一个 git 仓库。
     'manage': async (args) => {
@@ -639,12 +807,27 @@ export function apply(ctx, config) {
         return { ok: true, messageTexts: texts }
       }
       if (op === 'usage') {
-        const root = await rt.resolveRoot(sessionId)
-        if (!root) return { ok: false, code: 'NO_ROOT', message: '无法解析当前工作区' }
-        const store = state.stores.get(root)
-        if (!store) return { ok: false, code: 'NO_STORE', message: '当前工作区尚未创建快照存储' }
-        const out = await rt.runShell(rt.scripts.diskUsageScript(store.dir), { stdoutMaxBytes: 4096 })
-        const bytes = parseInt(rt.scripts.stripBom(out).trim(), 10) || 0
+        let bytes = 0
+        if (sessionId) {
+          // 旧调用方（带会话上下文）：单工作区占用
+          const root = await rt.resolveRoot(sessionId)
+          if (!root) return { ok: false, code: 'NO_ROOT', message: '无法解析当前工作区' }
+          const store = state.stores.get(root)
+          if (!store) return { ok: false, code: 'NO_STORE', message: '当前工作区尚未创建快照存储' }
+          const out = await rt.runShell(rt.scripts.diskUsageScript(store.dir), { stdoutMaxBytes: 4096 })
+          bytes = parseInt(rt.scripts.stripBom(out).trim(), 10) || 0
+        } else {
+          // 新调用方（settings.plugin.item 卡片无会话上下文）：全部已知
+          // store 汇总。store 全集取内存缓存（启动预热填齐）；单个失败
+          // 不影响汇总，best-effort。
+          for (const store of state.stores.values()) {
+            if (!store || !store.dir) continue
+            try {
+              const out = await rt.runShell(rt.scripts.diskUsageScript(store.dir), { stdoutMaxBytes: 4096 })
+              bytes += parseInt(rt.scripts.stripBom(out).trim(), 10) || 0
+            } catch (error) { /* 单 store 失败跳过 */ }
+          }
+        }
         return { ok: true, bytes }
       }
       if (op === 'delete') {
@@ -706,8 +889,24 @@ export function apply(ctx, config) {
         })
         return { ok: true }
       }
+      if (op === 'deleteAll') {
+        const result = await deleteAllSnapshots()
+        if (result.failed > 0) {
+          return {
+            ok: false,
+            code: 'PARTIAL_DELETE',
+            deleted: result.deleted,
+            message: result.message || ('已删除 ' + result.deleted + ' 条快照，但有 ' + result.failed + ' 个存储未完成；请查看最近错误后重试')
+          }
+        }
+        return { ok: true, deleted: result.deleted, stores: result.stores }
+      }
       if (op === 'gc') {
-        const done = await enqueue(() => maint.runGc(sessionId, true))
+        // 带会话上下文：只 gc 该会话的工作区；无上下文（设置卡片）：
+        // 全部已知 store 逐个 gc。两者都排进串行队列，与快照互斥。
+        const done = sessionId
+          ? await enqueue(() => maint.runGc(sessionId, true))
+          : await enqueue(() => maint.runGcAll())
         return { ok: true, gc: Boolean(done) }
       }
       return { ok: false, code: 'UNKNOWN_OP', message: '未知的管理操作: ' + op }
@@ -775,8 +974,12 @@ export function apply(ctx, config) {
       try {
         const records = await querySvc.listSessions()
         for (const record of records || []) {
+          // listSessions 记录形如 {header, live, persisted}，会话 id 在
+          // header.id——此前误用顶层 record.id（恒 undefined），预热重建
+          // 的孤儿快照 sessionId 记为空，树形管理里会落进「已删除会话」。
+          const id = record && record.header && record.header.id ? record.header.id : null
           const cwd = record && record.header && record.header.cwd
-          if (cwd && !warmupRoots.has(cwd)) warmupRoots.set(cwd, record.id || null)
+          if (cwd && !warmupRoots.has(cwd)) warmupRoots.set(cwd, id)
         }
       } catch (error) { /* 冷元数据不可用则退回 live 注册表 */ }
     }

package/lib/maintenance.js

@@ -11,13 +11,12 @@
  * 接线），因此 gc/清理与快照天然互斥，不存在 git 锁竞态。
  */
 
-// gc 节流阈值来自 config 域（用户可在 profile 的 cordis.patch.yml 覆盖，
-// 环境变量 DSH_RECALL_GC_SNAPS/GC_HOURS 仍最高优先，见 config.js）：
+// gc 节流阈值来自 config 域（设置页「插件配置」卡片可实时改写 cfg，
+// 因此这里按调用时取值而不是工厂创建时快照；环境变量
+// DSH_RECALL_GC_SNAPS/GC_HOURS 仍最高优先，见 config.js）：
 // 每 gcSnaps 条快照或距上次 gc gcHours 小时，先到先触发。默认「50 条或
 // 24 小时」——重活（gc）一天至多一次的量级，轻会话用户也不会等太久。
 export function createMaintenance(ctx, rt, snaps, config) {
-  const GC_SNAPS = config.gcSnaps
-  const GC_MS = config.gcHours * 3600000
   const sessions = ctx.sessions
   const state = rt.state
   // 平台选择的脚本模板（gc/purge 两套模板同名导出）
@@ -97,7 +96,7 @@ export function createMaintenance(ctx, rt, snaps, config) {
     const last = state.gcLastAt.get(store.git) || 0
     const count = (state.gcCount.get(store.git) || 0) + 1
     state.gcCount.set(store.git, count)
-    if (!force && count < GC_SNAPS && now - last < GC_MS) return false
+    if (!force && count < config.gcSnaps && now - last < config.gcHours * 3600000) return false
     state.gcCount.set(store.git, 0)
     try {
       await sweepDeletedSessions()
@@ -109,12 +108,38 @@ export function createMaintenance(ctx, rt, snaps, config) {
     return true
   }
 
+  // 全局 gc（设置卡片没有会话上下文）：清理扫描一次 + 逐 store gc。
+  // store 全集取内存缓存（启动预热与历次操作会填齐已知工作区）；逐个
+  // best-effort，单个失败记错误继续。调用方（manage 端点）把它排进同一条
+  // 串行队列，与快照天然互斥，无 git 锁竞态。
+  async function runGcAll() {
+    const stores = Array.from(new Set(Array.from(state.stores.values()).filter(Boolean)))
+    if (!stores.length || !state.gitExe) return false
+    try {
+      await sweepDeletedSessions()
+    } catch (error) {
+      rt.recordError('recall sweep failed: ' + String(error))
+    }
+    let done = 0
+    for (const store of stores) {
+      try {
+        await rt.runShell(S.gcScript(store, state.gitExe), { timeoutMs: 600000, stdoutMaxBytes: 4096 })
+        done++
+      } catch (error) {
+        rt.recordError('recall gc failed for ' + (store && store.git) + ': ' + String(error))
+      }
+      state.gcLastAt.set(store.git, Date.now())
+      state.gcCount.set(store.git, 0)
+    }
+    return true
+  }
+
   // 每条消息快照后串行调用（见 index.js 事件接线）
   async function maybeMaintain(sessionId) {
     await runGc(sessionId, false)
   }
 
-  // 模块收敛：只导出唯一被装配层消费的入口；sweepDeletedSessions /
-  // purgeSession 是 runGc 的内部步骤，不对外暴露面
-  return { maybeMaintain, runGc }
+  // 模块收敛：只导出被装配层消费的入口；sweepDeletedSessions /
+  // purgeSession 是 gc 的内部步骤，不对外暴露面
+  return { maybeMaintain, runGc, runGcAll }
 }

package/lib/scripts.posix.js

@@ -71,7 +71,9 @@ function oversizeBlock(maxBytes) {
 // base 基础排除表按调用注入（config.baseExcludes 可调），不硬编码。
 // 依赖外层已定义的 $git/$g。
 function excludeSyncBlock(excludeFile, base) {
-  const baseList = Array.isArray(base) && base.length ? base : ['.git', 'node_modules/', '.dsh-recall-snapshots/']
+  // 兜底含两种存储目录名：降级为 .dsh-recall-snapshots/，home 存储为
+  // dsh-recall-snapshots/（root=HOME 时落入工作区，漏排除会自吞，issue #6）
+  const baseList = Array.isArray(base) && base.length ? base : ['.git', 'node_modules/', '.dsh-recall-snapshots/', 'dsh-recall-snapshots/']
   const baseLines = baseList.join('\n') + '\n'
   return [
     'ex_file=' + psq(excludeFile),
@@ -258,6 +260,9 @@ export function listTagsScript(store, gitExe) {
     'set -e',
     'git=' + psq(gitExe),
     'g=' + psq(store.git),
+    // 仅创建过 store 目录、尚未产生过快照时没有 git/.git；把它视为
+    // 空快照仓库而非错误，全部删除仍可顺便清空其陈旧 index.json。
+    '[ -d "$g" ] || exit 0',
     '"$git" --git-dir="$g" tag -l \'snap-*\''
   ].join('\n')
 }

package/lib/scripts.pwsh.js

@@ -73,7 +73,9 @@ function oversizeBlock(maxBytes) {
 // - 依赖外层已定义的 $git/$g；被 ensureGit/snapshot/diff/rollback 复用，
 //   因此 exclude.txt 的改动在下一次快照/diff/回退时即时生效，无需重启。
 function excludeSyncBlock(excludeFile, base) {
-  const baseList = (Array.isArray(base) && base.length ? base : ['.git', 'node_modules/', '.dsh-recall-snapshots/']).map(psq).join(',')
+  // 兜底含两种存储目录名：降级为 .dsh-recall-snapshots/，home 存储为
+  // dsh-recall-snapshots/（root=HOME 时落入工作区，漏排除会自吞，issue #6）
+  const baseList = (Array.isArray(base) && base.length ? base : ['.git', 'node_modules/', '.dsh-recall-snapshots/', 'dsh-recall-snapshots/']).map(psq).join(',')
   return [
     "$exFile = " + psq(excludeFile),
     '$userPats = @()',
@@ -288,6 +290,9 @@ export function listTagsScript(store, gitExe) {
     "$ErrorActionPreference = 'Stop'",
     '$git = ' + psq(gitExe),
     '$g = ' + psq(store.git),
+    // 仅创建过 store 目录、尚未产生过快照时没有 git/.git；把它视为
+    // 空快照仓库而非错误，全部删除仍可顺便清空其陈旧 index.json。
+    'if (-not (Test-Path -LiteralPath $g -PathType Container)) { exit 0 }',
     '& $git --git-dir=$g tag -l "snap-*"'
   ].join('\n')
 }