koishi-plugin-bns-rate 1.2.0 → 1.2.1

package/README.md

@@ -32,6 +32,28 @@
 
 其它平台（OneBot / Telegram 等）、QQ 频道（`qqguild`）、以及卡片发送失败时，都会**自动回退为纯文本**，不会发不出消息。
 
+### 发送方式（重要）
+
+卡片通过 `bot.internal.sendMessage` 发送**一条** payload，`markdown` 与 `keyboard` 装在同一个请求里，因此**卡片正文和按钮在同一条消息内**（不会拆成两条）。命令回复使用**被动消息**（带触发消息的 `msg_id` + `msg_seq`），不占用主动消息配额。
+
+发送失败时会依次降级：**带按钮 → 不带按钮 → 纯文本**。
+
+## 横幅图片要求
+
+`bannerUrl` 必须是**公网可直接访问的图片直链**（QQ 会下载转存，勿用官方 `server-temp`）。
+
+关键不是绝对像素，而是**图片自身的宽高比必须等于 `bannerWidth : bannerHeight`**，否则会被拉伸变形。
+
+| 想做的比例 | 建议原图尺寸 | 对应配置 |
+| --- | --- | --- |
+| 4.67:1（默认） | **1120×240**（2 倍图） | `bannerWidth: 560` `bannerHeight: 120` |
+| 4:1 | **1200×300** | `bannerWidth: 600` `bannerHeight: 150` |
+| 5:1 | **1000×200** | `bannerWidth: 500` `bannerHeight: 100` |
+
+- 宽度做 **1000~1200px** 足够清晰：QQ 会把图片缩放到卡片内容宽度（手机上约 300~400 逻辑像素），再大也会被压下来。
+- 文件大小建议 **200KB 以内**，格式 PNG（文字/透明底）或 JPG（渐变/照片）。
+- `bannerWidth`/`bannerHeight` 填 `0` 会输出 `#0px #0px`（让 QQ 自行缩放），但各客户端表现不一致，**不推荐**。
+
 ## 配置项
 
 | 配置 | 默认值 | 说明 |

package/index.js

@@ -1,4 +1,4 @@
-const { Schema, h } = require('koishi')
+const { Schema } = require('koishi')
 
 const DEFAULT_URL = 'https://www.dd373.com/s-d5gqt8-0-0-0-0-0-0-0-0-0-0-0-1-0-5-0.html'
 const DEFAULT_BUTTON_URL = 'https://www.dd373.com/s-d5gqt8.html'
@@ -204,19 +204,100 @@ function buildCardMarkdown(rates, timestamp, config) {
   return lines.join('\n')
 }
 
