神笔马良 (Magic Brush) - 更新日志

v3.0.0 - 2026-08-26

✨ 重大新功能

1. 颜色绑定识别系统

• 物品必须用对应颜色画才能识别，颜色不对即使形状匹配也无法生成
• 颜色不匹配时，相似度惩罚至原来的 25%，基本无法通过识别
• 26种物品全部绑定了专属颜色
• 生物类不限制颜色（任何颜色都可识别）
• 方块类部分限制颜色

物品颜色对应表：

物品	必需颜色	物品	必需颜色
钻石	蓝色	煤炭	黑色
金锭	金色	红石	红色
铁锭	灰色	青金石	蓝色
苹果	红色	绿宝石	绿色
铁剑	灰色	面包	棕色
铁镐	灰色	胡萝卜	橙色
火把	橙色	弓	棕色
箭	白色	水桶	蓝色
书	棕色	钻石剑	蓝色
蛋糕	白色	西瓜	绿色
药水	不限	鞍	棕色
指南针	灰色	经验瓶	不限

2. 画板尺寸缩小，全分辨率适配

• 画布从 64x64（256px）缩小为 32x32（160px）
• 自动适配屏幕高度，低分辨率设备也能完整显示界面
• 按钮、颜色面板、相似度信息全部在右侧，不会被遮挡

3. 识别种类扩充至60种

类别	v2.0	v3.0	新增
物品	17	26	+9
生物	14	20	+6
方块	11	14	+3
总计	42	60	+18

新增物品（9种）： 钻石剑、蛋糕、西瓜、药水、鞍、指南针、经验瓶 新增生物（6种）： 烈焰人、恶魂、女巫、马、蜜蜂 新增方块（5种）： 钻石矿、木板、铁砧、附魔台、床

4. 相似度系统增强

• 识别阈值从 35% 提高至 38%，减少误识别
• 预览识别时显示 🥇🥈🥉 Top3 候选，每个候选显示名称和相似度
• 颜色不匹配的候选会标注 (需XX色) 提示
• 金/银/铜三色区分排名，一目了然
• 主颜色自动检测：计算画作中出现最多的颜色作为主色

5. 颜色选择器UI优化

• 色块从 16px 加大至 18px，更易点击
• 5列3行排列，14种颜色整齐展示
• 选中颜色有白色加粗边框高亮，状态清晰
• 底部信息栏显示当前笔刷大小和颜色名称
• 切换颜色时自动清除旧的预览结果

🔧 技术改进

• 网络包优化：32x32 位图使用 int[] 压缩传输，比 v2.0 的 long[] 更高效
• 新增主颜色字段传输（1 byte）
• 识别引擎重构：支持颜色匹配参数，颜色不匹配时应用惩罚系数
• 新增 getMainColor() 方法：自动统计画作主色调
• RecognitionResult 扩展：增加 shapeScore（纯形状分）、mainColor（主颜色）、top3（前三候选）
• 版本号升级至 3.0.0

🐛 修复

• 修复低分辨率下画布和按钮超出屏幕的问题
• 修复快速切换颜色后预览结果残留的问题

---

v2.0.0 - 2026-08-25

✨ 新功能

彩色画笔系统

• 新增 14种颜色 调色板：白、红、橙、黄、绿、青、蓝、紫、粉、棕、金、灰、黑、翠绿
• 画板右侧新增颜色选择区域，点击色块切换当前颜色
• 选中的颜色有白色边框高亮提示
• 底部信息栏显示当前笔刷大小和选中颜色名称
• 画笔光标预览使用当前颜色的半透明效果
• 识别算法优化：彩色图像自动二值化，颜色不影响形状识别

识别种类扩充（20种 → 42种）

新增物品（10种）： 煤炭、红石、青金石、绿宝石、面包、胡萝卜、弓、箭、水桶、书 新增生物（6种）： 蜘蛛、史莱姆、村民、狼、蝙蝠、铁傀儡 新增方块（6种）： 草方块、工作台、熔炉、箱子、南瓜、黑曜石

🔧 优化

• 界面布局优化：右侧面板增加颜色选择区和信息显示
• 标题更新为"神笔马良 v2.0"
• 版本号升级至 2.0.0

---

v1.0.0 - 2026-08-25

✨ 初始版本功能

核心玩法

• 新增神笔物品，右键打开 64x64 像素画板
• 左键绘画、右键擦除
• 可调节笔刷大小（0~5格）
• 圆形笔刷，拖动绘画带插值补全（快速拖动不断线）
• 「清除画布」按钮一键清空

图案识别系统

• 基于 16x16 模板匹配的识别引擎
• 识别算法：IoU（交并比）+ 召回率 + 精确率 组合评分
• 相似度低于 35% 提示"无法识别"
• 「预览识别」按钮：本地预览识别结果，不消耗生成
• 「识别并生成」按钮：发送到服务器生成对应内容

可识别内容（20种）

物品7种： 钻石、金锭、铁锭、苹果、铁剑、铁镐、火把 生物8种： 苦力怕、僵尸、骷髅、牛、猪、鸡、羊、末影人 方块5种： 圆石、橡木原木、玻璃、钻石块、TNT

生成机制

• 物品：在玩家前方生成，带向上弹起动画
• 生物：在玩家前方2格处生成
• 方块：在玩家前方2格处放置
• 聊天栏显示识别结果和相似度百分比

其他

• 创造模式专属「神笔马良」标签页
• 中文（zh_cn）+ 英文（en_us）双语支持
• 自定义画笔物品纹理
• 服务端/客户端网络通信（SimpleChannel）
• 兼容 Minecraft 1.20.1 + Forge 47.2.0+

🐛 Bug修复

• 修复画板按钮被画布遮挡、超出屏幕底部的问题
• 按钮布局从底部移至右侧垂直排列

---

技术信息

• 模组ID: magicbrush
• 适用版本: Minecraft 1.20.1
• 加载器: Forge 47.2.0+
• Java版本: Java 17
• Gradle版本: 8.1.1
• 识别算法: 16x16 模板匹配（IoU + 召回率 + 精确率 + 颜色匹配）
• 画布分辨率: 32x32 像素（v3.0）
• 网络协议: Forge SimpleChannel
• 许可证: MIT