Touhou Maid: Affection

[1.7.5.0] - 2026-09-25

Added

• 设置面板「功能」tab 末尾新增「缓存策略」区（bond.settings.section.cache_policy）：每池目标条数 / 扫描间隔 两个整数（复用紧凑数值控件 BondNumberField）与 消费即用 胶囊开关，全部走既有服务端权威通道（OP2 + [TMA Settings] 审计 + 状态回推 + pending 状态点，不新造视觉）。为此新增 4 个白名单键——morning_kiss.immediate_fallback_enabled（映射 ModConfig.BOND_MORNING_KISS_AI_DIALOGUE_IMMEDIATE_FALLBACK_ENABLED）、morning_kiss.cache_target_per_pool、morning_kiss.cache_scan_interval_ticks、morning_kiss.cache_consume_on_use（映射 ModConfig.BOND_MORNING_KISS_AI_DIALOGUE_CACHE_CONSUME_ON_USE），白名单从 10 项扩到 14 项（9 开关 + 2 语种 + 1 文本 + 2 整数）。TmaSettingsKeys 新增取值类型 Type.INT：只接受纯数字，逐键按 ModConfig defineInRange 的上下界校验（每池目标条数 1..8、扫描间隔 20..72000 tick），非数字/越界一律拒绝，并沿用既有的整包拒绝语义。morning_kiss.cache_consume_on_use 已从「功能」tab 的通用布尔列表里排除（TOGGLE_KEYS 过滤），「消费即用」在整个面板里只出现一次（就在缓存策略区内）。
• 新增紧凑数值输入控件 BondNumberField（单行原版 EditBox，关闭原版边框、复用面板字段式配色；只允许数字、失焦提交、提交前按范围夹取、右侧显示单位如 1200t）。范围跨度 20..72000 用滑块精度不可用，因此不做滑块。
• 新增中英 lang 键：bond.settings.section.cache_policy、bond.settings.key.morning_kiss.cache_target_per_pool / bond.settings.sub.morning_kiss.cache_target_per_pool、bond.settings.key.morning_kiss.cache_scan_interval_ticks / bond.settings.sub.morning_kiss.cache_scan_interval_ticks、bond.settings.status.pool.general（通用 / Any）、bond.settings.key.morning_kiss.immediate_fallback_enabled 与 bond.settings.sub.morning_kiss.immediate_fallback_enabled、bond.settings.key.morning_kiss.cache_consume_on_use 与 bond.settings.sub.morning_kiss.cache_consume_on_use、bond.settings.number.tip，以及状态页恢复只读后重新引用的 bond.settings.status.language.auto.display / bond.settings.status.language.auto.voice。
• 新增游戏内「全局设置」面板「语音」tab 的「台词提示词」多行编辑框：直接编辑早安吻 AI 台词模板（占位符 {maid} 女仆名 / {player} 玩家名 / {pool} 时段 / {time} 允许时段），带占位符图例与「恢复默认」按钮。这是服务端权威的新设置类型 TEXT（逻辑键 morning_kiss.text_prompt，上限 1024 字符，保存空值写回内置默认模板），沿用现有 OP2 + 审计日志的写入路径。字数计数画在编辑框内部右下角（次要文字色），占位符图例独占编辑框下方一整行、占满内容区整宽（完整显示、不再截断），「恢复默认」按钮移到编辑框上方标签行右对齐，「恢复默认」改用面板通用的文字按钮渲染（与「打开」「清空」同一个 drawTextButton 模板，无权限时置灰）。编辑框本身支持框内滚动：新增子类 BondPromptBox 把滚动步长（scrollRate() = 9px）与滚动上限（9 × (总行数 − 可见行数)）都吸附到文本行网格，编辑框高度取 9 × 行数 + 4（49px = 5 行 + 内边距），因此文字永远按整行显示、不会从行中间被切断；鼠标在框内滚轮只滚框内文本、不再带动面板，光标移出可视区时由原版光标监听自动滚动保持可见。
• 新增设置面板「状态」tab：移植 /tma morning_kiss status 与 /tma morning_kiss cache 的信息，全部只读——开关（早安吻 / AI 台词 / AI 语音 / 立即兜底）、语种（文本语种 / 配音语种，未配置显示 auto（跟随游戏语言） / auto（跟随女仆 AI 设置））、缓存策略（每池目标 / 扫描间隔 / 消费即用）都用纯文本行渲染（没有胶囊开关 / 下拉框 / 数值框 / pending 状态点），缓存统计（条目语音/纯文本、女仆数 / 在途 / 版本号）与按女仆列表（名字 + 各时段池条目数 + 总条目/目标 + 行内「清空」）同样只读。配套新增只读状态通道 TmaAiStatusRequestPayload / TmaAiStatusPayload 与清缓存操作包 TmaAiCacheClearPayload：状态只回该玩家名下的女仆，清缓存需 OP2 + 审计日志并复用 /tma morning_kiss clear_ai_cache 完全相同的服务方法。
• 新增设置面板「语音」tab 的「打开车万女仆的 AI 设置」按钮：跳转 TLM 原生 AIChatSettingsHubScreen（parent 传本面板，关闭后回到这里），是全局唯一的 AI 入口；TMA 不自建站点表单。
• 新增游戏内「全局设置」面板：在羁绊页顶部右侧（原 TMA AI Hub 按钮的槽位）新增「设置」入口，面板与当前女仆无关，分四个 tab——状态（只读）、功能开关（早安吻 / 女仆主动早安吻 / AI 台词 / AI 语音 / 立即兜底 / 残血救护 / 随机礼物 / 少女祈祷 Buff，末尾是「缓存策略」区：每池目标条数 / 扫描间隔 / 消费即用）、语音（文本语种 / 配音语种下拉框 + 台词提示词 + AI 站点入口）、音量（亲吻音效 / 早安吻语音 / 残血救护 / 语音试听，0.0–1.0 步进 0.05）。无需再手改 toml。
• 新增服务端权威设置同步通道：TmaSettingsRequestPayload（C2S，空列表表示只读状态）与 TmaSettingsStatePayload（S2C，回推全部白名单键的当前值与 canEdit）。面板里的开关与语种由服务端校验、应用并回推，单人存档与多人服务器行为一致。
• 新增自绘滑块组件 BondSlider，供设置面板的音量项使用。

