Promaid v1.2.4（1.20.1 Forge）

开发者不玩多人 / 没做服务端优化 / 请理解。

• Minecraft 1.20.1 · Forge 47.4.x
• 前置：车万女仆 Touhou Little Maid ≥ 1.5.0（实测 1.5.3）——纯独立前置，不对任何其他模组做专属联动
• 附件：promaid-1.2.4.jar（直接放入 mods 文件夹）
• 升级提示：安装前请删除 mods 目录里的旧 promaid-1.2.3.jar / promaid-1.2.2.jar / promaid-1.2.1.jar / promaid-1.2.0.jar / promaid-1.1.x.jar——两个 jar 的 modId 相同，同时加载会导致启动失败
• 旧存档兼容：物品 / 任务 / 蓝图 / 记忆 / 排班等持久化数据沿用 maid_smart 命名空间，v1.0.4 / v1.1.x / v1.2.x 存档无缝升级
• 其他模组武器天然可用：武器判定基于原版攻击力属性，tacz / 卓越前线 / 拔刀剑 / 史诗战斗 / 万法皆通等模组武器照常参与自动装备与伤害计算，无需专门适配

一句话：三叉戟不止能捅人，还能当燃料

激流三叉戟现在可以当「飞行推进剂」——起飞、空袭的盘旋抬升与俯冲下扎、飞行跟随，四条链路都能烧它；力度照「玩家在水里放激流那一记」并按附魔等级放大（I / II / III 行程约 17 / 25 / 33 格），而不是像烟花那样持续推。

同时修掉两条：远程空袭「拿着枪一枪不放」（两处病根，并新增「远程开火」诊断行）、右键蛋糕掉线（1.21.1）；另有守家（home）模式的两条（issue #22）：农场女仆不再在田里到处乱转、打完怪「驻守」不再变成「跟随」；还有一条嘴上功夫：「我卡住了，快喘不过气了」改成真吃到超过 4 点窒息伤害才说。另有一处口径变化：压缩盒里的带附魔物品一律禁入——那个开关和自定义清单都删掉了，详见第三节。

一、新功能

1. 激流三叉戟当「飞行推进剂」

• 四条链路共用一套实现：起飞（空袭 + 飞行跟随）、空袭的盘旋抬升、俯冲下扎。近战那一记「旋转冲击」一字未动——那里要的就是原版那一口的爆发力。
• 力度不打折，补的是"玩家那份空气阻力"：点火那一口 v ← v×0.5 + 视线 × 原版力度（原版力度 = 3.0×(1+等级)/4，I 1.5 / II 2.25 / III 3.0 格/tick），随后水平速度每 tick ×0.92（= 0.91 ÷ 0.99，把玩家在雨里的空气阻力补在滑翔自己的 0.99 之上）。行程于是回到玩家的量级：I ≈ 17 格 / II ≈ 25 格 / III ≈ 33 格。
• 老版"一下子飞出 100 多格"是什么：力度其实和玩家一样，但她在滑翔——鞘翅阻力只有 0.99/tick，同一口 3.0 能飘 3.0 ÷ (1 − 0.99) = 300 格。现在补上阻力，落点也就准了（旧版还"在旧速度上加一份视线速度"，转弯时两份速度直接相加，轨迹像醉汉走路）。
• 取材范围：主手 → 副手 → 背包三处都找（六百三十八 一度收成"只认背包"，六百四十 已按反馈改回）；耐久就扣在真正用到的那一件上。
• 想更省更稳：combat.riptideFlightScale（默认 1.0 = 就是玩家那一口）往 0.1 调即可全局打折。
• 验收：latest.log 搜 激流起飞 / 空袭·激流，那一行会写清「力度 3.00 格/tick，照玩家雨里那一记；水平衰减约 N tick、行程约 33 格」。

2. 精妙背包 / 旅行者背包适配

• 她自己的背包装得下就装自己的；装不下时，多出来的那一份再往她身上那件"额外容器"（精妙背包 / 旅行者背包）里塞一遍。接线覆盖六条"收东西"的链路：统一的还物出口、砍树收方块、挖矿收方块、搭路方块回收、追踪方块回收，以及农场连锁收割的掉落兜底（GitHub issue #20 报的就是这一处）。
• 反过来也能取：她自己的背包里没有时，去额外容器里把匹配的东西搬进她的背包（找材料 / 拿食物 / 取建材都会先看那里面）；运行日志搜「额外容器」能看到每一笔（限频 2 秒），飞行缺件诊断那一行也拆成了「身上激流三叉戟=」与「额外容器激流三叉戟=」两项。
• 顺序照抄 TLM 自己的拾取：先放"已经装着同类物品"的容器，再放任何容器——不然会出现"背包里明明有半组、却新开一格"的分裂观感。
• 生效条件（先说清楚，免得当成"没生效"）：需要 Curios 在场 + TLM 的「女仆饰品」功能开启 + 背包真的戴在她饰品栏里。一件都不满足时 getContainers 只返回"她自己"那一项 → 行为与旧版一字不差。
• 开关 misc.backpackOverflow（默认开）：关掉 = 只用自己的背包（旧行为）。

