sintbot 1.3.0 → 1.4.1

package/src/ui/dashboard.js

@@ -0,0 +1,168 @@
+'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, update = null, takeovers = [], groups = {}, dismissed = new Set(), now = Date.now() } = {}) {
+  const items = []
+  if (update && update.available && update.latestVersion) {
+    items.push({ key: `update:${update.latestVersion}`, kind: 'update', from: update.currentVersion || '', to: update.latestVersion, ts: update.checkedAt || now, dismissable: true })
+  }
+  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/feishulogin.js

@@ -0,0 +1,136 @@
+'use strict'
+// 控制台「用飞书登录」—— 标准 OAuth 2.0 授权码流程的纯逻辑(可测,不碰 http 服务)。
+//
+// 流程:登录页按钮 → GET /api/auth/feishu/start(签发一次性 state,302 到飞书授权页)
+//       → 飞书回调 GET /api/auth/feishu/callback?code&state(校验 state → 换 access_token
+//       → 取 open_id → 对照管理员名单 → 签发控制台会话 → 回一页 HTML 把令牌写进浏览器再跳回首页)。
+//
+// 只放行配置里管理员名单(feishu.admins[].openId)里的人 —— 名单本来就是「谁能替这台机器说话」,
+// 登录复用同一份名单,不另起一套账号。open_id 按应用算,两台机器各自的应用各自的名单,天然分开。
+//
+// ⚠ 回调地址必须是公网 HTTPS 且在开放平台「安全设置 → 重定向 URL」里预先登记(飞书侧校验),
+//    所以入口只在配置了 ui.publicUrl 之后才出现;局域网访问继续用密码登录。
+// ⚠ 这里的 HTML 是用户可见文案:零工具名、零机器路径。
+
+const crypto = require('node:crypto')
+
+const AUTHORIZE_URL = 'https://accounts.feishu.cn/open-apis/authen/v1/authorize'
+const TOKEN_URL = 'https://accounts.feishu.cn/oauth/v3/token' // v2 已标废弃,文档推荐 v3
+const USERINFO_URL = 'https://open.feishu.cn/open-apis/authen/v1/user_info'
+const CALLBACK_PATH = '/api/auth/feishu/callback'
+const START_PATH = '/api/auth/feishu/start'
+const FETCH_TIMEOUT_MS = 10_000
+
+// 公网地址只认 https://host[:port],其余(路径 / 查询 / http / 空)一律不认 —— 回调地址由它拼出来,
+// 拼错一段飞书就会报「重定向 URL 不匹配」,与其让人猜不如在存的时候就挡住。
+function normalizePublicUrl(s) {
+  const t = String(s || '').trim()
+  if (!t) return null
+  let u
+  try { u = new URL(t) } catch { return null }
+  if (u.protocol !== 'https:') return null
+  if (!u.hostname) return null
+  if (u.username || u.password) return null
+  return `https://${u.host}` // host 含端口(非默认时)
+}
+
+const redirectUri = (publicUrl) => `${publicUrl}${CALLBACK_PATH}`
+
+function buildAuthorizeUrl({ appId, redirectUri: ru, state }) {
+  const q = new URLSearchParams({ client_id: appId, redirect_uri: ru, response_type: 'code', state })
+  return `${AUTHORIZE_URL}?${q.toString()}`
+}
+
+// 一次性 state:防 CSRF(回调必须带我们签发过的 state,且只能用一次)。带 TTL 与上限,
+// 免得有人狂刷 /start 把内存撑爆 —— 满了就淘汰最早的。
+// ⚠ 上限不能太小:淘汰最早的 = 攻击者在别人「点按钮 → 授权 → 回调」那十几秒里刷满,就把别人的 state
+//    挤掉、登录恒失败(对抗审查 🟡)。一条 state 约 60 字节,一万条不到 1MB,门槛抬 50 倍。
+function createStateStore({ ttlMs = 10 * 60_000, max = 10_000, now = Date.now, random = () => crypto.randomBytes(16).toString('hex') } = {}) {
+  const pending = new Map() // state -> issuedAt
+  const prune = () => { const t = now(); for (const [k, at] of pending) if (t - at > ttlMs) pending.delete(k) }
+  return {
+    issue() {
+      prune()
+      while (pending.size >= max) pending.delete(pending.keys().next().value)
+      const s = random(); pending.set(s, now()); return s
+    },
+    consume(state) {
+      prune()
+      if (!state || !pending.has(state)) return false
+      pending.delete(state); return true
+    },
+    get size() { prune(); return pending.size },
+  }
+}
+
+// 网络层的错都翻成人话:超时 / 连不上 各一句,别把英文 AbortError 直接摆到登录失败页上。
+async function fetchJson(fetchImpl, url, init) {
+  const ac = new AbortController()
+  const timer = setTimeout(() => ac.abort(), FETCH_TIMEOUT_MS)
+  try {
+    let r
+    try { r = await fetchImpl(url, { ...init, signal: ac.signal }) } catch (e) {
+      throw new Error(e && e.name === 'AbortError' ? `连接飞书超时(${FETCH_TIMEOUT_MS / 1000} 秒)` : `连不上飞书:${(e && e.message) || e}`)
+    }
+    let j = null
+    try { j = await r.json() } catch { j = null }
+    return { status: r.status, json: j }
+  } finally { clearTimeout(timer) }
+}
+
+// 授权码 → user_access_token。成功形状 {code:0, access_token, ...};失败 {code:2xxxx, error, error_description}。
+async function exchangeCode({ fetchImpl = globalThis.fetch, appId, appSecret, code, redirectUri: ru }) {
+  const { status, json } = await fetchJson(fetchImpl, TOKEN_URL, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json; charset=utf-8' },
+    body: JSON.stringify({ grant_type: 'authorization_code', client_id: appId, client_secret: appSecret, code, redirect_uri: ru }),
+  })
+  if (!json || typeof json !== 'object') throw new Error(`飞书没有返回有效响应(HTTP ${status})`)
+  if (json.code !== 0 || !json.access_token) {
+    const why = json.error_description || json.error || json.msg || `code ${json.code}`
+    throw new Error(`飞书拒绝了这次授权:${why}`)
+  }
+  return { accessToken: String(json.access_token) }
+}
+
+// user_access_token → 这个人在本应用下的 open_id 与姓名(不需要额外 scope)。
+async function fetchUserInfo({ fetchImpl = globalThis.fetch, accessToken }) {
+  const { status, json } = await fetchJson(fetchImpl, USERINFO_URL, { method: 'GET', headers: { Authorization: `Bearer ${accessToken}` } })
+  const d = json && json.data
+  if (!json || json.code !== 0 || !d || !d.open_id) throw new Error(`取不到飞书身份(HTTP ${status}${json && json.msg ? ' · ' + json.msg : ''})`)
+  return { openId: String(d.open_id), name: String(d.name || d.en_name || ''), unionId: d.union_id ? String(d.union_id) : '' }
+}
+
+// 名单匹配:精确、区分大小写(open_id 是不透明标识符,不做任何「宽容」)。
+function adminMatch(admins, openId) {
+  if (!openId || !Array.isArray(admins)) return null
+  return admins.find((a) => a && a.openId === openId) || null
+}
+
+const escHtml = (s) => String(s == null ? '' : s).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]))
+
+// 回调落地页:成功 → 把令牌写进浏览器存储再回首页;失败 → 说人话并给回登录页的链接。
+// 令牌只经这页的脚本落地,不进 URL、不进日志。样式跟随系统深浅色,不依赖控制台的 CSS。
+function loginResultHtml({ ok, token = '', name = '', message = '' }) {
+  const tok = /^[0-9a-f]{16,128}$/.test(String(token)) ? String(token) : ''
+  const body = ok && tok
+    ? `<p class="t">登录成功${name ? ',' + escHtml(name) : ''}</p><p class="s">正在进入控制台…</p>
+<script>try{localStorage.setItem('sbot-token','${tok}');sessionStorage.setItem('sbot-token','${tok}')}catch(e){}location.replace('/')</script>`
+    : `<p class="t">没能登录</p><p class="s">${escHtml(message || '未知原因')}</p><p class="s"><a href="/">回到登录页</a></p>`
+  return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>SintBot 控制台</title>
+<style>:root{color-scheme:light dark}body{margin:0;min-height:100vh;display:flex;align-items:center;justify-content:center;font:14px/1.6 -apple-system,BlinkMacSystemFont,"PingFang SC","Microsoft YaHei",sans-serif;background:#f6f6f7;color:#1c1c1e}@media(prefers-color-scheme:dark){body{background:#1e1e2e;color:#cdd6f4}}main{padding:28px 32px;border-radius:14px;background:rgba(127,127,127,.08);text-align:center}.t{font-size:16px;font-weight:600;margin:0 0 6px}.s{margin:0;opacity:.75}a{color:inherit}</style></head><body><main>${body}</main></body></html>`
+}
+
+// 入口能不能亮:三样都齐才亮(缺一样就在设置页说清缺哪样,登录页不出按钮)。
+function feishuLoginReadiness({ publicUrl, appId, appSecret, admins }) {
+  if (!normalizePublicUrl(publicUrl)) return { ready: false, why: '未填公网地址' }
+  if (!appId || !appSecret) return { ready: false, why: '未配置飞书应用凭证' }
+  if (!Array.isArray(admins) || !admins.some((a) => a && a.openId)) return { ready: false, why: '管理员名单为空(只有名单里的人能登录)' }
+  return { ready: true, why: '' }
+}
+
+module.exports = {
+  AUTHORIZE_URL, TOKEN_URL, USERINFO_URL, CALLBACK_PATH, START_PATH,
+  normalizePublicUrl, redirectUri, buildAuthorizeUrl, createStateStore,
+  exchangeCode, fetchUserInfo, adminMatch, loginResultHtml, feishuLoginReadiness, escHtml,
+}