dsh-recall-plugin 1.5.0 → 1.6.0

package/lib/client.js

@@ -63,7 +63,6 @@ window.__ModuleLoader__.load({
           '.dsh-recall-toast{position:fixed;top:18px;left:50%;transform:translateX(-50%);z-index:10000;max-width:min(560px,86vw);box-sizing:border-box;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:10px 16px;font-size:13px;line-height:20px;box-shadow:0 8px 28px rgba(0,0,0,.22);display:flex;align-items:baseline;gap:8px;opacity:0;transition:opacity .25s ease;pointer-events:auto}',
           '.dsh-recall-toast.dsh-recall-toast-in{opacity:1}',
           '.dsh-recall-toast-tag{flex:none;font-weight:600;color:var(--dsw-alias-state-error-primary)}',
-          '.dsh-recall-ex-tab{display:flex;flex-direction:column;gap:16px;max-width:720px;padding:4px 0;text-align:left}',
           '.dsh-recall-ex-card{display:flex;flex-direction:column;gap:8px}',
           '.dsh-recall-ex-title{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:600;line-height:22px}',
           '.dsh-recall-ex-note{color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px;word-break:break-word}',
@@ -86,7 +85,22 @@ window.__ModuleLoader__.load({
           '.dsh-recall-tree-title{min-width:0;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
           '.dsh-recall-tree-meta{flex:none;font-size:11px;line-height:18px;color:var(--dsw-alias-label-tertiary);white-space:nowrap}',
           '.dsh-recall-tree-children{display:flex;flex-direction:column;gap:1px;margin-left:16px;border-left:1px solid var(--dsw-alias-border-l1);padding-left:8px}',
-          '.dsh-recall-tree-confirm{display:flex;gap:8px;align-items:center;font-size:12px;line-height:20px;color:var(--dsw-alias-label-secondary)}'
+          '.dsh-recall-tree-confirm{display:flex;gap:8px;align-items:center;font-size:12px;line-height:20px;color:var(--dsw-alias-label-secondary)}',
+          '.dsh-recall-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s;display:flex;flex-direction:column;text-align:left}',
+          '.dsh-recall-card.dsh-recall-card-open{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-label-dimmed)}',
+          '.dsh-recall-card-head{flex-direction:column;flex:1;gap:4px;min-width:0;display:flex}',
+          '.dsh-recall-card-name{color:var(--dsw-alias-label-primary);font-size:15px;font-weight:600;line-height:1.4}',
+          '.dsh-recall-card-desc{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5}',
+          '.dsh-recall-card-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding:12px 0 8px;display:flex;flex-direction:column;gap:12px}',
+          '.dsh-recall-cardbtn{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;align-items:center;gap:12px;padding:14px 16px;display:flex}',
+          '.dsh-recall-cfg-row{display:flex;flex-direction:column;gap:4px}',
+          '.dsh-recall-cfg-line{display:flex;align-items:center;gap:8px}',
+          '.dsh-recall-cfg-label{flex:none;width:130px;color:var(--dsw-alias-label-secondary);font-size:13px;line-height:20px}',
+          '.dsh-recall-cfg-input{flex:1;min-width:0;box-sizing:border-box;font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:4px 8px}',
+          '.dsh-recall-cfg-input:disabled{opacity:.5}',
+          '.dsh-recall-cfg-area{font-family:inherit;font-size:12px;line-height:18px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 8px;min-height:64px}',
+          '.dsh-recall-cfg-hint{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px;padding-left:138px}',
+          '.dsh-recall-cfg-tag{flex:none;font-size:11px;line-height:16px;padding:1px 6px;border-radius:6px;background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary)}'
         ].join('')
         // 静态 bundle 的 ctx 可能不提供 styles 服务，降级为直接注入 <style>
         const stylesSvc = ctx.get('styles')
@@ -140,11 +154,17 @@ window.__ModuleLoader__.load({
         // 返回 init 的 promise：Host 端 init 要跑数条 PowerShell（建仓/loadIndex），
         // snapshot-info 必须等它完成后再查，否则冷启动时索引尚未载入会误判
         // has:false 且不再重试，撤回按钮将永不出现。
+        // init 顺带下发插件行为开关（refillDraft 等），存进 pluginConfig
+        // 供撤回执行链读取——设置页改配置 + 重启后随下一次 init 刷新。
+        const pluginConfig = { refillDraft: true }
         function ensureInit(sessionId) {
           if (!sessionId) return Promise.resolve()
           const cached = initMap.get(sessionId)
           if (cached) return cached
           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
+            }
             const notice = res && res.notice
             if (notice && notice.unsupported) {
               showNotice('unsupported', '撤回插件仅支持 Windows / Linux / macOS，当前平台的快照不可用。')
@@ -352,14 +372,46 @@ window.__ModuleLoader__.load({
 
           React.useEffect(() => {
             let alive = true
-            // 先等 init 预热完成再查快照存在性：避免索引未载入时误判 has:false
+            let timer = null
+            let attempts = 0
+            // 快照捕获（Host 侧脚本）是异步的：消息节点挂载时 snapshot-info
+            // 可能先于捕获完成而返回 has:false。此前只查一次、失败不重试，
+            // 撤回按钮只能靠手动刷新才出现。改为有界轮询：has:true 或达到
+            // 上限即停（覆盖常规快照耗时，又避免无限请求），捕获完成后
+            // 按钮自动出现。
+            // 只对「近 5 分钟内」的消息轮询：快照只在消息发送当下捕获，
+            // 老消息若没有快照就永远不会再有，对它们轮询只会白打请求。
+            const RETRY_WINDOW_MS = 5 * 60 * 1000
+            const MAX_ATTEMPTS = 20
+            const RETRY_MS = 1000
+            const msgTime = data && typeof data.time === 'number' ? data.time : NaN
+            const recent = !isNaN(msgTime) && Date.now() - msgTime <= RETRY_WINDOW_MS
+            function schedule() {
+              if (!alive || !messageId) return
+              attempts++
+              api('snapshot-info', { messageId }).then((res) => {
+                if (!alive) return
+                if (res && res.has) {
+                  setHasSnapshot(true)
+                  return
+                }
+                if (recent && attempts < MAX_ATTEMPTS) timer = setTimeout(schedule, RETRY_MS)
+              }).catch(() => {
+                if (alive && recent && attempts < MAX_ATTEMPTS) timer = setTimeout(schedule, RETRY_MS)
+              })
+            }
+            // 先等 init 预热完成再查快照存在性：避免索引未载入时误判
+            // has:false；init 本身失败也进入轮询（预热可能只是慢，不是坏）。
             ensureInit(sessionId).then(() => {
               if (!messageId || !alive) return
-              return api('snapshot-info', { messageId }).then((res) => {
-                if (alive && res && res.has) setHasSnapshot(true)
-              }).catch(() => {})
+              schedule()
+            }).catch(() => {
+              if (alive && messageId) timer = setTimeout(schedule, RETRY_MS)
             })
-            return () => { alive = false }
+            return () => {
+              alive = false
+              if (timer !== null) clearTimeout(timer)
+            }
           }, [messageId, sessionId])
 
           const onCopy = () => {
@@ -410,6 +462,9 @@ window.__ModuleLoader__.load({
               const cutSeq = typeof res.cutSeq === 'number' ? res.cutSeq : previewCut
               let chatReverted = false
               let chatError = ''
+              // 回填目标会话：对话回退成功 → fork 出的新会话（视图已切过去）；
+              // 失败/无切点 → 当前会话
+              let fillTarget = sessionId
               if (cutSeq !== null && sessionsSvc && typeof sessionsSvc.fork === 'function') {
                 try {
                   // 撤回语义是「回退」而非「复制」：新会话顶替原会话（原会话已
@@ -420,6 +475,7 @@ window.__ModuleLoader__.load({
                   if (childId) {
                     if (typeof sessionsSvc.open === 'function') sessionsSvc.open(childId)
                     chatReverted = true
+                    fillTarget = childId
                     // 回退前的原会话归档：只是从列表隐藏、可恢复，避免侧栏出现两个近似会话
                     if (workspacesSvc && typeof workspacesSvc.archiveSession === 'function') {
                       workspacesSvc.archiveSession(sessionId).catch(() => {})
@@ -431,6 +487,10 @@ window.__ModuleLoader__.load({
                   chatError = String(error)
                 }
               }
+              // 把被撤回的消息文本回填到输入框（可在设置页关闭）：方便用户
+              // 修改后重新发送。拿不到官方 conversation 服务时静默跳过，
+              // 绝不阻塞撤回主流程。
+              if (pluginConfig.refillDraft) fillDraft(fillTarget, text)
               setHasSnapshot(false)
               // 注：快照 tag 在 Host 侧有意保留（幂等回退），刷新页面后
               // 该消息的撤回按钮会重新出现——这是「可再次回退到同一点」
@@ -444,6 +504,37 @@ window.__ModuleLoader__.load({
 
           const closePanel = () => setRecall({ stage: 'idle' })
 
+          // 撤回后把被撤回消息的文本回填到输入框，方便用户修改后重新发送。
+          // 官方 conversation 服务提供 input（InputHub）→ per-session shell
+          // → actions.setDraft，走与输入框自身同一条官方写入通道（draft
+          // 镜像同步，输入框即时刷新）。fork + open 之后 shell 可能需要
+          // 一个 tick 才就绪（binding 异步解析），做有界重试：最多 8 次、
+          // 间隔 150ms，覆盖常规竞态又不无限空转；拿不到服务时静默跳过。
+          function fillDraft(targetSessionId, draftText) {
+            if (!draftText || !targetSessionId) return
+            let attempts = 0
+            const attempt = () => {
+              try {
+                const conversation = ctx.get('conversation')
+                if (conversation && conversation.input && typeof conversation.input.shell === 'function') {
+                  const shell = conversation.input.shell(targetSessionId)
+                  if (shell) {
+                    if (shell.actions && typeof shell.actions.setDraft === 'function') {
+                      shell.actions.setDraft(draftText)
+                      return
+                    }
+                    if (typeof shell.setDraft === 'function') {
+                      shell.setDraft(draftText)
+                      return
+                    }
+                  }
+                }
+              } catch (e) { /* fall through to retry */ }
+              if (attempts++ < 8) setTimeout(attempt, 150)
+            }
+            attempt()
+          }
+
           const bubbleChildren = []
           if (text !== '') bubbleChildren.push(React.createElement('div', { className: 'dsh-recall-bubble', key: 'text' }, text))
           for (let i = 0; i < images.length; i++) {
@@ -579,7 +670,6 @@ window.__ModuleLoader__.load({
         // 清理与排障入口；全部操作走 Host 的 manage/status 端点（串行队列
         // 在 Host 侧保证，卡片只管发请求）。
         function ManageCard(props) {
-          const sessionId = props.sessionId
           const [items, setItems] = React.useState(null)
           const [usage, setUsage] = React.useState(null)
           const [errors, setErrors] = React.useState(null)
@@ -639,23 +729,33 @@ window.__ModuleLoader__.load({
                 fetchTitles(res.items || [])
                 fetchMessages(res.items || [])
               }
-            }).catch(() => {})
-            if (sessionId) {
-              api('manage', { op: 'usage', sessionId }).then((res) => {
+              // 列表返回后再补 usage/status：首次冷启动时磁盘占用和错误日志
+              // 都各要一条 shell，和 list 并发会抢资源拖慢首屏；延后到列表
+              // 渲染后，用户先看到树形内容，占用再异步补上（usage 不带
+              // sessionId，Host 汇总全部工作区）。
+              api('manage', { op: 'usage' }).then((res) => {
                 if (res && res.ok) setUsage(res.bytes || 0)
               }).catch(() => {})
-            }
-            api('status', {}).then((res) => {
-              if (res && res.ok) setErrors(res.errors || [])
-            }).catch(() => {})
+              api('status', {}).then((res) => {
+                if (res && res.ok) setErrors(res.errors || [])
+              }).catch(() => {})
+            }).catch(() => {
+              // list 失败时仍尝试补 usage/status，避免整卡全空
+              api('manage', { op: 'usage' }).then((res) => {
+                if (res && res.ok) setUsage(res.bytes || 0)
+              }).catch(() => {})
+              api('status', {}).then((res) => {
+                if (res && res.ok) setErrors(res.errors || [])
+              }).catch(() => {})
+            })
           }
 
-          React.useEffect(() => { refresh() }, [sessionId])
+          React.useEffect(() => { refresh() }, [])
 
           function run(op, extra, doneText) {
             if (state.busy) return
             setState({ busy: true, message: '执行中…', error: false })
-            api('manage', Object.assign({ op, sessionId }, extra || {})).then((res) => {
+            api('manage', Object.assign({ op }, extra || {})).then((res) => {
               if (res && res.ok) {
                 setState({ busy: false, message: typeof res.deleted === 'number' ? '已删除 ' + res.deleted + ' 条快照' : doneText, error: false })
                 refresh()
@@ -810,7 +910,7 @@ window.__ModuleLoader__.load({
             React.createElement('div', { className: 'dsh-recall-ex-note' },
               usage === null
                 ? '共 ' + (items ? items.length : '…') + ' 条快照。'
-                : '共 ' + (items ? items.length : '…') + ' 条快照，当前工作区快照存储占用 ' + sizeText(usage) + '。'
+                : '共 ' + (items ? items.length : '…') + ' 条快照，全部工作区快照存储占用 ' + sizeText(usage) + '。'
             ),
             treeNodes.length > 0 ? React.createElement('div', { className: 'dsh-recall-tree' }, ...treeNodes) : null,
             React.createElement('div', { className: 'dsh-recall-panel-actions' },
@@ -819,8 +919,8 @@ window.__ModuleLoader__.load({
               React.createElement('button', {
                 type: 'button',
                 className: 'dsh-recall-btn',
-                disabled: state.busy || !sessionId,
-                title: '立即执行一次 git gc（压缩对象库释放空间）',
+                disabled: state.busy,
+                title: '立即对全部工作区执行一次 git gc（压缩对象库释放空间）',
                 onClick: () => run('gc', {}, 'gc 完成')
               }, '立即 gc')
             ),
@@ -833,10 +933,10 @@ window.__ModuleLoader__.load({
           )
         }
 
-        // 「插件」设置分区的标签页主体：拉取 Host 枚举的 exclude 文件列表
-        // （home 存储通常合并为一条，降级工作区各一条）。标签页被选中后
-        // 由设置外壳保持挂载，本地草稿在标签间切换时不丢失。
-        function RecallSettingsTab(props) {
+        // 排除配置分区：拉取 Host 枚举的 exclude 文件列表（home 存储通常
+        // 合并为一条，降级工作区各一条）。折叠展开时由设置外壳保持挂载，
+        // 本地草稿在折叠期间不丢失。
+        function ExcludeFilesSection() {
           const [files, setFiles] = React.useState(null)
           const [error, setError] = React.useState('')
 
@@ -850,29 +950,226 @@ window.__ModuleLoader__.load({
 
           React.useEffect(() => { load() }, [])
 
-          let body = null
           if (error) {
-            body = React.createElement('div', { className: 'dsh-recall-ex-card' },
+            return React.createElement('div', { className: 'dsh-recall-ex-card' },
               React.createElement('div', { className: 'dsh-recall-ex-note' }, error),
               React.createElement('div', { className: 'dsh-recall-panel-actions' },
                 React.createElement('button', { type: 'button', className: 'dsh-recall-btn', onClick: load }, '重试')
               )
             )
-          } else if (files === null) {
-            body = React.createElement('div', { className: 'dsh-recall-ex-note' }, '正在加载排除配置…')
-          } else if (!files.length) {
+          }
+          if (files === null) {
+            return React.createElement('div', { className: 'dsh-recall-ex-note' }, '正在加载排除配置…')
+          }
+          if (!files.length) {
             // 全新安装且从未发过消息：store 还没建，先告诉用户怎么触发
-            body = React.createElement('div', { className: 'dsh-recall-ex-note' }, '尚未创建任何快照存储：在任意工作区发送一条消息后，这里会出现可编辑的排除配置。')
-          } else {
-            body = React.createElement('div', { className: 'dsh-recall-ex-card' },
-              ...files.map((f) => React.createElement(ExcludeCard, { key: f.path, file: f }))
+            return React.createElement('div', { className: 'dsh-recall-ex-note' }, '尚未创建任何快照存储：在任意工作区发送一条消息后，这里会出现可编辑的排除配置。')
+          }
+          return React.createElement('div', { className: 'dsh-recall-ex-card' },
+            ...files.map((f) => React.createElement(ExcludeCard, { key: f.path, file: f }))
+          )
+        }
+
+        // 插件配置表单：值经 Host 的 settings namespace「dsh-recall」读写
+        // （config-get / config-set 端点），保存即持久化进用户 settings 文档
+        // 并热生效（Host watch 链路原地更新 cfg），无需重启。只提交相对
+        // 基线修改过的字段，避免一次保存把全部字段标成「用户覆盖」。
+        function ConfigForm() {
+          const [baseline, setBaseline] = React.useState(null)
+          const [draft, setDraft] = React.useState(null)
+          const [envLocks, setEnvLocks] = React.useState({})
+          const [overridden, setOverridden] = React.useState({})
+          const [writable, setWritable] = React.useState(true)
+          const [state, setState] = React.useState({ busy: false, message: '', error: false })
+
+          function load() {
+            api('config-get', {}).then((res) => {
+              if (res && res.ok) {
+                const v = res.values || {}
+                const next = {
+                  gcSnaps: String(v.gcSnaps == null ? '' : v.gcSnaps),
+                  gcHours: String(v.gcHours == null ? '' : v.gcHours),
+                  maxFileBytes: String(v.maxFileBytes == null ? '' : v.maxFileBytes),
+                  baseExcludes: Array.isArray(v.baseExcludes) ? v.baseExcludes.join('\n') : '',
+                  refillDraft: v.refillDraft !== false,
+                }
+                setDraft(next)
+                setBaseline(next)
+                setEnvLocks(res.envLocks || {})
+                setOverridden(res.overridden || {})
+                setWritable(res.writable !== false)
+              } else {
+                setState({ busy: false, message: (res && (res.message || res.error)) || '无法读取配置', error: true })
+              }
+            }).catch((e) => setState({ busy: false, message: String(e), error: true }))
+          }
+
+          React.useEffect(() => { load() }, [])
+
+          function edit(key, value) {
+            setDraft((d) => Object.assign({}, d, { [key]: value }))
+          }
+
+          function save() {
+            if (state.busy || !draft || !baseline) return
+            const patch = {}
+            for (const key of ['gcSnaps', 'gcHours', 'maxFileBytes', 'baseExcludes', 'refillDraft']) {
+              if (draft[key] !== baseline[key]) patch[key] = draft[key]
+            }
+            if (!Object.keys(patch).length) {
+              setState({ busy: false, message: '没有修改', error: false })
+              return
+            }
+            const clean = {}
+            if (patch.gcSnaps !== undefined) {
+              const n = parseInt(patch.gcSnaps, 10)
+              if (!Number.isFinite(n) || n < 1) { setState({ busy: false, message: '快照条数阈值必须是 >= 1 的整数', error: true }); return }
+              clean.gcSnaps = n
+            }
+            if (patch.gcHours !== undefined) {
+              const n = parseInt(patch.gcHours, 10)
+              if (!Number.isFinite(n) || n < 1) { setState({ busy: false, message: 'gc 小时阈值必须是 >= 1 的整数', error: true }); return }
+              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
+            }
+            if (patch.refillDraft !== undefined) clean.refillDraft = Boolean(patch.refillDraft)
+            if (patch.baseExcludes !== undefined) {
+              clean.baseExcludes = String(patch.baseExcludes).split('\n').map((l) => l.trim()).filter(Boolean)
+            }
+            setState({ busy: true, message: '保存中…', error: false })
+            api('config-set', { patch: clean }).then((res) => {
+              if (res && res.ok) {
+                setState({ busy: false, message: '已保存并即时生效', error: false })
+                load()
+              } else {
+                setState({ busy: false, message: (res && (res.message || res.error)) || '保存失败', error: true })
+              }
+            }).catch((e) => setState({ busy: false, message: String(e), error: true }))
+          }
+
+          function numRow(key, label, hint) {
+            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 },
+              React.createElement('div', { className: 'dsh-recall-cfg-line' },
+                React.createElement('label', { className: 'dsh-recall-cfg-label' }, label),
+                React.createElement('input', {
+                  className: 'dsh-recall-cfg-input',
+                  type: 'number',
+                  value: draft ? draft[key] : '',
+                  disabled: locked || !writable,
+                  onChange: (e) => edit(key, e.target.value),
+                }),
+                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
+              ),
+              React.createElement('div', { className: 'dsh-recall-cfg-hint' }, hint)
+            )
+          }
+
+          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: 'refillDraft' },
+              React.createElement('div', { className: 'dsh-recall-cfg-line' },
+                React.createElement('label', { className: 'dsh-recall-cfg-label' }, '撤回后回填输入框'),
+                React.createElement('input', {
+                  type: 'checkbox',
+                  checked: Boolean(draft.refillDraft),
+                  disabled: !writable,
+                  onChange: (e) => edit('refillDraft', e.target.checked),
+                }),
+                draft.refillDraft !== baseline.refillDraft ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
+                overridden && overridden.refillDraft !== undefined ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已覆盖') : null
+              ),
+              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-line' },
+                React.createElement('label', { className: 'dsh-recall-cfg-label' }, '基础排除表'),
+                draft.baseExcludes !== baseline.baseExcludes ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已修改') : null,
+                overridden && overridden.baseExcludes !== undefined ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '已覆盖') : null
+              ),
+              React.createElement('textarea', {
+                className: 'dsh-recall-cfg-area',
+                rows: 4,
+                value: draft.baseExcludes,
+                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-panel-actions' },
+              state.message ? React.createElement('span', { className: 'dsh-recall-ex-status' + (state.error ? ' dsh-recall-ex-status-error' : '') }, 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, onClick: save }, '保存'),
+              !writable ? React.createElement('span', { className: 'dsh-recall-cfg-tag' }, '只读设置源') : null
             )
+          )
+        }
+
+        // 分区折叠头：官方卡片列表纵向排布，排除配置/快照管理是重内容，
+        // 默认折叠、按需展开（展开后由设置外壳保持挂载，草稿不丢）。
+        function SectionToggle(props) {
+          return React.createElement('button', {
+            type: 'button',
+            className: 'dsh-recall-cardbtn',
+            'aria-expanded': props.open,
+            onClick: props.onToggle,
+          },
+            React.createElement('span', { className: 'dsh-recall-tree-toggle' }, props.open ? '▾' : '▸'),
+            React.createElement('span', { style: { fontWeight: 600, fontSize: '14px', lineHeight: '22px' } }, props.title),
+            props.meta ? React.createElement('span', { className: 'dsh-recall-tree-meta' }, props.meta) : null
+          )
+        }
+
+        // 「插件配置」分区里的撤回卡片（settings.plugin.item keyed slot，
+        // key = Host 端注册的 settings namespace 'dsh-recall'）。整卡默认
+        // 收起、点卡片头展开，视觉规格对齐官方 PluginCard（ui-settings-
+        // plugins 的同名 CSS：bg-layer-3 底、展开变 bg-layer-2 + 边框
+        // label-dimmed、header 14px 16px、标题 15px/600、描述 13px、
+        // 内容区上边框 + margin 0 16px 分隔）。展开后内含三段：插件配置
+        // 表单 + 排除配置（折叠）+ 快照管理（折叠）。
+        function RecallSettingsCard() {
+          const [open, setOpen] = React.useState(false)
+          const [sections, setSections] = React.useState({ exclude: false, manage: false })
+          function toggle(key) {
+            setSections((prev) => Object.assign({}, prev, { [key]: !prev[key] }))
           }
-          // 快照管理卡片挂标签页底部：与排除配置同属撤回治理面，
-          // sessionId 从设置外壳 props 透传（usage/gc 按工作区定位 store）
-          return React.createElement('div', { className: 'dsh-recall-ex-tab' },
-            body,
-            React.createElement(ManageCard, { sessionId: props && props.sessionId })
+          return React.createElement('li', { className: 'dsh-recall-card' + (open ? ' dsh-recall-card-open' : '') },
+            React.createElement('button', {
+              type: 'button',
+              className: 'dsh-recall-cardbtn',
+              'aria-expanded': open,
+              'aria-label': (open ? '收起' : '展开') + ': 撤回插件',
+              onClick: () => setOpen((v) => !v),
+            },
+              React.createElement('span', { className: 'dsh-recall-card-head' },
+                React.createElement('span', { className: 'dsh-recall-card-name' }, '撤回插件'),
+                React.createElement('span', { className: 'dsh-recall-card-desc' }, '消息撤回（文件快照 + 对话回退）的阈值与治理')
+              ),
+              React.createElement('svg', {
+                width: 14, height: 14, viewBox: '0 0 16 16',
+                style: { color: 'var(--dsw-alias-label-tertiary)', flex: 'none', transition: 'transform .16s', transform: open ? 'rotate(180deg)' : 'none' }
+              }, React.createElement('path', { d: 'M4 6l4 4 4-4', fill: 'none', stroke: 'currentColor', strokeWidth: 1.5, strokeLinecap: 'round', strokeLinejoin: 'round' }))
+            ),
+            open ? React.createElement('div', { className: 'dsh-recall-card-body' },
+              React.createElement(ConfigForm),
+              React.createElement(SectionToggle, { title: '排除配置（exclude.txt）', open: sections.exclude, onToggle: () => toggle('exclude') }),
+              sections.exclude ? React.createElement(ExcludeFilesSection) : null,
+              React.createElement(SectionToggle, { title: '快照管理', open: sections.manage, onToggle: () => toggle('manage') }),
+              sections.manage ? React.createElement(ManageCard) : null
+            ) : null
           )
         }
 
@@ -894,19 +1191,23 @@ window.__ModuleLoader__.load({
           }
         }
 
-        // 「插件」设置分区挂自己的标签页：settings.plugins.tab 是 root 级
-        // list slot，id 唯一即无冲突（与 keyed slot 的 priority 冲突是两套
-        // 语义），order 20 排在官方「插件配置」(0) 与「插件清单」(10) 之后。
-        // 该 slot 由 ui-settings-plugins 声明；未组装设置页的部署里 inject
-        // 只是永不匹配的待定注册，天然无害。try/catch 是防御性兜底——注册
-        // 失败绝不该拖垮撤回按钮的主功能。
+        // 「插件配置」分区挂撤回卡片：settings.plugin.item 是 root 级
+        // keyed slot（官方 ui-settings-plugins 的 configurable 标签页声明，
+        // 按 settings namespace 作为 entryKey 分发）。key 必须与 Host 端
+        // 注册的 namespace 'dsh-recall' 一致——卡片只渲染「Host 服务的
+        // namespace」与「slot 注册的卡片」的交集，Host 端
+        // installSettingsSection 完成注册后 describe 命中、卡片即出现。
+        // 各 namespace 独占自己的 key，无同 key 抢占，不需要 priority
+        // （与 conversation.chat.node 覆盖默认渲染器是两套语义）。该 slot
+        // 未组装的部署里 inject 只是永不匹配的待定注册，天然无害；
+        // try/catch 是防御性兜底——注册失败绝不该拖垮撤回按钮的主功能。
         try {
-          slots.inject('settings.plugins.tab', () => slots.register(
-            { name: 'settings.plugins.tab', id: 'dsh-recall', order: 20, label: '撤回设置' },
-            RecallSettingsTab
+          slots.inject('settings.plugin.item', () => slots.register(
+            { name: 'settings.plugin.item', key: 'dsh-recall' },
+            RecallSettingsCard
           ))
         } catch (error) {
-          console.error('[dsh-recall-plugin] settings tab register failed:', error)
+          console.error('[dsh-recall-plugin] settings card register failed:', error)
         }
       }
     }

package/lib/config.js

@@ -1,17 +1,30 @@
 /**
  * dsh-recall-plugin — 配置域（ctx 绑定的工厂，无模块级副作用）
  *
- * 职责：把「用户大概率不改的默认值」从硬编码/环境变量迁移到 DSH 官方
- * 插件配置机制——cordis.patch.yml 的 insert 行声明 config 默认值，用户在
- * 自己 profile 的 cordis.patch.yml 里按 id 重述该行即可覆盖（层叠规则见
- * 《DSH 插件开发规范》第五节），无需设环境变量、无需改包。
- *
+ * 三层配置解析（官方 settings 模型，见 dsh-settings README）：
+ *   schema 默认值（Config）→ 组合 base（cordis.patch.yml insert 行 config
+ *   键）→ 用户文档（设置页「插件配置」卡片写入，dsh-settings 持久化）。
  * 环境变量 DSH_RECALL_GC_SNAPS / DSH_RECALL_GC_HOURS 保留为最高优先级
- * 覆盖：已用它们调档的用户（含冒烟测试脚本）升级后行为不漂移。
+ * 覆盖：已用它们调档的用户（含冒烟测试脚本）升级后行为不漂移；设了 env
+ * 的字段在设置卡片里锁定不可编辑。
+ *
+ * Config 同时承担两个角色：cordis 入口配置校验（index.js re-export 给
+ * 加载器，非法配置在插件加载时响亮失败）与 settings namespace
+ * 「dsh-recall」的注册 schema（installSettingsSection，见 index.js）。
  */
 
-// 平台分叉的默认值：Windows 用 \\ 拼基础排除表，POSIX 用 /——但排除表是
-// gitignore 语法（内部一律正斜杠），与平台无关，只有「是否含该项」的差异
+import Schema from '@deepseek-ai/schemastery'
+
+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('超过该字节数的文件不进快照、不被回退触碰'),
+  baseExcludes: Schema.array(Schema.string()).default(['.git', 'node_modules/', '.dsh-recall-snapshots/']).description('基础排除表（gitignore 语法，优先级低于 exclude.txt）'),
+  refillDraft: Schema.boolean().default(true).description('撤回后把被撤回的消息文本回填到输入框'),
+})
+
+// schema 默认值的运行时镜像：settings 服务未组装时 createConfig 直接以
+// 入口 config 解析，这组兜底与 Config 保持一致（改默认值两处同步改）
 const BASE_EXCLUDES = ['.git', 'node_modules/', '.dsh-recall-snapshots/']
 
 export function createConfig(raw) {
@@ -32,5 +45,7 @@ export function createConfig(raw) {
     ? cfg.baseExcludes.filter((p) => typeof p === 'string' && p.trim())
     : BASE_EXCLUDES
 
-  return { gcSnaps, gcHours, maxFileBytes, baseExcludes }
+  const refillDraft = typeof cfg.refillDraft === 'boolean' ? cfg.refillDraft : true
+
+  return { gcSnaps, gcHours, maxFileBytes, baseExcludes, refillDraft }
 }