Promaid v1.3.1 正式版（1.20.1 Forge + 1.21.1 NeoForge）

Promaid v1.3.1（1.20.1 Forge + 1.21.1 NeoForge）正式版更新说明

本版是「以优化为主」的一版。 新功能只加了少数几项（见第一节），其余 40 多轮改动基本都是
老 bug 的修复与使用手感上的优化——包括两条崩溃、一个从很早以前就存在的老坑、一个能刷物品的
复制 bug，以及一大批「看着别扭 / 用着不顺」的细节。
相较上一份发布包（v1.3.0，覆盖「实测七百六十四 ~ 七百九十四」），本次累积「实测七百九十五 ~
八百五十六」共 62 轮改动。
⚠️ 同名覆盖重传：请先删掉 mods 里的旧 jar，再放入新的。

🆕 本次新增（就这几项）

新饰品「大运」——鞘翅飞行途中顺手清路

佩戴者用鞘翅飞行时，自动击毁自身周边 5×5×5 内的方块；只砸「软」的（硬度 ≥ 黑曜石、或硬度 < 0 的一律不动）；范围可调；附带一条飞行 BGM（两首可选），一次空袭从头播到曲终。

佩戴者免疫撞墙：戴着「大运」的人（玩家 Curios 饰品栏 / 女仆 TLM 饰品栏，戴在身上就算、不看任务）在鞘翅滑翔中撞到方块不再掉血——原版对鞘翅玩家也会照常结算「撞墙」伤害，这条把它免掉（面板「佩戴者的保护 → 免疫冲撞伤害」，默认开）。

支援系统扩展

亡灵友军专属支援池（金苹果 / 治疗药水这类对亡灵无效甚至有害的按对亡灵有效的口径处理，伤害药水这类收进专属池）+ 支援品分类表（通用 / 亡灵两张）+ 女仆支援友方时的气泡语音。

挖矿 / 木材名单页：三档回退

名单页支持回退上一步（3 步），按错了能撤回来。

游戏内手册能配图了

手册正文新增行内小图标与整块合成表（零资源文件、零新贴图，用原版物品图标现画）。已配齐「大运」「指标石」「压缩盒」「手册本身」「武装拴绳」，这一版又补齐「骑乘指挥棒」「巡逻航图」「药剂手册」「排班表」四条。页高排版从「每页几行」改成「每页几像素」，合成表不会再被页边界劈成两半。

游戏内手册整体重写 + 完整英文翻译

手册正文重写了一遍：写法统一成「只讲现在是什么样、怎么用」，「这是什么？」那节压成一个功能一行，过长的章节拆成若干短段。同时手册补上了完整的英文翻译——把游戏语言切成英文，手册的正文、按钮与合成表说明都会跟着显示英文（原先「切了英文正文仍是中文」的根因一并修掉）。

刷怪笼：压不住就拆（默认开）

整合包里大量刷怪笼无视光照，插火把压不住。现在她走过去用镐直接拆掉——优先级高于战斗，干活时镐借在副手并行。判据是「这块笼子到底刷什么」：按实体类别判，只刷敌对生物的才拆，只刷牛羊猪这类和平类别的不拆，读不出内容的空笼子也不拆；读取异常按「宁可多拆不可漏拆」处理。日志逐条写清原因与读到的实体 id。有独立开关。

AI 长期记忆：整体升级（对照「灵魂核心」maidsoulcore 移植）

移植了 9 项记忆能力：BM25 + 7 路 RRF 融合检索（关键词 / 最近 / 画像 / 实体关系图多跳 / 既有索引 / 时间窗 / 语义向量）、时间线索解析、回忆闸、连续性队列、画像条目、她心里的记忆快照、世界事件记忆策略、审计日志、OpenAI 兼容向量索引（默认关）。配套新增 20 项配置。

手册新增「DIY / 默认」模式一键切

手册首页多了个入口，一键在「默认」（出厂推荐配置）与「DIY」（本模组不再介入女仆行为，像 TLM 原版）之间切换，带二次确认、会现算改动项数。本版把最后两处「写死在代码里、没有开关」的介入也补上了独立开关（每次平 A 强制横扫、把「类型判不出但正在打我方」的生物也算敌人）——默认开，切到 DIY 时随其它开关一起自动关。

✨ 手感与体验优化（本版主体）

「到处乱窜」治理（移速三连）：非战斗移速硬上限（不许比玩家快）+ 干活时移速压回「0 好感档」（新开关，默认开）+ 面板新增「归零本模组额外移速」一键。

性能：世界里没有女仆时不再空转。收到一份「超平坦、零女仆仍卡」的性能报告后，本版新增「已加载女仆名册」（按秒缓存），把 11 处「每 tick 各自拷贝整张实体表」改走名册、3 处加「零女仆即返回」快闸。顺带说明：那份报告里最大的开销其实来自另一个模组的每 tick 全实体区段扫描（占服务器线程执行时间一半以上），我如实说清楚，不含糊。

