sintbot 1.0.15 → 1.3.0

package/src/core/interfaces.js

@@ -1,114 +0,0 @@
-// The two contracts the engine talks to. Keeping these explicit (even as
-// JSDoc) is what lets the core stay agnostic: it never references "feishu" or
-// "claudecode" by name, only these shapes. Adding a platform or an agent =
-// a new file that satisfies one of these — engine untouched.
-//
-// See DESIGN.md §2 (module boundaries) and §4 (subsystem detail).
-
-/**
- * A normalized event emitted by an AgentRunner turn.
- * @typedef {Object} AgentEvent
- * @property {'system'|'assistant'|'tool_result'|'result'|string} type
- * @property {string} [subtype]      - e.g. 'init' for system, 'success' for result
- * @property {string} [text]         - assistant text or final result text
- * @property {string} [thinking]     - assistant reasoning, when present
- * @property {Array<{name:string,input:any}>} [tools]   - tool_use blocks on an assistant event
- * @property {Array<any>} [results]  - tool_result blocks on a user event
- * @property {boolean} [isError]
- * @property {string} [transient]    - 出错结果上的一句群面人话,只在失败是服务端瞬时状况(过载 / 限流 / 网关错)时有;
- *                                    由 runner 判(src/agent/transienterr.js,两个 runner 共用一份签名表),引擎只负责
- *                                    显示它并附「过一会儿发一句「继续」」的下一步。`text` 仍留服务端原话 —— 账本的失败
- *                                    原因靠它对号,人话不能顶掉它。没有这个字段 = 不是瞬时错
- * @property {{kind:'quota'|'account', window:'weekly'|'session'|null}} [quota]
- *                                  - 出错结果是额度用尽(quota)或账号 / 登录态不可用(account)时有;由 runner 判
- *                                    (src/agent/quotaerr.js,两个 runner 共用),引擎据此自动切到 providers[*].fallback
- *                                    指定的备用模型(v0.11.107)。`text` 同样留原话。没有这个字段 = 不是这两类
- * @property {string} [sessionId]    - agent-side session id (used for --resume)
- * @property {any} [usage]
- * @property {boolean} [usageCumulative] - result usage is SESSION-cumulative, not per-turn
- *                                    (codex reports totals); the engine baselines it into
- *                                    a per-turn delta via the store — never ledger it raw
- * @property {number} [contextTokens] - size of the LAST request's input side (fresh +
- *                                    cache read + cache write) ≈ current context size;
- *                                    runners report it when their stream exposes it
- * @property {number} [preTokens]    - 压缩事件(system · subtype 含 compact)上:压缩前的上下文量,runner 从 CLI 的
- *                                    压缩元数据取。引擎优先用它报「此前上下文约 X」—— contextTokens 是上一条
- *                                    assistant 的 usage,尚未回给模型的工具结果不在里面,真机少报过 5 倍
- * @property {number} [postTokens]   - 同上,压缩后的量;有就一并报
- * @property {any} [raw]             - unrecognized event passthrough
- */
-
-/**
- * AgentRunner — drives an AI coding agent CLI. Two implementations, picked per
- * provider (the engine stays agnostic — it only ever calls `runner.runTurn`):
- *   src/agent/claudecode.js — Claude Code, model swapped via env (default backend).
- *   src/agent/codexcode.js  — OpenAI Codex CLI for GPT (provider.runner === 'codex';
- *                             DESIGN §1). Both spawn-per-turn over stream-json.
- *
- * @typedef {Object} RunTurnOptions
- * @property {string} prompt
- * @property {Object} provider                 - { baseUrl?, apiKey?, model?, env?, runner? } — runner:'codex' routes to codexcode (no baseUrl/apiKey; auth is the machine's `codex login`)
- * @property {string} [model]                  - per-turn override of provider.model
- * @property {string} [workdir]                - agent working directory (confinement)
- * @property {string} [sessionId]              - resume an existing agent session
- * @property {string} [permissionMode]
- * @property {number} [autocompactTokens]      - context ceiling: past it the CLI compacts in place (claude --autocompact / codex model_auto_compact_token_limit); 0/absent ⇒ CLI default (window-edge only)
- * @property {{mcp?: string[], skills?: string[]}} [plugins] - per-group plugin enablement; absent ⇒ runner default loading
- * @property {string} [appendSystemPrompt]     - appended to the agent's system prompt (NO_REPLY / sender-tag contract; keep ASCII-safe — travels as argv)
- * @property {Object} [extraEnv]                - non-provider env merged into the spawn (SBOT_*-namespaced, e.g. SBOT_CHAT_ID for the feishu base skill); both runners apply it
- * @property {(ev: AgentEvent) => void} [onEvent]
- *
- * @typedef {Object} RunTurnResult
- * @property {string|null} sessionId
- * @property {AgentEvent|null} result
- * @property {number} code
- *
- * interface AgentRunner {
- *   runTurn(opts: RunTurnOptions): Promise<RunTurnResult>
- * }
- */
-
-/**
- * Platform — a messaging platform adapter. M2 implementation: src/platform/feishu.js.
- *
- * interface Platform {
- *   start(onMessage: (msg: InboundMessage) => void,
- *         hooks?: { onRecall?: (r: {chatId: string, msgId: string}) => void }): Promise<void>
- *     // hooks.onRecall: platform saw an inbound message get RECALLED — engine drops it from
- *     // the queue / aborts the running solo turn (撤回即停). Optional; stubs may ignore it.
- *   reply(replyCtx, content: string): Promise<void>
- *   send(chatId: string, content: string): Promise<string|null|void>
- *     // resolves null when the platform confirmed the message was NOT delivered (API rejected /
- *     // network down); anything else (message_id / undefined) = delivered or not tracked.
- *     // Callers that must not lose a message (cron say / script-failure notice) key their retry on null.
- *   createStreamingCard?(replyCtx): Promise<StreamingCard>   // optional
- *   stop(): Promise<void>
- *   sendCard?(chatId, card): Promise<any>        // 静态卡片(各平台自己的形状;bin 侧按平台用)
- *   connHealth?(): object                        // 连接健康快照(控制台用)
- *   // 平台自描述(可选;engine 据此改写自知清单,core 不认识任何平台名):
- *   skillCmd?: string          // 基础技能命令名,默认 'sbot feishu';清单末尾整体替换
- *   chatLabel?: string         // 「飞书群」/「企业微信群」这类称呼,清单开头与短语里用
- *   features?: {               // 某项 === false ⇒ 清单不教它(教了 agent 就会去调不存在的动作)
- *     history?, editRecall?, react?, download?, boards?, imagen?, cardPinned?, plainSend?: boolean,
- *     mediaMarker?: 'path'     // 入站图片 / 文件已由平台落盘,标记里给的是本机路径(默认是「先下载」的坐标)
- *   }
- * }
- *
- * interface StreamingCard {
- *   update(text: string): void        // 累积全量文本(打字机);引擎已把 `>> ` 里程碑行换成 ▶
- *   finish(text: string, opts?: { milestones?: string[] }): Promise<void>
- *     // 收尾正文(已剔掉里程碑行)+ 本轮里程碑整批;平台可收进默认收起的折叠区,不认的平台忽略 opts 即可
- *   recall?(): Promise<boolean>       // 撤回整张卡(ack 后转静默);不支持就没有这个方法
- * }
- *
- * @typedef {Object} InboundMessage
- * @property {string} chatId
- * @property {string} userId
- * @property {string} text
- * @property {string} msgId
- * @property {Array<{key:string,name?:string}>} [images]
- * @property {number} createTimeMs
- * @property {any} replyCtx           - opaque token the platform uses to reply
- */
-
-module.exports = {} // types only; no runtime exports yet

