sintbot 1.0.7 → 1.0.9

package/src/ui/dashboard.js

@@ -0,0 +1,165 @@
+'use strict'
+// 控制台「需要你处理」收件箱 + 实时活动的账本回填(纯逻辑,可测;读写盘只在 readLedgerTail / createDismissStore)。
+//
+// 为什么要有收件箱:agent 跑得越久、群越多,「哪里在等我」就越难从聊天记录和概览各区里拼出来 ——
+// 失败的轮次、没人认领的浏览器接管、没处理的反馈、残留进程,此前散在群消息和概览的四个地方。
+// 这里只**汇总**,不新增通知渠道:群里该说的照旧在群里说,控制台是人主动来看的地方。
+//
+// 为什么要回填:活动流是内存环形缓冲,daemon 一重启(含每次发版)概览就是空的,而账本一直在盘上。
+// 回填的事件 id 与引擎同形(`chatId:ts`),之后 SSE 重放同一轮也只会原地覆盖,不会重复。
+
+const fs = require('node:fs')
+const path = require('node:path')
+
+const FAIL_STATUSES = new Set(['error', 'failed']) // stopped 是人按的、no-reply 是设计如此、empty 会自己重试一次 —— 都不算「要人管」
+const FAIL_WINDOW_MS = 72 * 3600_000 // 三天前的失败,人早就在群里重说过或者放弃了
+const MAX_FAILS = 20
+const DISMISS_TTL_MS = 7 * 24 * 3600_000
+const DISMISS_MAX = 200
+
+const groupLabel = (groups, chatId) => {
+  const g = groups && groups[chatId]
+  return (g && g.name) || String(chatId || '').slice(-8)
+}
+
+// 只读账本末尾一段:账本一轮一行、只增不减(本机 30 天约 4,600 行),整本读进来没必要。
+// 从中间切开时丢掉第一行残片;坏行跳过(账本是 best-effort 追加,半行是可能的)。
+function readLedgerTail(file, maxBytes = 512 * 1024) {
+  let fd
+  try {
+    fd = fs.openSync(file, 'r')
+    const size = fs.fstatSync(fd).size
+    const start = Math.max(0, size - maxBytes)
+    const buf = Buffer.alloc(size - start)
+    fs.readSync(fd, buf, 0, buf.length, start)
+    const lines = buf.toString('utf8').split('\n')
+    if (start > 0) lines.shift()
+    const rows = []
+    for (const l of lines) {
+      if (!l.trim()) continue
+      try { const r = JSON.parse(l); if (r && typeof r === 'object') rows.push(r) } catch { /* 半行 / 坏行 */ }
+    }
+    return rows
+  } catch { return [] } finally { if (fd !== undefined) try { fs.closeSync(fd) } catch {} }
+}
+
+// 账本尾巴按 (大小, 修改时刻) 缓存:收件箱每次刷新都要读,账本却只在一轮结束时才变 ——
+// 本机尾部 512 KB 约 2,400 行,没变也每次解析一遍是白干。返回的数组是共享的,调用方别改它。
+function createLedgerTail(file, maxBytes) {
+  let key = null
+  let rows = []
+  return {
+    rows() {
+      let st
+      try { st = fs.statSync(file) } catch { key = null; rows = []; return rows }
+      const k = `${st.size}:${st.mtimeMs}`
+      if (k !== key) { rows = readLedgerTail(file, maxBytes); key = k }
+      return rows
+    },
+  }
+}
+
+// 账本行 → 活动事件(形状对齐引擎的 done 事件)。定时脚本行跳过:它没有模型、没有 token,
+// 本机 30 天里占了 93%,混进来活动流就只剩脚本了。返回从旧到新(与活动缓冲同序)。
+function ledgerActivity(rows, groups, n = 20) {
+  const turns = (rows || []).filter((r) => r && !r.script && r.ts && r.chatId)
+  return turns.slice(-n).map((r) => ({
+    id: `${r.chatId}:${r.ts}`,
+    ts: r.ts,
+    chatId: r.chatId,
+    group: String(r.chatId).slice(-8), // 与引擎 meta.group 同口径;群名由控制台按 chatId 换
+    name: groupLabel(groups, r.chatId),
+    sender: r.sender || '',
+    text: r.text || '',
+    kind: 'done',
+    status: r.status || '',
+    ms: r.ms || 0,
+    tokens: r.tokens || null,
+    ...(r.err ? { err: String(r.err) } : {}),
+    fromLedger: true,
+  }))
+}
+
+// 失败轮次:同群同一个人之后又有 ok 轮 ⇒ 当作已经重说过、自动消失 —— 否则一次网络抖动的失败
+// 要在收件箱里挂三天,人只能一条条手动忽略。
+function failedTurns(rows, now) {
+  const recent = (rows || []).filter((r) => r && !r.script && r.ts > now - FAIL_WINDOW_MS)
+  const out = []
+  for (let i = 0; i < recent.length; i++) {
+    const f = recent[i]
+    if (!FAIL_STATUSES.has(f.status)) continue
+    const retried = recent.slice(i + 1).some((r) => r.chatId === f.chatId && r.sender === f.sender && r.status === 'ok')
+    if (!retried) out.push(f)
+  }
+  return out.slice(-MAX_FAILS)
+}
+
+// 汇总成一张单子。文案不在这里拼:控制台有中英两套界面,这里只给事实(kind + 字段),由前端成句。
+//   failed     失败的轮次 · 可忽略
+//   takeover   agent 在群里发了接管链接、还没人认领(只算挂了群卡的票;管理员自己在控制台签的不算)
+//   issues     反馈本里没处理的(一行汇总,点了滚到反馈本)
+//   leftovers  残留的后台进程(同上)
+//   preview    服务整个项目目录的预览(全部代码都在局域网上可读)
+//   health     健康检查没通过的项(一行汇总,排最前:它是「现在就坏着」,没有发生时刻可排)
+function buildInbox({ ledgerRows = [], issues = null, previews = [], leftovers = null, health = null, takeovers = [], groups = {}, dismissed = new Set(), now = Date.now() } = {}) {
+  const items = []
+  for (const f of failedTurns(ledgerRows, now)) {
+    items.push({ key: `failed:${f.chatId}:${f.ts}`, kind: 'failed', chatId: f.chatId, group: groupLabel(groups, f.chatId), ts: f.ts,
+      sender: f.sender || '', text: f.text || '', err: f.err ? String(f.err) : '', dismissable: true })
+  }
+  for (const t of takeovers || []) {
+    if (!t || !t.chatId) continue
+    items.push({ key: `takeover:${t.id}`, kind: 'takeover', chatId: t.chatId, group: groupLabel(groups, t.chatId), ts: t.at, exp: t.exp,
+      pageTitle: t.pageTitle || '', pageUrl: t.pageUrl || '' })
+  }
+  if (issues && issues.openCount > 0) {
+    const latest = (issues.open || [])[0]
+    items.push({ key: 'issues', kind: 'issues', count: issues.openCount, ts: latest ? latest.ts : null })
+  }
+  const lo = leftovers && Array.isArray(leftovers.rows) ? leftovers.rows : []
+  if (lo.length) {
+    const oldest = Math.max(...lo.map((x) => Number(x.ageSec) || 0))
+    items.push({ key: 'leftovers', kind: 'leftovers', count: lo.length, ts: now - oldest * 1000 })
+  }
+  for (const p of previews || []) {
+    if (!p || !p.projectRoot) continue
+    items.push({ key: `preview:${p.id}`, kind: 'preview', chatId: p.chatId, group: p.name || groupLabel(groups, p.chatId), ts: now - (Number(p.upMs) || 0), port: p.port })
+  }
+  const sorted = items.filter((it) => !dismissed.has(it.key)).sort((a, b) => (b.ts || 0) - (a.ts || 0))
+  const bad = health && Array.isArray(health.rows) ? health.rows.filter((r) => r && r.status === 'fail') : [] // warn 不算:那是「可以更好」,不是「在等你」
+  return bad.length ? [{ key: 'health', kind: 'health', count: bad.length, labels: bad.map((r) => String(r.label || '')) }, ...sorted] : sorted
+}
+
+// 「忽略」记在盘上(daemon 重启不复活),7 天后清、最多 200 条 —— 失败轮次本身 72 小时就出窗口了,
+// 留 7 天只是余量。文件读坏就当空:最坏是几条已忽略的失败重新出现,不阻断任何东西。
+function createDismissStore({ file, now = Date.now, log = () => {} } = {}) {
+  let keys = null // key -> 忽略时刻
+  const load = () => {
+    if (keys) return
+    keys = new Map()
+    try {
+      const d = JSON.parse(fs.readFileSync(file, 'utf8'))
+      for (const [k, t] of Object.entries((d && d.keys) || {})) if (typeof t === 'number') keys.set(k, t)
+    } catch { /* 没有 / 读坏 ⇒ 空 */ }
+  }
+  const prune = () => {
+    const t = now()
+    for (const [k, at] of keys) if (!(at > t - DISMISS_TTL_MS)) keys.delete(k)
+    const extra = keys.size - DISMISS_MAX
+    if (extra > 0) for (const k of [...keys.keys()].slice(0, extra)) keys.delete(k) // Map 按插入序 ⇒ 先丢最老的
+  }
+  return {
+    set() { load(); prune(); return new Set(keys.keys()) },
+    add(key) {
+      load(); keys.delete(key); keys.set(String(key), now()); prune()
+      try {
+        fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 })
+        const tmp = `${file}.${process.pid}.tmp`
+        fs.writeFileSync(tmp, JSON.stringify({ v: 1, keys: Object.fromEntries(keys) }) + '\n', { mode: 0o600 })
+        fs.renameSync(tmp, file)
+      } catch (e) { log(`inbox: 写不进 ${path.basename(file)}(${e.message})—— 这次忽略只在内存里`) }
+    },
+  }
+}
+
+module.exports = { FAIL_WINDOW_MS, readLedgerTail, createLedgerTail, ledgerActivity, failedTurns, buildInbox, createDismissStore }