Fixed

• 修复设置面板下拉弹层被下层控件文字穿透（「恢复默认」浮在展开的列表之上）：根因是 GuiGraphics 把填充与文字分入不同 render type 缓冲、同帧按创建顺序刷出（填充先、文字后），于是先画的文字会盖住后画的填充。修法：画弹层前 graphics.flush() 先把此前的填充+文字落地、弹层底色改为不透明，并在弹层矩形确实覆盖某控件时跳过绘制该控件（BondDropdown#overlayCovers 判定，未覆盖时控件照常显示）。
• 修复「状态」tab「按女仆」行的池计数渲染成原始 key bond.settings.status.pool.general：lang 文件缺 GENERAL 池的键，现已补齐中英两语言；并新增回归测试 TmaSettingsLangKeysTest，逐一遍历 DialoguePool 的全部取值断言中英 lang 都存在 bond.settings.status.pool.<小写枚举名>，同时断言每个可编辑键的 bond.settings.key.* / bond.settings.sub.* 与状态页相关键存在（缺键时直接测试失败，而不是等到界面上露出原始 key）。
• 修复「状态」tab 行内文本压到「清空」按钮下面的问题：只读值行与女仆行一律在「控件左边界 − 间距」处用 clip(...) 截断并补省略号（女仆行拆成名字列 + 右对齐的计数列），长值（24 (18 / 6)、3 / 1 / 42、早 9 · 晚 9 · 通用 0 · 18/12）不再与控件重叠。
• 修复「语音」tab 占位符图例被截断（原可用宽度仅 218px，中英文案分别需 309px / 348px）：图例改为独占一整行、使用内容区整宽 270px，文案缩短为 {maid} 女仆 · {player} 玩家 · {pool} 时段 · {time} 允许时段（260px）与 {maid} maid · {player} player · {pool} pool · {time} range（261px），中英双语都完整显示；「恢复默认」按钮移到上方标签行右对齐。
• 修复设置面板语种下拉框最后一项被裁剪的问题：展开的弹层不再受面板内容区 scissor 约束，改为夹在屏幕范围内——向下会溢出屏幕底部时翻到表头之上渲染，命中测试/高亮/点击与实际渲染位置保持一致，所有候选条目可达。
• .maid 迁移不再携带运行态/调度键：导出（BondData.exportMaidData）剔除 BondKeys.RUNTIME_KEYS——礼物计时（RandomGiftLastWallClock / RandomGiftLastDelivery / RandomGiftLastIntervalMinutes）、早安吻窗口标记（MorningKissScheduledWindow / MorningKissScheduledAttemptTick / MorningKissLastAutoAttemptGameTime / MorningKissLastSuccessWindow / MorningKissLastFailedWindow）与本地记账 LastSeen——导入时再防御性剔一遍。此前这些会话/世界相关的绝对时间会随 .maid 迁到新女仆/新存档，导致刚导入就被判定「今天已亲过」或礼物计时错乱。待发礼物队列 RandomGiftQueue 是耐久状态，仍然随迁；extras 对外形状与整体替换语义不变。
• 空字符串不再落盘/导出：所有「getter 缺省值本就是空串」的字符串 setter（声音包、YSM 档案、救护动作、膝枕动作、早安吻计划/窗口标记、玩家粒度早安吻选择、早安吻与救护语音选择里的空字段）改为空串时移除键而非写入空值，避免无意义键堆积进存档与 .maid。