3. 飞行跟随新增省料开关

• flightFollow.trident（默认开 = 照原版每次推进扣 1 点耐久），与「消耗烟花」「消耗鞘翅耐久」凑成同一档三个开关。只管飞行跟随——空袭的起飞 / 抬升 / 俯冲是战斗动作，照旧扣耐久。

二、修复

• 女仆放床爆炸后原地留下「一格水」而不是火（1.20.1 专属，实测六百五十）：病根是一行 SRG 名写错。空袭的床在起爆那一刻会先把放下去的两格床拆掉，而拆床那一支写的是 Blocks.f_49990_——它其实是 minecraft:water（1.20.1 SRG 实证：f_49990_ = register("water", new LiquidBlock(Fluids.WATER, …))；本模组「落地水 / 岩浆放水」也正是拿它当水用），空气的 SRG 名是 f_50016_。于是这一炸拆完床，原地留下的是一格水；而原版爆炸点火那一步的判据恰好是「那一格是空气」——被水占住自然点不着，看上去就成了「不产生火而是水」。现在改回 Blocks.f_50016_（1.21.1 / NeoForge 树同一行本来就是对的，Mojmap 写的 Blocks.AIR，本次未动它）。只有 1.20.1 的床链路受影响：重生锚走的是另一个分支（removeBlock）、末地水晶底座是「留着 → 到期回收」，都不走这一支。
• 远程空袭「拿着枪一枪不放」（粉丝反馈 + 日志实证：26 秒一枪未放）。两条病根：
  1. 空中开火被 TLM 的"枪型交战距离带"卡死——旧版把 TLM 用来挑目标的距离档（手枪/霰弹/冲锋枪一档、狙击一档）当成了"这一发能不能打出去"的判据；而空袭是"绕目标盘旋且停在她上方"，3D 距离天生落在那些带外，于是每一 tick 都被挡回去。现在与 TLM 自家逐条对齐：视线由上层统一判，开火只看冷却（射程仍由上层把着：枪械 16 格、弓弩 24 格）。
  2. 地面远战分支压根不调开火那一句——她落地等重新起飞的那几秒会举着枪一直不放（现场那条 ranged kite … dist=2.6 就是它，随后被打死）。现在地面分支在返回前也补一次开火，节奏仍由内部冷却表管着，不会连发。
  • 顺带新增「远程开火」诊断行（节流 2 秒）：以前"她为什么不射"在日志里完全查不到，现在每一档都会印出来。