package/src/core/issues.js

@@ -1,185 +0,0 @@
-// 群内反馈本(issue)—— 每台 sbot 一本,存在本机 `~/.sbot/issues.jsonl`。
-//
-// 为什么要有它:群成员(产品、运营、业务同事)是这套系统真正的使用者,但他们的反馈至今
-// 只能散在群消息里,靠 operator 事后翻聊天记录去捞 —— 2026-08-13 就丢过一次(4 条消息
-// 静默蒸发,靠用户贴截图才被发现)。给他们一个够得着的入口,反馈才不会蒸发。
-// ⚠ 与仓库托管平台上的 issue 无关,不同步、不关联:这是 sbot 自己的本地反馈本。
-//
-// 形态:**事件流 JSONL**,与 turns.jsonl / audit.jsonl 同族。open/close/reopen 各追加一行,
-// 读时按 id 折叠成当前态 —— 从不改写历史行(崩溃安全、无锁读、天然可审计:谁在什么时候
-// 关的、备注是什么,全留在文件里)。
-//
-// id 只在**本机**内递增(#7 这种短号,群里好念好报)。跨机汇总时用 `host` 字段区分,故
-// 两台各自编号撞车也不影响 —— 全局标识是 host + id,而群成员只在自己那台的语境里念它。
-
-const fs = require('node:fs')
-const path = require('node:path')
-const os = require('node:os')
-
-// 正文上限。⚠ 不是为了省空间(这本账一天几条),是防「顺手粘一整段日志/一屏报错」把
-// 单行撑到兆级 —— 而这本账是要被整本读进来做分析的,一条撑爆等于整本读不动。
-// 4000 字远超任何正常反馈的长度,截断处留标记,让人知道后面还有东西、别当成全文。
-const MAX_TEXT = 4000
-const TRUNC_MARK = '…(过长已截断)'
-
-// ── 纯逻辑(无 IO,可单测)──────────────────────────────────────────────────
-
-// 事件流 → 当前态。open 建档,close/reopen 只改状态与备注,其余字段一律以 open 那条为准
-// (后续事件不许改写正文 —— 反馈原话是证据,不能被后来的操作悄悄改掉)。
-// 未知 op 一律忽略:老版本读新文件时宁可少认几条,也不能整本读不出来。
-function foldEvents(events) {
-  const byId = new Map()
-  for (const e of events) {
-    if (!e || e.id == null) continue
-    if (e.op === 'open') {
-      byId.set(e.id, {
-        id: e.id,
-        ts: e.ts || 0,
-        chatId: e.chatId || null,
-        group: e.group || '',
-        sender: e.sender || '',
-        text: e.text || '',
-        version: e.version || '',
-        host: e.host || '',
-        turn: e.turn || null,
-        status: 'open',
-        note: '',
-        closedAt: 0,
-      })
-      continue
-    }
-    const cur = byId.get(e.id)
-    if (!cur) continue // close 一个不存在的 id:忽略(文件被截断/手工编辑过)
-    if (e.op === 'close') {
-      cur.status = 'closed'
-      cur.closedAt = e.ts || 0
-      if (e.note) cur.note = e.note
-    } else if (e.op === 'reopen') {
-      cur.status = 'open'
-      cur.closedAt = 0
-      if (e.note) cur.note = e.note
-    }
-  }
-  return [...byId.values()].sort((a, b) => a.id - b.id)
-}
-
-// 下一个本机序号。⚠ 取「历史最大 + 1」而不是「条数 + 1」:后者在文件被手工删过行之后
-// 会发出重复号,而重复号会让 close 打在错的那条上。
-function nextId(issues) {
-  let max = 0
-  for (const i of issues) if (typeof i.id === 'number' && i.id > max) max = i.id
-  return max + 1
-}
-
-// 正文规整:去首尾空白 + 封顶。截断只发生在超长时,正常反馈逐字保留(原话是证据)。
-function clampText(text) {
-  const s = String(text || '').trim()
-  return s.length > MAX_TEXT ? s.slice(0, MAX_TEXT) + TRUNC_MARK : s
-}
-
-// 解析一行 JSONL,坏行返回 null(整本不能因为一行坏掉就读不出来)。
-function parseLines(text) {
-  const out = []
-  for (const line of String(text || '').split('\n')) {
-    const s = line.trim()
-    if (!s) continue
-    try { out.push(JSON.parse(s)) } catch { /* 坏行跳过 */ }
-  }
-  return out
-}
-
-// 群里回执 / CLI 列表共用的单行摘要。⚠ 正文压成一行并截断 —— 反馈里常有换行,
-// 直接进列表会把一屏冲掉。
-function summarize(issue, { width = 60 } = {}) {
-  const t = String(issue.text || '').replace(/\s+/g, ' ').trim()
-  return t.length > width ? t.slice(0, width) + '…' : t
-}
-
-// 出问题那一轮的技术指纹 —— 这是整个反馈本最值钱的一个字段。
-// 群成员的原话通常是「它刚才没回我」,单靠这句没法查;带上那一轮的 status/耗时/token,
-// 一眼就能分辨「空轮」「超时」「模型报错」还是「它其实答了但没看见」。
-// ⚠ 只带指标不带**正常正文**:正文可能含群里的业务数据,而反馈本是要被跨机收集、集中分析的。
-// ⚠ **失败原因是例外,而且必须显示**:它不是业务正文,是「为什么没成」——「模型报错」这一类
-//   光看 status 只知道错了、不知道错在哪,拿到反馈的人还得再猜一遍(这正是本字段存在的理由)。
-//   ⭐ 只有在**上游保证 err 里装的是错误文本、不是模型的正常回答**时这条才成立(见 engine 的
-//   turnErrText:第一版就是拿正常正文冒充原因,那样带出去才真的破了上面那条规矩)。
-//   指纹是给人扫一眼的,故这里再收一次长度;全文在 `issue show` 里。
-function fingerprint(turn) {
-  if (!turn) return ''
-  const bits = []
-  if (turn.status) bits.push(turn.status)
-  if (turn.ms >= 0) bits.push(Math.round(turn.ms / 1000) + 's')
-  const tk = turn.tokens
-  if (tk) bits.push(`tokens{in:${tk.in ?? 0},out:${tk.out ?? 0}}`)
-  if (turn.provider) bits.push(turn.provider)
-  if (turn.err) bits.push(String(turn.err).replace(/\s+/g, ' ').trim().slice(0, 120))
-  return bits.join(' · ')
-}
-
-// ── 落盘层(薄壳)────────────────────────────────────────────────────────
-// withFileLock 从 store 注入而不是这里 require:core 里已有一份跨进程写锁实现,
-// 两份锁 = 两把不同的锁,等于没锁。
-
-function createIssues(file, { log = () => {}, withFileLock = (f, fn) => fn(), host = os.hostname().split('.')[0] } = {}) {
-  const readAll = () => {
-    try { return foldEvents(parseLines(fs.readFileSync(file, 'utf8'))) } catch { return [] }
-  }
-  const appendEvent = (ev) => {
-    fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 })
-    fs.appendFileSync(file, JSON.stringify(ev) + '\n', { mode: 0o600 }) // 反馈原文含群成员的话,同账本只给自己读
-  }
-  return {
-    file,
-    host,
-    // 新建。⚠ 「算号 + 追加」必须在同一把锁里:两个群同时提,分头算出的会是同一个号。
-    add({ chatId, group, sender, text, version, turn } = {}) {
-      let created = null
-      withFileLock(file, () => {
-        const id = nextId(readAll())
-        const ev = {
-          op: 'open',
-          id,
-          ts: Date.now(),
-          chatId: chatId || null,
-          group: group || '',
-          sender: sender || '',
-          text: clampText(text),
-          version: version || '',
-          host,
-          turn: turn || null,
-        }
-        appendEvent(ev)
-        created = { ...ev, status: 'open', note: '', closedAt: 0 }
-      })
-      return created
-    },
-    list({ all = false } = {}) {
-      const arr = readAll()
-      return all ? arr : arr.filter((i) => i.status === 'open')
-    },
-    get(id) {
-      return readAll().find((i) => i.id === Number(id)) || null
-    },
-    // close/reopen 返回**变更后**的那条(调用方要拿它的 chatId 去原群回一句)。
-    // 找不到 / 状态已经是目标态 ⇒ 返回 null,让调用方如实说「没这条」或「本来就是开着的」。
-    setStatus(id, op, note) {
-      const n = Number(id)
-      // 备注先验形再走 clampText:到得了这里的两个入口(CLI / 控制台 API)都是 operator 侧,
-      // 但 API 传来的可能不是字符串 —— 不拦就会以对象形态写进事件行,前端渲染时炸整页
-      // (整本账连坐);拦成 '[object Object]' 也一样是脏数据。非字符串一律当没写。
-      const clean = typeof note === 'string' ? clampText(note) : ''
-      let out = null
-      withFileLock(file, () => {
-        const cur = readAll().find((i) => i.id === n)
-        if (!cur) return
-        if (op === 'close' && cur.status === 'closed') return
-        if (op === 'reopen' && cur.status === 'open') return
-        appendEvent({ op, id: n, ts: Date.now(), note: clean })
-        out = { ...cur, status: op === 'close' ? 'closed' : 'open', note: clean || cur.note }
-      })
-      return out
-    },
-  }
-}
-
-module.exports = { createIssues, foldEvents, nextId, parseLines, summarize, fingerprint, clampText, MAX_TEXT }

