起初…#

起初，我真的只是想写个简单的 Bot 指令查查歌，稍微方便一下自己。 但写着写着就“上头”了——为了追求所谓的“原生体验”和“极致美观”，我硬生生把这个简单的脚本搓成了一个包含了 Wiki 解析器、Canvas 绘图引擎、LRU 缓存甚至还有游戏逻辑的缝合怪。

这篇文章不讲那些虚头巴脑的架构，专门记录一下开发过程中那些让我血压飙升的瞬间，特别是跟 Wiki 格式搏斗、被 Go 的颜色处理坑惨以及和群里 AI 抢话语权的经历。

一、 Wiki 解析：看似规范，实则全是坑#

数据源我选了 Rizline中文维基。

最搞心态的是跨行单元格。 理论上每一行数据应该很规整，但实际上编辑者们的习惯千奇百怪。有的属性写在一行，有的分行写。我最开始天真地用 \n|- 来切分行，结果遇到下面这种“狂野”写法直接崩盘：

1
|[[版本:2.0.1|2.0.1]]
2
|style="text-align:center;| 2025/03/28
3
|加入了VICIOUS...

这一行被换行符切得稀碎，解析逻辑读不到完整数据，直接 panic。 后来我意识到，指望 Wiki 源码格式标准是不可能的。于是我采用了**“大力出奇迹”的预处理方案**：在解析前，先把这些碍眼的换行符给“拍扁”。简单粗暴但有效

1
func parseTable(tableText string) string {
2
    // ...
3
    for _, row := range rows {
4
        // 这里的逻辑简单粗暴但有效
5
        // 只要看到 \n| 或者 \n! 这种跨行写法，强制替换成标准分隔符 ||
6
        cleanRow := strings.ReplaceAll(row, "\n|", "||")
7
        cleanRow = strings.ReplaceAll(cleanRow, "\n!", "||")
8

9
        // 现在的 row 无论原本长啥样，都被我变成了标准的 Cell A || Cell B
10
        rawCells := strings.Split(cleanRow, "||")
11
        // ...
12
    }
13
}

这一步做完，世界瞬间清静了。不管编辑者怎么换行，我拿到的永远是单行数据。顺便我还写了个正则过滤器，把 scope="row" 这种这类样式代码全剔除掉，只留干货。

二、 绘图引擎：如果你看不见背景，说明你预乘了#

为了让查歌结果不是干巴巴的文字，我上了 gg 库画图。Rizline 的 UI 有很多半透明色（比如 Riztime 的那个淡绿色 #6B82A585），这里我连踩了三个坑，简直是 Go 语言图形处理的“教科书级反面教材”。

1
// 别笑，我真这么写过
2
fmt.Sscanf(hexStr, "%02x%02x%02x%02x", &r, &g, &b, &a)

1
// 简单粗暴的“挖孔屏”实现
2
if img, ok := dc.Image().(*image.RGBA); ok {
3
    // 算出要挖空的矩形坐标
4
    x0, y0, x1, y1 := int(startX), int(currentY), int(startX+blockW), int(currentY+blockH)
5
    for py := y0; py < y1; py++ {
6
        for px := x0; px < x1; px++ {
7
            // 物理清除背景色，设为全透明
8
            img.Set(px, py, color.Transparent)
9
        }
10
    }
11
}
12
// 坑挖好了，再填半透明色，就不会和背景混色了
13
dc.SetColor(hexToColor(c))
14
dc.DrawRectangle(startX, currentY, blockW, blockH)
15
dc.Fill()

三、 布局管理：CV 工程师的翻车现场#

开发“详细信息”板块时，我犯了个低级错误，导致调试了半小时 panic。

我的渲染逻辑是分离的：先算高度 calculateHeight，再实际画图 generateImage。 加新字段时，我为了省事直接复制粘贴了代码。

结果在写计算高度的函数时，我脑子一抽，复制了画图函数的参数列表：

1
// 错误现场：计算高度要个毛线的坐标(x, y)啊！
2
// calculateFormattedTextHeight 定义只要 (dc, text, maxWidth)
3
// 我传进去一大堆乱七八糟的 (dc, text, x, y, maxWidth, ...)
4
textHeight := calculateFormattedTextHeight(dc, line, cardMargin+40, y+24, cardWidth-80, ...)

编译器报 too many arguments 还是小事，关键是当时那一坨参数类型都差不多，我还硬改了半天类型转换。

教训：UI 代码写多了真的容易眼花。如果有条件，还是封装成对象，让每个组件自己管好 Measure() 和 Draw()，这种过程式代码维护起来太痛苦了。

四、 游戏交互：让机器人“有些情商”#

为了活跃群气氛，我搞了个“猜歌名”功能。上线第一天就被群友吐槽：

1. 太严格：谁记得住 Gleam feat. ふわまろ 这种全名？少打个点都算错。
2. 太吵：群里 BOT 接了 ChatGPT，这边开始游戏发图让大家猜，那边 ChatGPT 立刻跳出来胡说八道。

1
func simplifyTitle(title string) string {
2
    // 砍掉 (...) 和 [...]，顺便处理中文全角括号
3
    reParens := regexp.MustCompile(`\s*[(\[（].*?[)\]）]`)
4
    title = reParens.ReplaceAllString(title, "")
5

6
    // 砍掉 feat./cv. 后缀
7
    reFeat := regexp.MustCompile(`(?i)\s+(feat|ft|cv)\.?.*$`)
8
    title = reFeat.ReplaceAllString(title, "")
9

10
    return strings.TrimSpace(title)
11
}

1
engine.OnMessage().Handle(func(ctx *zero.Ctx) {
2
    session := Manager.GetSession(groupID)
3
    if session != nil {
4
        // 游戏进行中？那就拦下来，别让后续的 AI 插件处理了
5
        ctx.Block()
6

7
        // 顺手把 @机器人的部分切掉，只留纯文本
8
        cleanMsg := removeAtCode(ctx.Event.Message)
9
        session.HandleGuess(ctx, cleanMsg)
10
    }
11
})

碎碎念#

回头看这堆代码，从正则解析的脏活累活，到像素级操作的“绣花功夫”，虽然过程各种掉坑，但不得不说，看到群友们现在不用切出去查 Wiki，直接在群里 /riz random 发起挑战，或者对着一张模糊的图猜得热火朝天，那种成就感真的比写多少行业代码都强。

写代码嘛，本来就是为了解决这点“不方便”，顺便折腾自己，乐在其中。

最后，发点好玩的