• 右键蛋糕掉线（1.21.1 专属）：1.21.1 的"蛋糕可食用"移植时注错了方法——注入 Item.use 却把返回值写成布尔值，而它的真实返回是 InteractionResultHolder，于是右键蛋糕（尤其对着空气点）直接崩服 / 被踢出世界。现在改用 1.21.1 自己的机制：加载期给 minecraft:cake 挂上食物数据组件（营养 14 / 饱和 0.6 / 1.6 秒），不再注入任何方法。喂女仆蛋糕、把蛋糕当食物，一切照旧。
• 烧制 / 酿造没有目标时不再"把自己冻在原地"（粉丝反馈）：找不到炉子时旧版把她设成"彻底静止"，而那时随机散步是关的、其他移动驱动又都不管她 → 永久站住。现在三个"无目标"分支改为边走边找（每 2 秒在周围 8 格内挑一个闲逛点，受活动范围钳制；扫到就绑定、走过去坐下干活）；绑定并到达工作方块之后照旧站桩坐下，那才是"在干活"。
• 激流推进剂的四条连带修复（随第一条一起）：起飞时窜高、没起飞就炸风爆、落地愣一下、飞行跟随的朝向与"解除推进矢量"（现在会连衰减窗口一起收掉），以及远程空袭认不认它当燃料；六百四十二 又把力度整体 ×1.3（上一版实测偏慢，激流 III 甚至比俯冲自己飞还慢）——形状 / 水阻力 / 收手阈值 / 旋转时长一字不动。
• 骑乘或坐下时不再搭方块（护栏统一）：这条护栏原来散在三处、口径还不一样（挖矿只判骑乘、搭路另有一份坐姿判定、伐木与自保一处都没有）。现在对所有搭方块行为生效，判据统一。
• 守家（home）模式下农场女仆「在田里到处乱转」（issue #22 第一条）：病根是我们自己——旧版给守家女仆写了一份"没有移动目标就去家附近找个随机点走"的巡逻，每 0.25 秒直连导航改一次目的地，会直接覆盖掉原版农场任务正在走的路径（原版农场一次没找到活会安静等 6~12 秒，那段空隙正好被随机巡逻铺满，看起来就像"一格格走过去检查地"）。现在农场这条链路完全交回原版：平常站着（或按「空闲散步」走走），作物成熟了才走过去收/种——与跟随模式的表现一致（反馈里对"正常"的定义）。宰杀任务没有牲畜可杀时仍由我们带着闲逛（原版那边没有"自己找活"的能力）。顺带：锄地也不再抢路——她正被任务带着去收/种某一格时不再半路改道，只在站定/没有目标的间隙锄。
• 打完怪「驻守」变成「跟随」、回不去（issue #22 第二条）：战斗结束时还原"战斗前的模式"，那段代码把快照删在了读取之前——getBoolean 读不到键就返回 false，于是"还原"实际执行的是"把驻守关掉"，每打一场架就把守家的女仆变成跟随（排班中的女仆不走这条，所以现象是"有概率"）。现在改成先还原、后清标记，并且没有快照就完全不动她的设置；还原成功时运行日志里会写一行「战斗前模式已还原：驻守（home）=开/跟随」，可对账。
• 「我卡住了，快喘不过气了」变成了口头禅：那句话原来只按几何判定播报——头部那一格不是空气、形状够"实"就喊。她挤过窄缝、被方块顶一下、上下坡抬头、垫块瞬间位移滞后都能瞬时命中，一点血都没掉也照喊"喘不过气"；而每次自保会话进场又会重置"已播报"标记，于是反复说。现在改成先记账、再开口：只统计原版窒息伤害（in_wall），累计超过 4 点（5 秒窗口）才播报——真被闷住 0.25 秒就到门槛，没掉血则一个字都不说。只改"说不说"，不改"做什么"：挪位置、强制顶出、岩浆上下文保护全部原样保留；说与不说都会在运行日志分类「窒息」里留一行，可对账。
• 农场「收获物自动收集」写着关、收割产物却直接进背包（issue #22 第三条，实测六百四十九）：不是开关失灵，是那句说明写错了。查了两条链：① 我们自己的三处收割入口（原版目标格 / 3×3 整片 / BFS 连锁）在拾取前都用这个开关门控，线上 jar 的字节码里也能查到该字段引用；② 真正的原因在前置模组本体——反汇编车万女仆 1.5.3 的 TaskNormalFarm.harvest，产物走的是 EntityMaid.dropResourcesToMaidInv(...)，车万女仆收割时本来就把产物直接放进女仆背包（issue #20 反馈者描述的也正是这个机制）。所以把这一项改名为「农场掉落物立即拾取」并改写说明：它真正管的是"我们做连锁/整片收割时，要不要顺手把收割点附近散落的掉落物也立即捡掉"（默认仍是关 = 等她路过再捡）。行为一个字没改，改的只是说法；关着时收割产物照旧进背包、散落物等她路过捡，背包满了才掉地（精妙背包 / 旅行者背包会再接一层）。
• v1.2.3 那批修复（如果你手上的包是首发版，请务必换成本版）：收放魂符丢血量上限与装备、着火连吃金苹果（issue #17）、法术冷却被多乘 20 倍（issue #16）、图纸三条（issue #12 / #14 / #15）、搭路刷物品（生存可刷，issue #19）、熔炉产物写进隐藏格子、法术任务下不再动她的主手——这些都在 v1.2.3 的重传附件里；v1.2.3 首发版（09-22 07:42 UTC 下载的那份）不含后面的修复。

三、口径变化（装之前看一眼）

• 压缩盒：带附魔的物品一律不能放入（原来是"默认拦、可以关掉"）。理由没变——①盒子只有 5 格，而附魔物品不可堆叠（不同附魔组合互相不是同一件东西），很快就满，它的定位是"大批材料的压缩仓"而不是装备库；②以前报的"附魔类物品存进去会消失"正出在这一类上。把开关关掉 = 把这些坑重新打开，所以这次干脆写死：
  • 配置里的「禁入带附魔的物品」开关与「禁入清单」（自定义黑名单）两个选项已删除，配置面板原位留了一条只读说明「禁入规则」；
  • 老存档配置里如果还留着 refuseEnchanted / refuseList 两行，不再被读取（也不影响启动，不用手动去删）；
  • 压缩盒那一页现在只剩两条可调：女仆背包延伸、每格上限。
• 激流三叉戟的取材范围是"主手 → 副手 → 背包"三处（曾经有一版收成"只认背包"，已按反馈改回）；耐久扣在真正用到的那一件上。
• 接战时工作范围临时扩圈、散步默认速度 0.4 等 v1.2.3 的口径不变。

四、手册与文档

• 「压缩盒」章按新口径重写（禁入那一条、可调的两条、自检那一行）；
• 「战斗与自保」章补两处：① 战斗还原会连「驻守 / 跟随」与她当时的作息一起还原（没记录过快照就完全不动她的设置）；② 「窒息/卡墙」那条写明只有真吃到超过 4 点窒息伤害才喊，自救动作照旧；
• 「农场与杂项功能」章补两条：驻守（home）模式的农场不再到处乱转（含旧版为什么会乱转的一句话根因）、锄地不抢路；
• 「这是什么」章新增 v1.2.4 起新增功能速览（激流三叉戟当推进剂、精妙背包 / 旅行者背包适配、骑乘或坐下不搭方块、烧制酿造不再冻住、远程空袭开火修复、右键蛋糕崩服修复、压缩盒禁入写死、驻守农场不再乱转、打完怪不再丢驻守、窒息不再当口头禅）；
• 游戏内自检 /maid_smart box check [女仆] 的段落名改为「禁入判据」，并新增一条：用反射确认那两个配置字段确实已经不存在。

