koishi-plugin-bns-rate 1.2.3 → 1.2.5

package/README.md

@@ -38,16 +38,16 @@
 
 ### 报价区排版可选四种（`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 才有） |
+| `quote` | 块引用 → 灰底 + 左侧竖条 | ✅ 明确支持 |
+| `list` | 无序列表 → 无底色，缩进 + 圆点 | ✅ 明确支持 |
+| `none` | 不包裹，纯文本行 | — |
 
 拿不准就在群里发 **`bnsrate.box`**：它会发一条含四种样式的对照卡片，挑一个填进设置页即可。若手机上 ` ``` ` 显示成了原文，说明该客户端不支持代码块，换成 `quote`。
 
-> ⚠️ 手机端（安卓 / 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 +90,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` 代码块（灰框／等宽／对齐）／`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

@@ -28,7 +28,7 @@ const Config = Schema.object({
     .description('💬 用 QQ官方 Markdown 卡片回复（仅官方QQ机器人「群/私聊」生效；频道机器人、OneBot 等其它平台自动回退纯文本，发送失败也会回退）'),
   title: Schema.string()
     .default('神石比例实时播报')
-    .description('卡片顶部标题（# 一级标题）'),
+    .description('卡片顶部标题（# 一级标题）。留空则不输出标题——若横幅图上已经有标题文字，把这里清空即可'),
 
   bannerUrl: Schema.string()
     .default('')
@@ -66,12 +66,6 @@ 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'])
     .default('code')
     .description('📦 报价区排版：code = 代码块（灰色框、等宽、两列对齐，但不支持颜色，且代码块不在 QQ 官方支持清单里）；quote = 块引用（官方支持，灰底+左侧竖条，桌面端有颜色）；list = 无序列表（官方支持，无底色）；none = 不包裹。</br>拿不准就在群里发 bnsrate.box 看对照图，挑一个填这里'),
@@ -140,11 +134,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) {
@@ -176,15 +165,20 @@ function formatText(rates, timestamp, opts = {}) {
 }
 
 // QQ官方 Markdown 卡片源码
+// 按"块"拼装、块之间用空行分隔：任何一块留空/关闭就整块不输出，
+// 这样不会出现空标题（`# `）、也不会在开头/结尾留下多余空行
 function buildCardMarkdown(rates, timestamp, config) {
   const time = formatTime(timestamp, false)
-  const lines = [`# ${config.title}`]
+  const blocks = []
+
+  const title = String(config.title || '').trim()
+  if (title) blocks.push(`# ${title}`)
 
   const banner = String(config.bannerUrl || '').trim()
   if (banner) {
     const w = Math.max(0, Math.round(Number(config.bannerWidth) || 0))
     const ht = Math.max(0, Math.round(Number(config.bannerHeight) || 0))
-    lines.push('', `![${config.bannerAlt} #${w}px #${ht}px](${banner})`)
+    blocks.push(`![${String(config.bannerAlt || '').trim()} #${w}px #${ht}px](${banner})`)
   }
 
   const intro = fillTemplate(config.intro, {
@@ -192,21 +186,22 @@ function buildCardMarkdown(rates, timestamp, config) {
     time,
     date: time.split(' ')[0],
   }).trim()
-  if (intro) lines.push('', intro)
+  if (intro) blocks.push(intro)
 
-  lines.push('', ...buildRateBlock(rates, config))
+  blocks.push(buildRateBlock(rates, config).join('\n'))
 
   const footer = String(config.footer || '').trim()
-  if (config.button && footer) lines.push('', footer)
+  if (config.button && footer) blocks.push(footer)
 
-  return lines.join('\n')
+  return blocks.join('\n\n').trim()
 }
 
 // 报价区排版。box 省略时取 config.ratesBox
-// code  = 代码块（灰色框 / 等宽 / 两列对齐，代码块内不支持颜色）
-// quote = 块引用（官方支持，灰底 + 左侧竖条，桌面端可上色）
-// list  = 无序列表（官方支持，无底色，缩进 + 圆点）
+// code  = 代码块（灰色框 / 等宽 / 两列对齐）
+// quote = 块引用（灰底 + 左侧竖条）
+// list  = 无序列表（无底色，缩进 + 圆点）
 // none  = 不加任何包裹
+// ⚠️ 一律不输出 <font> 等 HTML 标签：手机端 QQ 不渲染 HTML，会把这串标签当纯文本显示出来
 function buildRateBlock(rates, config, box) {
   const mode = box || String(config.ratesBox || 'code')
   const rows = rates.map(r => ({
@@ -221,10 +216,7 @@ function buildRateBlock(rates, config, box) {
     return ['```', ...body, '```']
   }
 
-  const body = rows.map(r => (
-    `1元 = ${colorize(r.fwd, config.colorForward)}神石　|　`
-    + `1神石 = ${colorize(r.rev, config.colorReverse)}元`
-  ))
+  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

package/package.json

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