战斗与自保手感：举盾回到原版口径（近战 8 格内就举 / 远程 15 格 / 枪械任务也举盾；唯一例外是弓弩三叉戟御币蓄力中，与盾抢同一个槽位）；自保搭高改为「高于敌方 X 格」（默认 30）；营火 / 岩浆块「站在火上不跑」三修；夜里白班女仆参战时顺手把作息切「全天」；睡觉就睡死（睡着的女仆不再被战斗拽起来）；注视语音改为每只女仆 30 分钟最多一次。

建造与移动：建造模式不再强制开 home（并单独提供「禁自动传送」）；新增「幽灵方块投影」开关（弱机可关）；「床只剩半张」修复；干活乱窜出圈修复；罗盘圈优先；障碍物一键全加；排班表加站立 / 坐下键。

界面与文案：建造 / 排班界面行区排版修正（调试行区不再压住底部按钮）；修「字压图标」重叠；手册切成英文后正文仍是中文的根因修复。

🐛 关键修复

• 1.21.1 专服「用 AI 对话就崩服」：调了带 @OnlyIn(CLIENT) 的 TLM 方法，专服上被剥离 → 服务器 tick 崩溃；
• 1.21.1 客户端启动崩溃：mixin 注入点缺描述符；另加一道「打包闸」在打包时拦下这类错；
• 「AI 设计图纸 → 存不成蓝图」老坑：蓝图解析器把「现场 JSON」的小上限当成所有 JSON 蓝图的全局门槛；
• 拆刷怪笼「刷苦力怕也不拆」：只读两个固定刷怪表键名，整合包自定义刷怪表一个都不命中，且读取失败也被当成「和平」；现改为按实体类别判 + 递归兜底找刷怪表，读不出按「该拆」处理；
• 拆刷怪笼「空笼子也被挖」：空壳笼以前被归到「未知」而「未知 = 拆」；现在空壳笼一律不拆；
• 开关关掉后「正在拆的那一下还在拆」：总开关原来只在起手时问过；现在（含 DIY 一键关）一翻转，正在跑的那一半立刻停；
• 装备「救回」反而凭空复制（可刷物品）：在女仆界面从她副手取走镐，副手会自己回填一份。旧判据（扫调用栈里的玩家 / 容器帧）在本体里恒为 false，等于没写；现改为直接检查「这件东西此刻在不在任何玩家手里」（光标或玩家背包）；
• 装备偶尔凭空消失（盾牌 / 剑 / 靴子 / 帽子）：改「留痕 + 救回」；
• 「一键集合 / 召她过来」报成功却没到位、或看不见她：改为按到达校验 + 主动重发实体；
• 「这里烫！我走开点！」补语音；删掉巡逻轨道后她还在沿着飞；搭路方块缓慢变多（issue #19）+ 卡住窒息误报；搭路垫脚方块超距回收失效；飞行姿势散架（两层根因）；BGM 被攻击打断；指标石不能绑定守家 / 骑乘中的女仆；ALEX 生物攻击主人会触发护主（并补「伤害 > 0」防误伤）。

⚠️ 这一版的行为变化（装之前看一眼）

• 拆刷怪笼默认开（可在「战斗与自保 → 防刷怪插火把」关掉；「隔墙不拆」恒生效）；
• 干活移速上限、非战斗移速硬上限默认生效；
• 建造模式不再强制 home；
• DIY 模式现在真的能退回 TLM 原版行为（新补的两个开关 + 另 7 项会改变行为的项一起自动关）；
• 女仆配置界面那块「AI 长期记忆」浮层不再绘制（状态改看手册「AI 记忆系统」章）；
• 举盾频率明显变高（回到原版口径）。
• 落地水不再被搭路顶掉：她高空坠落放落地水缓冲时，搭路不再同时在脚底垫方块（方块占掉落点、她会踩上去，落地水白放）。现在放过缓冲后 2 秒内不搭路；
• 拆刷怪笼更主动：以前要求"此刻就在刷怪 / 主人就在旁边"才拆，她刚把刷出来的怪清掉、或在矿道深处拆笼（主人在上面）时常常不动。现在先读刷怪笼里写着的刷怪表——写的是敌对生物就直接去拆，只有"光照已经把它压住、边上也没有怪"的才留着；
• 配置面板子页文字不再溢出屏幕：支援品分类等子页的标题与底部说明改成按屏幕宽度自动折行，小窗口 / 小 GUI 缩放下不再被左右裁掉。

---

📦 下载

加载器	文件
Forge 1.20.1	promaid-1.3.1-forge-1.20.1.jar
NeoForge 1.21.1	promaid-1.3.1-neoforge-1.21.1.jar

两个 jar 均需搭配 Touhou Little Maid（车万女仆）本体（TLM ≥ 1.5.0，实测 1.5.3）。安装前请删除 mods 目录里的旧同 modId jar（同时加载会启动失败）。旧存档兼容：物品 / 任务 / 蓝图 / 记忆 / 排班等持久化数据沿用 maid_smart 命名空间。