主要功能一览

空袭（近战/远程两种飞行攻击模式 + 空袭轰炸） · 激流三叉戟（旋转冲击 / 飞行推进剂） · 战斗模式分类表 · 压缩盒 · 排班表（全女仆日程调度：早/晚/全天班次、6 段任务编排、当前时段高亮、一键集合、自动在家模式） · 建造系统（81 套内置蓝图 + 外部图纸/LLM 生成/AI 设计器、工地线框投影与 Z 键旋转、工头模式、进度持久化、缺料自动替代、区块内箱子取料、机械蓝图） · 挖矿（矿表白名单、连锁采集、透视感知、发呆看门狗） · 伐木（模组原木自动识别、随手补种、骨粉催熟） · 烧制 / 酿造（什么能烧就烧、多女仆多炉、药剂手册批量/定向酿造） · 农场（连锁收获/批量种植、耕地标记制、锄地索敌、作物骨粉） · 宰杀任务 · 战斗与自保（回血阶梯、逃生手段、保命道具优先、致死自动回魂符、女仆自动复活、环境伤害软处理、主动切换战斗+自动还原） · 主人免伤三层防护 · 被动技能（落地水/落地雪、岩浆放水、主人死亡传送、搭路、飞行跟随） · 单兵战术 · 贴身辅助（自动投喂/治疗/盾牌，喂食喂水走物品自己的路径） · 武器与工具自动切换（DPS 评分，兼容其他模组武器） · 指标石 · AI 记忆（段落/关系/画像/工作笔记 + 日/3日/周/月记忆日记 + 人格种子 + 睡一觉整理） · 主动对话 / 工作播报 / 自主决策 / 回复反馈学习 · 感知与情绪（PAD 模型） · 21 个 AI 工具（对话直接下命令） · TTS 语音（内置日语语音包 / 系统朗读 / 缓存 / 音量） · 冷却可视化 HUD · 床铺互通 · 交互（摸摸头/抱抱、蛋糕互动、女仆互助、手持光源、宠物保护） · 女仆安全与区块保载 · 运行日志 · 内置 33 章手册 · 全部功能游戏内配置面板逐项开关（7 大类 / 31 小类）

测试环境声明

其他版本（含更新/更旧的 TLM）未必兼容，请以实际测试为准。除上述前置与法术软联动外，不对其他模组声明联动兼容性。

已知情况

• 只玩单人：开发者不玩多人，未做服务端优化。多人服务器上若有异常，欢迎反馈但请多谅解；
• 有粉丝报过「投喂蛋糕时女仆在前方小范围快速移动」：我们的投喂链路一行位移都没写，暂时没能定位。如果你也遇到，欢迎把 latest.log 里投喂那一刻前后 10 秒的片段发到 issue，并顺手用一个**原版食物（比如面包）**喂她做对照——这样能分清是"蛋糕那条链路"还是"喂食/站位"本身；
• 1.20.1 与 1.21.1 的差异：1.21.1 多一块重锤相关内容（重锤猛击、风刃、专属落地水），1.20.1 没有重锤，其余功能对齐。

反馈

问题与建议请到 GitHub Issues：https://github.com/fadersketch/Promaid-mod/issues
（本版的守家（home）模式两条——农场里到处乱转、打完怪丢驻守——对应 issue #22；精妙背包 / 旅行者背包适配对应 issue #20；远程空袭开火与右键蛋糕崩服来自粉丝在评论区的反馈，两条都带日志实证；窒息口头禅来自开发者本人的游玩反馈。）

许可证

MIT © 2026 —— 开源地址：https://github.com/fadersketch/Promaid-mod

Promaid v1.2.3（1.21.1 NeoForge · 加急更新）

开发者不玩多人 / 没做服务端优化 / 请理解。

本版与 1.20.1 Forge 版（同为 v1.2.3）功能对齐，差异只在少数原版机制上（主要是 1.21.1 独有的重锤）。有问题欢迎提 Issue：https://github.com/fadersketch/Promaid-mod/issues

• Minecraft 1.21.1 · NeoForge 21.1.250
• 前置：车万女仆 Touhou Little Maid ≥ 1.5.0（NeoForge 1.21.1 版；实测 1.5.3-neoforge+mc1.21.1）——纯独立前置，不对任何其他模组做专属联动
• 附件：promaid-1.2.3-neoforge-1.21.1.jar（直接放入 mods 文件夹）
• 升级提示：安装前请删除 mods 目录里的旧 promaid-1.2.2-neoforge-1.21.1.jar / promaid-1.2.1-neoforge-1.21.1.jar / promaid-1.2.0-neoforge-1.21.1.jar——两个 jar 的 modId 相同，同时加载会导致启动失败
• 存档说明：1.21.1 存档与 1.20.1 不互通；1.21.1 内部沿用 maid_smart 命名空间，v1.1.x / v1.2.x 存档无缝升级
• 其他模组武器天然可用：武器判定基于原版攻击力属性，模组武器照常参与自动装备与伤害计算，无需专门适配