package/src/ui/server.js

@@ -51,6 +51,7 @@ const DEFAULT_SESSIONS_FILE = () => path.join(os.homedir(), '.sbot', 'ui-session
 const CONSOLE_HTML = path.join(__dirname, 'console.html')
 const BROWSER_HTML = path.join(__dirname, 'browser.html') // 接管浏览器页(自包含单文件,群成员凭一次性链接也能进)
 const takeover = require('./takeover') // 接管链接的票据与 cookie(纯逻辑)
+const dashboard = require('./dashboard') // 「需要你处理」收件箱 + 活动流的账本回填(纯逻辑)
 const { createBrowserRoutes } = require('./browserroutes') // /api/browser/* 的实现;这里只裁决谁能进
 const PKG_VERSION = (() => { try { return 'v' + require('../../package.json').version } catch { return '' } })() // 顶栏版本徽章
 let changelogCache = null // 随包分发的版本历史,进程内读一次
@@ -207,7 +208,7 @@ function bindNoticeText(workdir, platform = 'feishu', cmd = '/help') {
   return `✅ 本群已绑定项目「${path.basename(String(workdir || '')) || '(未命名)'}」\n${platform === 'wecom' ? '@我 派单(只有 @ 我的消息我才收得到)' : '直接发消息或 @我 派单'};${cmd} 查看命令`
 }
 
-function createUiServer({ configPath, getLiveState = null, getConnHealth = null, onConfigChange = null, control = null, host = '127.0.0.1', log = () => {}, issuesPath = null, sessionsPath = null, auditPath = null, fetchImpl = null, cdpImpl = null, onTakeoverClaim = null, onTakeoverExpire = null, onTakeoverEnd = null, takeoverNow = null, wecomExec = null, verifyFile = null } = {}) {
+function createUiServer({ configPath, getLiveState = null, getConnHealth = null, onConfigChange = null, control = null, host = '127.0.0.1', log = () => {}, issuesPath = null, sessionsPath = null, auditPath = null, ledgerPath = null, inboxDismissPath = null, fetchImpl = null, cdpImpl = null, onTakeoverClaim = null, onTakeoverExpire = null, onTakeoverEnd = null, takeoverNow = null, wecomExec = null, verifyFile = null } = {}) {
   // wecomExec:企业微信命令行工具的执行器注入(只为可测;生产走默认 execFile)
   // verifyFile:凭据验证记录的落点注入(只为可测;生产 = ~/.sbot/verify.json)
   const vopts = verifyFile ? { file: verifyFile } : undefined
@@ -313,6 +314,30 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
     else { activityBuf.push(ev); if (activityBuf.length > ACT_MAX) activityBuf.shift() }
   }
   const recentActivity = () => activityBuf.slice().reverse() // newest-first for the console
+  // 账本落点注入**只为可测**(同反馈本):单测写默认路径会读到本机真实账本。
+  const ledgerFile = () => ledgerPath || path.join(os.homedir(), '.sbot', 'turns.jsonl')
+  const ledgerTail = dashboard.createLedgerTail(ledgerFile()) // 按文件大小与修改时刻缓存:账本只在一轮结束时才变
+  // 启动即用账本最近的轮次垫底:此前 daemon 一重启(含每次发版)概览的活动流就是空的,
+  // 要等下一轮才有东西看。id 与引擎同形,之后真实事件进来只会原地覆盖、不会重复。
+  try {
+    let groupsRaw = {}
+    try { groupsRaw = readRaw().groups || {} } catch {}
+    for (const ev of dashboard.ledgerActivity(ledgerTail.rows(), groupsRaw, 20)) recordActivity(ev)
+  } catch { /* 回填是锦上添花,读不了就空着 */ }
+  const inboxDismiss = dashboard.createDismissStore({ file: inboxDismissPath || path.join(os.homedir(), '.sbot', 'inbox-dismissed.json'), log })
+  let lastHealth = null // 最近一次 buildState 的健康检查,给只算收件箱的 /api/inbox 用(那里不重跑探针)
+  // 「需要你处理」:从 state 各区取数(反馈本 / 预览 / 残留进程 / 健康)+ 账本 + 接管票,不再各算一遍
+  const buildInboxFor = ({ issues, previews, leftovers, health }, raw) => {
+    try {
+      return dashboard.buildInbox({
+        ledgerRows: ledgerTail.rows(),
+        issues, previews, leftovers, health,
+        takeovers: takeoverStore.pending(),
+        groups: (raw && raw.groups) || {},
+        dismissed: inboxDismiss.set(),
+      })
+    } catch (e) { log('inbox: 汇总失败(忽略): ' + (e && e.message)); return [] }
+  }
 
   // Disband hardening: server-enforced two-phase with a one-time
   // token — a bare &confirm=1 must never skip the in-group notice/cool-down.
@@ -344,6 +369,62 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
     return val
   }
 
+  // 运行中的群预览服务(`sbot preview`)。**必须在概览里看得见** —— v0.8.1 那个 agent 私装的
+  // 静态服务在局域网上挂了一周才被人肉发现,「operator 看不见」正是本技能要治的三个软肋之一。
+  // 纯读 ~/.sbot/preview/ 的记录文件(不 spawn、不探网),每个 API 响应都跑得起。
+  const previewsState = (raw) => {
+    try {
+      const t = Date.now()
+      // 只列 **running**:'starting' 期间端口还没绑定,列出来等于给一个可能打不开的 URL
+      return preview.listRecords(preview.previewDir()).filter((r) => r.status === 'running' && preview.isLive(r)).map((r) => ({
+        id: r.id, chatId: r.chatId, name: (raw.groups && raw.groups[r.chatId] && raw.groups[r.chatId].name) || r.chatId,
+        label: r.label || r.entry, port: r.port, entry: r.entry,
+        serveRoot: preview.displayRoot(r), // 展示用相对路径(与 CLI/doctor 同一份实现)
+        single: !!r.single,                 // 只服务 entry 这一个文件(文件形态)
+        served: preview.displayServed(r),   // 实际服务到的位置:single ⇒ 到文件,目录 ⇒ 到目录
+        projectRoot: !!r.projectRoot, // 服务整个项目目录 ⇒ 前端标风险色
+        upMs: t - (r.startedAt || t), lastReqMs: r.lastReqAt ? t - r.lastReqAt : null, reqCount: r.reqCount || 0,
+        idleLeftMs: r.idleMs > 0 ? Math.max(0, r.idleMs - (t - (r.lastReqAt || r.startedAt || t))) : null,
+        url: preview.buildUrl(r, preview.hostForUrl(r, lanIPv4())),
+      }))
+    } catch { return [] }
+  }
+
+  // 群内反馈本(群里 /issue 提的)。**未处理的必须在概览里看得见** —— 与上面的预览服务
+  // 同一条道理:这本账存在的全部意义是「反馈不会不声不响地消失」,而它要是只躺在本机
+  // 文件里没人看,和消失没区别。纯读一个小 JSONL(不 spawn、不探网),与 previews 同量级。
+  // ⚠ open 封顶 50 条:正常一天几条,封顶是防「这里有一天变成拖垮每个 API 响应的地方」。
+  const issuesState = (raw) => {
+    try {
+      const book = createIssues(issuesFile(), { host: raw.instance || undefined })
+      const all = book.list({ all: true })
+      const open = all.filter((i) => i.status === 'open').reverse() // 新的在上:反馈按「最近发生什么」读
+      const closed = all.filter((i) => i.status === 'closed').reverse()
+      const trim = (i) => ({ id: i.id, ts: i.ts, chatId: i.chatId, group: i.group, sender: i.sender, text: i.text, version: i.version, note: i.note, fp: fingerprint(i.turn) })
+      return { host: book.host, open: open.slice(0, 50).map(trim), closed: closed.slice(0, 5).map(trim), openCount: open.length, closedCount: closed.length }
+    } catch { return { host: '', open: [], closed: [], openCount: 0, closedCount: 0 } }
+  }
+
+  // 遗留进程(v0.11.108):agent 在对话轮次里用后台方式起的 shell,轮次结束后挂到 pid 1 下继续跑。
+  // **必须在概览里看得见** —— 与预览服务 / 反馈本同一条道理:2026-10-09 在生产机翻出一条每 5 秒
+  // 打线上云函数的循环,零 CPU、零报警地跑了 35 天。走 30 秒 TTL 缓存(每次 /api/state 都问,ps 一次
+  // 几十毫秒,不必每次都跑)。⚠ **不下发完整 command**:它带 shell 快照路径、/tmp 落点等机器布局
+  // (零工具名约束),页面只需要 summary(agent 真正写的那条命令)+ 年龄 + pid。
+  // supported:false(Windows 没有 ps 也没有这套快照)⇒ rows 为空,前端一个字不出现。
+  const leftoversState = async () => {
+    try {
+      const r = await leftover.cachedList()
+      return { supported: !!r.supported, rows: (r.rows || []).map((x) => ({ pid: x.pid, ageSec: x.ageSec, age: x.age, summary: x.summary })), error: r.error || null }
+    } catch { return { supported: false, rows: [], error: null } }
+  }
+
+  // 只算收件箱(轮次结束、忽略之后控制台来取这一块):不走 buildState —— 那里有 CLI 探针、
+  // 逐群读项目插件与设计卡,一轮一次全量太重。健康检查借上一次 buildState 的结果(概览每分钟刷新一次)。
+  const inboxOnly = async () => {
+    const raw = readRaw()
+    return buildInboxFor({ issues: issuesState(raw), previews: previewsState(raw), leftovers: await leftoversState(), health: lastHealth }, raw)
+  }
+
   async function buildState() {
     const cfg = loadConfig(configPath)
     const raw = readRaw()
@@ -424,6 +505,7 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       }),
     ]
     const health = { rows, fails: rows.filter((r) => r.status === 'fail').length, warns: rows.filter((r) => r.status === 'warn').length }
