sintbot 1.4.7 → 1.4.8

package/src/upgrade.js

@@ -0,0 +1,58 @@
+// 版本升级群播报:发版部署重启后,各绑定群收到一条版本更新消息(此前升级群内无感)。
+// daemon 启动时对比 state 里记录的上个版本号,变了就用 CHANGELOG.json(与控制台
+// 「版本历史」同一事实源)的新增条目拼文案。纯函数,bin/sbot.js 接线;零依赖。
+
+// 产品在群成员面前的名字;顶层 `brand` 配置覆盖。⚠ 改默认值 = 替所有没配 `brand` 的部署改名。
+const DEFAULT_BRAND = 'SintBot'
+
+// "0.3.10" vs "0.3.9" 逐段数值比较(字符串比较会把 .10 排在 .9 前);非法段按 0。
+function cmpVersion(a, b) {
+  const pa = String(a || '').split('.').map((x) => parseInt(x, 10) || 0)
+  const pb = String(b || '').split('.').map((x) => parseInt(x, 10) || 0)
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) - (pb[i] || 0)
+  }
+  return 0
+}
+
+// 升级播报文案;无需播报返回 null:首次运行(无基线,播了像误报)/ 版本没变 / 降级(回滚
+// 不宣传)。列出 (last, current] 区间的全部版本条目 —— 跨多版升级不漏说,新版在前;
+// 条目只列标题(t),详情引导去控制台「版本历史」,群消息保持一屏内。
+function upgradeSpan(lastVersion, currentVersion, changelog = []) {
+  if (!lastVersion || !currentVersion) return null
+  if (cmpVersion(currentVersion, lastVersion) <= 0) return null
+  return (Array.isArray(changelog) ? changelog : []).filter((e) =>
+    e && cmpVersion(e.version, lastVersion) > 0 && cmpVersion(e.version, currentVersion) <= 0)
+}
+
+function buildUpgradeNotice(lastVersion, currentVersion, changelog = [], brand = DEFAULT_BRAND) {
+  const span = upgradeSpan(lastVersion, currentVersion, changelog)
+  if (!span) return null
+  const L = [`🚀 ${brand || DEFAULT_BRAND} 已升级:v${lastVersion} → v${currentVersion}`]
+  for (const e of span) {
+    L.push(`【v${e.version}${e.name ? ' · ' + e.name : ''}】`)
+    for (const it of e.items || []) if (it && it.t) L.push(`· ${it.t}`)
+  }
+  L.push('详情见控制台「设置 → 版本历史」')
+  return L.join('\n')
+}
+
+function buildUpgradeNoticeParts(lastVersion, currentVersion, changelog = [], brand = DEFAULT_BRAND) {
+  const span = upgradeSpan(lastVersion, currentVersion, changelog)
+  if (!span) return null
+  const one = span.length === 1 ? span[0] : null
+  const body = span.map((e) => [
+    `**v${e.version}${e.name ? ' · ' + e.name : ''}**`,
+    ...(e.items || []).filter((it) => it && it.t).map((it) => `· ${it.t}`),
+  ].join('\n')).join('\n\n')
+  return {
+    tone: 'upgrade',
+    title: `${brand || DEFAULT_BRAND} 已升级到 v${currentVersion}`,
+    subtitle: `v${lastVersion} → v${currentVersion}` +
+      (one && one.name ? ` · ${one.name}` : (span.length > 1 ? ` · 共 ${span.length} 个版本` : '')),
+    body,
+    footer: '详情见控制台「设置 → 版本历史」',
+  }
+}
+
+module.exports = { cmpVersion, upgradeSpan, buildUpgradeNotice, buildUpgradeNoticeParts, DEFAULT_BRAND }

package/src/upgradeannounce.js

@@ -0,0 +1,62 @@
+'use strict'
+
+// Startup upgrade announcement. After a version change each configured group
+// that is neither paused nor held receives one notice card (text where the
+// chat has no card capability), built from CHANGELOG.json like the console's
+// version history. First run and downgrades only record the baseline; so does
+// a start with the console's announcement preference turned off.
+//
+// The new baseline is recorded before anything is sent: a crash during the
+// broadcast loses the announcement instead of repeating it on the next start.
+// Every failure is logged per group and never reaches startup.
+const fs = require('node:fs')
+const path = require('node:path')
+const { cmpVersion } = require('./upgrade')
+const { deliverUpgradeNotice } = require('./platform/noticesend')
+const { redact } = require('./core/redact')
+
+function readChangelog(file = path.join(__dirname, '..', 'CHANGELOG.json')) {
+  try {
+    const value = JSON.parse(fs.readFileSync(file, 'utf8'))
+    return Array.isArray(value) ? value : []
+  } catch { return [] }
+}
+
+function announceUpgradeOnStart({ store, cfg = {}, platform, changelog = [], currentVersion,
+  heldGroups = [], log = () => {}, deliver = deliverUpgradeNotice } = {}) {
+  const skipped = state => ({ state, chats: [], done: Promise.resolve([]) })
+  let last
+  try {
+    last = store.getLastVersion()
+    if (!currentVersion || last === currentVersion) return skipped('unchanged')
+    store.setLastVersion(currentVersion)
+  } catch (error) {
+    // Without a durable baseline every restart would announce again.
+    log(`升级播报: 版本基线没有记下,本次不播报: ${error && error.message}`)
+    return skipped('baseline-failed')
+  }
+  if (!last) return skipped('first-run')
+  if (cmpVersion(currentVersion, last) <= 0) return skipped('downgrade')
+  if (cfg.ui?.announceUpdates === false) return skipped('disabled')
+  if (!platform) { log('升级播报: 平台未连接,本次不播报'); return skipped('no-platform') }
+  const held = new Set(heldGroups instanceof Map ? heldGroups.keys() : heldGroups)
+  const chats = []
+  const deliveries = []
+  for (const [chatId, g] of Object.entries(cfg.groups || {})) {
+    if (!g || g.paused || held.has(chatId)) continue // 暂停 = 别打扰;被挂起的群不发
+    chats.push(chatId)
+    deliveries.push(Promise.resolve()
+      .then(() => deliver(platform, chatId, last, currentVersion, changelog, cfg.brand,
+        { redact: s => redact(s, { pii: g.redactPii !== false }), log }))
+      .then(r => {
+        if (r && r.result == null) log(`升级播报未送达(${chatId}):平台确认没发出去`)
+        return { chatId, mode: r ? r.mode : null, delivered: !!(r && r.result != null) }
+      }, error => {
+        log(`升级播报(${chatId}): ${error && error.message}`)
+        return { chatId, mode: null, delivered: false }
+      }))
+  }
+  return { state: 'announced', chats, done: Promise.all(deliveries) }
+}
+
+module.exports = { announceUpgradeOnStart, readChangelog }