🔧 附件已第三次重传（2026-09-22 · 第三次）——法术任务不再动她的主手

你下载到的 jar 又更新了一次（文件名不变，仍是 promaid-1.2.3-neoforge-1.21.1.jar）。第二次重传（下面那一段）装的是 627 ~ 631；这一次装的是 632，三次是叠加关系：现在的包 = v1.2.3 首发内容 + 624 / 625 / 626 + 627 ~ 631 + 632。

• 这次改的一条：法术任务（近战法术 / 远程法术）下，女仆不再自动切换她的主手武器。 此前那条口径是"她真带着法术装备时、也只换法术装备"——但附属（万法皆通）认的"法术书"里有一类根本不是武器：诡厄巫法的聚晶袋就是袋子。结果就是你往她主手放一把剑，她每个 tick 都会换成聚晶袋。
• 为什么这算问题（三条）：
  • 施法不需要手持：附属自己扫背包（诡厄巫法走它自己的数据 + 聚晶袋里的内容；铁魔法 / 新生魔艺那条我们更早就实证"法术书放饰品栏照样放"）。所以把聚晶袋塞进她主手是纯粹多此一举。
  • 主手是近战那一半的伤害来源：近战法术任务每次施法之后会照常挥一记近战攻击——主手拿什么就打什么伤害，换成袋子等于把她的近战削到拳头级。
  • 主手还是拔刀剑那条施法链路的前提（不是刀在主手就直接中断吟唱）：只要她背包里还有别的法术装备，我们就可能把刀从她手里换走。
• 现在的行为：法术模式下主手放什么就是什么，她不再动；想让她近战有伤害，把武器放她主手即可。其他模式（攻击 / 弓 / 弩 / 三叉戟 / 挖矿 / 伐木 / 枪械 / 弹幕 / 剪刀 / 钓鱼）的自动换装完全不变。
• 无需任何处理：没有新功能、没有新配置项；存档、配置、任务、蓝图一律不动。安装方式与前两次重传完全一样 —— mods 目录里只留这一个 promaid-1.2.3-neoforge-1.21.1.jar（同名覆盖即可）。

🔧 附件已二次重传（2026-09-22 · 第二次）——修掉一个可刷物品的漏洞（issue #19）

你下载到的 jar 又更新了一次（文件名不变，仍是 promaid-1.2.3-neoforge-1.21.1.jar）。第一次重传（下面那一段）装的是 624 / 625 / 626；这一次装的是 627 ~ 631，两次是叠加关系：现在的包 = v1.2.3 首发内容 + 624 / 625 / 626 + 627 ~ 631。

• 最要紧的一条：搭路刷物品（GitHub issue #19） —— 女仆铺桥的材料"用不完，还会越用越多"。粉丝报的是"搭路方块在使用时不会消耗，但回收时会增加背包内存量"；实测更狠：给她 1 个方块（铁块 / 云杉木板都一样）用来寻路，她铺了 128 格并把方块全数交回，净多 127 个。这是生存可刷的漏洞，建议所有在用 v1.2.3 的存档都换成这个包。
  • 根因一句话：让她"副手举一下这一下正在用的那件"这个动作表现，把展示件写进了真实副手槽——那是复制品，但货真价实、能被取材扣走；而搭路取材的口径是"背包 + 双手里数量最多的那种、先扣手"，搭路 4 tick 一块而展示持续 10 tick。于是每一次取材扣走的都是那件展示件，扣完动作表现又补一件新的，真材料一动不动；可方块到期回收是按方块 id 逐格还一件真物品（这条本身没错，她放下去的本来就是物品）——一进一出就是净产出。
  • 修法：取材一侧加统一口径 —— 被动作表现借走的副手不算材料。搭路 / 挖矿 / 伐木 / 索引石四条取材链 + 索引石"补下方支撑" + 战斗放置（黑曜石底座 / 床 / 重生锚）全部覆盖。展示观感零变化，玩家自己把方块挂在她副手的正常用法也不受影响（没被借走时照旧算材料）。
  • 连带效果（须知）：修完给她 1 个方块就只能铺 1 格，那一格到期回收后再拿回来铺下一格（总账守恒，不再凭空生长）。想"给 1 个也痛快铺完"属于另一个设计，不在本次。
• 熔炉产物"凭空消失"，其实没丢：她用小背包（可见可用 12 格）时，我们把东西写进了背包等级之外的隐藏格子——存档取证确认那批铜锭躺在第 12 格，玩家界面看不见。现在全模组（两树各 132 处）取材 / 存放 / 回收都按背包等级截取，不再写进看不见的格子。已知代价：以前被她放进隐藏格子的东西现在依然够不到，换中/大背包或手动取出即可。
• 不得把方块搭在别人头上：压人判定从"只判主人"扩到其他女仆；她自己那一格不判（否则搭高会把自己锁死）。覆盖搭路 / 挖矿 / 伐木 / 自保 + 插火把 + AI 工具 + 蓝图与碑石建造（蓝图类遇阻是延后而非跳过）。关掉 misc.noPlaceOnOwner 即回旧行为。
• 主人踩临时方块也刷新寿命：与女仆同款 —— 站上去、或进入刷新带（水平 ≤4 格、垂直 ≤6 格）都刷新。旧版只在"主人脚下正踩着那一格"时刷新，站偏半格 / 站在一格宽桥的边缘就会看着脚下的桥烂掉。
• 索引石"补下方支撑"那一格补上压人闸门（其余三家与蓝图 / 碑石建造本来就是逐格判的，只有这条漏了）。
• 无需任何处理：没有新功能、没有新配置项；存档、配置、任务、蓝图一律不动。安装方式与第一次重传完全一样 —— mods 目录里只留这一个 promaid-1.2.3-neoforge-1.21.1.jar（同名覆盖即可）。

