dsh-subagent-profile 0.5.0 → 0.5.1

package/lib/client.js

@@ -23,6 +23,7 @@
 
 const CSS = [
   '.sap-section{width:100%;color:var(--dsw-alias-label-primary);flex-direction:column;gap:12px;display:flex}',
+  '.sap-zoneStack{flex-direction:column;gap:12px;display:flex}',
   '.sap-statusBar{position:sticky;top:0;z-index:1;background:transparent;border:0;border-bottom:1px solid var(--dsw-alias-border-l2);flex-wrap:wrap;gap:4px 14px;padding:4px 0 8px;display:flex;font-size:12px;line-height:18px}',
   '.sap-statusDim{color:var(--dsw-alias-label-tertiary)}',
   '.sap-rowHighlight{border-color:var(--dsw-alias-brand-primary);background:var(--dsw-alias-interactive-bg-hover)}',
@@ -164,6 +165,8 @@ const CSS = [
   '.sap-candidateSettingsCustom .sap-input{max-width:120px}',
   '.sap-candidateSettingsActions{align-items:center;gap:10px;display:flex}',
   '.sap-desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;line-height:18px}',
+  '.sap-descMinor{color:var(--dsw-alias-label-tertiary);margin:0;font-size:11px;line-height:16px}',
+  '.sap-maintenanceSwitchDesc{flex-direction:column;gap:2px;display:flex}',
   '.sap-warn{color:var(--dsw-alias-state-warn-label);margin:0;font-size:12px;line-height:18px}',
   '.sap-versionWarn{background:var(--dsw-alias-state-warn-tertiary);border:1px solid var(--dsw-alias-state-warn-tertiary);color:var(--dsw-alias-state-warn-label);border-radius:8px;flex-direction:column;gap:4px;padding:10px 12px;font-size:12px;line-height:18px;margin:0;display:flex}',
   '.sap-chips{flex-wrap:wrap;gap:6px;display:flex}',
@@ -305,6 +308,7 @@ const CSS = [
   '.sap-ledgerRowHead:hover{background:var(--dsw-alias-interactive-bg-hover)}',
   '.sap-ledgerTime{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px;font-family:monospace;flex:none}',
   '.sap-ledgerMeta{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;min-width:0;word-break:break-word}',
+  '.sap-ledgerImageText{color:var(--dsw-alias-label-tertiary);max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:none}',
   '.sap-ledgerToggle{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px;transition:transform .12s;margin-left:auto;flex:none;display:inline-flex}',
   '.sap-ledgerRowOpen .sap-ledgerToggle{transform:rotate(90deg)}',
   '.sap-ledgerExpand{flex-direction:column;gap:10px;border-top:1px solid var(--dsw-alias-border-l2);padding:10px 14px 12px;display:flex}',
@@ -438,7 +442,7 @@ const ZH = {
   // 提醒系统
   reminderCenterTitle: '提醒中心',
   reminderCenterDesc: '需要你关注的事件汇总，所有动作均有审计记录；处理过的条目折叠保存',
-  reminderEmpty: '暂无提醒（治理事件会在这里留痕）',
+  reminderEmpty: '暂无提醒（历史操作与事件会在这里留痕）',
   reminderAck: '标记已读',
   reminderAdopt: '采纳',
   reminderIgnore: '忽略',
@@ -457,6 +461,27 @@ const ZH = {
   reminderNoteLabel: '说明',
   reminderNoSettlement: '未结算',
   reminderNoExcerpt: '（未记录）',
+  reminderArchivedEmpty: '暂无已归档条目（数据维护区执行归档后在此分页查看）',
+  reminderArchivedMore: '加载更早',
+  // 数据维护（设置页 → 方案管理尾部）
+  maintenanceCardTitle: '数据维护',
+  maintenanceCardDesc: '候选、快照、提醒与统计数据的清理入口；每次清理都会留下记录',
+  snapshotSwitchDesc: '派发时在本机自动保存完整配置（含自定义人格），供「保存为方案」与对比使用。\n数据仅存您本机（~/.dsh/subagent-evolution/snapshots/），插件更新不影响，可随时清理。\n关闭开关即停止新快照（已存保留）。',
+  snapshotCount: '已存快照：{n} / {cap} 条',
+  snapshotCapHint: '快照已达护栏上限，停止新快照（可清理后继续）',
+  snapshotNone: '暂无快照（开启开关后每次派发保存一条）',
+  snapshotView: '查看',
+  snapshotViewClose: '收起',
+  snapshotMeta: '快照 {id} · 于 {ts}',
+  snapshotPersonaFold: '人格（{n} 字符，点击展开）',
+  snapshotEmptyConfig: '（无配置字段）',
+  cleanCandidates: '清理候选/建议',
+  cleanSnapshots: '清理快照',
+  cleanReminders: '归档已处理提醒',
+  cleanStats: '重置统计',
+  maintenanceConfirm: '确认要执行「{zone}」吗？清理操作会留下记录。',
+  maintenanceDone: '已执行 {zone}：{count} 条',
+  maintenanceCleanErr: '清理失败：',
   toolRunning: '运行中',
   tierZh: { cheap: '省 token（cheap）', balanced: '均衡（balanced）', premium: '高成本（premium）' },
   stopReasonZh: { completed: '完成', 'max-tokens': '超出预算', aborted: '已中止', refusal: '已拒绝', error: '出错' },
@@ -719,7 +744,7 @@ const ZH = {
   auditCardTitle: '审计健康',
   auditCardDesc: '治理审计状态与留痕，异常红字提示',
   auditDetailToggle: '查看审计明细（点击展开）',
-  auditDetailEmpty: '暂无审计明细（治理事件会在这里留痕）',
+  auditDetailEmpty: '暂无审计明细（历史操作与事件会在这里留痕）',
   auditDetailScope: '只读展示，暂不提供导出与过滤',
   auditColTime: '时间',
   auditColEvent: '事件',
@@ -1100,6 +1125,27 @@ function readDispatchResult(block) {
 }
 
 
+// 生效画像一行（派发卡片/台账行展示）：优先 B3 交付的 meta.imageText（后端同源
+// 格式，；分隔转 UI 的 · 分隔、路由段加「模型」前缀）；旧结果无 imageText 时按
+// 生效字段同格式合成。未绑定方案 → 「继承父方案 · …」；两者都不可得返回空串
+// （不渲染该行）。fail-soft：坏输入绝不 throw。
+function imageTextOfBlock(meta, eff) {
+  const e = eff && typeof eff === 'object' ? eff : {}
+  const m = meta && typeof meta === 'object' ? meta : {}
+  let base = typeof m.imageText === 'string' && m.imageText !== '' ? m.imageText : ''
+  if (base === '') {
+    const profile = typeof e.profile === 'string' && e.profile !== '' && e.profile !== '(inline)' ? e.profile : ''
+    const provider = typeof e.provider === 'string' && e.provider !== '' && e.provider !== '(parent)' ? e.provider : ''
+    const model = typeof e.model === 'string' && e.model !== '' && e.model !== '(parent)' ? e.model : ''
+    const route = provider !== '' && model !== '' ? provider + '/' + model : '继承父'
+    const tier = typeof m.tokenTier === 'string' && m.tokenTier !== '' ? m.tokenTier : 'balanced'
+    base = profile !== '' ? `方案 ${profile}；${route}；档位 ${tier}` : `继承父方案；${route}；档位 ${tier}`
+  }
+  const parts = base.split('；').map((p) => p.trim()).filter((p) => p !== '')
+  if (parts.length >= 2) parts[1] = '模型 ' + parts[1]
+  return parts.join(' · ')
+}
+
 // 结算数字提取：tokens 数与缓存命中分别取，供「≈N tokens（缓存命中 M）」
 // 单括号合并展示。tokens 不可得返回 null。
 function summaryNumbersOf(result, block) {
@@ -1462,10 +1508,14 @@ function buildSubagentBanner(el, subagent, parentPreset, modelState, bannerMode)
 // 通知中心（设置页通知与提醒页签）：读 /reminders（与审计同源 host store），全动作
 // （标记已读/采纳/忽略/拒绝/关闭）经 POST 回写 host 并刷新——一条提醒 = 一条审计记录。
 // sessions 服务供条目主/子会话标题查询与跳转；跳转失败静默（设置页不被导航异常打断）。
+// 归档视图每页条数（防大量已处理条目一次性渲染卡 UI）。
+const ARCHIVED_PAGE_SIZE = 20
+
 function makeReminderCenter(el, useState, useEffect, openChild, getSessions) {
   function ReminderCenter(props) {
     const [reminders, setReminders] = useState([])
     const [error, setError] = useState('')
+    const [archived, setArchived] = useState({ open: false, list: [], total: 0, offset: 0, loading: false })
     const refresh = () => {
       api('/reminders').then((data) => setReminders(Array.isArray(data.reminders) ? data.reminders : [])).catch(() => {})
     }
@@ -1475,17 +1525,50 @@ function makeReminderCenter(el, useState, useEffect, openChild, getSessions) {
       const request = action === 'ack' ? api('/reminders/ack', { ids: [id] }) : api('/reminders/action', { id, action })
       request.then(refresh).catch((err) => setError(String((err && err.message) || err)))
     }
+    // 归档视图分页加载：打开时取第一页，「加载更早」按 offset 追加（存储只读）。
+    const loadArchivedPage = (offset) => {
+      setArchived((prev) => ({ ...prev, loading: true }))
+      api('/reminders/archived?offset=' + offset + '&limit=' + ARCHIVED_PAGE_SIZE)
+        .then((data) => {
+          const rows = Array.isArray(data.reminders) ? data.reminders : []
+          setArchived((prev) => ({ ...prev, loading: false, total: typeof data.total === 'number' ? data.total : prev.total, offset, list: offset === 0 ? rows : [...prev.list, ...rows] }))
+        })
+        .catch(() => setArchived((prev) => ({ ...prev, loading: false })))
+    }
+    const toggleArchived = () => {
+      const nextOpen = !archived.open
+      setArchived((prev) => ({ ...prev, open: nextOpen }))
+      if (nextOpen && archived.list.length === 0) loadArchivedPage(0)
+    }
     const jumpToAdvice = props !== null && typeof props === 'object' && typeof props.jumpToAdvice === 'function' ? props.jumpToAdvice : null
-    return buildReminderCenter(el, reminders, error, act, getSessions(), openChild, jumpToAdvice)
+    return buildReminderCenter(el, reminders, error, act, getSessions(), openChild, jumpToAdvice, archived, toggleArchived, loadArchivedPage)
   }
   return ReminderCenter
 }
 
+// 归档视图区：折叠开关（总条数）+ 只读行列表（已处理条目复渲染）+ 加载更早。
+function buildArchivedReminderSection(el, archived, act, sessions, openChild, jumpToAdvice, toggleArchived, loadArchivedPage) {
+  const rows = Array.isArray(archived.list) ? archived.list : []
+  const hasMore = archived.list.length < archived.total
+  return el('details', { className: 'sap-customized sap-customizedArrowEnd sap-reminderHandled', open: archived.open === true },
+    el('summary', { className: 'sap-customizedSummary', onClick: toggleArchived }, '已归档（' + archived.total + '）', el('span', { className: 'sap-customizedEndArrow' }, '▸')),
+    el('div', { className: 'sap-customizedBody' },
+      rows.length === 0
+        ? el('p', { className: 'sap-desc' }, ZH.reminderArchivedEmpty)
+        : [
+            el('ul', { className: 'sap-rows' }, rows.map((r) => buildReminderRow(el, r, act, sessions, openChild, jumpToAdvice))),
+            hasMore
+              ? el('button', { type: 'button', className: 'sap-secondaryButton', style: smallBtn, disabled: archived.loading === true, onClick: () => loadArchivedPage(archived.offset + ARCHIVED_PAGE_SIZE) }, ZH.reminderArchivedMore)
+              : null
+          ]
+    )
+  )
+}
+
 // 提醒中心分层：未终态条目（action 为空）进默认列表；已终态条目折叠为「已处理（N）」
-// 可展开区（原生 details，展开后仍按现有行渲染并保留已处理标注，可追溯）。审计留痕
-// 由 host 侧动作回写，已处理条目不再堆在默认列表里。全空才显示空态文案；仅剩已处理时
-// 只显示折叠区，不显示空态。
-function buildReminderCenter(el, reminders, error, act, sessions, openChild, jumpToAdvice) {
+// 可展开区（原生 details，展开后仍按现有行渲染并保留已处理标注，可追溯）；归档后的
+// 条目进入「已归档（N）」只读分页视图（存储与审计保留）。审计留痕由 host 侧动作回写。
+function buildReminderCenter(el, reminders, error, act, sessions, openChild, jumpToAdvice, archived, toggleArchived, loadArchivedPage) {
   const handled = reminders.filter((r) => typeof r.action === 'string' && r.action !== '')
   const pending = reminders.filter((r) => !(typeof r.action === 'string' && r.action !== ''))
   const pendingList = pending.length > 0
@@ -1499,6 +1582,9 @@ function buildReminderCenter(el, reminders, error, act, sessions, openChild, jum
         )
       )
     : null
+  const archivedSection = archived !== null && typeof archived === 'object'
+    ? buildArchivedReminderSection(el, archived, act, sessions, openChild, jumpToAdvice, toggleArchived, loadArchivedPage)
+    : null
   return el('div', { className: 'sap-card sap-cardStatic' },
     el('div', { className: 'sap-cardHead' },
       el('div', { className: 'sap-cardTitleBox' },
@@ -1510,7 +1596,8 @@ function buildReminderCenter(el, reminders, error, act, sessions, openChild, jum
       error !== '' ? el('p', { className: 'sap-notice' }, error) : null,
       pendingList === null && handledList === null
         ? el('p', { className: 'sap-desc' }, ZH.reminderEmpty)
-        : [pendingList, handledList]
+        : [pendingList, handledList],
+      archivedSection
     )
   )
 }
@@ -1577,10 +1664,20 @@ function reminderJumpButton(el, jump, disabled, onClick) {
   )
 }
 
+// 会话存在性探测（孤儿灰置）：跳转引用指向已删会话（binding 拿不到）时灰置跳转
+// 按钮——回溯安全，不点进不可达会话。空 id/异常一律视为不可用（fail-soft）。
+function sessionExists(sessions, id) {
+  if (typeof id !== 'string' || id === '') return false
+  try { return sessions.binding(id) !== undefined } catch { return false }
+}
+
 // 未采纳条目五字段区：主会话/子会话可点击跳转，任务/结果/说明只读展示。
 function buildUnadoptedFields(el, r, sessions, openChild) {
+  const childId = r.childSessionId !== null && r.childSessionId !== undefined && r.childSessionId !== '' ? r.childSessionId : r.childId
   const parentJump = reminderJumpText(sessions, r.sessionId, ZH.reminderParentLabel)
-  const childJump = reminderJumpText(sessions, r.childSessionId !== null && r.childSessionId !== undefined && r.childSessionId !== '' ? r.childSessionId : r.childId, ZH.reminderChildLabel)
+  const childJump = reminderJumpText(sessions, childId, ZH.reminderChildLabel)
+  const parentGone = !sessionExists(sessions, r.sessionId)
+  const childGone = !sessionExists(sessions, childId)
   const openParent = () => { try { sessions.open(r.sessionId) } catch { /* 会话不可用：静默 */ } }
   const childAddress = typeof r.sessionId === 'string' && r.sessionId !== '' && typeof r.childSessionId === 'string' && r.childSessionId !== ''
     ? { parentSessionId: r.sessionId, childSessionId: r.childSessionId, mode: reminderChildMode(r.childMode) }
@@ -1588,8 +1685,8 @@ function buildUnadoptedFields(el, r, sessions, openChild) {
   const jumpChild = () => { if (childAddress !== null) { try { openChild(childAddress) } catch { /* 子会话不可用：静默 */ } } }
   const excerpt = typeof r.promptExcerpt === 'string' && r.promptExcerpt !== '' ? '「' + r.promptExcerpt + '」' : ZH.reminderNoExcerpt
   return el('div', { className: 'sap-reminderFields' },
-    reminderJumpButton(el, parentJump, typeof r.sessionId !== 'string' || r.sessionId === '', openParent),
-    reminderJumpButton(el, childJump, childAddress === null, jumpChild),
+    reminderJumpButton(el, parentJump, parentGone, openParent),
+    reminderJumpButton(el, childJump, childAddress === null || childGone, jumpChild),
     reminderFieldLine(el, ZH.reminderTaskLabel, excerpt),
     reminderFieldLine(el, ZH.reminderResultLabel, reminderResultText(r)),
     reminderFieldLine(el, ZH.reminderNoteLabel, r.detail)
@@ -1599,10 +1696,11 @@ function buildUnadoptedFields(el, r, sessions, openChild) {
 // 未采纳条目按钮三件套：查看子会话（跳转，恒保留）/ 标记已读（未读显示）/ 关闭。
 // 已终态条目隐藏标记已读与关闭（只留只读跳转），防对终态条目重复处置产生重复审计；
 // 提醒上的处置只改变提醒自身状态（已读/终态），不改变采纳判定——采纳与否由事件流自动汇总。
-function buildUnadoptedActions(el, r, act, childAddress, jumpChild) {
+// 子会话已删（孤儿）时查看按钮灰置（回溯安全）。
+function buildUnadoptedActions(el, r, act, childAddress, jumpChild, childGone) {
   const terminated = typeof r.action === 'string' && r.action !== ''
   return el('div', { className: 'sap-reminderActions' }, [
-    el('button', { type: 'button', className: 'sap-detailToggle', disabled: childAddress === null, onClick: jumpChild }, ZH.reminderViewChild),
+    el('button', { type: 'button', className: 'sap-detailToggle', disabled: childAddress === null || childGone === true, onClick: jumpChild }, ZH.reminderViewChild),
     terminated ? null : r.unread === true ? el('button', { type: 'button', className: 'sap-detailToggle', onClick: act(r.id, 'ack') }, ZH.reminderAck) : null,
     terminated ? null : el('button', { type: 'button', className: 'sap-dangerButton', onClick: act(r.id, 'dismiss') }, ZH.reminderDismiss)
   ])
@@ -1612,9 +1710,11 @@ function buildUnadoptedActions(el, r, act, childAddress, jumpChild) {
 function buildUnadoptedReminderRow(el, r, act, sessions, openChild) {
   const severityCls = r.severity === 'P0' ? 'sap-reminderP0' : 'sap-reminderP1'
   const severityText = r.severity === 'P0' ? '紧急' : '注意'
+  const childId = r.childSessionId !== null && r.childSessionId !== undefined && r.childSessionId !== '' ? r.childSessionId : r.childId
   const childAddress = typeof r.sessionId === 'string' && r.sessionId !== '' && typeof r.childSessionId === 'string' && r.childSessionId !== ''
     ? { parentSessionId: r.sessionId, childSessionId: r.childSessionId, mode: reminderChildMode(r.childMode) }
     : null
+  const childGone = !sessionExists(sessions, childId)
   const jumpChild = () => { if (childAddress !== null) { try { openChild(childAddress) } catch { /* 子会话不可用：静默 */ } } }
   return el('li', { key: String(r.id), className: 'sap-rowCard' + (r.unread === true ? ' sap-reminderUnread' : '') },
     el('div', { className: 'sap-reminderHead' },
@@ -1622,7 +1722,7 @@ function buildUnadoptedReminderRow(el, r, act, sessions, openChild) {
       el('span', { className: 'sap-reminderTitle', title: r.title }, r.title)
     ),
     buildUnadoptedFields(el, r, sessions, openChild),
-    buildUnadoptedActions(el, r, act, childAddress, jumpChild),
+    buildUnadoptedActions(el, r, act, childAddress, jumpChild, childGone),
     typeof r.action === 'string' && r.action !== ''
       ? el('p', { className: 'sap-metaValueDefault' }, ZH.reminderActed.replace('{action}', ZH.reminderActionZh[r.action] || r.action))
       : null
@@ -1794,7 +1894,8 @@ function collectDispatchRecords(nodes) {
       request: readDispatchRequest(node),
       result: readDispatchResult(node),
       argsSummary: summarizeArgsRaw(node.call.argsRaw),
-      contentFirstLine: firstContentLine(node.content)
+      contentFirstLine: firstContentLine(node.content),
+      imageText: node.meta !== null && typeof node.meta === 'object' && typeof node.meta.imageText === 'string' ? node.meta.imageText : ''
     })
   }
   return records
@@ -2304,17 +2405,17 @@ function useBackgroundJobPoll(useState, useEffect, api, sessionId, callId, settl
 function makeDispatchToolview(el, chip, useState, useEffect) {
   function DispatchToolview(props) {
     const block = props && props.block; const request = readDispatchRequest(block); const result = readDispatchResult(block)
-    const settled = !!(block && typeof block === 'object' && 'kind' in block)
-    const trace = block && block.meta ? normalizeDecisionTrace(block.meta) : null
+    const settled = !!(block && typeof block === 'object' && 'kind' in block); const trace = block && block.meta ? normalizeDecisionTrace(block.meta) : null
     const { eff, ignored, kindLabel } = resolveDispatchState(request, result, settled)
     const chips = buildDispatchChips(el, chip, eff, result, block, ignored, request)
-    const safetyLine = safetyLineText(trace); const toolLine = toolLineText(request, trace)
-    const metaLine = (safetyLine !== '' || toolLine !== '') ? el('div', { className: 'sap-toolMeta' },
+    // 生效画像行并入 meta 行（B3 imageText 回读；旧结果按生效字段合成，空则不出现）。
+    const safetyLine = safetyLineText(trace); const toolLine = toolLineText(request, trace); const imageText = imageTextOfBlock(block && typeof block === 'object' ? block.meta : null, eff)
+    const metaLine = (safetyLine !== '' || toolLine !== '' || imageText !== '') ? el('div', { className: 'sap-toolMeta' },
       safetyLine !== '' ? el('span', { className: 'sap-toolMetaItem' }, safetyLine) : null,
-      toolLine !== '' ? el('span', { className: 'sap-toolMetaItem' }, toolLine) : null
+      toolLine !== '' ? el('span', { className: 'sap-toolMetaItem' }, toolLine) : null,
+      imageText !== '' ? el('span', { className: 'sap-toolMetaItem' }, imageText) : null
     ) : null
     const usage = usageFrom(result, block)
-    // 后台运行中按 callId 轮询 /ledger/jobs 配对结算（前台/continuable 静态终态）。
     const jobSettled = useBackgroundJobPoll(useState, useEffect, api, props.sessionId, props.callId, settled, request)
     const [open, setOpen] = useState(false); const suggestion = draftSuggestionFromDispatch(request, trace, result); const draft = useDraftCapture(useState, suggestion)
     // 摘要行只承载动态结果（成本/耗时/结束原因/缓存命中）；静态配置（方案/预设/
@@ -3864,19 +3965,22 @@ function buildSectionReturn(el, s, actions, rows, addCard, reminderCenter, sessi
     ...notices,
     buildTabBar(el, s),
     buildTabZone(el, s, 'profiles',
-      buildSettingsCard(el, 1, '方案管理', '管理派发可用的方案：启用、编辑、删除，含成本与成功率', true, () => {}, [
-        el('p', { className: 'sap-intro' }, ZH.profilesIntro),
-        el('ul', { className: 'sap-rows' }, rows),
-        buildDraftRows(el, s, actions),
-        el('div', { className: 'sap-addBlock' },
-          s.adding ? addCard : el('div', { className: 'sap-addActions' },
-            el('button', { className: 'sap-addButton', onClick: actions.openAdd }, '+ 新增 profile')
+      el('div', { className: 'sap-zoneStack' },
+        buildSettingsCard(el, 1, '方案管理', '管理派发可用的方案：启用、编辑、删除，含成本与成功率', true, () => {}, [
+          el('p', { className: 'sap-intro' }, ZH.profilesIntro),
+          el('ul', { className: 'sap-rows' }, rows),
+          buildDraftRows(el, s, actions),
+          el('div', { className: 'sap-addBlock' },
+            s.adding ? addCard : el('div', { className: 'sap-addActions' },
+              el('button', { className: 'sap-addButton', onClick: actions.openAdd }, '+ 新增 profile')
+            )
+          ),
+          el('div', { className: 'sap-addActions', style: { marginTop: '4px' } },
+            el('button', { type: 'button', className: 'sap-secondaryButton', style: smallBtn, onClick: actions.resetAll }, ZH.resetAllBuiltins)
           )
-        ),
-        el('div', { className: 'sap-addActions', style: { marginTop: '4px' } },
-          el('button', { type: 'button', className: 'sap-secondaryButton', style: smallBtn, onClick: actions.resetAll }, ZH.resetAllBuiltins)
-        )
-      ], true)),
+        ], true),
+        buildMaintenanceCard(el, s, actions)
+      )),
     buildTabZone(el, s, 'cost',
       buildSettingsCard(el, 2, '全局成本', '跨全部会话的派发成本汇总，按模型与方案拆分', true, () => {}, [
         buildCostObservabilitySection(el, s, actions)
@@ -3922,6 +4026,124 @@ function attachDraftActions(api, s, refresh, applyWrite, actions) {
   }
 }
 
+// ── 设置页：数据维护区（快照开关/单条查看 + 四区清理按钮组）───────────────────
+
+// 快照区数据装载 hook：挂载拉一次，开关切换与清理后回读（单条查看状态同驻）。
+function useSnapshotData(useState, useEffect) {
+  const [snapshots, setSnapshots] = useState({ snapshotEnabled: false, count: 0, cap: 200, entries: [] })
+  const [snapshotView, setSnapshotView] = useState({})
+  const [maintenanceNotice, setMaintenanceNotice] = useState('')
+  const refreshSnapshots = () => {
+    api('/snapshots').then((data) => {
+      setSnapshots({
+        snapshotEnabled: data !== null && typeof data === 'object' && data.snapshotEnabled === true,
+        count: data !== null && typeof data === 'object' && typeof data.count === 'number' ? data.count : 0,
+        cap: data !== null && typeof data === 'object' && typeof data.cap === 'number' ? data.cap : 200,
+        entries: data !== null && typeof data === 'object' && Array.isArray(data.entries) ? data.entries : []
+      })
+    }).catch(() => {})
+  }
+  useEffect(() => { refreshSnapshots() }, [])
+  return { snapshots, refreshSnapshots, snapshotView, setSnapshotView, maintenanceNotice, setMaintenanceNotice }
+}
+
+// 数据维护动作：快照开关、单条查看（展开/收起）、四区清理（确认一次、结果 echo）。
+function attachMaintenanceActions(api, s, refresh, actions) {
+  actions.toggleSnapshots = () => {
+    api('/snapshots/set-enabled', { snapshotEnabled: !s.snapshots.snapshotEnabled })
+      .then((data) => {
+        if (data !== null && typeof data === 'object' && data.persisted === false) s.setPersistWarning(ZH.persistFail)
+        else s.setPersistWarning('')
+        s.refreshSnapshots()
+      })
+      .catch((err) => s.setError(String((err && err.message) || err)))
+  }
+  actions.viewSnapshot = (id) => () => {
+    const next = { ...s.snapshotView }
+    if (next[id] !== undefined) { delete next[id]; s.setSnapshotView(next); return }
+    api('/snapshot?id=' + encodeURIComponent(id))
+      .then((data) => {
+        if (data !== null && typeof data === 'object' && data.ok === true && data.snapshot !== undefined) {
+          s.setSnapshotView({ ...s.snapshotView, [id]: data.snapshot })
+        }
+      })
+      .catch(() => {})
+  }
+  actions.cleanZone = (zone, label) => () => {
+    if (!window.confirm(ZH.maintenanceConfirm.replace('{zone}', label))) return
+    api('/maintenance/clean', { zone })
+      .then((data) => {
+        const count = data !== null && typeof data === 'object' && typeof data.count === 'number' ? data.count : 0
+        s.setMaintenanceNotice(ZH.maintenanceDone.replace('{zone}', label).replace('{count}', String(count)))
+        s.refreshSnapshots()
+        refresh()
+      })
+      .catch((err) => s.setError(ZH.maintenanceCleanErr + String((err && err.message) || err)))
+  }
+}
+
+// 单条快照只读体：persona 默认折叠（本地只读允许看原文，UI 不默认展开）；其余
+// 字段等宽 JSON 展示。
+function snapshotViewBody(el, payload) {
+  const cfg = payload !== null && typeof payload === 'object' && payload.config !== null && typeof payload.config === 'object' ? payload.config : {}
+  const keys = Object.keys(cfg)
+  const persona = typeof cfg.persona === 'string' ? cfg.persona : ''
+  return el('div', { className: 'sap-reminderFields' },
+    keys.length === 0 ? el('p', { className: 'sap-desc' }, ZH.snapshotEmptyConfig) : null,
+    keys.map((key) => {
+      if (key === 'persona') {
+        return el('details', { key: 'snap-persona', className: 'sap-customized' },
+          el('summary', { className: 'sap-customizedSummary' }, ZH.snapshotPersonaFold.replace('{n}', String(persona.length))),
+          el('pre', { className: 'sap-metaValueDefault' }, persona)
+        )
+      }
+      return reminderFieldLine(el, key, formatGateValue(cfg[key]))
+    })
+  )
+}
+
+// 快照开关说明三行分层：首行主说明，后两行小字次要色（数据落点与关闭语义）。
+function snapshotSwitchDescRows(el) {
+  return ZH.snapshotSwitchDesc.split('\n').filter((line) => line !== '').map((line, index) => el('p', { key: 'snap-desc-' + index, className: index === 0 ? 'sap-desc' : 'sap-descMinor' }, line))
+}
+
+// 数据维护卡（方案管理尾部）：快照开关 + B7 文案 + 数量/护栏提示 + 单条查看 +
+// 维护按钮组（四区各自独立、一次确认、结果 echo、DOM 一行）。
+function buildMaintenanceCard(el, s, actions) {
+  const snap = s.snapshots
+  const atCap = snap.count >= snap.cap && snap.count > 0
+  const entries = Array.isArray(snap.entries) ? snap.entries : []
+  const zoneButtons = [
+    { zone: 'candidates', label: ZH.cleanCandidates },
+    { zone: 'snapshots', label: ZH.cleanSnapshots },
+    { zone: 'reminders', label: ZH.cleanReminders },
+    { zone: 'stats', label: ZH.cleanStats }
+  ].map((z) => el('button', { key: 'clean-' + z.zone, type: 'button', className: 'sap-secondaryButton', style: smallBtn, onClick: actions.cleanZone(z.zone, z.label) }, z.label))
+  return buildSettingsCard(el, 11, ZH.maintenanceCardTitle, ZH.maintenanceCardDesc, true, () => {}, [
+    el('label', { className: 'sap-switch' },
+      el('input', { type: 'checkbox', checked: snap.snapshotEnabled === true, onChange: actions.toggleSnapshots }),
+      el('span', null, '配置快照')
+    ),
+    el('div', { className: 'sap-maintenanceSwitchDesc' }, snapshotSwitchDescRows(el)),
+    el('p', { className: 'sap-desc' },
+      snap.count > 0 ? ZH.snapshotCount.replace('{n}', String(snap.count)).replace('{cap}', String(snap.cap)) : ZH.snapshotNone
+    ),
+    atCap ? el('p', { className: 'sap-notice' }, ZH.snapshotCapHint) : null,
+    entries.map((entry) => {
+      const payload = s.snapshotView[entry.id]
+      return el('div', { key: 'snap-' + entry.id, className: 'sap-candidateSettingsPanel' },
+        el('div', { className: 'sap-candidateSettingsRow' },
+          el('b', null, ZH.snapshotMeta.replace('{id}', entry.id).replace('{ts}', formatMonthDayTime(entry.ts))),
+          el('button', { type: 'button', className: 'sap-candidateSettingsEdit', onClick: actions.viewSnapshot(entry.id) }, payload !== undefined ? ZH.snapshotViewClose : ZH.snapshotView)
+        ),
+        payload !== undefined ? snapshotViewBody(el, payload) : null
+      )
+    }),
+    s.maintenanceNotice !== '' ? el('p', { className: 'sap-notice' }, s.maintenanceNotice) : null,
+    el('div', { className: 'sap-candidateSettingsActions' }, zoneButtons)
+  ], true)
+}
+
 function makeProfilesSection(el, api, chip, useState, useEffect, useCallback, ReminderCenter, getSessions) {
   function ProfilesSection() {
     const [profiles, setProfiles] = useState([]); const [options, setOptions] = useState({ models: [], efforts: {}, presets: [] }); const [enabled, setEnabled] = useState(true)
@@ -3934,8 +4156,8 @@ function makeProfilesSection(el, api, chip, useState, useEffect, useCallback, Re
     const [candidateSettingsForm, setCandidateSettingsForm] = useState({ candidateMode: 'auto', candidateTtlChoice: '24', customDays: '', error: '' }); const [adviceDetails, setAdviceDetails] = useState({}); const [detailOpen, setDetailOpen] = useState({})
     const [activeTab, setActiveTab] = useState('profiles'); const [highlightId, setHighlightId] = useState(null); const [adviceOpen, setAdviceOpen] = useState({}); const [auditDetailOpen, setAuditDetailOpen] = useState(false); const [auditReminders, setAuditReminders] = useState([])
     const [evolutionStatus, setEvolutionStatus] = useState({ applyEnabled: false, canaryEnabled: false, reasons: [] }); const [evolutionAssets, setEvolutionAssets] = useState([])
-    const [applyModal, setApplyModal] = useState({ profileKey: '', candidateId: '', open: false, error: '' }); const [rollbackModal, setRollbackModal] = useState({ assetId: '', open: false, error: '' })
-    const s = { profiles, options, enabled, adding, editingId, error, savedNotice, persistWarning, form, tools, versionWarnings, pluginVersion, audit, escapeEnabled, escapePresets, escapeInput, evolutionAdvice, drafts, advice, evolutionCandidates, adviceGlobal, costSummary, draftPreviews, candidateOpen, candidateSelected, candidateSafetyOpen, candidateSettings, candidateSettingsOpen, candidateSettingsForm, adviceDetails, detailOpen, activeTab, highlightId, adviceOpen, auditDetailOpen, auditReminders, evolutionStatus, evolutionAssets, applyModal, rollbackModal, setProfiles, setOptions, setEnabled, setAdding, setEditingId, setError, setSavedNotice, setPersistWarning, setForm, setTools, setVersionWarnings, setPluginVersion, setAudit, setEscapeEnabled, setEscapePresets, setEscapeInput, setEvolutionAdvice, setDrafts, setAdvice, setEvolutionCandidates, setAdviceGlobal, setCostSummary, setDraftPreviews, setCandidateOpen, setCandidateSelected, setCandidateSafetyOpen, setCandidateSettings, setCandidateSettingsOpen, setCandidateSettingsForm, setAdviceDetails, setDetailOpen, setActiveTab, setHighlightId, setAdviceOpen, setAuditDetailOpen, setAuditReminders, setEvolutionStatus, setEvolutionAssets, setApplyModal, setRollbackModal }
+    const [applyModal, setApplyModal] = useState({ profileKey: '', candidateId: '', open: false, error: '' }); const [rollbackModal, setRollbackModal] = useState({ assetId: '', open: false, error: '' }); const snapshotCtl = useSnapshotData(useState, useEffect)
+    const s = { profiles, options, enabled, adding, editingId, error, savedNotice, persistWarning, form, tools, versionWarnings, pluginVersion, audit, escapeEnabled, escapePresets, escapeInput, evolutionAdvice, drafts, advice, evolutionCandidates, adviceGlobal, costSummary, draftPreviews, candidateOpen, candidateSelected, candidateSafetyOpen, candidateSettings, candidateSettingsOpen, candidateSettingsForm, adviceDetails, detailOpen, activeTab, highlightId, adviceOpen, auditDetailOpen, auditReminders, evolutionStatus, evolutionAssets, applyModal, rollbackModal, snapshots: snapshotCtl.snapshots, snapshotView: snapshotCtl.snapshotView, maintenanceNotice: snapshotCtl.maintenanceNotice, refreshSnapshots: snapshotCtl.refreshSnapshots, setSnapshotView: snapshotCtl.setSnapshotView, setMaintenanceNotice: snapshotCtl.setMaintenanceNotice, setProfiles, setOptions, setEnabled, setAdding, setEditingId, setError, setSavedNotice, setPersistWarning, setForm, setTools, setVersionWarnings, setPluginVersion, setAudit, setEscapeEnabled, setEscapePresets, setEscapeInput, setEvolutionAdvice, setDrafts, setAdvice, setEvolutionCandidates, setAdviceGlobal, setCostSummary, setDraftPreviews, setCandidateOpen, setCandidateSelected, setCandidateSafetyOpen, setCandidateSettings, setCandidateSettingsOpen, setCandidateSettingsForm, setAdviceDetails, setDetailOpen, setActiveTab, setHighlightId, setAdviceOpen, setAuditDetailOpen, setAuditReminders, setEvolutionStatus, setEvolutionAssets, setApplyModal, setRollbackModal }
     const refresh = useCallback(() => {
       api('/list')
         .then((data) => {
@@ -3960,13 +4182,9 @@ function makeProfilesSection(el, api, chip, useState, useEffect, useCallback, Re
     }, [])
     const loadEfforts = makeEffortsLoader(api, setOptions); const loadTools = makeToolsLoader(api, setTools)
     const loadVersions = useCallback(() => makeVersionsLoader(api, setVersionWarnings, setPluginVersion)(), []) // 只挂载时拉一次：稳定引用防 effect 依赖恒变
-    useEffect(() => {
-      refresh()
-      loadOptions()
-      loadVersions()
-    }, [refresh, loadOptions, loadVersions])
+    useEffect(() => { refresh(); loadOptions(); loadVersions() }, [refresh, loadOptions, loadVersions])
     const applyWrite = makeApplyWrite(s); const actions = makeProfilesActions(api, s, refresh, applyWrite, loadEfforts, loadTools)
-    attachDraftActions(api, s, refresh, applyWrite, actions)
+    attachDraftActions(api, s, refresh, applyWrite, actions); attachMaintenanceActions(api, s, refresh, actions)
     const rows = buildProfileRows(el, chip, s, actions); const toolSection = buildToolSection(el, s, actions)
     return buildSectionReturn(el, s, actions, rows, buildAddCard(el, s, actions, toolSection), ReminderCenter, sessionsSnapshot(getSessions))
   }
@@ -4952,6 +5170,7 @@ function buildLedgerRowHead(el, record, profileNames, proc, open, onToggle) {
   const costText = rejected ? '—' : (!settled ? ZH.ledgerCostRunning : (costInfo !== null ? '≈' + costInfo.actual + ' 元' : ''))
   const profileId = recordProfile(record)
   const profileText = profileId !== '' ? profileDisplay(profileId, profileNames) : ZH.inlineProfile
+  const imageText = imageTextOfBlock({ imageText: record.imageText }, record.trace !== null && typeof record.trace === 'object' ? record.trace.effective : null)
   const toolsText = ledgerToolsCountOf(record, proc)
   const interveneText = proc !== null && proc.interventions > 0 ? ZH.ledgerInterventionBadge.replace('{n}', String(proc.interventions)) : ''
   return el('button', {
@@ -4962,6 +5181,9 @@ function buildLedgerRowHead(el, record, profileNames, proc, open, onToggle) {
   },
     el('span', { className: 'sap-ledgerTime' }, formatClockTime(record.time)),
     el('span', { className: 'sap-ledgerMeta' }, profileText),
+    imageText !== ''
+      ? el('span', { className: 'sap-ledgerMeta sap-ledgerImageText' }, imageText)
+      : null,
     el('span', { className: 'sap-ledgerStatus ' + status.cls }, status.label),
     costText !== '' ? el('span', { className: 'sap-ledgerCostText' }, costText) : null,
     toolsText !== '' ? el('span', { className: 'sap-ledgerToolsText' }, toolsText) : null,

package/lib/core/cleanup.mjs

@@ -0,0 +1,33 @@
+// lib/core/cleanup.mjs — 启动与卸载清理辅助（从 index.mjs 移出以守装配文件行门）。
+// 卸载清理：本插件 3 个数据文件 + orchestrator-v2 预设目录改名备份（effect 清理器
+// 在禁用/热重载/退出时都可能触发；硬删除会静默丢用户数据）。启动清理：删上个
+// 生命周期留下的 .removed-* 备份残留（只清本插件前缀，防热重载反复产生新备份
+// 积累）；卸载后用户手动改回原名的场景不受影响。全部 fail-soft（改名/删除失败
+// 不抛）。import-free（仅 node 内置），可被裸 CI 单测。
+
+import { readdirSync, renameSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+
+export function removeOwnedData(home) {
+  const stamp = Date.now();
+  for (const file of ['subagent-profiles.json', 'subagent-profiles.state.json', 'subagent-profiles.failed-traces.json']) {
+    try { renameSync(join(home, file), join(home, `${file}.removed-${stamp}`)); } catch { /* 源不存在（正常首启）等：best effort */ }
+  }
+  try { renameSync(join(home, '.agent-presets', 'orchestrator-v2'), join(home, '.agent-presets', `orchestrator-v2.removed-${stamp}`)); } catch { /* best effort */ }
+}
+
+export function cleanRemovedBackups(home) {
+  for (const dir of [home, join(home, '.agent-presets')]) {
+    let names;
+    try { names = readdirSync(dir); } catch { continue; }
+    for (const name of names) {
+      try {
+        if (name.startsWith('subagent-profiles.') && name.includes('.removed-')) {
+          rmSync(join(dir, name), { force: true });
+        } else if (name.startsWith('orchestrator-v2.removed-')) {
+          rmSync(join(dir, name), { recursive: true, force: true });
+        }
+      } catch { /* best effort */ }
+    }
+  }
+}