Changed

• 设置面板改为单张整页底图 + 控件叠加：外框、表头分隔线、侧栏分隔线、footer 分隔线与左下角写实玫瑰全部烘进 textures/gui/settings_panel.png（1020×690 RGBA，已烘入 0.90 不透明度），面板背景改为一次 blit（按面板 340×230 逻辑尺寸在 GUI scale 3 下 1:1，不缩放、不额外着色），代码不再自绘面板底色 / 边框 / 分隔线；屏幕压暗层、tab 高亮、所有控件与配色 token、footer 按钮保持不变。为对齐底图，BondGuiTokens.MODAL_TITLE_HEIGHT 24→20（表头分隔线落在面板高的 20/230）、NAV_WIDTH 46→50（侧栏分隔线落在面板宽的 50/340），因此内容可视高 168→172px、内容区宽 274→270px（占位符图例 260px / 261px 仍不截断），各 tab 的 maxScroll 随可视高自动收敛。
• 「状态」tab「按女仆」列表对同名女仆去歧义：名字列新增纯逻辑助手 bond/settings/TmaMaidLabels，输入该玩家的女仆 (uuid, 名字) 列表输出显示标签——名字唯一时原样显示（不加噪声），同名出现 ≥2 次时这些行追加 # + UUID 前 4 位十六进制（小写），如 精灵酒狐 #a1b2；名字为空/空白回退为可本地化的占位名（新增 lang 键 bond.settings.status.maid.unknown，zh 未知女仆 / en Unknown maid，由 TmaSettingsScreen 传入 Component.translatable(...).getString()），并追加短 ID，如 未知女仆 #a1b2。名字列仍按原有 clip(...) 规则截断到可用宽度，不挤占行内「清空」按钮。配套单测 TmaMaidLabelsTest，TmaSettingsLangKeysTest 一并守护该新键。
• 设置面板间距放宽（用户反馈「配置页间距太挤」）：SECTION_HEADER_HEIGHT 12→15、ROW_GAP 3→6、LANGUAGE_ROW_HEIGHT 17→20、PROMPT_BOX_HEIGHT 36→49（= 9 × 5 行 + 内边距）、PROMPT_ROW_HEIGHT 12→14、STATUS_KV_HEIGHT 12→13、STATUS_ROW_GAP 2→6。上一轮的「语音 tab 打开即免滚动」要求随之作废：功能（294px）/ 语音（208px）/ 状态三个 tab 超出内容可视高 172px（230 模态高 − 20 标题 − 8 内容上留白 − 30 footer）时一律走面板内部滚动。占位符图例仍独占一整行、占满内容区整宽 270px（340 − 2 − 50 − 8 − 2 − 8，横向槽位不受间距常量影响），中英文案按原版字宽表复算为 260px / 261px，均 ≤ 270px、不截断。
• 设置面板 tab 顺序改为「状态 / 功能 / 语音 / 音量」：「状态」提到第一位并作为打开面板的默认选中项（activeTab 默认 0、tabLabel、导航命中测试与文档同步），状态 tab 请求 AI 状态改在 init() 里发起；「缓存策略」三个控件从状态页搬到「功能」tab 末尾，状态页对应的三行改回只读纯文本。
• 设置面板尺寸 300×188 → 340×230，侧栏 tab 从 3 个（功能 / 语音 / 音量）扩到 4 个（新增「状态」）；内容超出可视区走内部滚动。配色 token、服务端权威语义与既有状态机不变。
• 羁绊页「设置」按钮从左上空位移到面板右上角（原 TMA AI Hub 按钮的槽位）：尺寸 50×12，位置 x = panelX + panelWidth - 50 - 2、y = panelY - 12 - 3（即原 AI 按钮的 Y），文案仍是「设置」、居中绘制；命中测试与 tooltip 同步更新，左上空位不再有按钮。
• 音量上限从 4.0 收至 1.0：四项音量配置（cooldown.kissSoundVolume、morningKissBehavior.voiceVolume、emergencyRescueBehavior.volume、voicePreview.volume）与设置面板滑块现在只做衰减——0.0 静音、1.0 保持原有响度，不再放大。需要更大音量请使用 Minecraft 或系统音量。旧配置里大于 1.0 的值会被配置系统在加载时纠正为 1.0（Forge defineInRange 行为）。
• 音量四项（cooldown.kissSoundVolume、morningKissBehavior.voiceVolume、emergencyRescueBehavior.volume、voicePreview.volume）是纯客户端配置，面板里拖动即写入本机配置并立即生效，不走网络。
• 语音试听冷却从 5 秒降到 0.5 秒（100 → 10 tick）；被限流时给客户端一行 action bar 提示「试听过快，请稍候」，不再静默丢弃；非数据包（本地）试听请求不再占用限流额度。
• 早安吻 AI 台词缓存改为按语种读取：pollRandom / peekRandom 与预热满度判定（countMatching、addIfBelowTarget）都按当前解析出的显示/配音语种过滤，改了显示或配音语种后会自动按新语种重新预热，旧语种条目保留但不再被选中，也不再阻塞重新预热（仍可手动 clear_ai_cache）。目标语种为空（auto）时不过滤，保持旧行为。
• /tma morning_kiss status 的语种行改为两行说人话：文本语种：<值>（未配置显示 auto）、配音语种：<值>（未配置显示 auto），删掉 AI 覆盖与生效优先级两行。
• 早安吻语种语义统一为两个：文本语种（displayLanguage，内置数据包台词 + AI 生成台词用哪种语言显示；auto = 跟随游戏语言，内置台词按客户端语言渲染、未标记数据包台词通配、AI 台词沿用女仆的 TLM 聊天语言）与配音语种（voiceLanguage，数据包语音 + AI 合成语音用哪种语言；auto = 跟随女仆的 TLM AI 语言设置，数据包语音不按语言过滤、AI 合成沿用女仆的 TLM TTS 语言）。具体 locale（zh_cn / ja_jp…）固定该语言。旧关键字 tlm / inherit / default 继续接受，等价于 auto，但面板与状态页一律显示归一化后的 auto。
• 全局羁绊 UI 配色统一为「暖木底 + 玫瑰（交互面 / 装饰）+ 金（仅高亮文字）」：BondGuiTokens 换用新调色板（保留原常量名，新增开关 / 字段 / 滑块 / 导航等语义色常量），所有调用点自动跟随。设置面板同步按设计稿收口：300×188 模态框、46px 侧栏三 tab、胶囊开关、78×20 字段式下拉、88×13 滑块（数值金色居中）、分区作用域标签、行内请求状态点与「完成 / 重载」footer。不影响功能与其它二级页布局尺寸（仍为 172×150）。
• 设置面板从「女仆 GUI 内嵌二级页」改为独立 Screen（TmaSettingsScreen，删除 SettingsSecondaryPage）：在羁绊页「设置」按钮处用 Minecraft#setScreen 打开，自带全屏压暗背景，关闭（footer「完成」/ESC/点击压暗区）返回来源的女仆 GUI。面板尺寸/配色/控件与交互 token 不变，服务端权威语义、payload、状态机与音量直写零变更；除设置页外的其它二级页与 BondSecondaryPage 接口不受影响。
• 设置面板语种从 4 项砍到 2 项：白名单变为 7 开关 + 2 语种 = 9 项，面板只保留「文本语种」（display_language）与「配音语种」（voice_language），两者统管内置数据包与 AI 两条链路。
• 羁绊数据改为按女仆嵌套存储：女仆粒度数据从「根上扁平键 <base>_<女仆UUID>」改为 touhou_maid_affection.bond.maids.<女仆UUID>.<base> 子树，玩家粒度键（早安吻选择）仍在根上；键名常量集中到 BondKeys。首次读取旧存档时自动执行一次性迁移（根上新增 SchemaVersion，先写后删、幂等、无法解析的键原样保留），旧存档无损升级，无需手动操作。反查（按能力找女仆、按模型 ID 找女仆、按救护 provider 找女仆、批量重置能力）改为遍历女仆子树，不再全键扫描。
• 新增 /tma bond prune [days]（默认 90 天，权限等级 2）：清理执行者羁绊数据中 LastSeen 早于阈值的女仆子树（缺失 LastSeen 的历史数据视为过旧；days <= 0 只统计不删除），并回显删除/保留数量。LastSeen 在同步女仆档案时刷新；不在女仆死亡 / 卸载 / 换主人时自动删除数据（TLM 灵魂玩偶、椅子等会临时移除实体，自动删会丢数据），只能靠该命令显式清理。
• .maid 迁移（MaidFileManager SPI）的附加数据对外格式不变：仍是「base 名 → 值」的 compound（即女仆子树本身），旧导出文件仍可导入，导入后刷新 LastSeen。
• 删除若干零调用者死代码：BondData/BondManager.getUnlockedMaidModelIdsForAbility、BondData/BondManager.findMaidProfileByRescueProviderId、MorningKissGeneratedDialogueService.hasCachedLine（两个重载）、MorningKissGeneratedDialogueCache.isEmpty，以及已被 BondKeys 取代的 compat/maidfm/MaidDataKeyCodec。