package/src/core/ledger.js

@@ -1,30 +0,0 @@
-// Turn ledger — one JSONL line per finished turn, appended to disk:
-//   { ts, chatId, provider, sender, text, status, ms, tokens: { in, out, cr?, cw? }, err? }
-// err 只在 status 为 error/failed 时出现(v0.11.61):此前失败只记 status、一个字的原因都没有,
-// 而日志那边又没时间戳 ⇒ 线上失败事后无从查起。**字段缺席 = 旧行**,不是「这次没原因」。
-// tokens 是**本轮增量**(cr=缓存读 cw=缓存写,engine._settleUsage 归一;v0.11.17 前的旧行
-// claude 漏缓存、codex 记的是会话累计 —— 读历史数据时注意口径分界)。
-// The in-memory activity feed is just a view; this file is the durable record
-// and the data source for usage / cost accounting.
-// Best-effort by design: a ledger failure must never break a turn.
-
-const fs = require('node:fs')
-const path = require('node:path')
-
-function createLedger(file, log = () => {}) {
-  let dirReady = false
-  return {
-    file,
-    append(rec) {
-      try {
-        if (!dirReady) { fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 }); dirReady = true }
-        // 账本里有发送者和消息正文:新建时只给自己读写(mode 只在创建时生效,旧文件由 core/datadir 启动时收紧)
-        fs.appendFile(file, JSON.stringify(rec) + '\n', { mode: 0o600 }, (e) => { if (e) log('ledger append failed: ' + e.message) })
-      } catch (e) {
-        log('ledger append failed: ' + (e && e.message))
-      }
-    },
-  }
-}
-
-module.exports = { createLedger }

