koishi-plugin-bns-rate 1.2.1 → 1.2.3

package/README.md

@@ -2,7 +2,7 @@
 
 从 [dd373.com](https://www.dd373.com/s-d5gqt8.html) 获取剑灵怀旧服**神石**实时汇率，输出当前时段最低比例前 N 条。
 
-支持**官方 QQ 机器人 Markdown 卡片**回复：标题 + 横幅图 + 红绿报价 + 跳转按钮，全部可在插件设置页配置。
+支持**官方 QQ 机器人 Markdown 卡片**回复：标题 + 横幅图 + 灰框报价 + 跳转按钮，全部可在插件设置页配置。
 
 ## 命令
 
@@ -10,25 +10,44 @@
 | --- | --- |
 | `bnsrate` / `神石` / `shenshi` | 查询当前时段最低神石比例 |
 | `bnsrate -f` | 忽略缓存，强制刷新 |
+| `bnsrate.box` | **报价区排版对照**：一条消息里给出 code / quote / list / none 四种样式，在手机上挑一个填进 `ratesBox` |
 | `bnsrate.preview` | 只输出卡片 Markdown 源码（不发送卡片），调试用 |
 
 ## 卡片效果
 
 官方 QQ 机器人的**群聊 / 私聊**下，命令回复会变成 Markdown 卡片，形如：
 
-```
+````
 # 神石比例实时播报
 
 ![DD373 DATA #560px #120px](<横幅图片直链>)
 
-大家关注的 DD373 最低神石比例前5条来啦！当前时段（2026/9/10 10:46）最优价格如下：
+大家关注的 DD373 最低神石比例前5条来啦！当前时段（2026/9/10 11:03）最优价格如下：
+
+```
+1元 = 151.51 神石  |  1神石 = 0.0066元
+1元 = 149.54 神石  |  1神石 = 0.0067元
+1元 = 149.40 神石  |  1神石 = 0.0067元
+```
 
-1元 = <font color="#E60012">151.51</font>神石　|　1神石 = <font color="#00A650">0.0066</font>元
-...
-***
 如需查看完整详情或进行交易，请点击下方按钮直接跳转至 DD373 官网。
 [ 点此直达DD373网站 ]
-```
+````
+
+报价区默认用**代码块**包起来，在客户端渲染成**灰色框**（`ratesBox: code`）。代码块是等宽字体，插件会用空格把两列**对齐**（数字位数不同也对齐）。
+
+### 报价区排版可选四种（`ratesBox`）
+
+| 值 | 效果 | QQ 官方文档支持 | 颜色 |
+| --- | --- | --- | --- |
+| **`code`（默认）** | 代码块 → 均匀灰底圆角框、等宽字体、两列对齐 | ❌ 不在[支持清单](https://bot.qq.com/wiki/develop/api-v2/server-inter/message/type/markdown.html)（客户端能力，安卓新版本 / iOS 才有） | ❌ 代码块内不支持 |
+| `quote` | 块引用 → 灰底 + 左侧竖条 | ✅ 明确支持 | ✅ 桌面端 |
+| `list` | 无序列表 → 无底色，缩进 + 圆点 | ✅ 明确支持 | ✅ 桌面端 |
+| `none` | 不包裹，纯文本行 | — | ✅ 桌面端 |
+
+拿不准就在群里发 **`bnsrate.box`**：它会发一条含四种样式的对照卡片，挑一个填进设置页即可。若手机上 ` ``` ` 显示成了原文，说明该客户端不支持代码块，换成 `quote`。
+
+> ⚠️ 手机端（安卓 / iOS）**不渲染 HTML 标签**：`<font color="#E60012">` 会**原样显示成一串字符**。因此默认的 `code` 模式**不输出任何颜色标签**；`quote` / `list` / `none` 会输出颜色（桌面端有颜色，手机端会露出标签，自行取舍）。
 
 其它平台（OneBot / Telegram 等）、QQ 频道（`qqguild`）、以及卡片发送失败时，都会**自动回退为纯文本**，不会发不出消息。
 
@@ -71,14 +90,15 @@
 | `button` | `true` | 是否显示底部跳转按钮 |
 | `buttonText` | `点此直达DD373网站` | 按钮文字 |
 | `buttonUrl` | `https://www.dd373.com/s-d5gqt8.html` | 按钮跳转链接 |
-| `colorForward` | `#E60012` | 「1元=xx神石」数字颜色，留空不染色 |
-| `colorReverse` | `#00A650` | 「1神石=xx元」数字颜色，留空不染色 |
+| `ratesBox` | `code` | 报价区排版：`code` 代码块（灰框／等宽／对齐／无颜色）／`quote` 块引用／`list` 列表／`none` 不包裹。发 `bnsrate.box` 可看四种对照 |
+| `colorForward` | `#E60012` | 「1元=xx神石」数字颜色，留空不染色。**仅 `ratesBox` 不是 `code` 时才生效** |
+| `colorReverse` | `#00A650` | 「1神石=xx元」数字颜色，留空不染色。同上 |
 | `decimalsForward` | `2` | 「1元=xx神石」保留小数位（**截断**，不四舍五入），`0` = 原始值 |
 | `decimalsReverse` | `4` | 「1神石=xx元」保留小数位（截断），`0` = 原始值 |
 
 ## ⚠️ 注意事项
 
-1. **颜色只在桌面端生效**。QQ 官方 Markdown 的[支持格式](https://bot.qq.com/wiki/develop/api-v2/server-inter/message/type/markdown.html)中没有字体颜色，颜色依赖 HTML 标签，**只有桌面端 QQNT 会渲染**；安卓 / iOS 会显示为普通文字（卡片本身不会出错）。
+1. **手机端不渲染 HTML 标签**。QQ 官方 Markdown 的[支持格式](https://bot.qq.com/wiki/develop/api-v2/server-inter/message/type/markdown.html)里没有字体颜色，颜色靠 HTML 标签实现，而**安卓 / iOS 会把这串标签当纯文本原样显示出来**（实测：手机上会看到 `<font color="#E60012">151.51</font>` 这样的字符）。所以默认 `ratesBox: code` 完全不输出颜色标签，用**代码块灰框 + 等宽对齐**来排版；想要桌面端红绿数字就把 `ratesBox` 改成 `quote` 或 `none`，代价是手机端会露出标签。
 2. **横幅图片必须是公网直链**，QQ 会下载并转存该资源。请勿使用官方的 `server-temp`（首次访问后即删除文件，群里多人同时查看会出现白图）。
 3. 群聊/单聊自定义 Markdown 自 2026/04/23 起已开放给所有机器人，**无需申请 Markdown 模板**；QQ 频道（`qqguild`）场景仍需内邀开通，本插件在频道下自动回退纯文本。
 4. 命令回复属被动消息，不占用主动消息配额。

package/index.js

@@ -68,10 +68,13 @@ const Config = Schema.object({
 
   colorForward: Schema.string()
     .default('#E60012')
-    .description('「1元=xx神石」数字的颜色，如 #E60012（红）。留空 = 不染色。⚠️ 颜色仅在桌面端 QQ 显示，安卓/iOS 会显示为普通文字'),
+    .description('「1元=xx神石」数字颜色，如 #E60012，留空即不染色。⚠️ 仅当 ratesBox 不是 code 时才有意义；手机端不渲染颜色，会把这串标签当文字显示出来'),
   colorReverse: Schema.string()
     .default('#00A650')
-    .description('「1神石=xx元」数字的颜色，如 #00A650（绿）。留空 = 不染色'),
+    .description('「1神石=xx元」数字颜色，如 #00A650，留空即不染色。同上'),
+  ratesBox: Schema.union(['code', 'quote', 'list', 'none'])
+    .default('code')
+    .description('📦 报价区排版：code = 代码块（灰色框、等宽、两列对齐，但不支持颜色，且代码块不在 QQ 官方支持清单里）；quote = 块引用（官方支持，灰底+左侧竖条，桌面端有颜色）；list = 无序列表（官方支持，无底色）；none = 不包裹。</br>拿不准就在群里发 bnsrate.box 看对照图，挑一个填这里'),
   decimalsForward: Schema.number()
     .default(2)
     .min(0)
@@ -191,19 +194,42 @@ function buildCardMarkdown(rates, timestamp, config) {
   }).trim()
   if (intro) lines.push('', intro)
 
-  lines.push('', ...rates.map(r => (
-    `1元 = ${colorize(truncate(r.forward, config.decimalsForward), config.colorForward)}神石　|　`
-    + `1神石 = ${colorize(truncate(r.reverse, config.decimalsReverse), config.colorReverse)}元`
-  )))
+  lines.push('', ...buildRateBlock(rates, config))
 
   const footer = String(config.footer || '').trim()
-  if (config.button && footer) {
-    lines.push('', '***', '', footer)
-  }
+  if (config.button && footer) lines.push('', footer)
 
   return lines.join('\n')
 }
 
+// 报价区排版。box 省略时取 config.ratesBox
+// code  = 代码块（灰色框 / 等宽 / 两列对齐，代码块内不支持颜色）
+// quote = 块引用（官方支持，灰底 + 左侧竖条，桌面端可上色）
+// list  = 无序列表（官方支持，无底色，缩进 + 圆点）
+// none  = 不加任何包裹
+function buildRateBlock(rates, config, box) {
+  const mode = box || String(config.ratesBox || 'code')
+  const rows = rates.map(r => ({
+    fwd: truncate(r.forward, config.decimalsForward),
+    rev: truncate(r.reverse, config.decimalsReverse),
+  }))
+
+  if (mode === 'code') {
+    const wf = Math.max(...rows.map(r => r.fwd.length))
+    const wr = Math.max(...rows.map(r => r.rev.length))
+    const body = rows.map(r => `1元 = ${r.fwd.padEnd(wf)} 神石  |  1神石 = ${r.rev.padEnd(wr)}元`)
+    return ['```', ...body, '```']
+  }
+
+  const body = rows.map(r => (
+    `1元 = ${colorize(r.fwd, config.colorForward)}神石　|　`
+    + `1神石 = ${colorize(r.rev, config.colorReverse)}元`
+  ))
+  if (mode === 'quote') return body.map(l => '> ' + l)
+  if (mode === 'list') return body.map(l => '- ' + l)
+  return body
+}
+
 // —— QQ 官方 internal API 发送（单条 payload 内同时带 markdown 与 keyboard，避免被拆成两条消息）——
 // 与 koishi-plugin-ll-group-welcome / ll-schedule 用的是同一套已验证写法
 const KNOWN_IGNORE_CODES = new Set([11293, 40034101, 40034105, 304101, 304102])
@@ -228,12 +254,13 @@ function toPlainText(markdown, buttonUrl) {
     .replace(/!\[[^\]]*\]\([^)]*\)/g, '') // 去掉图片（含横幅）
     .replace(/<[^>]+>/g, '') // 去掉 <font color="..."> 等标签，保留其中文字
     .replace(/^#{1,6}\s*/gm, '')
+    .replace(/^\s*```.*$/gm, '') // 去掉代码块围栏
     .replace(/^\s*\*\*\*\s*$/gm, '') // 去掉水平分割线
     .replace(/\*\*([^*]+)\*\*/g, '$1')
     .replace(/\*([^*]+)\*/g, '$1')
     .replace(/`([^`]+)`/g, '$1')
     .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1: $2')
-    .replace(/^>\s?/gm, '')
+    .replace(/^\s*>\s?/gm, '')
     .replace(/[ \t]+\n/g, '\n')
     .replace(/\n{3,}/g, '\n\n')
     .trim()
@@ -335,6 +362,27 @@ function apply(ctx, config) {
     }
   }
 
+  // 发卡片：带按钮 → 不带按钮（按钮能力/权限不可用时仍出卡片）→ 返回 false 让调用方回退纯文本
+  async function sendCard(session, markdown, cfg) {
+    const plain = toPlainText(markdown, cfg.button ? cfg.buttonUrl : '')
+    const passive = passiveMeta(session)
+    const hasButtons = !!(cfg.button && String(cfg.buttonUrl || '').trim())
+    for (const withButtons of (hasButtons ? [true, false] : [false])) {
+      try {
+        await sendQqCard(session, buildCardPayload(markdown, plain, cfg, passive, withButtons))
+        logger.debug(`已发送 Markdown 卡片到 ${session.channelId}${withButtons ? '（含按钮）' : '（无按钮）'}`)
+        return true
+      } 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 false
+  }
+
   ctx.command('bnsrate', '查询剑灵怀旧服神石汇率')
     .alias('神石')
     .alias('shenshi')
@@ -351,23 +399,7 @@ function apply(ctx, config) {
       // 官方QQ机器人的群聊/私聊：发 Markdown 卡片（markdown + 按钮在同一条消息里）
       if (config.markdown && session && supportsCard(session)) {
         const markdown = buildCardMarkdown(data.rates, data.timestamp, config)
-        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 卡片全部尝试失败，回退纯文本')
+        if (await sendCard(session, markdown, config)) return
       }
 
       return formatText(data.rates, data.timestamp, { stale: data.stale, error: data.error })
@@ -384,6 +416,40 @@ function apply(ctx, config) {
         return '获取汇率失败: ' + message
       }
     })
+
+  // 排版对照：一条消息里同时给出 4 种报价区排版，在手机上挑一个填进 ratesBox
+  ctx.command('bnsrate.box', '报价区排版对照：一条消息看 4 种样式，挑一个填到 ratesBox')
+    .action(async ({ session }) => {
+      let data
+      try {
+        data = await resolveRates(false)
+      } catch (e) {
+        const message = e instanceof Error ? e.message : String(e)
+        return '获取汇率失败: ' + message
+      }
+      const sample = data.rates.slice(0, 2)
+      const parts = [
+        '# 报价区排版对照',
+        '',
+        '把下面最好看的那一项填到插件设置页的 ratesBox：',
+      ]
+      const labels = {
+        code: 'A. code —— 代码块（灰色框 / 等宽 / 两列对齐 / 无颜色）',
+        quote: 'B. quote —— 块引用（灰底 + 左侧竖条 / 桌面端有颜色）',
+        list: 'C. list —— 无序列表（无底色 / 缩进 + 圆点）',
+        none: 'D. none —— 不包裹（纯文本行）',
+      }
+      for (const box of ['code', 'quote', 'list', 'none']) {
+        parts.push('', `## ${labels[box]}`, '', ...buildRateBlock(sample, config, box))
+      }
+
+      const markdown = parts.join('\n')
+      // 对照图不需要按钮，避免误触
+      if (session && supportsCard(session)) {
+        if (await sendCard(session, markdown, { ...config, button: false })) return
+      }
+      return markdown
+    })
 }
 
 module.exports = {
@@ -394,6 +460,7 @@ module.exports = {
     formatText,
     buildCardMarkdown,
     buildCardPayload,
+    buildRateBlock,
     buildKeyboard,
     toPlainText,
     passiveMeta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-bns-rate",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Fetch BNS Classic Divine Stone exchange rate from dd373.com, with QQ official Markdown card support",
   "main": "index.js",
   "files": [
@@ -17,8 +17,8 @@
   },
   "koishi": {
     "description": {
-      "zh": "从 dd373.com 获取剑灵怀旧服神石实时汇率，输入 神石/bnsrate/shenshi 即可查询最低比例。支持官方QQ机器人 Markdown 卡片（标题+横幅图+红绿报价+跳转按钮），横幅图片与配色均可在插件设置页配置。",
-      "en": "Fetch BNS Classic Divine Stone exchange rate from dd373.com. Supports QQ official bot Markdown cards (title, banner image, colored rates, jump button), all configurable."
+      "zh": "从 dd373.com 获取剑灵怀旧服神石实时汇率，输入 神石/bnsrate/shenshi 即可查询最低比例。支持官方QQ机器人 Markdown 卡片：标题 + 横幅图 + 代码块灰框报价（等宽对齐）+ 跳转按钮，正文与按钮同一条消息；横幅图片、外框样式、配色、小数位均可在插件设置页配置。",
+      "en": "Fetch BNS Classic Divine Stone exchange rate from dd373.com. QQ official bot Markdown card: title, banner image, gray code-box rate table, jump button — all in a single message and fully configurable."
     },
     "service": {
       "required": ["http"]