koishi-plugin-bns-rate 1.2.4 → 1.2.6

package/README.md

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

package/index.js

@@ -6,6 +6,17 @@ const DEFAULT_BUTTON_URL = 'https://www.dd373.com/s-d5gqt8.html'
 const FORWARD_RE = /1元\s*=\s*(\d+\.?\d*)神石/g
 const REVERSE_RE = /(?<!\d)1神石\s*=\s*(\d+\.\d+)元/
 
+// 报价区排版方式（设置页下拉 + bnsrate.box 对照图都用这一份定义，避免两头不同步）
+// ⚠️ 除 code/table 外都会输出 <font> 等 HTML 标签，而手机端不渲染 HTML，所以一律不加标签
+const RATE_BOXES = ['code', 'table', 'quote', 'list', 'none']
+const RATE_BOX_LABELS = {
+  code: 'A. code —— 代码块（灰色框 / 等宽 / 两列对齐）',
+  table: 'B. table —— 表格（带表头 / 需客户端支持）',
+  quote: 'C. quote —— 块引用（灰底 + 左侧竖条）',
+  list: 'D. list —— 无序列表（缩进 + 圆点）',
+  none: 'E. none —— 不包裹（纯文本行）',
+}
+
 // ===== 配置 Schema =====
 
 const Config = Schema.object({
@@ -66,15 +77,9 @@ const Config = Schema.object({
     .default(DEFAULT_BUTTON_URL)
     .description('按钮跳转的链接'),
 
-  colorForward: Schema.string()
-    .default('#E60012')
-    .description('「1元=xx神石」数字颜色，如 #E60012，留空即不染色。⚠️ 仅当 ratesBox 不是 code 时才有意义；手机端不渲染颜色，会把这串标签当文字显示出来'),
-  colorReverse: Schema.string()
-    .default('#00A650')
-    .description('「1神石=xx元」数字颜色，如 #00A650，留空即不染色。同上'),
-  ratesBox: Schema.union(['code', 'quote', 'list', 'none'])
+  ratesBox: Schema.union(RATE_BOXES)
     .default('code')
-    .description('📦 报价区排版：code = 代码块（灰色框、等宽、两列对齐，但不支持颜色，且代码块不在 QQ 官方支持清单里）；quote = 块引用（官方支持，灰底+左侧竖条，桌面端有颜色）；list = 无序列表（官方支持，无底色）；none = 不包裹。</br>拿不准就在群里发 bnsrate.box 看对照图，挑一个填这里'),
+    .description('📦 报价区排版，拿不准就在群里发 bnsrate.box 看对照图再挑：<br>code = 代码块（灰色框、等宽、两列对齐）<br>table = 表格（带表头，不在 QQ 官方支持清单里，客户端能渲染才行）<br>quote = 块引用（灰底 + 左侧竖条，官方支持）<br>list = 无序列表（缩进 + 圆点，官方支持）<br>none = 不包裹'),
   decimalsForward: Schema.number()
     .default(2)
     .min(0)
@@ -140,11 +145,6 @@ function formatTime(timestamp, withSeconds) {
   return withSeconds ? `${date} ${time}:${pad2(d.getUTCSeconds())}` : `${date} ${time}`
 }
 
-function colorize(text, color) {
-  const c = String(color || '').trim()
-  return c ? `<font color="${c}">${text}</font>` : String(text)
-}
-
 // 按位截断（不四舍五入），并补足小数位；decimals 为 0 时返回原始值
 // 先定点到 d+2 位消除浮点误差（否则 0.0066 * 10000 会得到 65.9999 这种值）
 function truncate(value, decimals) {
@@ -208,10 +208,12 @@ function buildCardMarkdown(rates, timestamp, config) {
 }
 
 // 报价区排版。box 省略时取 config.ratesBox
-// code  = 代码块（灰色框 / 等宽 / 两列对齐，代码块内不支持颜色）
-// quote = 块引用（官方支持，灰底 + 左侧竖条，桌面端可上色）
-// list  = 无序列表（官方支持，无底色，缩进 + 圆点）
+// code  = 代码块（灰色框 / 等宽 / 两列对齐）
+// table = GFM 管道表格（带表头，客户端支持才渲染；不在 QQ 官方支持清单里）
+// quote = 块引用（灰底 + 左侧竖条）
+// list  = 无序列表（无底色，缩进 + 圆点）
 // none  = 不加任何包裹
+// ⚠️ 一律不输出 <font> 等 HTML 标签：手机端 QQ 不渲染 HTML，会把这串标签当纯文本显示出来
 function buildRateBlock(rates, config, box) {
   const mode = box || String(config.ratesBox || 'code')
   const rows = rates.map(r => ({
@@ -226,10 +228,16 @@ function buildRateBlock(rates, config, box) {
     return ['```', ...body, '```']
   }
 
-  const body = rows.map(r => (
-    `1元 = ${colorize(r.fwd, config.colorForward)}神石　|　`
-    + `1神石 = ${colorize(r.rev, config.colorReverse)}元`
-  ))
+  if (mode === 'table') {
+    // 表头第二行的分隔行：单元格数量必须与表头一致，否则表格不成立
+    return [
+      '| # | 1元 兑 | 1神石 折 |',
+      '| --- | --- | --- |',
+      ...rows.map((r, i) => `| ${i + 1} | ${r.fwd} 神石 | ${r.rev} 元 |`),
+    ]
+  }
+
+  const body = rows.map(r => `1元 = ${r.fwd}神石　|　1神石 = ${r.rev}元`)
   if (mode === 'quote') return body.map(l => '> ' + l)
   if (mode === 'list') return body.map(l => '- ' + l)
   return body
@@ -267,8 +275,16 @@ function toPlainText(markdown, buttonUrl) {
     .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1: $2')
     .replace(/^\s*>\s?/gm, '')
     .replace(/[ \t]+\n/g, '\n')
-    .replace(/\n{3,}/g, '\n\n')
-    .trim()
+
+  // GFM 表格 → 纯文本：分隔行丢掉，数据行的竖线换成空格
+  out = out.split('\n').map((line) => {
+    const t = line.trim()
+    if (!t.startsWith('|')) return line
+    if (/^\|[\s:|-]*\|$/.test(t)) return '' // | --- | --- | 这种分隔行
+    return t.replace(/^\||\|$/g, '').split('|').map(c => c.trim()).filter(Boolean).join('  ')
+  }).join('\n')
+
+  out = out.replace(/\n{3,}/g, '\n\n').trim()
   if (buttonUrl) out += `\n详情: ${buttonUrl}`
   return out || ' '
 }
@@ -422,8 +438,8 @@ function apply(ctx, config) {
       }
     })
 
-  // 排版对照：一条消息里同时给出 4 种报价区排版，在手机上挑一个填进 ratesBox
-  ctx.command('bnsrate.box', '报价区排版对照：一条消息看 4 种样式，挑一个填到 ratesBox')
+  // 排版对照：一条消息里同时给出各种报价区排版，在手机上挑一个填进 ratesBox
+  ctx.command('bnsrate.box', '报价区排版对照：一条消息看所有样式，挑一个填到 ratesBox')
     .action(async ({ session }) => {
       let data
       try {
@@ -438,14 +454,8 @@ function apply(ctx, config) {
         '',
         '把下面最好看的那一项填到插件设置页的 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))
+      for (const box of RATE_BOXES) {
+        parts.push('', `## ${RATE_BOX_LABELS[box]}`, '', ...buildRateBlock(sample, config, box))
       }
 
       const markdown = parts.join('\n')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-bns-rate",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Fetch BNS Classic Divine Stone exchange rate from dd373.com, with QQ official Markdown card support",
   "main": "index.js",
   "files": [
@@ -17,7 +17,7 @@
   },
   "koishi": {
     "description": {
-      "zh": "从 dd373.com 获取剑灵怀旧服神石实时汇率，输入 神石/bnsrate/shenshi 即可查询最低比例。支持官方QQ机器人 Markdown 卡片：标题 + 横幅图 + 代码块灰框报价（等宽对齐）+ 跳转按钮，正文与按钮同一条消息；横幅图片、外框样式、配色、小数位均可在插件设置页配置。",
+      "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": {