dsh-recall-plugin 1.7.1 → 2.0.0

package/lib/client.js

@@ -9,7 +9,7 @@
  *
  * 这是 dsh.client bundle（exports["./client"]），由 client-modules 打包成
  * /plugins/<pkg>/client.js 注入页面；factory 内 require("react") 由平台
- * 模块表提供。零构建依赖：纯 JS + React.createElement。
+ * 模块表提供。当前为纯 JS + React.createElement 直写。
  */
 window.__ModuleLoader__.load({
   id: "dsh-recall-plugin",
@@ -73,6 +73,7 @@ window.__ModuleLoader__.load({
           '.dsh-recall-ex-chip:hover{color:var(--dsw-alias-label-primary)}',
           '.dsh-recall-ex-status{margin-right:auto;font-size:12px;line-height:20px;color:var(--dsw-alias-label-tertiary)}',
           '.dsh-recall-ex-status-error{color:var(--dsw-alias-state-error-primary)}',
+          '.dsh-recall-ex-status-success{color:var(--dsw-alias-state-success-primary)}',
           '.dsh-recall-tree{display:flex;flex-direction:column;gap:2px;padding:4px 0}',
           '.dsh-recall-tree-node{display:flex;flex-direction:column;gap:1px}',
           '.dsh-recall-tree-row{display:flex;gap:6px;align-items:center;min-width:0;padding:2px 4px;border-radius:6px;cursor:default}',
@@ -175,7 +176,7 @@ window.__ModuleLoader__.load({
         // has:false 且不再重试，撤回按钮将永不出现。
         // init 顺带下发插件行为开关（refillDraft 等），存进 pluginConfig
         // 供撤回执行链读取——设置页改配置 + 重启后随下一次 init 刷新。
-        const pluginConfig = { refillDraft: true }
+        const pluginConfig = { refillDraft: true, archiveOriginal: true }
         function ensureInit(sessionId) {
           if (!sessionId) return Promise.resolve()
           const cached = initMap.get(sessionId)
@@ -183,6 +184,7 @@ window.__ModuleLoader__.load({
           const done = api('init', { sessionId }).then((res) => {
             if (res && res.config && typeof res.config === 'object') {
               if (typeof res.config.refillDraft === 'boolean') pluginConfig.refillDraft = res.config.refillDraft
+              if (typeof res.config.archiveOriginal === 'boolean') pluginConfig.archiveOriginal = res.config.archiveOriginal
             }
             const notice = res && res.notice
             if (notice && notice.unsupported) {
@@ -472,9 +474,36 @@ window.__ModuleLoader__.load({
             if (recall.stage !== 'confirm') return
             const changes = recall.changes || []
             const previewCut = typeof recall.cutSeq === 'number' ? recall.cutSeq : null
+            // P0-3：携带预览摘要（total 是完整计数，与 Host 侧 diffFor 的
+            // total 对齐；changes 截断到 500 条，不能用来比对）。Host 端
+            // 据此在 execute 时校验「预览后文件集是否变化」，变了则返回
+            // STALE 拒绝执行，防止把工作区改到用户没看过的新状态。
+            const previewTotal = typeof recall.total === 'number' ? recall.total : changes.length
             setRecall({ stage: 'executing', changes })
-            api('execute', { messageId, sessionId }).then(async (res) => {
+            api('execute', { messageId, sessionId, previewTotal, previewAt: Date.now() }).then(async (res) => {
               if (!res || !res.ok) {
+                // STALE：预览后文件变了——自动重新拉一次最新清单回到确认
+                // 阶段让用户看新内容，而不是停在错误面板
+                if (res && res.code === 'STALE') {
+                  setRecall({ stage: 'loading' })
+                  api('preview', { messageId, sessionId }).then((res2) => {
+                    if (!res2 || !res2.ok) {
+                      setRecall({ stage: 'error', message: (res2 && (res2.message || res2.error)) || '无法获取快照' })
+                      return
+                    }
+                    setRecall({
+                      stage: 'confirm',
+                      changes: res2.changes || [],
+                      total: typeof res2.total === 'number' ? res2.total : (res2.changes || []).length,
+                      truncated: Boolean(res2.truncated),
+                      time: res2.time || null,
+                      cutSeq: typeof res2.cutSeq === 'number' ? res2.cutSeq : null
+                    })
+                  }).catch((error) => {
+                    setRecall({ stage: 'error', message: String(error) })
+                  })
+                  return
+                }
                 setRecall({ stage: 'error', message: (res && (res.message || res.error)) || '回退失败' })
                 return
               }
@@ -496,8 +525,10 @@ window.__ModuleLoader__.load({
                     if (typeof sessionsSvc.open === 'function') sessionsSvc.open(childId)
                     chatReverted = true
                     fillTarget = childId
-                    // 回退前的原会话归档：只是从列表隐藏、可恢复，避免侧栏出现两个近似会话
-                    if (workspacesSvc && typeof workspacesSvc.archiveSession === 'function') {
+                    // 回退前的原会话归档（可关，见设置页 archiveOriginal）：只是从列表
+                    // 隐藏、可恢复，避免侧栏出现两个近似会话；关闭时原会话
+                    // 保留供对照
+                    if (pluginConfig.archiveOriginal && workspacesSvc && typeof workspacesSvc.archiveSession === 'function') {
                       workspacesSvc.archiveSession(sessionId).catch(() => {})
                     }
                   } else {
@@ -682,7 +713,7 @@ window.__ModuleLoader__.load({
               }, s))
             ),
             React.createElement('div', { className: 'dsh-recall-panel-actions' },
-              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : '') }, state.message) : null,
+              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : ' dsh-recall-ex-status-success') }, state.message) : null,
               React.createElement('button', { type: 'button', className: 'dsh-recall-btn', disabled: !dirty || state.busy, onClick: discard }, '放弃修改'),
               React.createElement('button', { type: 'button', className: 'dsh-recall-btn dsh-recall-btn-danger', disabled: !dirty || state.busy, onClick: save }, '保存')
             )
@@ -698,6 +729,21 @@ window.__ModuleLoader__.load({
           const [usage, setUsage] = React.useState(null)
           const [errors, setErrors] = React.useState(null)
           const [state, setState] = React.useState({ busy: false, message: '', error: false })
+          // 快照全量计数与当前拉取上限（S1-2）：Host 按 limit 切片返回，
+          // total 是全量——树默认折叠，全量加载到 2000 上限对 DOM 无压力，
+          // 分页与树形组装互斥，故用「加载更多」而非翻页。
+          const [limit, setLimit] = React.useState(200)
+          const [total, setTotal] = React.useState(0)
+          // 存储健康（S2-4）：git 可用性 + home/降级分区计数，来自 usage
+          // 端点的扩展响应；git 不可用/降级是消息流一次性 toast 之外常驻
+          // 可见的排障信息。
+          const [health, setHealth] = React.useState(null)
+          // 树搜索关键字（S3-4）：纯客户端过滤已加载条目，按工作区名/会话
+          // 标题/消息文本/快照 ID 匹配；只过滤当前已加载数据，与 S1-2 的
+          // limit 正交。
+          const [query, setQuery] = React.useState('')
+          // 最近错误展开态（S3-5）：默认 5 条，可展开全部 20 条/收起
+          const [showAllErrors, setShowAllErrors] = React.useState(false)
           // 冷会话标题在服务端要整日志解压（10 秒级），首屏不等它：列表
           // 先出（live/缓存标题），拿到后对缺标题的会话异步补拉再合并。
           const [titlesPending, setTitlesPending] = React.useState(false)
@@ -746,10 +792,12 @@ window.__ModuleLoader__.load({
             }).catch(() => {})
           }
 
-          function refresh() {
-            api('manage', { op: 'list' }).then((res) => {
+          function refresh(overLimit) {
+            const useLimit = overLimit || limit
+            api('manage', { op: 'list', limit: useLimit }).then((res) => {
               if (res && res.ok) {
                 setItems(res.items || [])
+                setTotal(typeof res.total === 'number' ? res.total : (res.items || []).length)
                 fetchTitles(res.items || [])
                 fetchMessages(res.items || [])
               }
@@ -758,7 +806,10 @@ window.__ModuleLoader__.load({
               // 渲染后，用户先看到树形内容，占用再异步补上（usage 不带
               // sessionId，Host 汇总全部工作区）。
               api('manage', { op: 'usage' }).then((res) => {
-                if (res && res.ok) setUsage(res.bytes || 0)
+                if (res && res.ok) {
+                  setUsage(res.bytes || 0)
+                  setHealth({ gitAvailable: res.gitAvailable !== false, homeStores: res.homeStores || 0, fallbackStores: res.fallbackStores || 0 })
+                }
               }).catch(() => {})
               api('status', {}).then((res) => {
                 if (res && res.ok) setErrors(res.errors || [])
@@ -766,7 +817,10 @@ window.__ModuleLoader__.load({
             }).catch(() => {
               // list 失败时仍尝试补 usage/status，避免整卡全空
               api('manage', { op: 'usage' }).then((res) => {
-                if (res && res.ok) setUsage(res.bytes || 0)
+                if (res && res.ok) {
+                  setUsage(res.bytes || 0)
+                  setHealth({ gitAvailable: res.gitAvailable !== false, homeStores: res.homeStores || 0, fallbackStores: res.fallbackStores || 0 })
+                }
               }).catch(() => {})
               api('status', {}).then((res) => {
                 if (res && res.ok) setErrors(res.errors || [])
@@ -776,6 +830,13 @@ window.__ModuleLoader__.load({
 
           React.useEffect(() => { refresh() }, [])
 
+          // S3-5：清空 Host 侧错误缓冲并同步本地状态；Host 已清后下次
+          // refresh 拉回为空，不重复请求。
+          function clearErrors() {
+            setErrors([])
+            api('status', { op: 'clear' }).catch(() => {})
+          }
+
           function run(op, extra, doneText) {
             if (state.busy) return
             setState({ busy: true, message: '执行中…', error: false })
@@ -795,17 +856,17 @@ window.__ModuleLoader__.load({
           function renderDeleteAllConfirm() {
             if (!confirming || confirming.kind !== 'all') return null
             return React.createElement('div', { className: 'dsh-recall-tree-confirm' },
-              '确认删除所有工作区的全部快照？此操作不可恢复。',
-              React.createElement('button', {
-                type: 'button',
-                className: 'dsh-recall-ex-chip',
-                onClick: () => {
-                  setConfirming(null)
-                  run('deleteAll', {}, '已清空全部快照')
-                }
-              }, '确认全部删除'),
-              React.createElement('button', { type: 'button', className: 'dsh-recall-ex-chip', onClick: () => setConfirming(null) }, '取消')
-            )
+                '确认删除所有工作区的全部快照？此操作不可恢复。',
+                React.createElement('button', {
+                  type: 'button',
+                  className: 'dsh-recall-btn dsh-recall-btn-danger',
+                  onClick: () => {
+                    setConfirming(null)
+                    run('deleteAll', {}, '已清空全部快照')
+                  }
+                }, '确认全部删除'),
+                React.createElement('button', { type: 'button', className: 'dsh-recall-ex-chip', onClick: () => setConfirming(null) }, '取消')
+              )
           }
 
           // 树形管理：工作区 → 会话 → 快照三级。折叠状态用 Set<key> 记录，
@@ -843,7 +904,16 @@ window.__ModuleLoader__.load({
             }
             return wsList
           }
-          const tree = buildTree(items)
+          const q = query.trim().toLowerCase()
+          const filteredItems = q
+            ? (items || []).filter((it) =>
+                (it.workspace || '').toLowerCase().indexOf(q) >= 0 ||
+                (it.sessionTitle || '').toLowerCase().indexOf(q) >= 0 ||
+                (it.messageText || '').toLowerCase().indexOf(q) >= 0 ||
+                String(it.id || '').toLowerCase().indexOf(q) >= 0
+              )
+            : items
+          const tree = buildTree(filteredItems)
           // 每个节点的删除按钮统一走 run()；workspace/session 用新端点 scope
           // 批量删，叶子沿用原单条删除。二次确认文案按节点层级区分。
           function confirmDelete(kind, key, extra, text) {
@@ -948,21 +1018,63 @@ window.__ModuleLoader__.load({
           }
           const treeNodes = tree.map(renderWorkspace)
 
+          // 计数用 Host 返回的全量 total 而非已加载条数（S1-2）：loaded 为
+          // null 表示首屏加载中（显示 …），已加载但 total 超过当前 limit
+          // 时提示「当前显示最新 X 条」与加载更多入口。
+          const loaded = items ? items.length : null
+          const countText = loaded === null
+            ? '共 … 条快照'
+            : '共 ' + total + ' 条快照' + (limit < total ? '（当前显示最新 ' + loaded + ' 条）' : '')
+
+          // 加载更多：上限 2000 与 Host 端钳制一致；total 已含全量计数，
+          // 直接按 total 一次拉满（再往上就是 2000 封顶）
+          function loadMore() {
+            const next = Math.min(Math.max(total, limit), 2000)
+            if (next <= limit) return
+            setLimit(next)
+            refresh(next)
+          }
+
           return React.createElement('div', { className: 'dsh-recall-ex-card' },
             React.createElement('div', { className: 'dsh-recall-ex-title' }, '快照管理'),
             React.createElement('div', { className: 'dsh-recall-ex-note' },
               usage === null
-                ? '共 ' + (items ? items.length : '…') + ' 条快照。'
-                : '共 ' + (items ? items.length : '…') + ' 条快照，全部工作区快照存储占用 ' + sizeText(usage) + '。'
+                ? countText + '。'
+                : countText + '，全部工作区快照存储占用 ' + sizeText(usage) + '。'
             ),
+            health ? React.createElement('div', { className: 'dsh-recall-ex-note', key: 'health' },
+              React.createElement('span', {
+                className: health.gitAvailable ? '' : 'dsh-recall-ex-status-error'
+              }, health.gitAvailable ? 'git 可用' : 'git 不可用（快照引擎依赖 git）'),
+              ' · 快照存储：home ' + health.homeStores + ' 个工作区' + (health.fallbackStores ? '，降级 ' + health.fallbackStores + ' 个' : '')
+            ) : null,
+            React.createElement('input', {
+              className: 'dsh-recall-ex-input',
+              placeholder: '搜索工作区 / 会话标题 / 消息内容 / ID',
+              value: query,
+              spellCheck: false,
+              onChange: (e) => setQuery(e.target.value),
+            }),
             treeNodes.length > 0 ? React.createElement('div', { className: 'dsh-recall-tree' }, ...treeNodes) : null,
+            items && items.length === 0 && !q
+              ? React.createElement('div', { className: 'dsh-recall-ex-note', key: 'empty' }, '在任意工作区发送一条消息后，这里会出现快照。')
+              : null,
+            q && filteredItems && filteredItems.length === 0
+              ? React.createElement('div', { className: 'dsh-recall-ex-note', key: 'no-match' }, '无匹配快照')
+              : null,
             renderDeleteAllConfirm(),
             React.createElement('div', { className: 'dsh-recall-panel-actions' },
-              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : '') }, state.message) : null,
+              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : ' dsh-recall-ex-status-success') }, state.message) : null,
+              limit < total ? React.createElement('button', {
+                type: 'button',
+                className: 'dsh-recall-btn',
+                disabled: state.busy,
+                onClick: loadMore
+              }, '加载更多') : null,
               React.createElement('button', { type: 'button', className: 'dsh-recall-btn', disabled: state.busy, onClick: refresh }, '刷新'),
               React.createElement('button', {
                 type: 'button',
-                className: 'dsh-recall-btn',
+                className: 'dsh-recall-btn dsh-recall-btn-danger',
                 disabled: state.busy,
                 title: '删除全部工作区的所有快照；会直接核对并删除 git tag（即使列表为空也可清理残留）',
                 onClick: () => setConfirming({ kind: 'all' })
@@ -976,9 +1088,15 @@ window.__ModuleLoader__.load({
               }, '立即 gc')
             ),
             errors && errors.length > 0
-              ? React.createElement('div', { className: 'dsh-recall-ex-note' },
-                  '最近错误：',
-                  errors.slice(0, 5).map((e, i) => React.createElement('div', { key: i, className: 'dsh-recall-ex-note' }, clockText(e.time) + '  ' + e.message))
+              ? React.createElement('div', { className: 'dsh-recall-ex-note', key: 'errors' },
+                  React.createElement('div', { className: 'dsh-recall-ex-status' },
+                    '最近错误：',
+                    (showAllErrors ? errors : errors.slice(0, 5)).map((e, i) => React.createElement('div', { key: i, className: 'dsh-recall-ex-note' }, clockText(e.time) + '  ' + e.message))
+                  ),
+                  React.createElement('div', { className: 'dsh-recall-panel-actions' },
+                    errors.length > 5 ? React.createElement('button', { type: 'button', className: 'dsh-recall-ex-chip', onClick: () => setShowAllErrors((v) => !v) }, showAllErrors ? '收起' : '展开全部 (' + errors.length + ')') : null,
+                    React.createElement('button', { type: 'button', className: 'dsh-recall-ex-chip', onClick: clearErrors }, '清空')
+                  )
                 )
               : null
           )
@@ -1021,6 +1139,16 @@ window.__ModuleLoader__.load({
           )
         }
 
+        // ConfigForm 的字节↔MB 换算：持久化与 schema 都是字节（config-get
+        // 下发原值），只在 display/input 层换算成人工友好的 MB 小数；round
+        // 2 位小数去尾零，避免默认值 104857600 裸奔成一长串数字
+        // （plan-settings-ux S1-1）。
+        function bytesToMb(bytes) {
+          const n = Number(bytes)
+          if (!Number.isFinite(n) || n <= 0) return ''
+          return String(Math.round((n / 1048576) * 100) / 100)
+        }
+
         // 插件配置表单：值经 Host 的 settings namespace「dsh-recall」读写
         // （config-get / config-set 端点），保存即持久化进用户 settings 文档
         // 并热生效（Host watch 链路原地更新 cfg），无需重启。只提交相对
@@ -1032,6 +1160,9 @@ window.__ModuleLoader__.load({
           const [overridden, setOverridden] = React.useState({})
           const [writable, setWritable] = React.useState(true)
           const [state, setState] = React.useState({ busy: false, message: '', error: false })
+          // 「高级：基础排除表」折叠态（S3-2）：与 exclude.txt 同为 gitignore
+          // 编辑器，叠放会造成认知负担——内置规则收进折叠，只留高频项在首屏
+          const [showAdvanced, setShowAdvanced] = React.useState(false)
 
           function load() {
             api('config-get', {}).then((res) => {
@@ -1040,9 +1171,13 @@ window.__ModuleLoader__.load({
                 const next = {
                   gcSnaps: String(v.gcSnaps == null ? '' : v.gcSnaps),
                   gcHours: String(v.gcHours == null ? '' : v.gcHours),
-                  maxFileBytes: String(v.maxFileBytes == null ? '' : v.maxFileBytes),
+                  maxFileBytes: bytesToMb(v.maxFileBytes),
+                  maxSnapshotsPerWorkspace: String(v.maxSnapshotsPerWorkspace == null ? '' : v.maxSnapshotsPerWorkspace),
                   baseExcludes: Array.isArray(v.baseExcludes) ? v.baseExcludes.join('\n') : '',
                   refillDraft: v.refillDraft !== false,
+                  snapshotEnabled: v.snapshotEnabled !== false,
+                  archiveOriginal: v.archiveOriginal !== false,
+                  retentionDays: String(v.retentionDays == null ? '' : v.retentionDays),
                 }
                 setDraft(next)
                 setBaseline(next)
@@ -1064,7 +1199,7 @@ window.__ModuleLoader__.load({
           function save() {
             if (state.busy || !draft || !baseline) return
             const patch = {}
-            for (const key of ['gcSnaps', 'gcHours', 'maxFileBytes', 'baseExcludes', 'refillDraft']) {
+            for (const key of ['gcSnaps', 'gcHours', 'maxFileBytes', 'maxSnapshotsPerWorkspace', 'baseExcludes', 'refillDraft', 'snapshotEnabled', 'archiveOriginal', 'retentionDays']) {
               if (draft[key] !== baseline[key]) patch[key] = draft[key]
             }
             if (!Object.keys(patch).length) {
@@ -1083,11 +1218,25 @@ window.__ModuleLoader__.load({
               clean.gcHours = n
             }
             if (patch.maxFileBytes !== undefined) {
-              const n = parseInt(patch.maxFileBytes, 10)
-              if (!Number.isFinite(n) || n < 1024) { setState({ busy: false, message: '文件大小上限必须是 >= 1024 的字节数', error: true }); return }
-              clean.maxFileBytes = n
+              // display 层是 MB 小数，持久化仍是字节（Math.round 取整）：
+              // model 侧不变，config-get/config-set 往返零改动
+              const mb = Number(patch.maxFileBytes)
+              if (!Number.isFinite(mb) || mb < 0.01) { setState({ busy: false, message: '文件大小上限至少 0.01 MB', error: true }); return }
+              clean.maxFileBytes = Math.round(mb * 1048576)
+            }
+            if (patch.maxSnapshotsPerWorkspace !== undefined) {
+              const n = parseInt(patch.maxSnapshotsPerWorkspace, 10)
+              if (!Number.isFinite(n) || n < 0) { setState({ busy: false, message: '快照总量上限必须是 >= 0 的整数（0 表示不限制）', error: true }); return }
+              clean.maxSnapshotsPerWorkspace = n
             }
             if (patch.refillDraft !== undefined) clean.refillDraft = Boolean(patch.refillDraft)
+            if (patch.snapshotEnabled !== undefined) clean.snapshotEnabled = Boolean(patch.snapshotEnabled)
+            if (patch.archiveOriginal !== undefined) clean.archiveOriginal = Boolean(patch.archiveOriginal)
+            if (patch.retentionDays !== undefined) {
+              const n = parseInt(patch.retentionDays, 10)
+              if (!Number.isFinite(n) || n < 0) { setState({ busy: false, message: '保留天数必须是 >= 0 的整数（0 表示不启用）', error: true }); return }
+              clean.retentionDays = n
+            }
             if (patch.baseExcludes !== undefined) {
               clean.baseExcludes = String(patch.baseExcludes).split('\n').map((l) => l.trim()).filter(Boolean)
             }
@@ -1102,7 +1251,7 @@ window.__ModuleLoader__.load({
             }).catch((e) => setState({ busy: false, message: String(e), error: true }))
           }
 
-          function numRow(key, label, hint) {
+          function numRow(key, label, hint, opts) {
             const locked = Boolean(envLocks && envLocks[key])
             const changed = Boolean(draft && baseline && draft[key] !== baseline[key])
             return React.createElement('div', { className: 'dsh-recall-cfg-row', key: key },
@@ -1113,8 +1262,11 @@ window.__ModuleLoader__.load({
                   type: 'number',
                   value: draft ? draft[key] : '',
                   disabled: locked || !writable,
+                  min: opts && opts.min,
+                  step: opts && opts.step,
                   onChange: (e) => edit(key, e.target.value),
                 }),
+                opts && opts.suffix ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, opts.suffix) : null,
                 changed && !locked ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
                 overridden && overridden[key] !== undefined ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已覆盖') : null,
                 locked ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '环境变量锁定') : null
@@ -1123,18 +1275,49 @@ window.__ModuleLoader__.load({
             )
           }
 
+          function resetDefaults() {
+            if (state.busy || !writable) return
+            setState({ busy: true, message: '恢复默认中…', error: false })
+            api('config-reset', {}).then((res) => {
+              if (res && res.ok) {
+                load()
+                setState({ busy: false, message: '已恢复默认值', error: false })
+              } else {
+                setState({ busy: false, message: (res && (res.message || res.error)) || '恢复默认失败', error: true })
+              }
+            }).catch((e) => setState({ busy: false, message: String(e), error: true }))
+          }
+
           if (!draft) {
             return React.createElement('div', { className: 'dsh-recall-ex-note' }, state.message || '正在读取配置…')
           }
 
           return React.createElement('div', { className: 'dsh-recall-ex-card' },
-            numRow('gcSnaps', 'gc 触发条数', '每积累多少条快照触发一次 git gc'),
-            numRow('gcHours', 'gc 触发小时', '距上次 gc 超过多少小时触发（与条数先到先触发）'),
-            numRow('maxFileBytes', '文件大小上限', '超过该字节数的文件不进快照、不被回退触碰'),
+            React.createElement('div', { className: 'dsh-recall-cfg-row', key: 'snapshotEnabled' },
+              React.createElement('div', { className: 'dsh-recall-cfg-line' },
+                React.createElement('label', { className: 'dsh-recall-cfg-label', htmlFor: 'dsh-recall-cfg-snapshot' }, '启用快照'),
+                React.createElement('input', {
+                  id: 'dsh-recall-cfg-snapshot',
+                  type: 'checkbox',
+                  checked: Boolean(draft.snapshotEnabled),
+                  disabled: !writable,
+                  onChange: (e) => edit('snapshotEnabled', e.target.checked),
+                }),
+                draft.snapshotEnabled !== baseline.snapshotEnabled ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
+                overridden && overridden.snapshotEnabled !== undefined ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已覆盖') : null
+              ),
+              React.createElement('div', { className: 'dsh-recall-cfg-hint' }, '关闭后不再新建快照（已有快照仍可撤回），适合临时禁用快照的场合')
+            ),
+            numRow('gcSnaps', 'gc 触发条数', '每积累多少条快照触发一次 git gc', { min: 1, step: 1 }),
+            numRow('gcHours', 'gc 触发小时', '距上次 gc 超过多少小时触发（与条数先到先触发）', { min: 1, step: 1 }),
+            numRow('maxFileBytes', '文件大小上限', '超过该大小的文件不进快照、不被回退触碰（单位 MB，支持小数）', { suffix: 'MB', min: 0.01, step: 0.5 }),
+            numRow('maxSnapshotsPerWorkspace', '快照总量上限', '每个工作区保留的最大快照数，超限自动删除最旧的；填 0 表示不限制', { min: 0, step: 1 }),
+            numRow('retentionDays', '快照保留天数', '按天数保留快照，超期自动删除最旧的；填 0 表示不启用（与快照总数上限各自生效）', { min: 0, step: 1 }),
             React.createElement('div', { className: 'dsh-recall-cfg-row', key: 'refillDraft' },
               React.createElement('div', { className: 'dsh-recall-cfg-line' },
-                React.createElement('label', { className: 'dsh-recall-cfg-label' }, '撤回后回填输入框'),
+                React.createElement('label', { className: 'dsh-recall-cfg-label', htmlFor: 'dsh-recall-cfg-refill' }, '撤回后回填输入框'),
                 React.createElement('input', {
+                  id: 'dsh-recall-cfg-refill',
                   type: 'checkbox',
                   checked: Boolean(draft.refillDraft),
                   disabled: !writable,
@@ -1145,7 +1328,23 @@ window.__ModuleLoader__.load({
               ),
               React.createElement('div', { className: 'dsh-recall-cfg-hint' }, '撤回成功后把被撤回的消息文本回填到输入框，方便修改后重新发送')
             ),
-            React.createElement('div', { className: 'dsh-recall-cfg-row', key: 'baseExcludes' },
+            React.createElement('div', { className: 'dsh-recall-cfg-row', key: 'archiveOriginal' },
+              React.createElement('div', { className: 'dsh-recall-cfg-line' },
+                React.createElement('label', { className: 'dsh-recall-cfg-label', htmlFor: 'dsh-recall-cfg-archive' }, '撤回后归档原会话'),
+                React.createElement('input', {
+                  id: 'dsh-recall-cfg-archive',
+                  type: 'checkbox',
+                  checked: Boolean(draft.archiveOriginal),
+                  disabled: !writable,
+                  onChange: (e) => edit('archiveOriginal', e.target.checked),
+                }),
+                draft.archiveOriginal !== baseline.archiveOriginal ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
+                overridden && overridden.archiveOriginal !== undefined ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已覆盖') : null
+              ),
+              React.createElement('div', { className: 'dsh-recall-cfg-hint' }, '撤回后原会话从列表归档隐藏（可从归档找回）；关闭则保留在列表中，方便对照回退前后的上下文')
+            ),
+            React.createElement(SectionToggle, { title: '高级：基础排除表', open: showAdvanced, onToggle: () => setShowAdvanced((v) => !v) }),
+            showAdvanced ? React.createElement('div', { className: 'dsh-recall-cfg-row', key: 'baseExcludes' },
               React.createElement('div', { className: 'dsh-recall-cfg-line' },
                 React.createElement('label', { className: 'dsh-recall-cfg-label' }, '基础排除表'),
                 draft.baseExcludes !== baseline.baseExcludes ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
@@ -1158,11 +1357,18 @@ window.__ModuleLoader__.load({
                 disabled: !writable,
                 onChange: (e) => edit('baseExcludes', e.target.value),
               }),
-              React.createElement('div', { className: 'dsh-recall-cfg-hint' }, 'gitignore 语法，每行一条；优先级低于 exclude.txt，下一次快照/回退即时生效')
-            ),
+              React.createElement('div', { className: 'dsh-recall-cfg-hint' }, '内置规则，每个工作区共享，建议保持默认；gitignore 语法每行一条，优先级低于「排除配置」里的 exclude.txt（S3-2 折叠）')
+            ) : null,
             React.createElement('div', { className: 'dsh-recall-panel-actions' },
-              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : '') }, state.message) : null,
+              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : ' dsh-recall-ex-status-success') }, state.message) : null,
               React.createElement('button', { type: 'button', className: 'dsh-recall-btn', disabled: state.busy || !writable, onClick: () => setDraft(Object.assign({}, baseline)) }, '放弃修改'),
+              React.createElement('button', {
+                type: 'button',
+                className: 'dsh-recall-btn',
+                disabled: state.busy || !writable,
+                title: '把所有字段恢复到插件出厂默认值',
+                onClick: resetDefaults
+              }, '恢复默认'),
               React.createElement('button', { type: 'button', className: 'dsh-recall-btn', disabled: state.busy || !writable, onClick: save }, '保存'),
               !writable ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '只读设置源') : null
             )
@@ -1229,16 +1435,23 @@ window.__ModuleLoader__.load({
         // 整个插件；lowest renders，负值恰好覆盖默认渲染器实现撤回 UI。
         // priority -1 也可能被别的机器上的插件占用（同样抛冲突），所以
         // 递减重试三次——最坏情况只是撤回按钮不渲染，绝不让插件加载失败。
-        let mounted = false
-        for (let priority = -1; priority >= -3 && !mounted; priority--) {
-          try {
-            slots.inject('conversation.chat.node', () => slots.register(
-              { name: 'conversation.chat.node', key: 'user', priority },
-              UserRecallNode
-            ))
-            mounted = true
-          } catch (error) {
-            if (priority === -3) console.error('[dsh-recall-plugin] slot register failed:', error)
+        // chat.node 的 keyed key 与节点 UI 投影 kind 对齐：'user' 是常规
+        // 用户消息；'steering' 是 agent 运行中插入的转向指令——官方仍按
+        // 用户气泡回显，但 keyed 'user' 不命中，会落到默认渲染、撤回按钮
+        // 缺失（实测存储层 role 一致、仅 UI 投影 kind 不同）。两个 key
+        // 各自独立注册，互不抢占。
+        for (const slotKey of ['user', 'steering']) {
+          let mounted = false
+          for (let priority = -1; priority >= -3 && !mounted; priority--) {
+            try {
+              slots.inject('conversation.chat.node', () => slots.register(
+                { name: 'conversation.chat.node', key: slotKey, priority },
+                UserRecallNode
+              ))
+              mounted = true
+            } catch (error) {
+              if (priority === -3) console.error('[dsh-recall-plugin] slot register failed (' + slotKey + '):', error)
+            }
           }
         }
 

package/lib/config.js

@@ -19,18 +19,36 @@ export const Config = Schema.object({
   gcSnaps: Schema.number().default(50).description('每积累多少条快照触发一次 git gc'),
   gcHours: Schema.number().default(24).description('距上次 gc 超过多少小时触发（与条数先到先触发）'),
   maxFileBytes: Schema.number().default(104857600).description('超过该字节数的文件不进快照、不被回退触碰'),
+  maxSnapshotsPerWorkspace: Schema.number().default(500).description('每个工作区保留的最大快照数，超限删除最旧的'),
   // 排除表必须同时覆盖两种存储目录名：降级存储是项目内 .dsh-recall-snapshots/，
   // 而 home 存储目录名是 dsh-recall-snapshots/（无点）——工作区 root 恰为
   // HOME 时（容器 root=/root 等）它落在工作区内，漏排除会让 git add -A
   // 把影子仓库自己吞进去、快照全部失败（issue #6）
   baseExcludes: Schema.array(Schema.string()).default(['.git', 'node_modules/', '.dsh-recall-snapshots/', 'dsh-recall-snapshots/']).description('基础排除表（gitignore 语法，优先级低于 exclude.txt）'),
   refillDraft: Schema.boolean().default(true).description('撤回后把被撤回的消息文本回填到输入框'),
+  snapshotEnabled: Schema.boolean().default(true).description('启用消息快照（关闭后不再新建，已有快照仍可撤回）'),
+  archiveOriginal: Schema.boolean().default(true).description('撤回后归档原会话（关闭后原会话保留在列表中）'),
+  retentionDays: Schema.number().default(0).description('按天数保留快照，超期自动删除；0 表示不启用'),
 })
 
 // schema 默认值的运行时镜像：settings 服务未组装时 createConfig 直接以
-// 入口 config 解析，这组兜底与 Config 保持一致（改默认值两处同步改）
+// 入口 config 解析，这组兜底与 Config 保持一致（改默认值两处同步改）。
+// DEFAULTS 同时供 config-reset 降级路径（settings.replace 不可用时的兜底，
+// 见 index.js config-reset 端点）——默认值只此一份，避免重置与 schema 漂移。
 const BASE_EXCLUDES = ['.git', 'node_modules/', '.dsh-recall-snapshots/', 'dsh-recall-snapshots/']
 
+export const DEFAULTS = {
+  gcSnaps: 50,
+  gcHours: 24,
+  maxFileBytes: 104857600,
+  maxSnapshotsPerWorkspace: 500,
+  baseExcludes: BASE_EXCLUDES,
+  refillDraft: true,
+  snapshotEnabled: true,
+  archiveOriginal: true,
+  retentionDays: 0,
+}
+
 export function createConfig(raw) {
   const cfg = raw && typeof raw === 'object' ? raw : {}
 
@@ -44,6 +62,13 @@ export function createConfig(raw) {
   const gcSnaps = pickNumber(process.env.DSH_RECALL_GC_SNAPS, pickNumber(cfg.gcSnaps, 50, 1), 1)
   const gcHours = pickNumber(process.env.DSH_RECALL_GC_HOURS, pickNumber(cfg.gcHours, 24, 1), 1)
   const maxFileBytes = pickNumber(cfg.maxFileBytes, 104857600, 1024)
+  // 每工作区快照上限：0 或负值语义 = 不限制（给想全保留的用户出口）；
+  // 非数值回退默认 500。默认 500 ≈ 重度使用一周量级，太小会静默丢历史
+  // 撤回点，太大失去防膨胀意义。
+  const rawMax = typeof cfg.maxSnapshotsPerWorkspace === 'number'
+    ? cfg.maxSnapshotsPerWorkspace
+    : parseInt(String(cfg.maxSnapshotsPerWorkspace == null ? '' : cfg.maxSnapshotsPerWorkspace), 10)
+  const maxSnapshotsPerWorkspace = Number.isFinite(rawMax) ? Math.max(0, rawMax) : 500
 
   const baseExcludes = Array.isArray(cfg.baseExcludes) && cfg.baseExcludes.length
     ? cfg.baseExcludes.filter((p) => typeof p === 'string' && p.trim())
@@ -51,5 +76,21 @@ export function createConfig(raw) {
 
   const refillDraft = typeof cfg.refillDraft === 'boolean' ? cfg.refillDraft : true
 
-  return { gcSnaps, gcHours, maxFileBytes, baseExcludes, refillDraft }
+  // 快照总开关：false 冻结「新建」（session/event 短路，见 index.js），
+  // 已有快照的撤回链路不受影响——关闭只停增量，不销毁存量。
+  const snapshotEnabled = typeof cfg.snapshotEnabled === 'boolean' ? cfg.snapshotEnabled : true
+
+  // 撤回后是否归档原会话：关闭时原会话保留在侧栏（fork 新会话仍打开），
+  // 供用户对照回退前后上下文；默认开（归档只是隐藏、可恢复）。
+  const archiveOriginal = typeof cfg.archiveOriginal === 'boolean' ? cfg.archiveOriginal : true
+
+  // 按时间保留（S2-3）：0 或负值 = 不启用（静默删历史撤回点必须显式
+  // opt-in）；非数值回退 0。与 maxSnapshotsPerWorkspace（条数维度）并存，
+  // 各自独立触发——见 maintenance.enforceRetention。
+  const rawDays = typeof cfg.retentionDays === 'number'
+    ? cfg.retentionDays
+    : parseInt(String(cfg.retentionDays == null ? '' : cfg.retentionDays), 10)
+  const retentionDays = Number.isFinite(rawDays) ? Math.max(0, rawDays) : 0
+
+  return { gcSnaps, gcHours, maxFileBytes, maxSnapshotsPerWorkspace, baseExcludes, refillDraft, snapshotEnabled, archiveOriginal, retentionDays }
 }