koishi-plugin-kkk 1.0.0

package/src/karin/module/utils/parseTip.ts

@@ -0,0 +1,59 @@
+/**
+ * 解析开始时的提示语。
+ *
+ * **为什么要单独一个文件**：这个函数原来放在 QqPanel 里，而 QqPanel 又依赖平台模块；
+ * 平台模块反过来调用 sendParseTip → 形成循环 import，打包后函数绑定还没初始化，
+ * 调用时直接报 `(0 , module_1.sendParseTip) is not a function`（快手整个解析挂掉就是这个原因）。
+ * 这里只依赖 Config / ParseOverride / 基础段，彻底断开环。
+ */
+import { segment, type Message } from 'node-karin'
+
+import { getParseOverride } from './ParseOverride'
+
+/** 阶段登记用的固定 key（同一时间只可能有一个解析在跑） */
+const STAGE_KEY = 'parse'
+import { Config } from './Config'
+
+/** 撤回上一条机器人消息（拿不到就忽略） */
+const recallPrevious = async (e: Message, content: any): Promise<void> => {
+  try {
+    const target: any = e as any
+    const bot: any = target?.bot?.bot ?? target?.bot
+    // 尽量撤掉上一条：群里的提示只留最新的一条
+    const last: any = (target as any)?.__kkkLastPanelMessage
+    if (last && typeof bot?.recallMsg === 'function') {
+      await bot.recallMsg(last, String(target?.contact?.peer ?? target?.channelId ?? ''))
+    }
+  } catch { /* 撤回失败无所谓 */ }
+  await e.reply(content)
+}
+
+/**
+ * 解析开始时的提示语 —— 两种来源说两句话：
+ *   - **面板按钮点出来的**：画质面板刚发过，这里只回「收到请求，开始下载」
+ *   - 手工发链接的：仍然是「检测到 XX 链接，开始解析」
+ */
+export const sendParseTip = async (e: Message, platformName: string): Promise<void> => {
+  /**
+   * 登记一个「正在获取下载链接」的阶段。
+   * 用户在「收到请求，开始下载」刚出现时点「查询下载进度」，这时还没开始传字节，
+   * 以前只会显示「当前没有正在进行的下载」，很误导 —— 现在能看到真实阶段。
+   * 真正开始下载时 Downloader 会清掉这个阶段条目。
+   */
+  try {
+    const { reportDownloadStage } = await import('./Network/Downloader')
+    reportDownloadStage(STAGE_KEY, platformName + '解析', '正在获取下载链接')
+  } catch { /* 观测失败不影响解析 */ }
+
+  const fromPanel = getParseOverride()?.fromPanel === true
+  if (fromPanel) {
+    await recallPrevious(e, '收到请求，开始下载')
+    return
+  }
+  if (Config.app.parseTip) {
+    await recallPrevious(e, '检测到' + platformName + '链接，开始解析')
+  }
+}
+
+/** 兼容：某些地方可能还需要 markdown 段 */
+export const parseTipSegment = () => segment

package/src/karin/module/utils/runtime-report.ts