Removed

• 删除独立玫瑰贴图 textures/gui/rose_vine.png 及其绘制代码：TmaSettingsScreen#renderVine、ROSE_VINE 资源常量、NAV_VINE_WIDTH / NAV_VINE_HEIGHT / NAV_VINE_TEXTURE_WIDTH / NAV_VINE_TEXTURE_HEIGHT 尺寸常量与相关 javadoc 一并移除（全仓 grep -ri rose_vine 零命中），玫瑰改由整页底图承载。
• 删除 AI 专用语种覆盖层：ModConfig 的 morningKissBehavior.aiDialogueLanguage / aiDialogueVoiceLanguage 两项（含 toml 键 aiDialogueLanguage / aiDialogueVoiceLanguage）与解析链里的优先级逻辑（MorningKissLanguageSettings#liveChatLanguage 的「AI 显式 > 全局显式 > 旧语义」判定、resolveGeneratedTextLanguage / resolveGeneratedVoiceTextLanguage 的 AI 专用入参与配音继承显示语种的规则）。若此前用 AI 覆盖让 AI 台词/配音与内置台词/语音用了不同语言，现在统一由文本语种与配音语种控制——把原来的值填到这两项即可（例：原来 aiDialogueLanguage=zh_cn + aiDialogueVoiceLanguage=ja_jp，现在填 displayLanguage=zh_cn + voiceLanguage=ja_jp）。旧 toml 里残留的这两个键不再被定义，配置系统直接忽略，无需手动清理。
• 删除 TMA 自研的 AI 站点适配层：com.github.touhoumaidaffection.ai.mimo 整包（TmaMimoAdapterExtension provider 注册、MimoLLMSite / MimoTTSSite 站点类型与 serializer、MimoTTSFormLayout 站点表单、MimoLLMClient / MimoTTSClient / MimoHttp / MimoProtocol / MimoCodecHelper 协议实现、BoundedHttpClient / BoundedHttpResponse 有界响应工具）及其单元测试（MimoProtocolTest 7 例、BoundedHttpResponseTest 3 例）。
• 删除 ModConfig 的 tmaMimoAdapter 配置段：enabled / apiKey / chatUrl / ttsUrl / maxCompletionTokens / ttsVoicePrompt / ttsAudioFormat 七项。旧 toml 里残留的 [tmaMimoAdapter] 键不再被定义，配置系统会直接忽略，无需手动清理，也没有迁移代码。
• 删除中英文文案中的 MiMo 站点名与入口文案（各 6 个键）。
• 羁绊页顶部不再有任何 AI 入口：原右上角「TMA AI Hub」按钮整条删除（含字段、渲染、命中测试、tooltip、BondPrimaryPageHost#openMimoAdapterSettings / isMimoAdapterAvailable 及其实现与 TLM AI hub 跳转）。AI 相关配置今后由 TMA 自己的设置面板承担。
• 早安吻的 LLM/TTS 本就完全走 maid.getAiChatManager() 里 TLM 自己的站点，删除适配层不影响任何功能；TMA 也不再提供全局音色提示词（音色由 TLM 站点配置决定，GPT-SoVITS 站点另有其原生 prompt 字段）。
• 旧站点条目处理：TLM 读取 config/touhou_little_maid/sites/{llm,tts}.json 时，api_type 找不到对应 serializer 的条目只记一条 error 日志并跳过（不抛异常、不崩溃），随后 TLM 保存站点时把该条目从文件里清掉。实测：删掉适配层后启动服务器，日志出现 Unknown LLM site type: tma_mimo_chat 与 Unknown TTS site type: tma_mimo_tts，服务器正常完成启动，且 tma_mimo_chat / tma_mimo_tts 两个条目已从两个 json 中消失——玩家无需手动删旧站点条目。