package/src/core/opsalert.js

@@ -1,214 +0,0 @@
-// 运维告警(operator alert)—— 模型账号 / 额度类故障发到专用告警群,让 operator 第一时间知道。
-//
-// 为什么要做:账号被停 / 登录态刷新失败 / 额度用尽,此前只在**出事的那个群**里说一句(错误卡或自动切换的
-// 通知),operator 不在那个群就一无所知。2026-09-25 OAuth 过期 6 轮静默失败 10 小时、09-27 账号 on hold、
-// 10-05 周额度被别人用光 —— 三次都是事后翻日志才知道。账号类异常更是「会不会被封」的最早信号,必须有人立刻看到。
-//
-// 分工(与 quotaalert 同款):本模块只做**文案 + 去重判定**,不碰 IO、不认平台;引擎在事发点吐结构化事件
-// (onAlert 钩子),bin 接线把文案发到 `alerts.chatId`。core 不认 runner 名、不碰错误原话以外的东西。
-//
-// 事件形状(引擎吐的):
-//   { kind:'provider-down', provider, cause:'account'|'quota', window:'weekly'|'session'|null, until:ms|null,
-//     chatId?, source:'turn'|'probe', detail? }   —— 某模型不可用(出错轮判出来的 / 额度探针判出来的)
-//   { kind:'provider-up',   provider }                                    —— 探针确认恢复(之前标过不可用)
-//   { kind:'failover', chatId, from, to, home, cause, until, back }       —— 某群自动切换(back=true 是切回)
-//   { kind:'platform-down', platform, downMs, detail }                     —— 某平台长连接断开超过宽限期(createConnWatch 吐)
-//   { kind:'platform-up',   platform, downMs }                             —— 报过中断的平台重连上了
-//   { kind:'platform-issue', platform, issue:'kicked'|'auth-expired'|'tool-gated', detail } —— 平台侧需要人处理的事:被另一台机器挤掉已停连 / 工具能力授权过期 / 读群历史被企业规模门控(853006)
-//
-// 去重:账号 / 额度类故障每个模型每小时最多一条(每轮都失败就每轮都报 = 刷屏);「已恢复」只在报过故障之后才报;
-// 切换按群 + 目标 10 分钟一条(两边都没额度时来回切,别把告警群也刷满);平台中断按平台一小时一条,恢复同模型的规矩。
-// ⚠ 文案是群面文字:零工具名、零机器路径(规则见 CONTRIBUTING.md「用户面零工具名」),单测钉死。
-// ⚠ core 不认平台名:platform 只是个字串,中文名(飞书 / 企业微信)由 bin 经 createSink 的 platformLabels 注入。
-
-const DOWN_COOLDOWN_MS = 60 * 60_000
-const FAILOVER_COOLDOWN_MS = 10 * 60_000
-const CONN_GRACE_MS = 5 * 60_000
-const DETAIL_MAX = 160
-
-// 去重闸:同键在冷却期内只放行一次。内存态即可 —— daemon 重启后同一故障再报一次反而是对的(故障还在)。
-function createGate(now = () => Date.now()) {
-  const last = new Map()      // key → 上次放行时刻
-  const downSent = new Set()  // 报过故障的模型:只有它们的「已恢复」才值得说
-  function allow(ev) {
-    if (!ev || !ev.kind) return false
-    const t = now()
-    if (ev.kind === 'provider-down') {
-      const k = `down:${ev.provider}:${ev.cause}`
-      if (last.has(k) && t - last.get(k) < DOWN_COOLDOWN_MS) return false // ⚠ 没发过要用 has 判,不能拿 0 当「很久以前」(小时钟下会把首条压掉)
-      last.set(k, t); downSent.add(ev.provider); return true
-    }
-    if (ev.kind === 'provider-up') {
-      if (!downSent.has(ev.provider)) return false
-      downSent.delete(ev.provider)
-      for (const k of [...last.keys()]) if (k.startsWith(`down:${ev.provider}:`)) last.delete(k) // 恢复后再出事要立刻能报
-      return true
-    }
-    if (ev.kind === 'failover') {
-      const k = `failover:${ev.chatId}:${ev.to}`
-      if (last.has(k) && t - last.get(k) < FAILOVER_COOLDOWN_MS) return false
-      last.set(k, t); return true
-    }
-    // 平台连接中断:键带 `conn:` 前缀 —— 与模型的 `down:` 分开,名字撞上(某 provider 恰好叫 feishu)也不会互相压掉。
-    if (ev.kind === 'platform-down') {
-      const k = `conn:${ev.platform}`
-      if (last.has(k) && t - last.get(k) < DOWN_COOLDOWN_MS) return false
-      last.set(k, t); downSent.add(`conn:${ev.platform}`); return true
-    }
-    if (ev.kind === 'platform-up') {
-      if (!downSent.has(`conn:${ev.platform}`)) return false
-      downSent.delete(`conn:${ev.platform}`)
-      last.delete(`conn:${ev.platform}`) // 恢复后再断、再过宽限期,要能立刻报,不受上一次的小时冷却影响
-      return true
-    }
-    // 平台侧要人处理的事(被挤掉已停连 / 工具授权过期):按平台 + 事由每小时一条 —— 授权过期时每次轮询都会撞到,不压就是刷屏
-    if (ev.kind === 'platform-issue') {
-      const k = `issue:${ev.platform}:${ev.issue}`
-      if (last.has(k) && t - last.get(k) < DOWN_COOLDOWN_MS) return false
-      last.set(k, t); return true
-    }
-    return false
-  }
-  return { allow }
-}
-
-// 时长人话:「不到 1 分钟」/「约 N 分钟」/「约 H 小时 M 分钟」。自带「约」,拼文案时别再加。
-function humanDur(ms) {
-  const m = Math.round(Math.max(0, Number(ms) || 0) / 60_000)
-  if (m < 1) return '不到 1 分钟'
-  if (m < 60) return `约 ${m} 分钟`
-  const h = Math.floor(m / 60), r = m % 60
-  return `约 ${h} 小时${r ? ` ${r} 分钟` : ''}`
-}
-
-// 平台长连接的中断观察:看门狗每次状态变化调 note(platform, snapshot),这里判「断开持续超过宽限期」才吐事件。
-//
-// 为什么要宽限期:机器断电重启后开机头两分钟 DNS 未就绪,两个平台都先报 ENOTFOUND 再自愈(10-11 真机)——
-// 没有宽限每次重启都是一条假告警;默认 5 分钟,比看门狗自己的退避重建周期宽得多。
-// 为什么要做:两台机互相探活只看控制台 HTTP 200,平台订阅一直失败(凭据被吊销 / 被另一条连接反复踢 / DNS 长期不通)
-// 时 daemon 活着、控制台绿着,没人知道群消息其实收不到。
-// 依赖全注入(now / setTimer / clearTimer)所以能用假时钟单测;本模块不碰 IO,事件交给 onAlert(= createSink 产物)。
-function createConnWatch({ now = () => Date.now(), setTimer = setTimeout, clearTimer = clearTimeout, graceMs = CONN_GRACE_MS, onAlert = () => {}, log = () => {} } = {}) {
-  const st = new Map() // platform → { downSince, timer, reported, lastError }
-  const get = (p) => { if (!st.has(p)) st.set(p, { downSince: null, timer: null, reported: false, lastError: '' }); return st.get(p) }
-  const disarm = (r) => { if (r.timer) { try { clearTimer(r.timer) } catch {} r.timer = null } }
-  const emit = (ev) => { try { onAlert(ev) } catch (e) { log('平台连接告警处理失败(忽略): ' + (e && e.message)) } }
-
-  function fire(platform) {
-    const r = get(platform)
-    r.timer = null
-    if (r.downSince == null || r.reported) return // connected 已撤过 / 已报过(防御:定时器照理此时已被撤)
-    r.reported = true
-    emit({ kind: 'platform-down', platform, downMs: now() - r.downSince, detail: r.lastError })
-  }
-
-  function note(platform, snap) {
-    if (!platform || !snap || !snap.state) return
-    const r = get(platform)
-    if (snap.state === 'connected') {
-      disarm(r)
-      if (r.reported) emit({ kind: 'platform-up', platform, downMs: now() - (r.downSince == null ? now() : r.downSince) })
-      r.downSince = null; r.reported = false; r.lastError = ''
-      return
-    }
-    if (snap.state === 'stopped') { disarm(r); r.downSince = null; r.reported = false; return } // daemon 关停,不是故障
-    // connecting / reconnecting / failed 都算断开态;只在**进入**断开态那一刻起计时,之后的状态抖动不重置、不重复起表
-    if (snap.lastError) r.lastError = String(snap.lastError)
-    if (r.downSince == null) r.downSince = now()
-    if (!r.timer && !r.reported) {
-      r.timer = setTimer(() => fire(platform), graceMs)
-      if (r.timer && typeof r.timer.unref === 'function') r.timer.unref() // 观察用定时器不该拖住进程退出
-    }
-  }
-
-  function stop() { for (const r of st.values()) disarm(r) }
-  return { note, stop }
-}
-
-const windowLabel = (w) => (w === 'weekly' ? '一周' : w === 'session' ? '5 小时' : '')
-const causeLabel = (c) => (c === 'account' ? '账号不可用' : '额度用完')
-
-// 事件 → 告警正文 | ''。ctx:{ instance(这台机器怎么自称) · groupName(事发群名,可空) · when(距重置的人话,可空) }
-function alertText(ev, ctx = {}) {
-  if (!ev || !ev.kind) return ''
-  const where = ctx.instance ? `${ctx.instance} · ` : ''
-  const group = ctx.groupName ? `群「${ctx.groupName}」` : (ev.chatId ? '某个群' : '')
-  if (ev.kind === 'provider-down') {
-    if (ev.cause === 'account') {
-      // ⚠ 不把服务端原话(ev.detail)贴进群:原话里有「Claude Code」「/login」这类产品名 / 命令(v0.11.107 定的口径
-      //    「英文原话只进账本」);原话由接线层写进日志,排查看日志。
-      const lines = [`🚨 【模型账号异常】${where}${ev.provider}`]
-      lines.push(ev.source === 'probe' ? '额度探针读到登录态不可用' : `${group || '有群'}的一轮因账号不可用失败`)
-      lines.push('请尽快检查该模型的登录态与账号状态;配了备用模型的群会自动切换,没配的群每轮都会失败。')
-      return lines.join('\n')
-    }
-    const win = windowLabel(ev.window)
-    const head = `⏳ 【模型额度用完】${where}${ev.provider}${win ? `(${win}窗口)` : ''}${ctx.when ? ` · ${ctx.when}重置` : ''}`
-    const src = ev.source === 'probe' ? '额度探针读到已到上限' : `${group || '有群'}的一轮因额度用完失败`
-    return `${head}\n${src};配了备用模型的群会自动切换并到点切回。`
-  }
-  if (ev.kind === 'provider-up') return `✅ 【模型已恢复】${where}${ev.provider} 可以正常使用了`
-  if (ev.kind === 'platform-issue') {
-    const label = (ctx.platformLabels && ctx.platformLabels[ev.platform]) || ev.platform || '平台'
-    // ⚠ 事由只给人话,不给服务端 / 工具原话(原话有命令名、链接;原话进日志)
-    if (ev.issue === 'kicked') return `🔌 【${label}连接被挤掉】${where}另一台机器用同一个机器人登录,10 分钟内第二次被踢下线,本机已停止重连\n请检查是不是两台机器配了同一个机器人(每台各建各的);处理完后重启守护进程才会重新连接。`
-    if (ev.issue === 'tool-gated') return `🚧 【${label}读群历史未开放】${where}官方命令行工具回「本企业不可用」(853006):读群历史这项能力官方按企业规模门控,不是配置错\n「不 @ 也回复」已暂停半小时后再试,@ 它仍正常;群里不 @ 的话它看不见,要连着聊就私聊它。`
-    if (ev.issue === 'auth-expired') return `🔑 【${label}工具授权过期】${where}官方命令行工具的能力授权(每 7 天一续)已过期\n群里会暂时查不到成员姓名、发不了图和文件、「不 @ 也回复」停摆;请机器人创建者在企业微信里点续期链接(日志里有),续完自动恢复。`
-    return ''
-  }
-  if (ev.kind === 'platform-down' || ev.kind === 'platform-up') {
-    // 平台中文名由接线层注入(core 不认平台名);查不到就直接用字串。⚠ lastError(ENOTFOUND / 853000 这类网络 / 服务端
-    //    原话)在 ev.detail 里,只进日志不进群 —— 与模型账号异常同一口径。
-    const label = ctx.platformLabel || ev.platform || '平台'
-    if (ev.kind === 'platform-up') return `✅ 【平台连接恢复】${where}${label}:中断${humanDur(ev.downMs)}后已重连`
-    return `📡 【平台连接中断】${where}${label}:已断开${humanDur(ev.downMs)}\n这段时间该平台的群消息收不到也发不出;会一直自动重连,持续不恢复请检查网络与机器人凭据。`
-  }
-  if (ev.kind === 'failover') {
-    if (ev.back) return `🔄 【已切回】${where}${group || '有群'}:${ev.from} → ${ev.to}(原模型已恢复)`
-    const tail = ev.home && ev.to !== ev.home ? (ctx.when ? `,${ctx.when}切回 ${ev.home}` : `,${ev.home} 恢复后切回`) : ''
-    return `🔄 【自动切换】${where}${group || '有群'}:${ev.from} → ${ev.to}(${causeLabel(ev.cause)})${tail}`
-  }
-  return ''
-}
-
-// 错误原话截断成一行(只进日志;引擎给的 detail 已脱敏,这里只管长度与换行)
-function clip(s) {
-  const t = String(s || '').replace(/\s+/g, ' ').trim()
-  if (!t) return ''
-  return t.length > DETAIL_MAX ? t.slice(0, DETAIL_MAX - 1) + '…' : t
-}
-
-// 接线层(bin 用):事件 → 闸 → 文案 → 发到 alerts.chatId。依赖全注入,所以能单测;IO 只有 send 与 log。
-//   getCfg()      → 当前配置(热重载后要读新的 alerts.chatId / groups / instance,所以是函数不是值)
-//   getPlatform() → 平台对象(可能还没建好 ⇒ null;要有 send(chatId, text))
-//   humanReset(ms)→ 「约 N 后」(与额度告警同一份措辞,由调用方注入,core 内不互相 require 成环)
-//   fallbackInstance → 配置没写 instance 时这台机器怎么自称(主机名)
-//   platformLabels → { 平台名: 中文名 }(平台连接告警用;core 不认平台名,所以由 bin 注入)
-// 返回 onAlert(ev):同步、永不抛(抛了只记日志 —— 它挂在轮次结算路上)。
-// ⚠ 平台连接告警经同一个 platform.send 发出,而 send 是路由器按告警群归属分发 —— 若断的恰是告警群所在平台,
-//    这条告警必然发不出去(落到下面的 catch 只记日志)。这是预期:它能报的是「另一个平台断了」,本平台断了靠对端机探活。
-function createSink({ getCfg, getPlatform, gate = createGate(), log = () => {}, humanReset = () => '', fallbackInstance = '', platformLabels = {} }) {
-  return function onAlert(ev) {
-    try {
-      const cfg = (typeof getCfg === 'function' && getCfg()) || {}
-      const a = cfg.alerts
-      const to = a && a.chatId != null ? String(a.chatId).trim() : ''
-      const platform = typeof getPlatform === 'function' ? getPlatform() : null
-      if (!to || !platform || typeof platform.send !== 'function') return false
-      if (!gate.allow(ev)) return false
-      const g = ev.chatId ? (cfg.groups || {})[ev.chatId] : null
-      const when = typeof ev.until === 'number' && ev.until > Date.now() ? humanReset(ev.until - Date.now()) : ''
-      const platformLabel = ev.platform ? ((platformLabels || {})[ev.platform] || ev.platform) : ''
-      const text = alertText(ev, { instance: cfg.instance || fallbackInstance, groupName: g && g.name, when, platformLabel })
-      if (!text) return false
-      const d = clip(ev.detail)
-      // Platform 契约:send 对「平台确认没送出去」resolve null 而不抛(企微主动推送被拒就是这形态)⇒ null 也要当失败记,否则日志写「已发」而群里没有
-      Promise.resolve(platform.send(to, text))
-        .then((r) => log(r === null ? `运维告警发送失败(${ev.kind}):平台确认未送达` : `运维告警已发:${ev.kind} ${ev.provider || ev.platform || ev.to || ''}${d ? ' — ' + d : ''}`))
-        .catch((e) => log(`运维告警发送失败(${ev.kind}): ` + (e && e.message)))
-      return true
-    } catch (e) { log('运维告警处理失败(忽略): ' + (e && e.message)); return false }
-  }
-}
-
-module.exports = { createGate, alertText, createSink, createConnWatch, humanDur, DOWN_COOLDOWN_MS, FAILOVER_COOLDOWN_MS, CONN_GRACE_MS }