@@ -0,0 +1,142 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+
+import type { RuntimeReportData } from '@template/template/other/runtime/components/types'
+import { isDocker, logs, type Message } from 'node-karin'
+
+import { Root } from '../../root'
+import { formatBuildTime, getBuildMetadata } from './build-metadata'
+import { Config } from './Config'
+import { formatBytes } from './Network/helpers'
+
+type PluginPackageMetadata = typeof Root.pkg & {
+  karin?: {
+    engines?: string
+  }
+}
+
+/**
+ * 将秒数格式化为适合诊断海报展示的紧凑时长。
+ *
+ * @param seconds 原始秒数
+ * @returns 例如 `2天 6小时 18分钟`
+ */
+const formatDuration = (seconds: number): string => {
+  if (!Number.isFinite(seconds) || seconds < 0) return '未知'
+
+  const totalMinutes = Math.floor(seconds / 60)
+  const days = Math.floor(totalMinutes / 1440)
+  const hours = Math.floor((totalMinutes % 1440) / 60)
+  const minutes = totalMinutes % 60
+
+  if (days > 0) return `${days}天 ${hours}小时 ${minutes}分钟`
+  if (hours > 0) return `${hours}小时 ${minutes}分钟`
+  if (minutes > 0) return `${minutes}分钟`
+  return `${Math.floor(seconds)}秒`
+}
+
+/**
+ * 从随包发布的 CHANGELOG 中提取指定数量的本地版本记录。
+ * 读取失败时返回空字符串，让调用方决定降级展示或抛出错误。
+ *
+ * @param length 需要提取的版本数量
+ */
+export const getLocalChangelog = (length: number): string => {
+  try {
+    const changelogPath = path.join(Root.pluginPath, 'CHANGELOG.md')
+    const changelogContent = fs.readFileSync(changelogPath, 'utf8')
+    return logs({
+      version: Root.pluginVersion,
+      data: changelogContent,
+      length
+    })
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * 采集 `#kkk版本` 使用的安全运行环境快照。
+ *
+ * 不采集账号、主机名、用户目录、网络地址、环境变量内容、启动参数或适配器鉴权信息，
+ * 保证该命令在群聊中触发时不会把机器身份和凭据写入图片。
+ *
+ * @param event 当前消息事件
+ */
+export const collectRuntimeReport = (event: Message): RuntimeReportData => {
+  const packageMetadata = Root.pkg as PluginPackageMetadata
+  const adapter = event.bot.adapter
+  const cpus = os.cpus()
+  const memory = process.memoryUsage()
+  const totalMemory = os.totalmem()
+  const usedMemory = Math.max(0, totalMemory - os.freemem())
+  const buildMetadata = getBuildMetadata()
+  const currentChangelog = getLocalChangelog(1)
+  const renderScale = Math.min(2, Math.max(0.5, Number(Config.app.renderScale) / 100))
+  const buildState = !buildMetadata ? 'unavailable' : buildMetadata.version === Root.pluginVersion ? 'matched' : 'mismatched'
+
+  return {
+    snapshotAt: new Intl.DateTimeFormat('zh-CN', {
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+      hour: '2-digit',
+      minute: '2-digit',
+      second: '2-digit',
+      hour12: false
+    }).format(new Date()),
+    identity: {
+      pluginName: Root.pluginName,
+      pluginVersion: Root.pluginVersion,
+      karinVersion: Root.karinVersion || '未知',
+      releaseType: /^\d+\.\d+\.\d+$/.test(Root.pluginVersion) ? 'Stable' : 'Preview',
+      requiredNodeVersion: packageMetadata.engines?.node ?? '未声明',
+      requiredKarinVersion: packageMetadata.karin?.engines ?? packageMetadata.engines?.karin ?? '未声明'
+    },
+    build: {
+      state: buildState,
+      version: buildMetadata?.version,
+      buildTime: buildMetadata?.buildTime ? formatBuildTime(buildMetadata.buildTime) : undefined,
+      shortCommitHash: buildMetadata?.shortCommitHash
+    },
+    runtime: {
+      nodeVersion: process.version,
+      nodeEnv: process.env.NODE_ENV ?? '未设置',
+      os: `${os.type()} ${os.release()}`,
+      platform: os.platform(),
+      arch: os.arch(),
+      timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || '未知',
+      container: isDocker,
+      systemUptime: formatDuration(os.uptime()),
+      processUptime: formatDuration(process.uptime())
+    },
+    adapter: {
+      name: adapter.name || '未知',
+      version: adapter.version || '未知',
+      platform: String(adapter.platform || '未知'),
+      protocol: String(adapter.protocol || '未知'),
+      standard: String(adapter.standard || '未知'),
+      communication: String(adapter.communication || '未知'),
+      connectedFor: formatDuration(Math.max(0, (Date.now() - adapter.connectTime) / 1000))
+    },
+    renderer: {
+      scale: `${renderScale.toFixed(2)}x`,
+      timeout: `${Config.app.RenderWaitTime}秒`,
+      multiPage: Config.app.multiPageRender && adapter.protocol !== 'qqbot'
+    },
+    resources: {
+      cpuModel: cpus[0]?.model?.trim() || '未知处理器',
+      cpuCores: cpus.length,
+      totalMemory: formatBytes(totalMemory),
+      usedMemory: formatBytes(usedMemory),
+      memoryUsagePercent: totalMemory > 0 ? `${((usedMemory / totalMemory) * 100).toFixed(1)}%` : '未知',
+      processRss: formatBytes(memory.rss),
+      heapUsed: formatBytes(memory.heapUsed)
+    },
+    releaseNotes: {
+      markdown: currentChangelog,
+      available: currentChangelog.length > 0
+    }
+  }
+}

package/src/karin/module/utils/semver.ts

@@ -0,0 +1,60 @@
+/**
+ * 语义化版本比较
+ * @param remote 远程版本字符串
+ * @param local 本地版本字符串
+ * @returns 如果远程版本大于本地版本则返回true，否则返回false
+ */
+export const isSemverGreater = (remote: string, local: string): boolean => {
+  if (!remote || !local) return false
+
+  const parse = (v: string) => {
+    v = v.trim()
+    if (v.startsWith('v') || v.startsWith('V')) v = v.slice(1)
+    const [preBuild] = v.split('+', 2)
+    const [core, pre] = preBuild.split('-', 2)
+    const parts = core.split('.')
+    const major = parseInt(parts[0] || '0', 10) || 0
+    const minor = parseInt(parts[1] || '0', 10) || 0
+    const patch = parseInt(parts[2] || '0', 10) || 0
+    const prerelease = pre ? pre.split('.') : []
+    return { major, minor, patch, prerelease }
+  }
+
+  const cmpId = (a: string, b: string): number => {
+    const an = /^\d+$/.test(a)
+    const bn = /^\d+$/.test(b)
+    if (an && bn) {
+      const na = parseInt(a, 10)
+      const nb = parseInt(b, 10)
+      if (na === nb) return 0
+      return na > nb ? 1 : -1
+    }
+    if (an && !bn) return -1
+    if (!an && bn) return 1
+    if (a === b) return 0
+    return a > b ? 1 : -1
+  }
+
+  const r = parse(remote)
+  const l = parse(local)
+
+  if (r.major !== l.major) return r.major > l.major
+  if (r.minor !== l.minor) return r.minor > l.minor
+  if (r.patch !== l.patch) return r.patch > l.patch
+
+  const ra = r.prerelease
+  const la = l.prerelease
+
+  if (ra.length === 0 && la.length === 0) return false
+  if (ra.length === 0 && la.length > 0) return true
+  if (ra.length > 0 && la.length === 0) return false
+
+  const len = Math.min(ra.length, la.length)
+  for (const [i, raItem] of ra.entries()) {
+    if (i >= len) break
+    const c = cmpId(raItem, la[i])
+    if (c !== 0) return c > 0
+  }
+  if (ra.length !== la.length) return ra.length > la.length
+  return false
+}