Notes

• MaidFileManager 1.4.0 已正式发布（GitHub Releases，fabric/forge/neoforge 四产物）：官方 SPI 与我们所 vendored 的版本逐字节一致，集成无需改动；官方把 .maid 格式版本从 5 升到 6，但迁移只作用于女仆实体 NBT，extras（我们的羁绊数据）不受影响，旧 v5 导出文件仍可导入。两实例已把自建 1.4.0 换成官方产物。
• 权限：开关、语种与缓存策略属于服务端权威设置，只有 OP（权限等级 2）可以修改；普通玩家能看、不能改，界面底部会显示「只读」提示，按钮 tooltip 提示需要管理员权限。每次成功修改都会在服务端日志打印 [TMA Settings] player=... key=... old=... new=...；越权或非法请求打印 WARN。
• 非法请求（未知 key、非法布尔、非法语种、超长值）整包拒绝，不会部分生效。
• 语种下拉框只提供 auto 与常见 locale，当前值若不在列表里会动态补上；旧关键字 tlm / inherit / default 仍是合法值（服务端原样存储、语义等价 auto），但面板与状态页显示归一化后的 auto，不再作为候选条目出现。

[1.7.4.0] - 2026-09-24

Added

• 新增 morningKissBehavior.displayLanguage（默认 auto）与 morningKissBehavior.voiceLanguage（默认 auto），把原先只存在于 AI 链路的「显示语种 / 配音语种」解耦提升为全局可配，并让数据包链路同样支持按语种选择台词与语音。
• 数据包 data/touhou_maid_affection/morning_kiss/profile.json 纯增量扩展：dialogue.<pool> 元素接受 {"text": "...", "language": "zh_cn"}，voice_files 元素接受 {"file": "x.ogg", "language": "ja_jp", "text": "可选字幕", "text_language": "zh_cn"}；旧的纯字符串写法保留并视为「未标记」通配，向后兼容。
• voice_files[].text / text_language 支持语音与字幕配对：选中该语音时直接显示配对字幕，不再随机抽台词；text_language 与目标显示语种不一致时退回随机台词。

