dsh-recall-plugin 1.7.0 → 2.0.0

package/lib/client.js

@@ -2,13 +2,14 @@
  * dsh-recall-plugin — Client 半（持久插件形态，浏览器 bundle）
  *
  * 职责：注册 conversation.chat.node 的 user 渲染器，重绘用户消息气泡
- * （文本/图片/JSON 块），在复制按钮旁加「撤回」按钮；二次确认面板展示
+ * （文本/图片/JSON 块；图片经官方 props.renderMessageImages 管线渲染，
+ * 见 UserRecallNode 内注释），在复制按钮旁加「撤回」按钮；二次确认面板展示
  * 文件变更清单，确认后经 /api/recall/* 调用 Host 回退文件，并用官方
  * sessions.fork 把对话一并回退（新会话打开、原会话归档）。
  *
  * 这是 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",
@@ -38,9 +39,6 @@ window.__ModuleLoader__.load({
           '.dsh-recall-row{flex-direction:column;align-items:flex-end;gap:6px;display:flex}',
           '.dsh-recall-stack{flex-direction:column;align-items:flex-end;gap:8px;min-width:0;max-width:min(525px,82%);display:flex}',
           '.dsh-recall-bubble{background:var(--dsw-specific-bubble);max-width:100%;color:var(--dsw-alias-label-primary);border-radius:22px;padding:10px 16px;font-size:16px;line-height:24px;white-space:pre-wrap;word-break:break-word}',
-          '.dsh-recall-img{max-width:100%;max-height:320px;border-radius:12px;object-fit:contain}',
-          '.dsh-recall-img-failed{border:1px dashed var(--dsw-alias-border-l2);border-radius:12px;padding:8px 14px;font-size:13px;line-height:20px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0}',
-          '.dsh-recall-img-failed:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}',
           '.dsh-recall-json{margin:0;max-width:100%;font-size:12px;line-height:18px;color:var(--dsw-alias-label-tertiary);white-space:pre-wrap;word-break:break-word;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:8px 10px;background:var(--dsw-alias-markdown-code-block)}',
           '.dsh-recall-actions{align-items:center;gap:10px;height:28px;display:flex}',
           '.dsh-recall-time{color:var(--dsw-alias-label-tertiary);white-space:nowrap;padding-right:12px;font-size:14px;line-height:24px}',
@@ -75,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}',
@@ -177,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)
@@ -185,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) {
@@ -268,52 +268,6 @@ window.__ModuleLoader__.load({
           )
         }
 
-        // 图片加载失败的暂态判定（issue #8）：会话回放时最早的图片消息先于
-        // 会话 binding 就绪渲染，loadImage 以 unknown session 拒绝——这类
-        // 失败靠短退避自动重试即可自愈；此前 `.catch(() => {})` 把失败静默
-        // 吞掉且 src 恒为 null，图片永久空白且刷新无法恢复。自动重试耗尽
-        // 后置 failed，由 ImageBox 提供「点击重试」（对齐官方 MessageImage
-        // 的失败态语义），attempt 仅被手动重试递增以复用整条加载链。
-        const IMAGE_RETRY_DELAYS = [400, 1500, 4000]
-
-        function useImageSrc(attachment, loadImage) {
-          const [src, setSrc] = React.useState(null)
-          const [failed, setFailed] = React.useState(false)
-          const [attempt, setAttempt] = React.useState(0)
-          React.useEffect(() => {
-            let alive = true
-            let timer = null
-            if (!attachment || typeof loadImage !== 'function') return undefined
-            // 复位旧状态：attachment 变化或手动重试时清掉上一轮的 src/failed，
-            // 避免加载期间短暂显示上一张图或残留的失败态
-            setSrc(null)
-            setFailed(false)
-            const tryLoad = (retried) => {
-              Promise.resolve(loadImage(attachment)).then((url) => {
-                if (!alive) return
-                if (url) setSrc(String(url))
-                else if (retried < IMAGE_RETRY_DELAYS.length) timer = setTimeout(() => tryLoad(retried + 1), IMAGE_RETRY_DELAYS[retried])
-                else setFailed(true)
-              }).catch(() => {
-                if (!alive) return
-                if (retried < IMAGE_RETRY_DELAYS.length) timer = setTimeout(() => tryLoad(retried + 1), IMAGE_RETRY_DELAYS[retried])
-                else setFailed(true)
-              })
-            }
-            tryLoad(0)
-            return () => { alive = false; if (timer) clearTimeout(timer) }
-          }, [attachment, loadImage, attempt])
-          return { src, failed, retry: () => setAttempt(attempt + 1) }
-        }
-
-        function ImageBox(props) {
-          const { src, failed, retry } = useImageSrc(props.attachment, props.loadImage)
-          if (src) return React.createElement('img', { className: 'dsh-recall-img', src, alt: '' })
-          // 加载中保持原零占位语义（不撑气泡）；只在确定失败后渲染可重试入口
-          if (failed) return React.createElement('button', { type: 'button', className: 'dsh-recall-img-failed', onClick: retry }, '图片加载失败，点击重试')
-          return null
-        }
-
         // kind 语义单表承载（文案/徽章类名/汇总顺序）：新增 kind 时只改
         // 这一处，避免出现「映射表改了、CSS 类名忘了」的半改状态
         const KIND_INFO = {
@@ -404,14 +358,21 @@ window.__ModuleLoader__.load({
 
         function UserRecallNode(props) {
           const node = props && props.node
-          const loadImage = props && props.loadImage
+          // 图片渲染入口：官方 ChatNodeSeat 传给本 slot 的 props 契约只有
+          // renderMessageImages（内部经 conversation.message.images slot 渲染
+          // 官方 MessageImages，自带鉴权、缓存、失败重试与灯箱预览）。
+          // 契约里从不存在 loadImage（issue #9）：v1.6/v1.7 读该不存在的
+          // 字段导致自研加载链从未执行、用户消息图片永久无声空白。
+          const renderMessageImages = props && props.renderMessageImages
           const sessionId = props && props.sessionId
           const data = node && node.data ? node.data : {}
           // node.id 是会话事件匹配时写入的真实消息 ID；node.key 是位置键（如 13:input），不能用于快照查询
           const messageId = node ? String(node.id || node.key || '') : ''
           const blocks = Array.isArray(data.content) ? data.content : []
           const text = blocks.filter((b) => b && b.type === 'text' && typeof b.text === 'string').map((b) => b.text).join('')
-          const images = blocks.filter((b) => b && b.type === 'image' && b.attachment).map((b) => b.attachment)
+          // 官方契约：images 传 image 块数组（{attachment}），官方内部取
+          // image.attachment.attachmentId —— 不是裸 attachment 对象
+          const imageBlocks = blocks.filter((b) => b && b.type === 'image' && b.attachment).map((b) => ({ attachment: b.attachment }))
           const rest = blocks.filter((b) => !b || !(b.type === 'text' && typeof b.text === 'string') && !(b.type === 'image' && b.attachment))
 
           const [copied, setCopied] = React.useState(false)
@@ -513,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
               }
@@ -537,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 {
@@ -597,10 +587,14 @@ window.__ModuleLoader__.load({
           }
 
           const bubbleChildren = []
-          if (text !== '') bubbleChildren.push(React.createElement('div', { className: 'dsh-recall-bubble', key: 'text' }, text))
-          for (let i = 0; i < images.length; i++) {
-            bubbleChildren.push(React.createElement(ImageBox, { key: 'img-' + i, attachment: images[i], loadImage }))
+          // 图片在上、气泡在下：布局顺序对齐官方 UserStyleBubble（历史会话
+          // 里用户消息的观感与官方一致）。Fragment 包一层仅为挂 key。
+          if (imageBlocks.length && typeof renderMessageImages === 'function') {
+            bubbleChildren.push(React.createElement(React.Fragment, { key: 'images' },
+              renderMessageImages({ images: imageBlocks, align: 'end' })
+            ))
           }
+          if (text !== '') bubbleChildren.push(React.createElement('div', { className: 'dsh-recall-bubble', key: 'text' }, text))
           for (let i = 0; i < rest.length; i++) {
             bubbleChildren.push(React.createElement('pre', { className: 'dsh-recall-json', key: 'rest-' + i }, JSON.stringify(rest[i], null, 2)))
           }
@@ -719,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 }, '保存')
             )
@@ -735,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)
@@ -783,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 || [])
               }
@@ -795,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 || [])
@@ -803,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 || [])
@@ -813,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 })
@@ -832,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> 记录，
@@ -880,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) {
@@ -985,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' })
@@ -1013,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
           )
@@ -1058,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），无需重启。只提交相对
@@ -1069,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) => {
@@ -1077,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)
@@ -1101,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) {
@@ -1120,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)
             }
@@ -1139,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 },
@@ -1150,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
@@ -1160,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,
@@ -1182,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,
@@ -1195,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
             )
@@ -1266,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)
+            }
           }
         }