-// 组装成 koishi 元素：qq:markdown = 原生 markdown 正文，button-group/button = 卡片底部按钮
-// 注意：必须用 qq:markdown 元素包裹，否则适配器会把 # * - > 等符号全部转义成纯文本
-function buildCardElements(markdown, config) {
-  const elements = [h('qq:markdown', {}, markdown)]
-  if (config.button && String(config.buttonUrl || '').trim()) {
-    elements.push(h('button-group', {},
-      h('button', {
-        type: 'link',
-        href: String(config.buttonUrl).trim(),
-        class: 'primary',
-      }, config.buttonText || '点此查看详情')))
+// —— QQ 官方 internal API 发送（单条 payload 内同时带 markdown 与 keyboard，避免被拆成两条消息）——
+// 与 koishi-plugin-ll-group-welcome / ll-schedule 用的是同一套已验证写法
+const KNOWN_IGNORE_CODES = new Set([11293, 40034101, 40034105, 304101, 304102])
+// 被动回复窗口：超过 5 分钟的 msg_id 已失效，此时改发主动消息
+const PASSIVE_TIMEOUT = 5 * 60 * 1000 - 2000
+
+function errCode(e) {
+  const d = e && e.response && e.response.data
+  if (!d) return undefined
+  return d.code !== undefined ? d.code : d.err_code
+}
+
+function isKnownIgnoreError(e) {
+  const code = errCode(e)
+  return typeof code === 'number' && KNOWN_IGNORE_CODES.has(code)
+}
+
+// markdown → 纯文本（用作 msg_type=2 的 content 兜底字段）
+function toPlainText(markdown, buttonUrl) {
+  let out = String(markdown || '')
+    .replace(/<qqbot-at-user[^>]*\/>/g, '')
+    .replace(/!\[[^\]]*\]\([^)]*\)/g, '') // 去掉图片（含横幅）
+    .replace(/<[^>]+>/g, '') // 去掉 <font color="..."> 等标签，保留其中文字
+    .replace(/^#{1,6}\s*/gm, '')
+    .replace(/^\s*\*\*\*\s*$/gm, '') // 去掉水平分割线
+    .replace(/\*\*([^*]+)\*\*/g, '$1')
+    .replace(/\*([^*]+)\*/g, '$1')
+    .replace(/`([^`]+)`/g, '$1')
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1: $2')
+    .replace(/^>\s?/gm, '')
+    .replace(/[ \t]+\n/g, '\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim()
+  if (buttonUrl) out += `\n详情: ${buttonUrl}`
+  return out || ' '
+}
+
+// QQ 官方「消息按钮」：跳转按钮（action.type=0），所有人可点（permission.type=2）
+function buildKeyboard(config) {
+  const url = String(config.buttonUrl || '').trim()
+  if (!config.button || !url) return undefined
+  const label = config.buttonText || '点此查看详情'
+  return {
+    content: {
+      rows: [{
+        buttons: [{
+          render_data: { label, visited_label: label, style: 1 },
+          action: {
+            type: 0,
+            permission: { type: 2 },
+            data: url,
+            unsupport_tips: '请升级客户端后点击按钮',
+          },
+        }],
+      }],
+    },
+  }
+}
+
+// 被动回复：带上触发消息的 msg_id + 自增 msg_seq（不占主动消息配额）
+function passiveMeta(session) {
+  const messageId = session && session.messageId
+  const timestamp = (session && session.timestamp) || 0
+  if (!messageId || !timestamp || Date.now() - timestamp > PASSIVE_TIMEOUT) return null
+  const seq = (Number(session.seq) || 0) + 1
+  session.seq = seq
+  return { msg_id: messageId, msg_seq: seq }
+}
+
+// 一条 payload 同时装 markdown + keyboard（分成两个 payload 就会变成两条消息）
+function buildCardPayload(markdown, plain, config, passive, withButtons) {
+  const payload = {
+    msg_type: 2,
+    content: plain || ' ',
+    markdown: { content: markdown },
+  }
+  if (passive) {
+    payload.msg_id = passive.msg_id
+    payload.msg_seq = passive.msg_seq
+  }
+  if (withButtons) {
+    const keyboard = buildKeyboard(config)
+    if (keyboard) payload.keyboard = keyboard
+  }
+  return payload
+}
+
+async function sendQqCard(session, payload) {
+  const internal = session.bot.internal
+  const target = session.channelId || session.guildId || session.userId
+  if ((session.isDirect || session.subtype === 'private') && typeof internal.sendPrivateMessage === 'function') {
+    return internal.sendPrivateMessage(target, payload)
   }
-  return elements
+  return internal.sendMessage(target, payload)
 }
 
 // 只有官方QQ机器人的「群聊 / 私聊」支持自定义 markdown + 自定义按钮
@@ -267,15 +348,26 @@ function apply(ctx, config) {
         return '获取汇率失败: ' + message
       }
 
-      // 官方QQ机器人的群聊/私聊：发 Markdown 卡片
-      if (config.markdown && session && supportsCard(session) && typeof session.send === 'function') {
+      // 官方QQ机器人的群聊/私聊：发 Markdown 卡片（markdown + 按钮在同一条消息里）
+      if (config.markdown && session && supportsCard(session)) {
         const markdown = buildCardMarkdown(data.rates, data.timestamp, config)
-        try {
-          await session.send(buildCardElements(markdown, config))
-          return
-        } catch (e) {
-          logger.warn('Markdown 卡片发送失败，回退纯文本:', (e && e.message) || e)
+        const plain = toPlainText(markdown, config.button ? config.buttonUrl : '')
+        const passive = passiveMeta(session)
+        const hasButtons = !!(config.button && String(config.buttonUrl || '').trim())
+        // 依次尝试：带按钮 → 不带按钮（按钮能力/权限不可用时仍出卡片），都失败才回退纯文本
+        for (const withButtons of (hasButtons ? [true, false] : [false])) {
+          try {
+            await sendQqCard(session, buildCardPayload(markdown, plain, config, passive, withButtons))
+            logger.debug(`已发送 Markdown 卡片到 ${session.channelId}${withButtons ? '（含按钮）' : '（无按钮）'}`)
+            return
+          } catch (e) {
+            const code = errCode(e)
+            const detail = code !== undefined ? `code=${code}` : ((e && e.message) || e)
+            const level = isKnownIgnoreError(e) ? 'debug' : 'warn'
+            logger[level](`Markdown 卡片发送失败（${withButtons ? '含按钮' : '无按钮'}）: ${detail}`)
+          }
         }
+        logger.warn('Markdown 卡片全部尝试失败，回退纯文本')
       }
 
       return formatText(data.rates, data.timestamp, { stale: data.stale, error: data.error })
@@ -297,5 +389,16 @@ function apply(ctx, config) {
 module.exports = {
   Config,
   apply,
-  _test: { fetchRates, formatText, buildCardMarkdown, buildCardElements, supportsCard, fillTemplate, truncate },
+  _test: {
+    fetchRates,
+    formatText,
+    buildCardMarkdown,
+    buildCardPayload,
+    buildKeyboard,
+    toPlainText,
+    passiveMeta,
+    supportsCard,
+    fillTemplate,
+    truncate,
+  },
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-bns-rate",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Fetch BNS Classic Divine Stone exchange rate from dd373.com, with QQ official Markdown card support",
   "main": "index.js",
   "files": [