Changed

• 语言解析优先级统一为「AI 专用显式 locale > 全局显式 locale > 旧语义（tlm / inherit / auto）」；tlm/inherit/auto 语义与翻译、缓存机制保持不变。旧配置项名字与默认值不变。
• 数据包台词与语音选择新增语种优先级：匹配目标语种的条目 → 未标记条目 → 全部条目。dialogue_mode=append 时内置台词按「语言 = 客户端语言」参与同一筛选。
• auto（默认值）下行为与 1.7.3.0 完全一致：不启用任何语种筛选。

Notes

• 内置台词仍是 i18n key，由客户端按自身语言渲染，服务端无法指定渲染语种；TLM 音包没有语言元数据，天然单语种，不参与筛选。

[1.7.3.0] - 2026-07-24

Added

• 新增 cooldown.kissSoundVolume 配置项，可在 0.0 到 4.0 之间调整普通亲吻与早安吻复用亲吻音效的音量；0.0 可静音，1.0 保持旧版默认响度。
• 新增 morningKissBehavior.voiceVolume、emergencyRescueBehavior.volume 与 voicePreview.volume 配置项，分别控制早安吻语音、残血救护语音/兜底音效和羁绊页语音试听音量。
• 新增 morningKissBehavior.aiDialogueVoiceLanguage，可将 AI 早安吻的显示文本与配音文本设为不同语言；例如 aiDialogueLanguage=zh_cn、aiDialogueVoiceLanguage=ja_jp 会显示中文台词，并先翻译为日文后请求 TTS。
• 新增 randomGiftBehavior.curatedPoolOnly，默认只从 touhou_maid_affection:bond_random_gift_pool 物品标签抽取礼物；可通过 bond_random_gift_blacklist 继续追加黑名单。
• 新增可选的残血救护最大生命百分比阈值配置；启用后按最大生命的 20% 触发，在原版 20 点生命下仍等于旧版 4 点阈值。为兼容旧服自定义配置，该模式默认关闭。
• 接入 MaidFileManager（女仆档案管理器）迁移 SPI：导出 .maid 时携带该女仆的羁绊数据（羁绊等级、能力解锁、语音池与播放模式、膝枕姿态、随机礼物队列与计时、早安吻计划/窗口、救援动作与提供者 id 等），导入到新存档/新版本时按新 UUID 自动还原；未安装管理器时静默不生效。