+    lastHealth = health
     const feishu = raw.feishu ? {
       appId: isEnvRef(raw.feishu.appId) ? '' : (raw.feishu.appId || ''),
       appIdRef: isEnvRef(raw.feishu.appId) ? raw.feishu.appId.slice(4) : '',
@@ -462,7 +544,7 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       replyInThread: raw.slack.replyInThread !== false,
       commandAlias: raw.slack.commandAlias || '!',
     } : null
-    return {
+    const state = {
       configPath: cfg._path,
       health,
       providers,
@@ -495,54 +577,11 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       proxy: raw.proxy && raw.proxy.http ? { http: raw.proxy.http, noProxy: raw.proxy.noProxy || '' } : null,
       live: getLiveState ? getLiveState() : { running: false },
       conn, // 各平台连接健康度字典 { feishu, wecom }(daemon 运行时);未运行为 null
-      // 运行中的群预览服务(`sbot preview`)。**必须在概览里看得见** —— v0.8.1 那个 agent 私装的
-      // 静态服务在局域网上挂了一周才被人肉发现,「operator 看不见」正是本技能要治的三个软肋之一。
-      // 纯读 ~/.sbot/preview/ 的记录文件(不 spawn、不探网),每个 API 响应都跑得起。
-      previews: (() => {
-        try {
-          const t = Date.now()
-          // 只列 **running**:'starting' 期间端口还没绑定,列出来等于给一个可能打不开的 URL
-          return preview.listRecords(preview.previewDir()).filter((r) => r.status === 'running' && preview.isLive(r)).map((r) => ({
-            id: r.id, chatId: r.chatId, name: (raw.groups && raw.groups[r.chatId] && raw.groups[r.chatId].name) || r.chatId,
-            label: r.label || r.entry, port: r.port, entry: r.entry,
-            serveRoot: preview.displayRoot(r), // 展示用相对路径(与 CLI/doctor 同一份实现)
-            single: !!r.single,                 // 只服务 entry 这一个文件(文件形态)
-            served: preview.displayServed(r),   // 实际服务到的位置:single ⇒ 到文件,目录 ⇒ 到目录
-            projectRoot: !!r.projectRoot, // 服务整个项目目录 ⇒ 前端标风险色
-            upMs: t - (r.startedAt || t), lastReqMs: r.lastReqAt ? t - r.lastReqAt : null, reqCount: r.reqCount || 0,
-            idleLeftMs: r.idleMs > 0 ? Math.max(0, r.idleMs - (t - (r.lastReqAt || r.startedAt || t))) : null,
-            url: preview.buildUrl(r, preview.hostForUrl(r, lanIPv4())),
-          }))
-        } catch { return [] }
-      })(),
+      previews: previewsState(raw),
 
-      // 群内反馈本(群里 /issue 提的)。**未处理的必须在概览里看得见** —— 与上面的预览服务
-      // 同一条道理:这本账存在的全部意义是「反馈不会不声不响地消失」,而它要是只躺在本机
-      // 文件里没人看,和消失没区别。纯读一个小 JSONL(不 spawn、不探网),与 previews 同量级。
-      // ⚠ open 封顶 50 条:正常一天几条,封顶是防「这里有一天变成拖垮每个 API 响应的地方」。
-      issues: (() => {
-        try {
-          const book = createIssues(issuesFile(), { host: raw.instance || undefined })
-          const all = book.list({ all: true })
-          const open = all.filter((i) => i.status === 'open').reverse() // 新的在上:反馈按「最近发生什么」读
-          const closed = all.filter((i) => i.status === 'closed').reverse()
-          const trim = (i) => ({ id: i.id, ts: i.ts, chatId: i.chatId, group: i.group, sender: i.sender, text: i.text, version: i.version, note: i.note, fp: fingerprint(i.turn) })
-          return { host: book.host, open: open.slice(0, 50).map(trim), closed: closed.slice(0, 5).map(trim), openCount: open.length, closedCount: closed.length }
-        } catch { return { host: '', open: [], closed: [], openCount: 0, closedCount: 0 } }
-      })(),
+      issues: issuesState(raw),
 
-      // 遗留进程(v0.11.108):agent 在对话轮次里用后台方式起的 shell,轮次结束后挂到 pid 1 下继续跑。
-      // **必须在概览里看得见** —— 与预览服务 / 反馈本同一条道理:2026-10-09 在生产机翻出一条每 5 秒
-      // 打线上云函数的循环,零 CPU、零报警地跑了 35 天。走 30 秒 TTL 缓存(每次 /api/state 都问,ps 一次
-      // 几十毫秒,不必每次都跑)。⚠ **不下发完整 command**:它带 shell 快照路径、/tmp 落点等机器布局
-      // (零工具名约束),页面只需要 summary(agent 真正写的那条命令)+ 年龄 + pid。
-      // supported:false(Windows 没有 ps 也没有这套快照)⇒ rows 为空,前端一个字不出现。
-      leftovers: await (async () => {
-        try {
-          const r = await leftover.cachedList()
-          return { supported: !!r.supported, rows: (r.rows || []).map((x) => ({ pid: x.pid, ageSec: x.ageSec, age: x.age, summary: x.summary })), error: r.error || null }
-        } catch { return { supported: false, rows: [], error: null } }
-      })(),
+      leftovers: await leftoversState(),
 
       codexStatus: codexStatusCache ? { login: codexStatusCache.login, usage: codexStatusCache.usage } : null, // 前端加载回填,codex 卡片刷新不丢
       claudeStatus: claudeStatusCache ? claudeStatusCache.login : null, // 同上,Claude 订阅登录态
@@ -571,6 +610,8 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
         }
       })(),
     }