🔄 附件已重传（2026-09-22）——你下载到的 jar 比下面这段首发说明多两处修复

本页首发于 09-22 07:42（UTC）。附件已按用户要求重传覆盖（文件名不变，仍是 promaid-1.2.3-neoforge-1.21.1.jar）；重传后的 jar = 首发内容 + 实测六百二十四 / 六百二十五 / 六百二十六：

• 只带拔刀剑的女仆不会再被切进「法术模式」（实测六百二十五，粉丝反馈）：万法皆通判断"她会不会用法术"时，我们原先把它各前置附属 provider 的判定照单全收，而其中两条认的"法术装备"本身就是武器——slashblade 认拔刀剑、youkaishomecoming 认弹幕/激光/符卡（javap 反编译实证）。后果就是"背包里有把拔刀剑 = 她带着法术书"：法术任务进候选池，再被"模组任务优先让位"顶到原版任务前面，于是出现"我明明只给了她一把刀，她怎么自己切去法术了"。现在默认把这两个 provider 排除在"她会用法术"之外（配置 combat.spellGearIgnore，留空 = 旧口径）；面板「战斗与自保 → 主动参战 → 法术装备忽略表」可直接改；排查看 latest.log 里的 combat pools 那条，会附 spellGear= 直接点名是哪件东西放行的（形如 slashblade:slashblade:slashblade）。手动在女仆界面切到法术模式不受影响（本模组从不拦手动切换）；
• 源码内部大扫除（实测六百二十四，玩家可见行为零变化）：几个"读一次要滚几千行"的巨型文件（蓝图库 6677 行的那个等）拆成小文件 + 删掉从未接线的死代码，不影响任何游戏内表现；
• 手册更正一句过头话（实测六百二十六）：手册原写"女仆喂食繁殖不再有任何击杀行为"，其实当年删掉的是本模组自己的加码，车万女仆本体的繁殖模式本来就有"超过上限就杀"（任务提示里那条"主手持有攻击性武器（用于杀死超过上限的动物）"是真事）。本模组一行代码未改，只是把手册写对；
• 安装方式与首发完全一样：把 mods 目录里的旧 promaid-1.2.x.jar 删掉、放这一个（同名覆盖即可）；存档不需要任何处理。

⚠ 首先声明：这是一次加急更新

B 站用户 lawte 反馈：安装本模组后，女仆由好感度升阶带来的血量上限加成、以及身上穿着的装备，会因为收放魂符被卡掉。同一个问题在 GitHub issue #18 里 P1aneZ 也报了（「魂符放出后从女仆背包/装备栏取物会丢失」，并附了逐条复现与字节码证据）。

这是会吃掉玩家存档里实打实物品的严重 bug，所以这次不按原来的节奏攒版本，单独发一次加急更新；同时把本来准备上线的一批新功能一起带上（见下文第二节）。

两个症状是同一个出处，而且不在 TLM、也不在服务端——她存档里一直是好的（TLM 收放魂符就是「拍快照 → 放出来时读回」，血量上限与装备都无损）。坏在本模组自己的「入世界自动补包」（v1.2.2 里为了治「客户端看不到她」而加的）：

1. 血量上限掉回 20：那个补包收到「生成实体」包后会 new 出一只全新的客户端实体，而它那一串补包偏偏没补属性表（原版只在「开始追踪」那一枪下发属性表）。于是客户端算出来的血量上限永远是默认的 20；等好感度升阶让服务端属性变脏，原版又把属性表补回来 → 就是你看到的「80 和 20 反复横跳」。
2. 拖装备被吞：收放魂符的「放出」本身就是一次入世界，于是每收放一次，客户端那只女仆就被销毁重建一次；而 TLM 的容器槽位绑的是建容器那一刻那只实体的句柄——删了再生成，你正开着的物品栏/装备栏还指着已经被删掉的那只，拖进去的东西就落进了虚空。

修复（实测五百九十五 / 五百九十六，两版本同步，1.20.1 与 1.21.1 一字不差）：补包改成按实体网络 id 分流——魂符放出的新实体不再补包（原版追踪本来就会发全套：生成 + 数据 + 属性 + 装备），只有同一只女仆离场又回来（区块卸载重载这类、id 没变）才补；补包那一支同时补发一次饰品全量同步（1.21.1 是 SyncBaublePackage）；另外新增一条诊断日志：她的装备槽从有东西变空时会写一行（logs/promaid.log 搜「装备离开」，含槽位、丢了什么、她背包实时快照与 8 帧调用栈）——以后真再遇到「谁把她的装备拿走了」，一行日志就能指认。