Changed

• 休闲膝枕按键默认改为未绑定，仍可在 Minecraft 控制设置中自行绑定，避免默认占用常见的 B 键。
• 羁绊页中的休闲膝枕触发提示与能力描述改为显示当前实际绑定按键，不再固定显示 B。
• 随机礼物默认不再遍历几乎全部物品注册表；显式标签池成为默认来源，旧的广泛抽样模式仍可通过配置恢复。
• 羁绊解锁提示现在显示背包中的 P 点物品数量，并明确其不是神社庭灯存储的 P 点数值；点击不可用按钮时会显示失败原因。
• 早安吻调度、对话来源与语音池策略拆分为独立模块；客户端内存语音统一复用格式检测、异步解码和实体跟随实现，减少不同播放入口之间的行为漂移。

Fixed

• 拒绝膝枕姿态中的 NaN/无限坐标，避免无效网络数据污染玩家存档和实体姿态。
• 对持久化 AI 早安吻语音执行 2 MiB 单文件上限并隔离可变字节数组，避免异常 TTS 或手工缓存文件造成内存放大与缓存篡改。
• 拒绝膝枕角度锁中的非有限旋转值，并在启动与持续执行期间复核女仆当前所有权。
• 数据包语音改为有界流式读取，并在构造资源位置前过滤非法大小写、空格和路径字符，避免资源重载期间的过量分配或中断。
• 限制客户端可控语音配置和动作标识的持久化长度，并为数据包语音试听增加每玩家 100 tick 冷却和请求字段上限，避免玩家 NBT 超限和小请求放大为连续大响应。
• 旧版广泛随机礼物模式仅默认排除屏障、命令方块、结构方块、调试棒等破坏沉浸感的技术/管理物品；基岩与刷怪蛋仍可正常出现。显式礼物池标签可覆盖默认排除规则。
• MiMo Chat 与 TTS 响应改为有界流式接收：聊天响应上限 1 MiB、TTS JSON 响应上限 4 MiB、解码后音频上限 2 MiB；远端错误正文只保留 512 字符摘要，避免异常响应造成内存和日志放大。

Removed

• 移除潜行空手右击女仆的亲吻入口及其 cooldown.rightClickKissEnabled 配置，避免永久占用 TLM 坐下/站起交互；亲吻改用准星目标或公主抱专用按键。