+    state.inbox = buildInboxFor(state, raw)
+    return state
   }
 
   async function testProvider(name, prompt) {
@@ -752,6 +793,7 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
         return
       }
       if (p === '/api/state' && req.method === 'GET') return sendJSON(res, 200, await buildState())
+      if (p === '/api/inbox' && req.method === 'GET') return sendJSON(res, 200, { inbox: await inboxOnly() })
       // Recent activity for the console to seed/merge on load + SSE reconnect (下一步 ②).
       // Lightweight + kept off /api/state so mutations don't re-ship it every write.
       if (p === '/api/activity' && req.method === 'GET') return sendJSON(res, 200, { activity: recentActivity() })
@@ -1606,6 +1648,14 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
           : '🔒 本群已恢复数据遮盖:回复里的手机号/邮箱将显示为遮盖标记')
         return sendJSON(res, 200, await buildState())
       }
+      // 「需要你处理」里忽略一条。只有失败轮次能忽略:其余几类各有自己的处理路径(反馈本标已处理、
+      // 结束进程、停预览),在这里「忽略」只会把还在的问题藏起来。只回收件箱,前端只重画这一块。
+      if (p === '/api/inbox/dismiss' && req.method === 'POST') {
+        const { key } = await body(req)
+        if (typeof key !== 'string' || !key.startsWith('failed:') || key.length > 300) return sendJSON(res, 400, { error: '这一条不能忽略' })
+        inboxDismiss.add(key)
+        return sendJSON(res, 200, { inbox: await inboxOnly() })
+      }
       // 群预览服务:手动停一个(概览「预览服务」区的停止按钮)。控制台停 ⇒ **发群一行告知**
       // (群成员可能正开着那个链接,悄悄拔掉会让人以为 bot 坏了);记录由这里写 —— 「谁杀谁写」。
       if (p === '/api/previews/stop' && req.method === 'POST') {

package/src/ui/takeover.js

@@ -73,6 +73,13 @@ function createTakeoverStore({ ttlMs = DEFAULT_TTL_MS, now = Date.now, onClaimed
     session(sid) { prune(); return sessions.get(String(sid || '')) || null },
     revokeSession(sid) { return endSession(String(sid || ''), 'ended') },
     revokeAll() { const n = sessions.size + links.size; for (const k of [...sessions.keys()]) endSession(k, 'ended'); for (const l of links.values()) if (l.timer) clearTimeout(l.timer); links.clear(); return n },
+    // 群里还挂着、没人来认领的票(控制台「需要你处理」用):只算挂了群卡的票 —— 那是 agent 在群里求助;
+    // 管理员自己在控制台签的没有卡,不算。只给元数据,不给令牌。
+    pending() {
+      prune()
+      return [...links.values()].filter((l) => !l.usedAt && l.meta && l.meta.chatId)
+        .map((l) => ({ id: l.id, at: l.at, exp: l.exp, chatId: l.meta.chatId, pageTitle: l.meta.pageTitle || '', pageUrl: l.meta.pageUrl || '' }))
+    },
     // 摘要(测试与排障用,不暴露令牌本身)
     stats() { prune(); return { links: links.size, unused: [...links.values()].filter((l) => !l.usedAt).length, sessions: sessions.size } },
   }