为什么要单独发一版：这两条修复在 09-20 就已经提交（实测五百九十五 / 五百九十六），但 v1.2.2 的 release 附件上传于 09-20 01:20 UTC，比它们早约 12 小时——也就是说从 release 页面下到 v1.2.2 的玩家仍然会踩到这个 bug（issue #18 的作者用字节码核对过：那份附件里连 MaidGiveBack 类都没有）。所以这一版的第一优先级，就是把它真正交到玩家手里。

顺带修掉的同类问题：issue #17（女仆着火时会把背包里的金苹果连着吃到背包空——那条冷却对「会被消耗的普通食物」从来没生效过）。现在金苹果/附魔金苹果吃完会按它自己给的效果时长记一次冷却（普通 = 吸收 2 分钟，附魔 = 抗性/抗火 5 分钟），一次一颗、吸收耗尽才会再吃；低血回血那两条路共用同一条冷却。

这一版和上一版（v1.2.2）的区别，一句话

「先把会吃玩家东西的 bug 发出去，再把攒下的新功能一起上线」：收放魂符不再丢血量上限与装备、着火不再连吃金苹果；同时带来战斗模式分类表（逐任务点名近战/远程/不参与）、压缩盒（5 格 × 每格 114514，放进她背包就是她背包的延伸）、空袭轰炸（末地水晶 / 重生锚 / 床 / 投掷 TNT）、飞行跟随（主人飞走了她背鞘翅追过来）四块新玩法，以及散步速度终于调得动、索敌不再隔着方块记仇、战斗中不再被工作范围传送回来等等一批打磨。

一、加急修复（本版重点，详见开头）

另外新增**「装备离开」诊断日志**（她的装备槽从有东西变空时记一行，含调用栈），以后同类问题可直接定位。

二、新功能（本版一起上线）

• 战斗模式分类表（新配置 combat.taskModes）：入战选任务与战中换战术原本三条规则全是写死的——谁能进候选池、算近战还是远程靠猜（UID 关键词与命名空间，未知模组任务一律当近战兜底）、池里有模组专属任务时原版五件套整体让位。现在可以逐任务点名：一行一条 任务UID=近战/远程/不参与（认中文写法与逗号分隔）——写 近战/远程 = 分类以表为准，且不再被"模组优先让位"挤掉；写 不参与 = 入战选任务与战中换战术两条路都永不选它；留空 = 与旧版一字不差。不想用「模组优先」就关掉新开关 combat.vanillaYieldToMod（默认开 = 旧行为）。查 UID：只读命令 /maid_smart combat modes 会把当前所有攻击类任务列成一张表（内置算什么 ｜ 现在算什么 ｜ 表里写了什么 ｜ 参不参与）。面板位置「战斗与自保 → 主动参战」；
• 压缩盒（新道具）：只有 5 格，但每格能堆 114514 个，合成 = 4 个樱花木板放四角 + 4 个钻石放四边中点 + 1 个粉色染料放正中。放进女仆背包就等于是她背包的延伸——她会从盒子里取材料（挖矿/建造/烧制的料），也会吃盒子里的食物；界面是箱子式鼠标取放（左键拿放、右键拿一半、Shift 快速移动），背包格照原版口径显示数量与耐久条，带常驻附魔光效。禁入清单：压缩盒本身、带附魔的物品（附魔书按物品类型判——1.21.1 的附魔存在 STORED_ENCHANTMENTS，isEnchanted() 看不见它，所以按类型判）、以及你在配置里自己加的清单；一个判据四条路共用（界面点击 / 服务端搬运 / 女仆背包插入 / 溢出回退），拒绝时会给话，而且在这个界面里鼠标也选不中压缩盒。自检与诊断：/maid_smart box check [女仆]、/maid_smart box <女仆>；
• 空袭轰炸：近战空袭打完那一记、远程空袭开火之后顺手放炸弹——四条链路各走各的，材料齐的几段在同一次攻击里都放：末地水晶（黑曜石底座 + 水晶）、重生锚（要 1 颗萤石方块，不是萤石粉）、床（只在原版会爆炸的维度）、投掷 TNT（挂在攻击链路最末段，所有有战斗标签的模式都会扔；TNT 判据很宽：注册名里带 tnt 的都算、方块继承原版 TntBlock 的也算，放出去的就是它自己那一枚；点火料 = 打火石（按类认、走耐久）或烈焰弹）。默认全部保护：不破坏方块（模组 TNT 也归这条管）、不伤主人与友军、爆炸火焰改粉色火焰（不蔓延、会自己灭、玩家与女仆都不被它点燃掉血）；她做这些事时副手会举起正在用的那一件（萤石 / 打火石）。目标悬空时走「后门」照样放得下；带着材料却没放，日志搜「轰炸跳过」会写原因；
• 飞行跟随（默认关，观赏玩法）：你自己飞走了，她也能背上鞘翅追过来——触发与「搭路」同一档，起手 25 格 / 收手 5 格是两个不同的球（3~128 可调，中间 20 格迟滞），进到收手半径会解除推进矢量再交回普通跟随；燃料可以是烟花 / 孔雀羽扇 / 能上天的位移类法术（法术优先、不烧燃料）；两个空袭任务未接敌时同样适用；/maid_smart flyfollow 是调试入口，elytra_goto <x> <y> <z> 能让她飞去指定坐标（这一件取自粉丝 Roderick32 的「鞘翅赶路」分支）；
• 散步速度终于调得动：默认倍率 0.7 → 0.4（老存档会自动迁移一次），可调下限 0.3 → 0.05。实测对照（专用服务器量的，玩家走路 4.32 格/秒、跑步 5.61）：0.3 → 1.9、0.4 → 3.3、0.5 → 4.9、0.7 → 8、1.0 → 14；注意 0.2 以下实测几乎不走，好用的慢档是 0.3~0.4。现场量速与调档：/maid_smart stroll check（打她的基础移速、实测对照表与散步门禁）、/maid_smart stroll go（用当前倍率走一次 24 格直线）、/maid_smart stroll speed <值>（当场改并落盘）；
• 索敌两处调整：① 隔着方块的怪不再算威胁——以前她会"感知"到地下空洞里、墙那头的怪并写进攻击目标，找不到入口就原地打转（根因是原版对"已经是攻击目标"的实体跳过视线判定，下游所有链路都当它看得见）；现在威胁候选加了一道视线门，"隔墙挥刀"也从源头断了。② 战斗时工作范围临时扩圈——home 模式（排班/在家干活）下她接战后追怪，一跑出工作范围就会被 TLM 直接传送回工位，"追出去 → 传回来"打不完；现在接战期间范围临时扩大（combatWorkRange，默认 15 格，0 = 关闭），战斗结束自动落回常态，且取的是"常态与战斗值里更大的那个"，不会把你调大的活动半径改小；
• 副手动作表现（推广到全链路）：放置 / 充能 / 投掷 / 起爆，以及搭路 / 插火把 / 建造 / 种植 / 酿造 / 喂主人时，副手短暂举起她正在用的那一件（方块 / 萤石 / 打火石 / 树苗 / 酿造材料 / 食物）——看得出她在干什么。

