1.3.0
What's new
更新日志
版本号与 LibMonetColor-1.0.toc 的 ## Version 保持一致;对外 API 在 1.x 内向后兼容。
1.3.0 — 2026-11-15
状态层可消费「接入方加工过的色板」+ 回灌一处版本分叉
Anim:SetBaseColorProvider(fn)/Anim:GetBaseColorProvider()(新增): 状态层原本直接从核心引擎缓存取edge/ambient/highlight/neutral,接入方若在 自己的策略层做过亮度阶梯、对比度纠偏或主题覆盖,那批加工色到不了状态层。现在可注入function(key) -> r, g, b, a,注册 / 清除立即重绘所有 sink;返回nil、抛错或未注册时 一律回落引擎缓存,显式{r,g,b,a}的 sink 基色优先级更高。仍是「库给原语、策略归消费方」 (R-04),不改变对比度归消费方这一分工。未注册时行为与 1.2.x 完全一致,1.x 内向后兼容。- 回灌 11-02 分叉:
ComputeNeutral的「可读性优先」规则(明度 =1 - envL,钳在lMin 0.25 / lMax 0.85,替代原先跟随环境的lMin + envL*lRange)此前只落在 MonetUI 的 vendored 副本里,源仓一直停在旧公式、版本号也没跟上。本版把它收回源仓, 两仓 core 重新一致。 - 版本:
## Version1.2.0 → 1.3.0;coreMINOR10003 → 10005(10004 是那次分叉在 vendored 副本里占用的号);AnimMINOR10000 → 10001(状态层自身 v1.1.0)。 - 测试:
test_anim_runtime补 7 项 provider 用例(注入 / 回落 / 抛错隔离 / 显式基色优先 / 注册与清除重绘 / 参数校验),test_hardening把过时的lRange断言改成钳制边界断言并补 1 项逆明度用例。7 组共 163 项全通过。 - 发布链路:
.github/workflows/release.yml、.pkgmeta、CURSEFORGE.md首次纳入版本库 (此前只在本地),tag 触发打包上传才生效。
数据层 — 2026-11-08(引擎 API 与 MINOR 均未变更)
data/game_palette_v1.json扩到 25 区,每条带source(当前trip18 /game7);MonetColorMapData-1.0.lua由gen_map_env.ps1重生成,数值随底账。- 补拍 7 区 trip v2 出图(相机原图 1536×2048)升级色源:阿拉希高地 / 提瑞斯法林地 / 银松森林 / 希尔斯布莱德丘陵 / 艾尔文森林 / 西部荒野 / 奥格瑞玛;其余 18 区逐字段零变化。幽暗城 1458 保留 game 色(旅拍取点落在洛丹伦废墟地表,语义不符)。
- 色源优先级定为 官方地图美术贴图 > wuxianwow/trip > 自己的游戏截图;
trip_sources.json记取点与format,source_bias.json记 v1/v2 口径差「不做比例校正」。 tests/test_map_sampler.lua不再硬编码区域 h/s/l,改从数据模块读期望值、区数下界 14 → 25;修掉本轮数据升级造成的 4 项回归。7 组共 155 项全通过。
1.2.0 — 2026-10-30
色彩工具函数(纯函数,不读缓存、不发事件)
LMC.ContrastRatio(r1,g1,b1, r2,g2,b2)— WCAG 2.x 对比度,顺序无关,>= 1;1.0 即"等亮、看不出差别"。相对亮度复用RGBToXYZ的 Y(与RGBToLab同一套 sRGB 解码,口径一致)。LMC.AtLightness(r,g,b, targetL)— 保住色相与饱和度,把颜色按 CIE L* 重定位(在 HSL 的l轴上二分,容差 0.25、最多 24 轮);目标超出该色相可达范围时返回最接近的那一个,不静默改色相。- 保守回退:
ContrastRatio遇到读不出来的分量(缺字段 / 非数值 / NaN / secret)返回 1——宁可得出"分不开",也不拿一个猜出来的数字充数;AtLightness同情况按契约返回中性灰,targetL读不出则原色返回。 - 这两个函数补的是决策日志 R-04 留的口子:对比度校验不内置进主题计算(不碰每帧路径),只给原语,"要几级阶梯、差多少 L*"归消费方自己定。功能色依旧不 Monet 化。
MINOR10002 → 10003(vendored 的接入方需要看见"更新的库",否则NewLibrary直接返回 nil,新代码不加载)。- 测试 24 项(
tests/test_color_tools.lua),覆盖可达/不可达目标、色相与饱和度守恒、单调性、越界钳制、非法与 secret 输入;全套 155 项通过。
1.1.0 — 2026-10-21
状态染色层 LibMonetColor-Anim-1.0(新文件)
- 玩家状态 → 颜色修饰:战斗增亮 / 进战闪烁 / 战斗脉搏 / 低血红与加速脉搏 / 脱战降亮 / 休息冷调 / PvP / 载具 / 死亡灰化。
RegisterColorSink(fn, opts)订阅最终颜色,opts.base选色彩槽、opts.pulse控制脉冲、opts.modifiers逐项关掉不需要的修饰。- 全部闪烁共用一个 ticker:64 点查表波形、15 fps、空闲自动停表;无 sink 无回调时零开销。
GetColor(base, atTime?, modifiers?)拉取式取色,GetPlayerState()暴露状态快照,SetStyle / GetStyle / ResetStyle深合并样式。- 保密值安全:受限状态读不到血量时只关掉低血效果,不抛错。
核心引擎
## Version升到 1.1.0。- 抽出
Libs/LibStub/LibStub.lua内嵌副本,自带LibMonetColor-1.0.toc,可作为独立 addon(LoadOnDemand)加载。 - 测试补到 131 项,覆盖 LibStub 加载顺序、状态染色取色与 sink / ticker / 事件路径。
1.0.0 — 2026-10-16
首个可用版本:环境驱动配色引擎。
- HSL 转换、莫奈规则引擎(环境互补色 + S 曲线钳制 + 色相域细分 + 无彩域兜底)、Delta E 缓存防抖。
- 「5+3」色彩模型:功能色(Primary / Health / Resource / Danger / Neutral)与风格色(Edge / Ambient / Highlight)分离。
- 生产者 API:
RegisterProfile/SetActiveProfile/GetRules/ClearCache。 MonetColorMapData-1.0数据模块(14 区域环境色,由tools/extract_game_palette_v1.ps1→tools/gen_map_env.ps1生成)。- 环境解析链:运行时覆盖 → 区域数据 → 父地图 → 回退;未收录地图回退中性无彩。
- 契约:永不抛错、返回值钳制在
[0, 1]、事件防抖(Delta E > 5.0)、消费者回调隔离、警告冷却 30 秒。 - 测试 45 + 14 + 16 + 4 项,全部可脱离游戏用
lua直接运行。
This mod has no additional files