三、其它修复与调整

• 法术自身冷却被多乘了 20 倍（issue #16）：ISS 的 getSpellCooldown() 返回的本来就是 tick，旧版又乘了一次 20（烈焰冲锋真实 10 秒被写成了 200 秒）——现在原样返回；
• 图纸相关三条（issue #12 / #14 / #15）：墙上告示牌/火把永远报缺料、流体保留判据可配置、缺料同类宽松按「建筑严格 / 机器放宽」分档；
• 回收方块"整体还她"：萤石不再变成萤石粉；
• 「明明拿着孔雀羽扇却报缺飞行道具」的假提示：本模组自己的副手动作把那件借走了，判定没算上；
• 「坐下还在搭路」：坐姿（被玩家叫坐下/坐在椅子上）时不再启动搭路，搭到一半被坐下也会立即让位；
• 无主女仆全面降级：不是你的女仆，promaid 一概不碰（整合包自己的仇恨/农田规则接管）；
• 面板的「字符串输入行」一直没画标签与说明（用户截图反馈）：渲染链漏了一条分支，字符串类配置行只画一个空黑框——新加的「模式分类表」因此整页只剩一个黑框；顺带把既有的六条字符串行（API 地址/密钥/模型、导入路径、法术表、危险方块表、禁入清单）标签一起修好；
• 空袭俯冲段冲刺加速 与 俯冲段烟花力度 ×1.4、粉色火焰的"会自己灭"两层兜底、重生锚不再被末地水晶吞、爆炸特效对齐原版等一批打磨。

四、本版的调整（行为变化，装之前看一眼）

• 散步默认速度变慢：空闲散步的倍率默认从 0.7 改成 0.4（老存档只在"还停在旧默认 0.7"时自动迁移一次，你写回 0.7 随你）——如果你习惯了她快步走，改「空闲与流畅 → 散步速度倍率」；
• 排班表「全员在家」整条移除：列表页那个批量按钮（一键把全队留在家不跟随）按玩家裁定删掉，它的计数逻辑与对应的网络包一起移除。单只女仆的在家开关照旧（详情页），「自动在家模式」也不受影响；
• 压缩盒默认不许放"带附魔的物品"（附魔书/附魔武器等），也不许把压缩盒放进压缩盒——想放开附魔那条可以关「系统与杂项 → 压缩盒 → 禁入带附魔的物品」；
• 轰炸默认不动地形、不伤主人与友军（两个开关都在「空袭数值 → ⑦ 空袭轰炸」），想按原版炸坑就打开；
• 战斗模式分类表留空 = 与旧版一字不差；「模组任务优先让位」默认仍然开着（关掉才是"原版与模组同池纯按权重随机"）；
• 接战时工作范围会临时扩圈（默认 15 格，与默认工作范围 12 格同量级）——不想让她跑出去追就把 combatWorkRange 设成 0。