Promaid v1.3.3-beta（1.20.1 Forge + 1.21.1 NeoForge · 修复为主）

Promaid v1.3.3（1.20.1 Forge + 1.21.1 NeoForge）临时追加更新说明

v1.3.3 beta（预发布）· 以修复为主

原计划加入的「鞘翅长矛」玩法制作难度比预期高，尚未完成；眼下有一批更重要的修复，所以先把修复端上来。
本版 1.21.1 与 1.20.1 同步更新；1.20.1 另外补上了重锤兼容（试炼密室回移植的 trials:mace /
trials:wind_charge），让整合包玩家也能玩到重锤空袭女仆。

双版本同步更新，版本号 1.3.2 → 1.3.3。这是一次临时追加更新，原计划内容先往后放。

这是一次临时追加更新。原计划里的内容先往后放，这一版专门把三个会直接
影响正常游玩的问题修掉：飞行跟随刷物品 / 吞物品、从女仆装备槽取放装备在传送后消失、日程表集合后
女仆丢失；同时把一批用着别扭的交互和视觉问题顺手优化了。1.20.1 Forge 与 1.21.1 NeoForge 同步更新。

一、三项紧急修复

1. 飞行跟随：不再复制胸甲，也不再吞建造材料

• 飞行跟随给女仆换鞘翅时，原来的胸甲会被复制：飞一趟多一件，飞 N 趟多 N 件。现在真品始终只有一件：
  换下的胸甲只作为“认领钥匙”记录，收翅时按签名把真胸甲从她身上取回穿上；取不到或只找回一部分时
  一律不凭空补件。
• 换装结算的日志会明确区分“把胸甲还回去 / 收翅回背包（本趟没穿胸甲） / 原胸甲已不在她身上，不补件 /
  胸甲槽已被换过，不覆盖”，不会再出现“没换也说还了”。
• 建造放置失败时（例如脚手架位置暂时放不稳），材料会原样退回，不再每次失败吞掉一件。

2. 传送后从女仆装备槽 / 主副手取放装备，不会再消失

• 问题现象：女仆传送一次之后，打开她的物品栏，把装备或武器拖到玩家背包、放下那一下，物品真的消失；
  之后的“补包”只是兜底，并不能解决消失本身。
• 根因：单机整合服的本地连接不经过网络序列化，而装备同步包在构造时不复制物品对象。传送后的客户端实体
  重建会重发装备包，客户端女仆装备格与服务端因此持有同一枚物品对象；客户端在放下时的预判会把这枚对象
  原地清零，服务端光标也跟着变空，下一次放置自然什么也放不进去。
• 修复：装备同步包构造时逐枚复制物品，切断客户端与服务端之间的对象共享。专用服务器原本会序列化复制，
  因此多人服行为不变；单机整合服不再丢件。
• 这项修复已由开发者在实机验收：传送后逐件取放两轮，装备都正常落进目标格，不再触发补包。

3. 日程表集合后女仆丢失

• 问题现象：用日程表「一键集合」后，女仆有时会彻底找不到，存档里也像是消失了。
• 根因：主人被瞬移离开（例如从下界回主世界）时，她可能还在原地或正在自保；区块卸载后，集合功能使用的
  “最后位置”快照仍指向旧位置或旧维度。集合时按过期快照强载了错误区块，15 秒超时后把登记项删掉——玩家侧
  看到的就是“女仆消失”。
• 修复：集合功能增加 TLM 世界数据作为第二来源（按实体 ID 取最新记录，保留守家 / 原地待命标记，时效放宽
  到 1 天）；女仆入服时立即刷新位置记录，不再只依赖过期快照。

二、排班表传送：三键直达坐标

• 「一键集合」删掉了“已经在 5 格内就不传”的距离闸：距离再近也照传，人工意图优先。
• 「一键集合」「召她过来」的落点改为直达你的坐标；「去她身边」改为直达她的坐标（跨维度同样）。
  骑扫帚 / 坐骑的“连人带载具”落在你所在的格。
• 自动路径（受困救援、守家牵引、远距拉回、跟随、主人死亡传送、自保）保持不变，仍是“找可站立格”的稳妥口径；
  守家女仆、坐着 / 骑普通载具时的一键集合保持原位。

三、新增与行为变化

女仆搭出的方块有金色描边，潜行右键可强制回收

• 女仆放置的方块（搭路 / 垫脚 / 挖矿垫块 / 战斗垫块）会显示一圈金色线框，96 格内可见。
• 潜行 + 右键描边方块 = 立刻强制回收成掉落物，并清理登记；不需要双手都空。
• 金色线框约 3 秒后自动消失，不再跟着方块整个存活寿命一直留在视野里；方块本身的回收寿命 / 自动清理不受影响。
• 这套交互采用最低优先级：手里拿着方块、主手物品自带右键动作（食物、蓄力物品、桶、工具等）、
  或被点方块本身有交互（门、按钮、工作台、蛋糕等）时自动让位，不抢原版交互。

精妙背包里的弓箭 / 枪械弹药也能用了

• 她的自己背包没有箭时，会先只读探测饰品栏里的精妙背包 / 旅行者背包，再把箭搬进自己的背包使用——
  空袭、扫帚射击、贴脸自保都生效。
• 枪械（TACZ / SBW）换弹同样会从额外容器取弹药；判断“打不打得响”时会把额外容器里的存量算进去。

蛋糕可食用：检测到其他模组改过蛋糕时自动关闭

• 「蛋糕可食用」现在会在启动时探测：如果其他模组已经让蛋糕可食用，或已经给蛋糕写入了食物属性，
  本模组的蛋糕功能会自动关闭（配置开关同步显示为关），避免两边同时修改同一个判定。
• 探测只认“蛋糕是否已经被改过”这个事实，不会因为其他模组碰了普通物品就误关；需要恢复时在配置面板
  手动重新打开即可。

四、其他修复与体验优化

• 取装备不再误判补发：玩家把取下的装备穿到自己身上（护甲 / 副手）后，定位器现在会扫描玩家完整的
  41 格背包，不再因为“找不到”而在 1.5 秒后往女仆背包补一件。
• 自动回魂符空快照崩溃：收符改为事务化——先放符，再确认女仆实体确实移除；移除失败就换回空魂符并清冷却，
  不再产出没有 Owner 的废符导致释放时客户端崩溃。旧废符会在进服后自动清扫。
• 粉色火焰不再渲染成黑色方块：粉火登记进 cutout 渲染层，透明像素恢复正常。
• 搭路 / 垫脚的选材更稳：床、门、双高草不再被选来垫脚或搭桥（放下就会被原版打掉、白扣材料）；
  脚手架会等下方支撑建好再放，放不上时补支撑或延后，不再悬空被原版打落。
• 头顶窒息保护：头格被方块压住时也会横移脱出（优先有落脚点、避开岩浆），不再只看身体中心；
  搭路 20 秒没垫出方块时不再误报“头顶被挡住”，只有真的被窒息方块占住才提示；挡路的是主人 / 其他女仆的碰撞箱时她会保持等待、不播失败气泡，中性提示“搭不上去，我先下来……”也补上了语音。
• 挖矿 / 伐木 / 农场：挖矿没有目标时，一旦玩家手动改任务就立即停止自动切换，不再把人切回采矿；
  home 女仆的伐木、挖矿、酿造、烧制目标都会复检工作区；伐木清叶的“任务 × 工作时段”双闸复核通过。
• 指标石建造：删掉“20 秒没进展”和“3 秒缺料”的自动放弃路径，改为持续节流重试；参战时暂停，
  打完继续；缺料时会正常播报语音。
• 1.20.1 潜行判定修正：金色描边回收、指标石潜行解锁、骑乘指挥棒潜行下坐骑、自保传送豁免等
  共用潜行判定的入口，之前误用了亡灵判定，现已全部改正。
• 手册：新增「特别鸣谢」章，补全蓝图作者与地形作者名单；建造章按当前随包数量整理为 79 套。
• 其他小项：指标石缺料语音、建造 HUD 广播、远程界面与实体同步的若干稳定性修正。

五、配置面板与重锤（本次追加）

• 删掉「保存并返回」按钮：ESC、目录跳转、手册返回、关窗口本来都会走同一个保存入口；按钮与 ESC 完全等价，
  留着只会让人以为“不点就不保存”。现在所有返回路径都会自动保存，失败提示也改为“按 Esc 关闭会自动保存”；
  手册里的操作指引同步更新。
• 矿表不再弹重要度输入框：点方块图标 = 直接加入名单，右上角小叉 = 移出；木材表 / 障碍物表同款，
  回退（↩）仍然可用。
• 物品名改用原版名称：配置面板里的方块 / 物品显示改用原版语言表的悬浮名（中文客户端显示中文），
  第二行仍保留注册名方便填配置；搜索同时匹配中文名与注册名，不再出现 stripped_warped_hyphae 这类
  纯英文路径占第一行。
• 1.20.1 也有重锤猛击了（Forge）：识别「试炼密室」回移植的 trials:mace / trials:wind_charge——
  主手重锤 + 背包风弹，靠近目标起跳、下落猛砸；伤害按 1.21.1 原版三段下落加成，附魔 / 击退 / 火焰附加 /
  耐久照常。配置面板「战斗与自保 → 单兵战术」新增 4 行：重锤猛击、必须消耗风弹、冷却、起跳距离，
  默认值与 1.21.1 版一致。未安装带重锤的模组时该行为不会启动。
• 近战空袭也会用重锤砸了（Forge）：鞘翅 + trials:mace + 烟花齐备时，女仆会优先把背包里的重锤
  换到主手；收翅俯冲那一击按「本轮最高点 → 当前高度」结算 1.21.1 三段下落加成与猛击烟尘/音效，
  飞得越高越痛。没有重锤时仍按原版暴击 ×1.5。配置面板「战斗与自保 → 空袭数值」新增
  「猛击下落加成门槛」；跃起/空袭期间自动传送、搭方块与自保归位都会让位，避免半空被拽走。
• 1.21.1 近战空袭兼容「长矛核心」（spearcore，1.20.1 待验收后镜像）：初版主手长矛走通用空袭链路，
  起飞 / 爬升 / 拉开 / 再点火完全一致；只把俯冲段换成幻翼式下落——接近目标时逐步压平机头，最终与地面水平，
  在这一刻补一记烟花（原本「俯冲时加速」的位置），吃完这枚烟花的矢量后再次起飞。进入冲锋后全程保持举矛蓄力
  （后撤 / 重新起飞也不收矛），威胁解除 / 切换模式才取消；命中结算仍交给长矛模组自己的 onUseTick。
  配置面板五行改为「点火距离」「开始压平距离」「烟花矢量时长」「烟花后平飞」「单次突袭最长」。
  未安装长矛核心时行为与之前一致。R1022 起空袭改走独立链路，见下一条。
• 1.21.1 攻击模式兼容「长矛核心」（1.20.1 待验收后镜像）：攻击模式主手长矛不再普通挥砍——
  目标进 10 格自动举矛冲锋，造成伤害后按当前方向再冲 1 秒，随后折返跑出接敌范围，再压回去重新冲锋；
  全程保持蓄力（长矛自己到时限收手也立刻续上），骑乘时追击速度 ×2。相对速度伤害、疲劳后失去击落坐骑/击退
  全部交给长矛模组结算。配置面板「长矛核心·攻击模式冲锋」关闭后长矛照旧一下一下戳。
• 女仆搭方块金色描边与方块同生死（R1047，两版本同步）：1.20.1 之前仍保留 60 tick（3 秒）视觉 TTL，
  方块还在框先没了；现在两版本统一为硬绑定——服务端登记时记录预期方块 id 并随包下发，客户端每帧比对
  空气与方块 id，方块被拆掉或被换成别的方块当帧即不画，方块还在就一直画、不再计时淡出。客户端只隐藏、
  不删除条目，真正撤框只由服务端在方块消失时下发，避免预测/回滚把框永久抹掉；服务端每 10 tick 再对账一次兜底。
• 版本号仍为 1.3.3（同号重打）。

六、安装前看一眼

• ⚠️ 先删除 mods 里的旧 promaid-*.jar，再放入新的（同一个 modId，同时加载会启动失败）。
• 两个 jar 都需要 Touhou Little Maid（车万女仆）本体，实测 1.5.3。
• 旧存档兼容：物品 / 任务 / 蓝图 / 记忆 / 排班等持久化数据沿用 maid_smart 命名空间。
• 1.21.1 存档与 1.20.1 不互通；1.21.1 内部沿用 maid_smart 命名空间，v1.1.x / v1.2.x 存档无缝升级。

平台	文件
Forge 1.20.1	promaid-1.3.3-forge-1.20.1.jar
NeoForge 1.21.1	promaid-1.3.3-neoforge-1.21.1.jar

---

附：Promaid v1.3.2（1.20.1 Forge + 1.21.1 NeoForge）正式版更新说明（存档）

这一版的主线，是把骑乘、飞行载具降落、挖矿伐木这三条「用着别扭」的链路整体捋一遍，另加一批
配置面板与手册的整理。相较上一份发布包（v1.3.1），本次从「骑乘链路的修整」一直覆盖到「对话输出语言」。
⚠️ 请先删掉 mods 里的旧 promaid-*.jar，再放入新的（同一个 modId，同时加载会启动失败）。
完整逐条见桌面 Promaid文本\v1.3.2 骑乘修整与全部配置开关可见.md。

🆕 本次新增 / 改动

「大运」撞击：破坏范围内的敌人按速度吃伤害

佩戴者高速掠过时，破坏范围内的非友方单位会按佩戴者的速度结算伤害与击飞（有封顶）；击飞方向顺着佩戴者的
运动方向——平飞不抬升、俯冲往下砸、爬升往上抛。默认开、随 DIY 关，伤害与击飞各有一个数值可调。

压缩盒：一次投 / 放多个 + 收纳袋式交互

盒里存着 TNT / 末地水晶 / 重生锚时，女仆可以一次投或放出最多 5 个，形成「压缩爆炸」的效果。
交互也做成了收纳袋那套：左键拿起盒子挂在光标上，右击别的一叠物品即可整组装进盒里（反向也支持）。

末地水晶：五个叠在同一格一起放

放置末地水晶改为在同一格叠 5 枚、一起起爆（原先并排散开）。

配置面板「常用」页 + 全项可见

面板最上方新增「常用」大类：第一眼就能在「出厂默认」与「DIY」两套预设之间一键切换（两步确认、会现算改动项数），
下面按类别列出各功能总开关，点「前往 →」直接跳转；另加「显示高级项」开关（默认关，关掉时每页只显示开关与常用数值）。
原先没有面板入口的 toml 项会列进「其余开关（自动补全）」页（该页真有内容时才出现），配置项也补齐了中英文名称。

DIY 模式改口径

切到 DIY 后，只关「本模组对女仆原有行为的改动」；新任务（挖矿 / 伐木 / 建造 / 扫帚 / 宰杀 / 空袭）与新物品
在 DIY 下与默认模式逐项相同、照常可用。

多人服务器：「配置以服务端为准」（默认关）

服主可以打开一个新开关，让全服以服务端那一份配置为准：服务端把配置整份推给每个客户端（只在内存生效、
不写客户端文件），非 OP 只能看不能改，OP 在面板里的改动写回服务端并同步全服（矿表、危险方块表这类
列表也一并同步）。这一行只在专用服务器、或局域网里已有多人在线时，且只对本机是 OP 的玩家显示；单机不显示。
默认关着 = 各人改各人自己的，和以前一样。想撤销：关掉它，或直接改服务端的 config/promaid-common.toml。

随包附赠蓝图：两张进来、三张下架

「唯一」与「《Mistry Memory》」打进包里，干净安装也会在建造目录里直接看到，不用自己导入；
同时下架三张：中世纪刷石机、圆形水族箱、水立方。随包蓝图最终是 79 张（原来那 80 张去掉这 3 张、
加上这 2 张）。已经装过旧版、配置目录里落过这三张副本的，本版首次启动会把它们清掉（那都是模组自己解压的，
不是你自己导入的内容）；早已标记失效的「甘蔗牧场」仍然不随包发出。

滑翔类载具的盘旋高度：开关搬到「骑乘指挥棒」，默认 60 格

滑翔式载具（固定翼那一类）此前有一个写死的「额外加高」，现在进了配置面板：
「物品 → 骑乘指挥棒」里的「滑翔类盘旋加高（格）」（默认 60，范围 0~80）——
跟随你时盘旋在你头顶 63 格、接敌时压在敌人上方 75 格，地形净空高度跟着一起抬，超平坦上也真能飞高。
嫌高 / 嫌低都调这一项；填 0 = 只按「悬停高度 / 接敌高度」飞。老存档里仍是旧默认值（30）的会在
首次启动时自动迁到 60，自己调过的不动；这一行原先挂在「战斗与自保 → 空袭数值」，本版搬进了「骑乘指挥棒」。

骑乘指挥棒：金色光标可以关掉了

绑定 / 选中时给女仆与坐骑打的那圈金色描边，可以在 「物品 → 骑乘指挥棒 → 光标（金色描边）」 关掉。
关掉后不再点亮，已经亮着的会在 5 秒内自动熄掉。它只是「灯」——绑定关系、自动还原、排班统统不受影响。

危险方块设置搬到「战斗与自保」

原先「寻路危险方块避让 / 险境脱离 / 危险方块名单」挂在「生存与复活 → 女仆安全」，而名单页又与矿表共用
同一张子页（页签里就有「危险方块」）——看着就像藏在挖矿里。现在这三项单开一栏**「战斗与自保 → 危险方块」**；
矿表 / 木材表子页只剩「目标矿物 / 障碍物」（木材表为「木材 / 障碍物」）；「危险方块名单」自成一页；
「受困救援」归到「生存与复活 → 传送与逃生」。手册里的路径、跳转链接与英文译文一并跟上。

TNT 有体积了，追踪窗口加长到 1 秒

• 她扔出的 TNT 现在有实体碰撞体积：飞行途中碰到敌人就当场引爆，不再从敌人身上穿过去、落点偏掉；
• 离开她手之后的追踪修正从 0.5 秒加长到 1 秒（配置项默认值 10 → 20 tick，可在「战斗与自保 → 空袭数值」里调；老存档里仍是旧默认值的会自动迁移，自己调过的不动）。

扔的炸药兼容 TNT 矿车

她「掏炸药」时手上认到的若是一辆 TNT 矿车，扔出去的就是那一辆点着的矿车（飞行、落地反弹、
引信都按矿车自己的走法），不再「拿走矿车、变出一枚普通 TNT」；它同样受「爆破不破坏方块」管，
也不会误伤你和同主的女仆。

固定翼降落可切换：「拟真降落」（默认关）

配置面板新增「拟真降落」（「物品 → 骑乘指挥棒」，默认关）：关着 = 上一个版本的降落方式
（扫一块「够平」的地当落点、朝它压高度、近了压平机翼轻接地）；打开 = 以主人脚下为圆心规划跑道的
拟真进近（扫跑道 → 对准进近 → 沿下滑道压高度 → 接地收速停稳；人不在圈内先飞进圈，找不到跑道原地盘旋）。
两种方式共有的「电量见底照常安全降落、接地后停稳」不变。

矿表 / 木材表默认带标签行

矿表默认名单尾带着 #forge:ores / #c:ores，木材表尾带着 #minecraft:logs / #minecraft:bamboo_blocks——
打了这些标签的模组矿石 / 原木默认就算目标；表里也可以自己写 #命名空间:标签=价值 这样的行（面板列表里
显示成「[标签] …」）。把被标签盖住的某一块点小叉移出时，标签行会自动展开成逐块行、这一块除外——移出仍
精确到那一块。老存档首次启动会自动补上这四行。

战斗任务没有敌人时：行为完全按原版

• 她在攻击类战斗任务下、附近没有敌人的时候，行为完整交还给 TLM 原版：跟随模式就跟着你走、守家模式就在家按原版节奏活动；
• 她自己接敌的下一刻，本模组的战斗链路（走位、跳劈、举盾、投弹与轰炸）立即接管；敌人一清立即复原；
• 开关：「单兵战术 → 接管走位」（默认开；关掉 = 战斗状态下本模组不再接管她的走位与移动——战术走位、跳劈、追怪导航都停，喂目标、原地补刀、投弹与举盾照常）。

钓鱼与农场也各有「接管」总开关（各自配置页第一条）

• 面板新增「钓鱼」页（「生产与工作」大类下）：第一条是「接管钓鱼」总开关（默认开；原「钓鱼自动坐垫」开关移进这一页）——关掉 = 她钓鱼完全按 TLM 原版：主动找开阔水域、生成坐垫、坐垫上的走位维持全部停手；
• 「农场与宰杀」页第一条是「接管农场」总开关（默认开）——关掉 = 农场完全按 TLM 原版：连锁收获、批量种植、顺手拾取、锄地、骨粉催熟、不踩农田等增强全体停手；
• 两个开关都保留子开关的勾选状态（重新打开即恢复），并且都随 DIY 关闭；
• 「常用」页新增三颗「前往 →」：单兵战术 / 钓鱼 / 农场与宰杀。

「常用」大类的参数现在少点一次就到

• 配置面板的「常用」分类此前要先点进一个小类才能看到内容，现在点开就是参数页，「← 返回」直接回首页；界面与手册里不再出现「常用与一键预设」这个名字。

第三方玩法模式黑名单：新收「拔刀剑模式」与「战斗模式」

• 《车万女仆：真正的力量》的**「拔刀剑模式」、《史诗战斗联动》的「战斗模式」，和原有的《傀儡装配》「傀儡师」一起列入第三方玩法模式黑名单**（开关行同步改名为「第三方玩法模式黑名单」，默认开）；
• 名单里的模式：自主参战 / 战中换战术 / LLM 自主切换都能把「拔刀剑模式 / 战斗模式」当普通战斗任务切进去；切进去之后（不管谁切的），本模组的战术与行动（单兵走位、跳劈、举盾、投弹与轰炸、威胁驱动、自动换装、排班换段）全体让位，只留那个模组原汁原味的玩法，她按那个模组的打法打完——敌人清除后自动化链路照常把她还原回战斗前的任务；保命动作（自保、落地水、防火）不在让位之列；
• 「傀儡师」例外：它不在战斗候选的语义里，自主切换永不切入——想进它只有你手动切；
• 没装对应模组的整合包：名单自动为空，什么都不影响。

✨ 手感与体验优化

飞机降落改成了可切换的两种方式：「拟真降落」（面板「物品 → 骑乘指挥棒」，默认关）开着 = 以主人脚下
为圆心找一条合适跑道，飞进跑道并沿下滑道一路压高度，接地后把速度逐渐收到零、停稳；她若不在圈内会先飞进圈。
关着（默认）= 上一个版本的降落方式（扫一块「够平」的地当落点、朝它压高度、近了轻接地）。「巡航速度钳回
设计值、地形前瞻按速度加长」与开关无关、两种方式都算，不再等到跟前才抬升避险。卓越前线的载具再解禁两台（汤姆 F6F、迷你快艇）。

挖矿伐木：咬住目标不放。锁定了一块矿 / 一棵树就持续推进，够不着会自己垫高、搭桥、把头顶挡路的方块挖开；
原先那套「发呆几秒、说一句『我走神了』、再重新挑目标」的机制整个去掉了。接近目标改成严格「先高度、后水平」
并加「到位就停」，治掉了「在一个方块里来回走」。选目标改为就近优先（只按距离，去掉价值 / 深度权重）。
干活时照常捡掉落物；新增智能挖矿 / 智能伐木（默认名单带着矿物 / 原木标签行，打了标签的模组矿石 / 原木自动...

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

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

这一版的主线，是把骑乘、飞行载具降落、挖矿伐木这三条「用着别扭」的链路整体捋一遍，另加一批
配置面板与手册的整理。相较上一份发布包（v1.3.1），本次从「骑乘链路的修整」一直覆盖到「对话输出语言」。
⚠️ 请先删掉 mods 里的旧 promaid-*.jar，再放入新的（同一个 modId，同时加载会启动失败）。
完整逐条见桌面 Promaid文本\v1.3.2 骑乘修整与全部配置开关可见.md。

🆕 本次新增 / 改动

「大运」撞击：破坏范围内的敌人按速度吃伤害

佩戴者高速掠过时，破坏范围内的非友方单位会按佩戴者的速度结算伤害与击飞（有封顶）；击飞方向顺着佩戴者的
运动方向——平飞不抬升、俯冲往下砸、爬升往上抛。默认开、随 DIY 关，伤害与击飞各有一个数值可调。

压缩盒：一次投 / 放多个 + 收纳袋式交互

盒里存着 TNT / 末地水晶 / 重生锚时，女仆可以一次投或放出最多 5 个，形成「压缩爆炸」的效果。
交互也做成了收纳袋那套：左键拿起盒子挂在光标上，右击别的一叠物品即可整组装进盒里（反向也支持）。

末地水晶：五个叠在同一格一起放

放置末地水晶改为在同一格叠 5 枚、一起起爆（原先并排散开）。

配置面板「常用」页 + 全项可见

面板最上方新增「常用」大类：第一眼就能在「出厂默认」与「DIY」两套预设之间一键切换（两步确认、会现算改动项数），
下面按类别列出各功能总开关，点「前往 →」直接跳转；另加「显示高级项」开关（默认关，关掉时每页只显示开关与常用数值）。
原先没有面板入口的 toml 项会列进「其余开关（自动补全）」页（该页真有内容时才出现），配置项也补齐了中英文名称。

DIY 模式改口径

切到 DIY 后，只关「本模组对女仆原有行为的改动」；新任务（挖矿 / 伐木 / 建造 / 扫帚 / 宰杀 / 空袭）与新物品
在 DIY 下与默认模式逐项相同、照常可用。

多人服务器：「配置以服务端为准」（默认关）

服主可以打开一个新开关，让全服以服务端那一份配置为准：服务端把配置整份推给每个客户端（只在内存生效、
不写客户端文件），非 OP 只能看不能改，OP 在面板里的改动写回服务端并同步全服（矿表、危险方块表这类
列表也一并同步）。这一行只在专用服务器、或局域网里已有多人在线时，且只对本机是 OP 的玩家显示；单机不显示。
默认关着 = 各人改各人自己的，和以前一样。想撤销：关掉它，或直接改服务端的 config/promaid-common.toml。

随包附赠蓝图：两张进来、三张下架

「唯一」与「《Mistry Memory》」打进包里，干净安装也会在建造目录里直接看到，不用自己导入；
同时下架三张：中世纪刷石机、圆形水族箱、水立方。随包蓝图最终是 79 张（原来那 80 张去掉这 3 张、
加上这 2 张）。已经装过旧版、配置目录里落过这三张副本的，本版首次启动会把它们清掉（那都是模组自己解压的，
不是你自己导入的内容）；早已标记失效的「甘蔗牧场」仍然不随包发出。

滑翔类载具的盘旋高度：开关搬到「骑乘指挥棒」，默认 60 格

滑翔式载具（固定翼那一类）此前有一个写死的「额外加高」，现在进了配置面板：
「物品 → 骑乘指挥棒」里的「滑翔类盘旋加高（格）」（默认 60，范围 0~80）——
跟随你时盘旋在你头顶 63 格、接敌时压在敌人上方 75 格，地形净空高度跟着一起抬，超平坦上也真能飞高。
嫌高 / 嫌低都调这一项；填 0 = 只按「悬停高度 / 接敌高度」飞。老存档里仍是旧默认值（30）的会在
首次启动时自动迁到 60，自己调过的不动；这一行原先挂在「战斗与自保 → 空袭数值」，本版搬进了「骑乘指挥棒」。

骑乘指挥棒：金色光标可以关掉了

绑定 / 选中时给女仆与坐骑打的那圈金色描边，可以在 「物品 → 骑乘指挥棒 → 光标（金色描边）」 关掉。
关掉后不再点亮，已经亮着的会在 5 秒内自动熄掉。它只是「灯」——绑定关系、自动还原、排班统统不受影响。

危险方块设置搬到「战斗与自保」

原先「寻路危险方块避让 / 险境脱离 / 危险方块名单」挂在「生存与复活 → 女仆安全」，而名单页又与矿表共用
同一张子页（页签里就有「危险方块」）——看着就像藏在挖矿里。现在这三项单开一栏**「战斗与自保 → 危险方块」**；
矿表 / 木材表子页只剩「目标矿物 / 障碍物」（木材表为「木材 / 障碍物」）；「危险方块名单」自成一页；
「受困救援」归到「生存与复活 → 传送与逃生」。手册里的路径、跳转链接与英文译文一并跟上。

TNT 有体积了，追踪窗口加长到 1 秒

• 她扔出的 TNT 现在有实体碰撞体积：飞行途中碰到敌人就当场引爆，不再从敌人身上穿过去、落点偏掉；
• 离开她手之后的追踪修正从 0.5 秒加长到 1 秒（配置项默认值 10 → 20 tick，可在「战斗与自保 → 空袭数值」里调；老存档里仍是旧默认值的会自动迁移，自己调过的不动）。

扔的炸药兼容 TNT 矿车

她「掏炸药」时手上认到的若是一辆 TNT 矿车，扔出去的就是那一辆点着的矿车（飞行、落地反弹、
引信都按矿车自己的走法），不再「拿走矿车、变出一枚普通 TNT」；它同样受「爆破不破坏方块」管，
也不会误伤你和同主的女仆。

固定翼降落可切换：「拟真降落」（默认关）

配置面板新增「拟真降落」（「物品 → 骑乘指挥棒」，默认关）：关着 = 上一个版本的降落方式
（扫一块「够平」的地当落点、朝它压高度、近了压平机翼轻接地）；打开 = 以主人脚下为圆心规划跑道的
拟真进近（扫跑道 → 对准进近 → 沿下滑道压高度 → 接地收速停稳；人不在圈内先飞进圈，找不到跑道原地盘旋）。
两种方式共有的「电量见底照常安全降落、接地后停稳」不变。

矿表 / 木材表默认带标签行

矿表默认名单尾带着 #forge:ores / #c:ores，木材表尾带着 #minecraft:logs / #minecraft:bamboo_blocks——
打了这些标签的模组矿石 / 原木默认就算目标；表里也可以自己写 #命名空间:标签=价值 这样的行（面板列表里
显示成「[标签] …」）。把被标签盖住的某一块点小叉移出时，标签行会自动展开成逐块行、这一块除外——移出仍
精确到那一块。老存档首次启动会自动补上这四行。

战斗任务没有敌人时：行为完全按原版

• 她在攻击类战斗任务下、附近没有敌人的时候，行为完整交还给 TLM 原版：跟随模式就跟着你走、守家模式就在家按原版节奏活动；
• 她自己接敌的下一刻，本模组的战斗链路（走位、跳劈、举盾、投弹与轰炸）立即接管；敌人一清立即复原；
• 开关：「单兵战术 → 接管走位」（默认开；关掉 = 战斗状态下本模组不再接管她的走位与移动——战术走位、跳劈、追怪导航都停，喂目标、原地补刀、投弹与举盾照常）。

钓鱼与农场也各有「接管」总开关（各自配置页第一条）

• 面板新增「钓鱼」页（「生产与工作」大类下）：第一条是「接管钓鱼」总开关（默认开；原「钓鱼自动坐垫」开关移进这一页）——关掉 = 她钓鱼完全按 TLM 原版：主动找开阔水域、生成坐垫、坐垫上的走位维持全部停手；
• 「农场与宰杀」页第一条是「接管农场」总开关（默认开）——关掉 = 农场完全按 TLM 原版：连锁收获、批量种植、顺手拾取、锄地、骨粉催熟、不踩农田等增强全体停手；
• 两个开关都保留子开关的勾选状态（重新打开即恢复），并且都随 DIY 关闭；
• 「常用」页新增三颗「前往 →」：单兵战术 / 钓鱼 / 农场与宰杀。

「常用」大类的参数现在少点一次就到

• 配置面板的「常用」分类此前要先点进一个小类才能看到内容，现在点开就是参数页，「← 返回」直接回首页；界面与手册里不再出现「常用与一键预设」这个名字。

第三方玩法模式黑名单：新收「拔刀剑模式」与「战斗模式」

• 《车万女仆：真正的力量》的**「拔刀剑模式」、《史诗战斗联动》的「战斗模式」，和原有的《傀儡装配》「傀儡师」一起列入第三方玩法模式黑名单**（开关行同步改名为「第三方玩法模式黑名单」，默认开）；
• 名单里的模式：自主参战 / 战中换战术 / LLM 自主切换都能把「拔刀剑模式 / 战斗模式」当普通战斗任务切进去；切进去之后（不管谁切的），本模组的战术与行动（单兵走位、跳劈、举盾、投弹与轰炸、威胁驱动、自动换装、排班换段）全体让位，只留那个模组原汁原味的玩法，她按那个模组的打法打完——敌人清除后自动化链路照常把她还原回战斗前的任务；保命动作（自保、落地水、防火）不在让位之列；
• 「傀儡师」例外：它不在战斗候选的语义里，自主切换永不切入——想进它只有你手动切；
• 没装对应模组的整合包：名单自动为空，什么都不影响。

✨ 手感与体验优化

飞机降落改成了可切换的两种方式：「拟真降落」（面板「物品 → 骑乘指挥棒」，默认关）开着 = 以主人脚下
为圆心找一条合适跑道，飞进跑道并沿下滑道一路压高度，接地后把速度逐渐收到零、停稳；她若不在圈内会先飞进圈。
关着（默认）= 上一个版本的降落方式（扫一块「够平」的地当落点、朝它压高度、近了轻接地）。「巡航速度钳回
设计值、地形前瞻按速度加长」与开关无关、两种方式都算，不再等到跟前才抬升避险。卓越前线的载具再解禁两台（汤姆 F6F、迷你快艇）。

挖矿伐木：咬住目标不放。锁定了一块矿 / 一棵树就持续推进，够不着会自己垫高、搭桥、把头顶挡路的方块挖开；
原先那套「发呆几秒、说一句『我走神了』、再重新挑目标」的机制整个去掉了。接近目标改成严格「先高度、后水平」
并加「到位就停」，治掉了「在一个方块里来回走」。选目标改为就近优先（只按距离，去掉价值 / 深度权重）。
干活时照常捡掉落物；新增智能挖矿 / 智能伐木（默认名单带着矿物 / 原木标签行，打了标签的模组矿石 / 原木自动认）。

骑乘：绑定飞行载具后先留约 3 秒「引擎起、车不动」给你上机（面板可调，填 0 = 旧行为）；骑马近战会主动
朝目标追上去打，不再「砍一刀没砍死就原地罚站」。

配置面板重组：新增「物品」大类（压缩盒 / 武装拴绳 / 骑乘指挥棒 / 大运各占一小类），归类归位，
「危险方块表」改成与矿表同款的勾选子页，挖矿 / 伐木两页陈旧文案重写。

蓝图目录的搜索框回来了：上一版为了「深色字看不清」把搜索框画成了无边框，结果看着像一行提示文字、很多人找不到输入入口。这一版改回有边框的输入框（文字用白色），点一下就能打字搜索。

区块调控放宽到「接触到区块」：以前必须整个人站在区块里才能暂停 / 改速 / 取消，只有一格高的建筑根本进不去。现在三轴各向外放一格——贴着区块边缘站着（就站在它旁边）也算「在里面」，调控照常可用。

「常用」页里另外三件道具也有「前往 →」了：以前这一页只有压缩盒能一键跳过去，**武装拴绳（二号位）/ 骑乘指挥棒 / 饰品「大运」**现在同样能跳。

面板导航少一层：某个大类下面只有一个小类时，不再让你先进「选择小类」再选那唯一的一项——点大类直接进那一页，「返回分类」也直接回大类列表。

🐛 关键修复

• 枪械 / 三叉戟模式下她不再投 TNT、也不放末地水晶 / 重生锚 / 床：这两类任务的攻击不写「攻击冷却」那份记忆，共用触发点因此一直空转；现在改用「目标身上最近打她的那一下」当判据，任何打法只要真打中就会照旧轰炸起手与投弹；
• 打开《Promaid 手册》会卡死：外部蓝图扫描会把缓存反复失效、每 tick 重解析；现在按路径记时间戳、
  内容没变直接返回，并给每轮扫描加时间预算；
• 自动复活倒计时走完又刷回 5 秒、永远复活不了：死亡瞬间所在区块掉出实体结算，尸体一直占着她的身份导致
  复活失败；现在复活前全维度查同一身份（活的摘登记、死的当场清掉），失败重试也有了次数上限；
• 有抗火 / 火焰保护饰品，她仍会喊「这里烫」并逃跑、传送：豁免判据统一收口，抗火药水只剩最后几十秒也不再
  算「会疼」，站在营火 / 岩浆块等热源上的抢救一并豁免；
• 配置界面「飞行聚晶」那一行的开关，读到的是「创造飞行」的状态：两处界面注入方法重名、后一个被静默丢弃；
• 挖矿误报「附近没有值得挖的矿石」；工作圈只认 home 模式（跟随下不再被留在老家的圈钳死在原地，
  以前会出现「旁边就是煤矿石也不挖」）；
• 排班表「召她过来 / 一键集合」在 home 模式下点不动：守家豁免不再拦骑在载具上的她；一键集合对特殊载具
  改为连人带载具一起搬；
• 把对话输出语言设成英文后偶尔仍回中文：提示词里加了「只用设定语言回复」的硬指令，输出检测改为按目标语言
  判定并自动内联翻译一次，聊天栏 [名字] 台词 拆段（名字含汉字时不再让整句译文丢失），补齐 8 条气泡英文；
• 巡逻总开关与扫帚总开关撞在同一个配置项上（动一个另一个跟着变）：拆开并做老存档迁移；
• 船与汤姆6 不再「没电」；被水流卡住会自动脱困（原先只有岩浆有兜底）；路径直线上有岩浆会先提示；
• 手册骑乘列表去掉僵尸马 / 骷髅马（Java 版骑不了）；大运配方文案计数更正；
• 女仆建刷铁机 / 刷石机时，水会「漫出去」、机器建好却不工作：水与岩浆原先在搭建顺序里排得很靠前（和墙、地板同批），围壁还没立起来水就先流走——冲散推人水道、漫过还没砌好的槽，还会冲掉随后放下的红石粉 / 火把 / 铁轨 / 作物。现在水与岩浆一律排到最后放：先把结构、机构、红石全部立好，最后才放液体（机器蓝图里液体放在电源之前，机器一通电就是完整状态）；贴着水的睡莲这类方块会一直等到水落地再放；
• 放下女仆那一下游戏直接崩掉：本模组"拾取优先级"的注入点原先只写了方法名——重映射后的类里同名的方法有两份（一份收女仆、一份是编译器留下的、收更泛类型的那份），它挑中了后者、参数对不上，于是女仆一被放出来（那个类第一次被加载）就崩。现在注入点一律写全签名、精确指向该用的那一份；并把全模组每一处同类写法都核对了一遍（又揪出 5 处同样的隐患，一并改掉），还给打包流程加了一道自动审计——这类"名字对、签名错"的注入点以后直接拦住不让出包。
• 手册里两处过时说法改掉了：一处是"已经坐上这四架固定翼的女仆会每拍自检、自动解绑"——代码里没有这套机制（现在能不能骑只看载具报废没报废、有没有能坐的位子）；另一处是英文手册里"汤姆 F6F / 迷你快艇还是飞不了"这句过期话，这两台现在与四架固定翼一样走固定翼链路。
• 英文手册「骑乘指挥棒」一章的分段错位修掉了：这一章的英文原先不是按中文段落切的，每条的首/尾会错落到
  相邻条目上（英文客户端读到的是"上一段的后半句 + 这一段的前半句"），另有两句中文在表里完全没有英文。
  现在整章按中文段落重新对齐，并补译缺的四句（投弹间隔 2 秒 / 主炮弹种表 / 特殊载具传送那行 / 日志关键词表）；
  顺带修掉小标题「七、固定翼全都能开了」因丢了加粗标记、在英文端显示成中文的问题；另清掉表里一条早已被推翻的旧断言（「汤姆 F6F / 迷你快艇还是开不了」）。
• 英文手册补齐了一批漏译，并修好 Neo 版固定翼那一章：手册里凡是「中文有、英文没有」的行都补上了译（按渲染器口径逐段核对，共 44 处：首页各章导航行、DIY / 默认模式、工作区域与工位标记、压缩盒三处、智能挖矿 / 智能伐木、空中接敌机动相关若干、合成行等）；Neo 版「固定翼」那一章原先英文错位、有整段没译，现已按中文段落重新对齐并补译（巡航与接敌 / 高度与地形净空 / 坠机与安全降落）；另删掉一处漏进手册正文的轮次号。
• 手册「骑乘与载具」章：固定翼起飞抬头角写错了，Neo 版的这一章也换成了新排布：书上写的是 25°，而代码里的实际值是 35°（AIRCRAFT_TAKEOFF_PITCH，与汤姆 F6F 那条同值；同章另一处本来就写的是 35°），现按实际值更正；Neo 版这一章原先停在旧版排布（60 段，比其它版本少 7 段、正文里有两段被并作一段），现已换成与其它版本逐段一致的 67 段新版，该章英文一并补齐（Neo 的英文表因此补了 13 条）。
• 伐木不再被头顶的方块卡死、垫方块不再盖到自己脑袋、随手种树不挨着种：①伐木时头顶压着一块方块（地形房顶，或是她自己先前垫上去的方块）原先会让她站着不动——现在她会像挖矿那样把那块砍开，一格一格开出天窗往上走；②搭柱子（够高处的树 / 矿）时，方块原先在“脚下那格不是空气”（站在水里、树叶里、雪层上）时会直接放在她的上半身 / 脑袋上，顶起稍有滞后就把自己闷住——现在一律只垫在她脚下那一格（最多盖住下半身）；③随手种树原先不看旁边有没有树苗，两棵能挨着种——现在候选点周围 2 格（同层上下各 2 格）已有树苗就静默跳过、不种也不吱声，照常重新计时。
• 伐木不再「到点就放弃目标」：原先她在够不着的树前超过一段时间（默认 15 秒，面板「伐木 → 目标与节奏 → 目标超时」可调）且零进度就会丢掉这棵树去换目标——地表挡路的方块她基本都能砍开、也能垫上去，这个计时器只会打断正在推进的活。现在这条判据整条删掉（连同面板那一行），她会一直朝目标推进；只有真的走不到（挡路块挖不开，或她连续 2 秒一字未动）才会换树。挖矿侧不变。
• 矿表 / 木材表页新增「✖ 一键删除」：障碍物那一页原先只有「✔ 一键全部加入」——点一下把网格里的方块全设成可挖穿，但想反悔只能一个个点回去。现在它旁边多了一个「✖ 一键删除」：点一下就把你先前配置过的障碍物整张删掉（额外名单清空、排除名单恢复出厂默认，也就是内置的木 / 竹 / 蘑菇 / 冰 / 珊瑚那些重新变回“不挖穿”），不看搜索框过滤、整张复位。删完可以用同一页的「↩ 回退」一键还原（删错了不心疼）；名单本来就是出厂状态时按钮灰显，点了只给一行提示、不会有动作。挖矿与伐木两页共用同一对名单，在任一侧删除都是同一份配置。
• 建造完工「整体重放」（走后门）：建造完成的那一瞬间，她会把自己刚搭好的这一片（方块和流体）先静默清掉——没有粒子、没有音效、也不触发任何方块更新——再按蓝图从头整片重放一遍。于是终态严格等于图纸本身：建造过程中被活塞推走的方块、被红石误触的机构、被水流冲散的槽位、补支撑多出来的石头，全部一次抹平，“机器因为建造顺序而失效”从根上不再出现。流体也在这一步统一重放：水、岩浆与模组流体都按方块自身的流体状态判定并重新激活（不会再出现“只带岩浆的机器建好后岩浆不流”这种按名字漏判），水道与气泡柱随之成形。超大蓝图（超过 5 万步）自动跳过重放。配置面板「建造」页新增「完工整体重放」开关，默认开。
• 超大蓝图也能重放了（上限 2 万步 → 5 万步）：完工重放要把整片先清掉、再按蓝图重放一遍，这套动作是挤在完工那一瞬间的一个游戏刻里做完的，步数越多这一下越卡，所以此前超过 2 万步就直接跳过。现在上限提到 5 万步，同时把「清空」和「重放」两趟各自的解析合并成一趟，把这一档的瞬时开销也压下来；仍然超过 5 万步的巨型蓝图保持原有做法（跳过重放，完工即终态）。
• 压缩盒右键收纳加了一记音效：光标上拿着压缩盒、右键点某个槽把东西收进去（或者盒子在槽里、右键把光标上那组收进去）时，收成功会响一下——就是玩家穿装备那个声音，音量/音调照原版。没装进去（格子满了 / 这一件不许进盒）不响；嫌吵可以拉低原版「玩家」音量滑条。
• 建造时她瞬移得更跟手：建造模式下，她「先瞬移到要放的那块旁边、再放下」的节奏放快了——原来是至少隔 4 拍才挪一次，现在每 2 拍就可以挪一次（一拍内最多一次；比最早的口径快一倍）。她已经站在目标旁 2 格内时照旧不挪（这一条没变）。指标石搭建复用同一条节流，一并生效。
• 导入蓝图：游戏内选文件窗口的排版修好了：手册里点「⬆ 导入建筑」/「⬆ 导入地图」，走的是游戏内自带的文件浏览窗口——它的列表现在会随窗口大小自动调整每页条数，条目不会再画到屏幕外面去，底部的左右翻页也不会再和文件条目叠在一起；两侧按钮在窄窗口下会跟着收窄，不会再顶出屏幕边缘。
• 飞行跟随不再「追不上还在原地空烧烟花」：她起飞追你之后，如果连续 5 秒都没能把距离拉近（地形卡住、你在持续爬升、速度差太大等），她会自己收手停下——日志「结束」那一行会写明是「追不上」才停的；在你重新回到她身边（回到起手距离以内）之前，她不会再次自动起飞，不会再「丢目标原地乱飞、一枚接一枚地烧烟花」。另外每次收手后有 3 秒冷却，不会刚收手又立刻起飞来回烧料。
• 修：手册建造目录顶部的搜索框消失：建筑 / 材料目录页顶部那条搜索框，此前改了外观之后整个看不见了（框还在、还点得动，但一个像素都不画）——现在恢复显示，提示文字「搜索建筑名称…」也回来了。
• 建造期间水与岩浆不再流动：建造计划进行中，图纸区域内的水不会漫出去、岩浆不会溢开，也不会再把刚放下的红石粉 / 火把 / 铁轨冲掉——少了一大类「回头补建」的来回，搭得更快。这一条与既有的「沙子悬空不落、草不传播、蓝图树叶不掉」同属建造区保护（默认开；在配置面板关掉即回到原版物理）。完工时会整体重放，终态与图纸完全一致。
• 刚确定下来的建造区域，走出区块也看得见：用手册把区块确定下来、女仆还没开工的这段时间，原先只要走出这片区域，红色框和橙色虚影就整片消失（走回来才又有）；现在确定它的人一直看得见这片区域，人在不在区块里都一样。
• 情绪系统按手册口径重做：手册一直写着"你喂她、夸她，她的愉悦值会升高"，但代码里这两件事根本不碰愉悦（只加亲密/唤醒）——所以顿顿金苹果也看不到愉悦动一下。现在：喂食（手里拿着食物右键她）每次愉悦 +6%，夸她（对话里夸）每次 +8%，挨打会把愉悦拉下来。另外三处修正：① 被主人打还会压低「支配」、并欠下一次需要道歉偿还的「修复债」；而世界给的伤（怪物、摔落、着火、挤压…）只算「她最近受了委屈」，不再算到你头上——以前两类伤混在一起，才会出现"你明明没伤过她，她却在提旧账"；② 多人服里别人打你的女仆不再记成你打的（单列一档、比主人轻）；③ 恢复不再被打断：以前喂食、聊天都会把"10 分钟安静计时"重置，你越关心她愉悦越回不来，现在只有挨打才会顺延；愉悦是负分时也如实显示（不再一律显示 0%）。
• 情绪数值的判定边界（不会被高频刷爆、也不会被扣死）：每一类情绪事件（喂食、夸奖、对话、道歉，以及"主人打 / 别人打 / 世...

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 命名空间。

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

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

本版为 1.20.1 Forge 与 1.21.1 NeoForge 双版本同步更新（源码 v1.3.0，版本号由 v1.3.0(beta) 转正）。
相较上一份发布包（v1.3.0(beta)，覆盖「实测七百四十九 ~ 七百六十三」），本次累积了「实测七百六十四 ~ 七百九十四」共 31 轮改动，外加一个新道具「巡逻航图」与一轮多人服务端隐患整改。
⚠️ 同名覆盖重传：请先删掉 mods 里的旧 jar，再放入新的。

🆕 本次新增

巡逻航图（新道具）——给扫帚女仆画一条闭环轨道

合成：纸 + 指南针 + 墨囊（无序）。给「扫帚模式 + 在家模式」的女仆画一条闭环轨道，让她沿你画的线一圈圈飞，替代原本「绕工作范围盘旋」的守家行为。

📖 游戏内手册同步更新：新增《巡逻航图》整章（保姆式五步教学）；「功能总览」章补上 v1.3.0 新增功能速览。手册总章数 35 → 37。

• 怎么画：右键开界面 → 「＋ 创建一个轨道」→ 进管理页把女仆绑上去、点「开始标记」→ 退出界面，手持航图按鼠标中键记一个标记（不用潜行、空中地面都行，落点就是你此刻的位置）→ 再次右键回界面点「连接」，首尾接成闭环；
• 一本航图装 16 条轨道：各有名字 / 净空半径 / 标记点 / 是否闭环；可新建 / 改名 / 删除 / 切换，另有「标记管理页」可逐条删 / 删最后一个 / 清空。旧版单条格式的存档升级时自动包成第一条，原来录的那条不会丢；
• 标记长什么样：只在你手持航图时世界里才可见——菱形核 + 地面光环 + 竖针，首点青绿、末点品红，每个菱形头上标「轨道名 #几」；
• 「连接」没有门禁：点数不够 / 坡度太陡 / 自交 / 半径超限 / 挡路方块一律照连不误，原来的判据只化作一句 ⚠ 提醒——能不能飞由她自己兜底（航线会自动抬过挡路方块，标记本身不动）；
• 配置：总开关（默认开）、默认净空半径（默认 1.5 格）、最大水平半径（默认 128 格，0 = 不限制）；命令 /maid_smart broom_goto 直接飞某点、/maid_smart broom_patrol status|off 查状态 / 解除。巡逻期间她不再受扫帚牵引绳影响。

超越维度（BeyondDimensions）存储联动（合并贡献者 PR #34）

• 产物回收 / 溢出入库 / 自动补货 / 缓存冲刷四条链路接上超越维度网络存储；
• 合并后整改了三处复制 bug（还库复制物品、溢出入库依赖会改物品的探测、补货），并把选项全部并入配置面板（全局开关 + 规则名单子页 + 每女仆产出回收开关）。

✨ 载具武器与飞行（实测七百七十三 ~ 七百八十六）

载具武器

• 装填认得创造弹药盒、多根炮管一起开火、射速改按各炮自己的 RPM、投弹最小间隔 2 秒；骑乘指挥棒三处整改（骑乘中右击一律取消 + 玩家坐主驾时驾驶让给玩家 + 载具武器改「直瞄开火」）。

固定翼（AC-130H 这类，只动这一档，其他载具一个字节未动）

• 从「真的飞得起来」到「真的能保持 / 爬回高度」：起飞抬头角 25°→35°、净空线 14→44 格、高度环改走引擎原生俯仰通道（符号与权限两处修正）、修掉「竖直通道死点」；
• 航迹改成「绕主人盘旋 / 敌顶来回穿梭轰炸」（弃用引擎 loiter，自己管航向 / 推力 / 高度）；
• 索敌改成「以主人为圆心、水平 50 格」（原来 44 格高度差把 3D 50 格球压成水平 24 格 → 锁不到敌、只在头顶才开火）；
• 没电 = home 模式 → 立刻安全降落；home 模式新增「安全降落」；
• 坦克主炮射速兜底：json 里没写射速数据的炮，不再按引擎默认 RPM=600 的「0.1 秒一发」开火（创造盒下"一部分坦克主炮射速 / 攻击间隔异常"）。

🐛 其他修复（实测七百六十四 ~ 七百九十四）

• 无鞍可骑模组仆从坐骑区间 + 友军支援（七百六十四 ~ 七百七十一）；
• 指名道姓的「召她过来」豁免收窄成「只留守家」：坐姿 / 骑乘的女仆一律"只拽人不拽载具"，一键集合口径不变（七百九十）；
• 建造 / 排班两个界面的行区排版修正：调试行区不再压住底部动作按钮（小窗口下按钮行卡在列表中间）（七百九十）；
• 近战「智能举盾」反而削弱了举盾频率：删掉与近战走位打架的 2.6 格「贴身」闸（七百九十一）；
• 举盾回到「原版口径」：近战 8 格内就举盾（不再要求攻击冷却中）+ 远程 15 格 + 视线 + 枪械任务也举盾（原版 gun_attack 本就注册了举盾，是早期误挡）；唯一例外是弓 / 弩 / 三叉戟 / 御币蓄力中（与盾抢同一个「使用物品」槽位，物理互斥）（七百九十二）；
• 固定翼「机上有人且周围无敌人」时不再平飞漂走、立刻丢失目标：改走 home 那套安全降落（它不能悬停，旧版 holdHere 等于没制动一路漂出锁敌圈）（七百九十四）；顺带修掉一处「注释说 A、代码做 B」——降落期间落点缓存每拍被无条件清空、每拍重扫 625 列高度图。

🔧 多人服务端隐患整改

复核了 v1.1.0 修过的两类服务端崩溃（客户端类型签名内联 / TLM 客户端专用方法），用 javap 逐类扫过两棵树的服务端可达类描述符——未发现新的客户端类型出现在方法 / 字段描述符里。本轮实修另外三处「信息泄露 + 无谓广播 + 无谓全图扫描」：

• 建造 HUD 不再全服广播：旧版每个玩家每秒收到全服务器所有人的建造进度（区块名 / 进度 / 速度 / ETA），改为只发给「与该区块有关的人」（站在区块内 / 区块里绑着归他的女仆）；
• 建造区块描边不再全服广播：旧版每秒把全服所有人的建造区块位置发给每个玩家，同上口径收敛；
• 钓鱼坐垫维持不再全图扫实体：旧版每 3 tick 对每个维度取全量实体视图再 instanceof 过滤 = 15 次/秒 × 全部维度 × 全部实体；改为只遍历「正在走向钓鱼坐垫」的那几只（没人走坐垫时零开销）。三处均为服务端行为收敛，不改任何玩家可见的判定结果。

📦 下载

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

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

Promaid v1.3.0-beta（1.20.1 Forge + 1.21.1 NeoForge）

Promaid v1.3.0(beta) 更新说明

本版为 1.20.1 Forge 与 1.21.1 NeoForge 双版本同步更新（源码覆盖 v1.3.0(beta)）。
相较上一份发布包，本次累积了「实测七百四十九 ~ 七百六十三」共 15 轮的改动；最后两轮是把仓库里的 issue 逐条对着代码复核后的集中修复。
⚠️ 同名覆盖重传：请先删掉 mods 里的旧 jar，再放入新的。

🐛 本次修订重点（实测七百六十二 ~ 七百六十三：issue 复核）

• #19 搭路方块长期使用缓慢变多：「取材必须真的扣掉」的核对从一条链路扩到全部九条（搭路 / 挖矿与伐木垫脚 / 索引石与补支撑 / 战斗放置 / 蓝图建造 / 插火把 / 自动点灯）；「先放后扣」的两条改成扣不到就把刚放下的拆掉回滚。
• #27 远距 / 跨界传送后血上限显示掉回 20：属性补包除广播外对主人直连再补一枪——故障态下服务端追踪表里没有主人，广播一发包都到不了；每次传送在 promaid.log 留一行兜底记录。
• #28 Home 女仆卡在复活点不再回工位：「干活不打断」豁免只在「活动半径 + 4」以内生效，飘到圈外交还原版把她送回来。
• #29 连锁挖矿耐久：mine.chainFullDurability 开关补齐英文 lang（英文界面里 mine 段的 17 条配置不再显示原始键名）。
• #30 被自己垫的方块闷住时不播报：窒息播报从「飞行 / 扫帚」早退之后提到之前——她飞着 / 骑扫帚时被闷住也会说；判据保持「累计 in_wall 伤害 ≥ 4.0」的常驻检查。
• #31 坐垫 / 椅子上的女仆残血被自保传送拉走：停放豁免补上 isPassenger()——TLM 的坐垫 / 椅子让她成为的是「乘客」，而不是坐姿。
• #33 墓碑残留（复活后物品两份）：把这条链读透了——不存在「区块没加载所以删不掉」：我们自己那句 getChunk 按 33 级 ticket 同步载入，实体当场进入可见实体表，不需要任何玩家在附近，同 tick 就能取到；真正会让墓碑「存在却够不到」的是登记表记的维度在本服务器上没有对应维度，现在单独点名并写明坐标（此前会并进另一句日志、指向错误方向），加载过程抛异常也补了日志。

✨ 本次重点（实测七百四十九 ~ 七百六十一）

骑乘时也能打出横扫之刃

修正了「只要不站在地面就取消横扫」这条过宽的判据：骑在坐骑 / 卓越前线载具 / 船上时照常触发横扫之刃，只有真正的跳劈 / 坠落仍保持单体暴击。原版对骑乘本就没有这一层限制。

没电的载具不再能起飞

卓越前线的直升机 / 固定翼，电量耗尽后女仆无法再把它飞起来——此前我们的飞行驱动每拍直接写推力，绕过了引擎自己的「没电熄火」闸；现在在给推力前先问同一条闸，电量见底就让载具自然落下。

伊卡洛斯之翼 / 神秘遗物+ 的鞘翅兼容（功能 + 外观）

• 功能：伊卡洛斯空域系 6 件自推翼——双重可变翼 / 电子战用隐秘翼 / 超加速型羽翼 / 混沌进化之翼 / 缓滞时空羽翼 / 反逆可变翼——女仆穿上后不靠烟花也能自己巡航，各自套用该鞘翅自己的推力公式；神秘遗物+ 的**「壮丽鞘翅」「混沌之傲」**同样支持飞行与自推。
• 外观：女仆背上渲染的是那件鞘翅自己的翅膀贴图（12 件伊卡洛斯翼 + 神秘遗物+ 两款，共 14 款逐一收录），不是一律原版鞘翅。
• 通解通法：凡「能滑翔」的物品都会画翅膀；模组公开了取值口（如伊卡洛斯的 getType().getTexture()）就自动用它的外观，换新模组也无需专门适配。

🐛 修复与改进（实测七百四十九 ~ 七百六十一）

骑乘指挥棒 / 坐骑

• 坐骑改走「她寻路上的终点」并改为每 tick 驱动，跟随与接敌不再慢半拍。
• 陆地坐骑（原版马 / 驴 / 骡 / 骆驼及任何可骑乘模组生物）直接换成女仆自己的移动逻辑——跟随与作战自然同步；骑上后迂回战术走位恢复正常。
• 修掉总根源：自保里「坐下就锁移动」每拍把骑乘女仆的寻路清掉（坐姿其实是本模组自己压上去的，不是玩家指令）。
• 多只女仆坐卓越前线载具时不再「叠罗汉」（按车体尺寸互斥，5 格内的别的载具互相弹开）。
• 守家（home 模式）→ 她乘坐的坐骑立刻停；本版起对飞行载具也生效——就地定高悬停，不再追着主人 / 敌人飞。
• 左击换座（主驾 ↔ 副驾）、绑定顺序固定为「先右击坐骑、再右击女仆」。

索敌 / 开火

• 车上索敌不再把「什么东西」都当敌人（引入带 5 秒时效的活敌人判据）：不再对着自家的动物开炮；正在打的仗与模组 boss 不受影响。
• 坦克 / 载具用自己的炮塔炮弹开火、弹道瞄准；导弹改走「投掷 TNT 同款短锁」（只在前 0.2 秒盯着敌人，之后交还末端制导），不再乱飞。

其他

• 轮椅（1.20.1）坐上就能走；墓碑「没加载就漏删」已修；issue #27 远距传送后血上限恢复。
• 手册「骑乘指挥棒」整章按当前功能重写。

📦 下载

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

版本号保持 v1.3.0(beta)（同名覆盖）；两个 jar 均需搭配 Touhou Little Maid（东方小女仆）本体。

Promaid v1.2.4（1.21.1 NeoForge）

Promaid v1.2.4（1.21.1 NeoForge）

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

本版与 1.20.1 Forge 版（同为 v1.2.4）功能对齐，差异只在少数原版机制上（主要是 1.21.1 独有的重锤，以及本版修掉的右键蛋糕崩服是 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.4-neoforge-1.21.1.jar（直接放入 mods 文件夹）
• 升级提示：安装前请删除 mods 目录里的旧 promaid-1.2.3-neoforge-1.21.1.jar（含它的三次重传，文件名相同）/ 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 存档无缝升级
• 其他模组武器天然可用：武器判定基于原版攻击力属性，模组武器照常参与自动装备与伤害计算，无需专门适配

---

一句话：三叉戟不止能捅人，还能当燃料（外加一颗 1.21.1 的雷被拆了）

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

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

如果你现在装的是 v1.2.3 的三次重传包：本版是新版本号（不再是同名覆盖），下面第二节最后一条列了 v1.2.3 那批修复——如果你手上还是 v1.2.3 首发版，请务必换成本版。

---

一、新功能

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

---

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

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

---

四、手册与文档

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

---

主要功能一览

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

测试环境声明

模组	关系	测试通过的版本
Touhou Little Maid（车万女仆）	必装前置	1.5.3-neoforge+mc1.21.1
车万女仆：万法皆通（touhou_little_maid_spell）	软联动（法术兼容，非必需）	1.21.1 NeoForge 版

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

已知情况

• 只玩单人：开发者不玩多人，未做服务端优化。多人服务器上若有异常，欢迎反馈但请多谅解；
• 有粉丝报过「投喂蛋糕时女仆在前方小范围快速移动」：我们的投喂链路一行位移都没写，暂时没能定位。如果你也遇到，欢迎把 latest.log 里投喂那一刻前后 10 秒的片段发到 issue，并顺手用一个**原版食物（比如面包）**喂她做对照——这样能分清是"蛋糕那条链路"还是"喂食/站位"本身；
• 1.21.1 与 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.4（1.20.1 Forge）

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 小类）

测试环境声明

模组	关系	测试通过的版本
Touhou Little Maid（车万女仆）	必装前置	1.5.3（Forge 1.20.1）
车万女仆：万法皆通（touhou_little_maid_spell）	软联动（法术兼容，非必需）	1.8.2（Forge 1.20.1）

其他版本（含更新/更旧的 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 · 加急更新）

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）、飞行跟随（主人飞走了她背鞘翅追过来）四块新玩法，以及散步速度终于调得动、索敌不再隔着方块记仇、战斗中不再被工作范围传送回来等等一批打磨。

---

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

问题	现象	修复批次
收放魂符后血量上限掉回 20	好感升阶给的 80 血上限在收放魂符后来回横跳	实测五百九十五
收放魂符后拖装备被吞	从她背包/装备栏往外拖，第一件直接消失	实测五百九十六
着火连吃金苹果（issue #17）	一着火就把一整组金苹果几秒内吃光	实测六百一十九

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

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

• 战斗模式分类表（新配置 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。

五、手册与 README 也一起更新了

• 内置手册：「这是什么」章的版本表述改成两版本对齐，并补上 v1.2.2 起 / v1.2.3 起两段新增功能速览；「战斗与自保」章新增一条 【收放魂符后血量上限掉回 20 / 拖她的装备被吞？】（症状 / 根因 / 改法 / 诊断入口）；「专业术语」章补 7 条...

Promaid v1.2.3（1.20.1 Forge · 加急更新）

Promaid v1.2.3（1.20.1 Forge · 加急更新）

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

• Minecraft 1.20.1 · Forge 47.4.x
• 前置：车万女仆 Touhou Little Maid ≥ 1.5.0（实测 1.5.3）——纯独立前置，不对任何其他模组做专属联动
• 附件：promaid-1.2.3.jar（直接放入 mods 文件夹）
• 升级提示：安装前请删除 mods 目录里的旧 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 / 卓越前线 / 拔刀剑 / 史诗战斗 / 万法皆通等模组武器照常参与自动装备与伤害计算，无需专门适配

---

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

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

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

---

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

你下载到的 jar 又更新了一次（文件名不变，仍是 promaid-1.2.3.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.jar（同名覆盖即可）。

---

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

本页首发于 09-22 07:42（UTC）。附件已按用户要求重传覆盖（文件名不变，仍是 promaid-1.2.3.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 的容器槽位绑的是建容器那一刻那只实体的句柄——删了再生成，你正开着的物品栏/装备栏还指着已经被删掉的那只，拖进去的东西就落进了虚空。

修复（实测五百九十五 / 五百九十六，两版本同步）：补包改成按实体网络 id 分流——魂符放出的新实体不再补包（原版追踪本来就会发全套：生成 + 数据 + 属性 + 装备），只有同一只女仆离场又回来（区块卸载重载这类、id 没变）才补；补包那一支同时补发一次饰品全量同步；另外新增一条诊断日志：她的装备槽从有东西变空时会写一行（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）、飞行跟随（主人飞走了她背鞘翅追过来）四块新玩法，以及散步速度终于调得动、索敌不再隔着方块记仇、战斗中不再被工作范围传送回来等等一批打磨。

---

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

问题	现象	修复批次
收放魂符后血量上限掉回 20	好感升阶给的 80 血上限在收放魂符后来回横跳	实测五百九十五
收放魂符后拖装备被吞	从她背包/装备栏往外拖，第一件直接消失	实测五百九十六
着火连吃金苹果（issue #17）	一着火就把一整组金苹果几秒内吃光	实测六百一十九

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

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

• 战斗模式分类表（新配置 combat.taskModes）：入战选任务与战中换战术原本三条规则全是写死的——谁能进候选池、算近战还是远程靠猜（UID 关键词与命名空间，未知模组任务一律当近战兜底）、池里有模组专属任务时原版五件套整体让位。现在可以逐任务点名：一行一条 任务UID=近战/远程/不参与（认中文写法与逗号分隔）——写 近战/远程 = 分类以表为准，且不再被"模组优先让位"挤掉；写 不参与 = 入战选任务与战中换战术两条路都永不选它；留空 = 与旧版一字不差。不想用「模组优先」就关掉新开关 combat.vanillaYieldToMod（默认开 = 旧行为）。查 UID：只读命令 /maid_smart combat modes 会把当前所有攻击类任务列成一张表（内置算什么 ｜ 现在算什么 ｜ 表里写了什么 ｜ 参不参与）。面板位置「战斗与自保 → 主动参战」；
• 压缩盒（新道具）：只有 5 格，但每格能堆 114514 个，合成 = 4 个樱花木板放四角 + 4 个钻石放四边中点 + 1 个粉色染料放正中。放进女仆背包就等于是她背包的延伸——她会从盒子里取材料（挖矿/建造/烧制的料），也会吃盒子里的食物；界面是箱子式鼠标取放（左键拿放、右键拿一半、Shift 快速移动），背包格照原版口径显示数量与耐久条，带常驻附魔光效。禁入清单：压缩盒本身、带附魔的物品（附魔书按物品类型判——1.20.1 与 1.21.1 的附魔存储不一样）、以及你在配置里自己加的清单；一个判据四条路共用（界面点击 / 服务端搬运 / 女仆背包插入 / 溢出回退），拒绝时会给话，而且在这个界面里鼠标也选不中压缩盒。自检与诊断：/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。

五、手册与 README 也一起更新了

• 内置手册：「这是什么」章的版本表述改成两版本对齐，并补上 v1.2.2 起 / v1.2.3 起两段新增功能速览；「战斗与自保」章新增一条 【收放魂符后血量上限掉回 20 / 拖她的装备被吞？】（症状 / 根因 / 改法 / 诊断入口）；「专业术语」章补 7 条新词；
• 仓库 README：新增「v1.2.3 加急修复」一节（含 issue 链接）与空袭轰炸、压缩盒、飞行跟随、战斗模式分类表、散步速度等内容，章节数与面板小类数一并校准。

主要功能一览

空袭（近战/远程两种飞行攻击模式 + 空袭轰炸） · 战斗模式分类表 · 压缩盒 · 排班表（全女仆日程调度：早/晚/全天班次、6 段任务编排、当前时段高亮、一键集合、自动在家模式） · 建造系统（81 套内置蓝图 + 外部图纸/LLM 生成/AI 设计器、工地线框投影与 Z 键旋转、工头模式、进度持久化、缺料自动替代、区块内箱子取料、机械蓝图） · 挖矿（矿表白名单、连锁采集、透视感知、发呆看门狗） · 伐木（模组原木自动识别、随手...

Promaid v1.2.2（1.21.1 NeoForge 版）

Promaid v1.2.2（1.21.1 NeoForge 版）

本版与 1.20.1 Forge 正式版（同为 v1.2.2）功能对齐，差异只在少数原版机制上（主要是 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.2-neoforge-1.21.1.jar（直接放入 mods 文件夹）
• 升级提示：安装前请删除 mods 目录里的旧 promaid-1.2.1-neoforge-1.21.1.jar / promaid-1.2.0-neoforge-1.21.1.jar / promaid-1.1.0-beta.2-neoforge-1.21.1.jar——两个 jar 的 modId 相同，同时加载会导致启动失败
• 存档说明：1.21.1 存档与 1.20.1 不互通；1.21.1 内部沿用 maid_smart 命名空间，v1.1.x / v1.2.x 存档无缝升级
• 其他模组武器天然可用：武器判定基于原版攻击力属性，模组武器照常参与自动装备与伤害计算，无需专门适配

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

v1.2.2 是「法术兼容」与「空袭手感」的一次合流：位移类法术正式当推进器用——不带烟花也能平地起飞、空中补高、盘旋掉高时续速，空袭途中还会顺手放攻击法术（这一层最早就是在 1.21.1 上做出来的，本版把后续的所有打磨一并带上）；飞行朝向全面对齐烟花（不再自己发明角度）；远程空袭终于做到脚不沾地（"低于期望高度就补"从来没生效过的 bug 修掉了，期望盘旋高度也提到目标上方 10 格）；空袭的 34 项数值全部搬进配置面板，游戏内随便调。

另外修掉两件很实际的事：喂食 / 喂水会吃掉遗物类食物、毁掉多用途水壶（现在统一走物品自己的使用路径），以及 Sable 同装时一大片功能静默失效、客户端实体丢失、空袭女仆被困远处回不来这三个兼容/稳定性问题。

一、《车万女仆：万法皆通》法术兼容（本版最大的一块，需装该模组）

官方译名统一：本版起，手册与配置里一律写《车万女仆：万法皆通》（旧称《车万女仆：魔法》）。

• 空袭途中顺手放法术（实测五百六十七，PR #8，1.21.1 先行）：近战/远程空袭照常用默认武器打，同时向她当前目标顺带释放法术——法术书放背包或饰品栏即可（法术模组自己扫背包与饰品栏，不看主手，所以它不占武器位）。只在"她本来就该面向目标"的两个相位发起施法（远战盘旋开火前、近战已爬到目标上方准备俯冲时）：吟唱期间法术模组会每 tick 把朝向拧向目标，挑这两个时机才不会被抢飞向。没装法术模组 = 本项无效果。
• 位移类法术当推进器（实测五百七十二，PR #11）：带上【升腾】【烈焰冲锋】这类位移法术，她会把它们当推进器用——平地起飞（烟花/羽扇都没有时也能上天）、空中补高、盘旋掉高时续一口速度。按法术的冲量方向分两类：提供高度（升腾：原生向上冲量；烈焰冲锋：沿视线冲刺且垂直分量保留，抬头瞄着放同样能顶人起来）与提供速度（默认只有烈焰冲锋）。两张表都能自己填。
• 朝向一律照抄烟花（实测五百七十八，A 方案）：起飞、补高、掉高补推，全部用烟花那一套朝向——地面目标 = 背离敌人 + 抬头（只有目标高出她 10 格以上才朝目标爬），盘旋掉高 = 抬头 45° 朝目标。旧版是"自己发明角度"，地面起飞时会直接朝敌人脸上窜。
• 冷却口径（实测五百七十二，按"激流三叉戟"的既有先例定）：起飞/补高不受法术自身冷却限制（只按我们这边的间隔，否则升腾 15 秒一记只抬约 6 格、平地起飞等于没有），空中加速照旧尊重法术自身冷却（不会比玩家更频繁）。
• 1.20.1 侧还有一条"法术兼容层被方法签名判死"的关键修复（实测五百七十五）——那是 1.20.1 独有的问题，1.21.1 不受影响。

二、空袭的飞行手感

• 远程空袭「掉高补推」从来没生效过（实测五百七十八）：两个阈值常量正好相消，触发点落在"几乎贴地"——这就是"低于期望高度就补"一次都没发生的根因。修好后配合下一项，远程空袭才真正脚不沾地（远战本来比近战更容易被贴脸打死，这个 bug 让结论反了过来）。
• 期望盘旋高度 3.5 → 10 格（实测五百七十九，按作者口径）：3.5 格的高度带太薄，滑翔一转弯就低于敌人；掉高容差同步从 3.0 收到 0.5（掉出高度带半格就补）。射程不受影响（3D 24 格，盘旋半径 10 格时约 14 格）。
• 续航战术（实测五百七十八）：位移法术从"没烟花时的备胎"变成第一顺位引擎（不消耗燃料、也不占烟花冷却），所以只带法术、不带烟花的女仆也能持续飞；盘旋掉高时它优先于烟花与羽扇。
• 羽扇（实测五百七十五 / 五百七十六）：竖直冲量 0.85 → 1.05（≈ 玩家体感的 1.25 倍）并补上挥扇动作；羽扇注册名少写一个词的误报也修了（实测五百七十三）。
• 动作看得见了（实测五百六十九 / 五百七十）：重锤猛击命中时会挥臂、远程空袭的弓/弩/弩烟花也有开火动作；近战空袭起手挥臂，且起飞前会先在地面补跳（起飞更稳）。
• 缺件文案统一（实测五百七十四）：提示从点名"烟花/羽扇"改为「没有可以飞行的道具」，并且法术也算"可以飞行的道具"（进得了起飞判定）；刚切任务就误报缺件也修了（实测五百七十六）。
• 空袭被困远处 / 异维度回不来（实测五百六十五）：三条自动召回链全被"无界让位"挡死 → 给让位加超时兜底，"飞太高打完回不来"不再无解。

三、喂食与喂水（不再毁掉多用途物品）

• 喂食改走物品自己的 finishUsingItem（实测五百七十九）：普通食物与旧版 eat() 完全等价，但重写过它的物品（例：奇异饰品「永恒牛排」这类吃完不消失的遗物）以前被手搓的"扣 1 个"逻辑吃掉——现在效果照常生效、并按物品自己的语义与冷却节流。姐妹链 / 主人链 / 自救吃食物 / 测试命令共 7 处站点统一。
• 喂水同样改成对真栈结算（实测五百八十）：旧版是"喂一个副本 + 扣掉来源 1 个"，对可以喝好几次的容器（水壶这类，用完还剩 3/4 次）等于把整件容器当一次性物品扣掉；交还的容器/残余一旦塞不进背包还会被静默丢弃（物品凭空消失）。现在由物品自己决定消耗几份，交还的栈塞回背包、塞不下就掉在她脚下。
• 勾选面板按「剩余次数」细分（实测五百八十）：喂食勾选页与喂水白名单页里，能喂/喝好几档的物品每一档剩余次数各占一行——「剩 4/4 次」和「剩 3/4 次」是两个独立条目，各自勾选互不影响（悬停写明「剩余 N/M 次」）；名单条目也支持手写 注册名#剩余次数，不写 # = 该物品任意次数（旧配置照旧生效）。
• 喂水水质分级（实测五百七十六）：按口渴模组自己的四档水质，默认只喂「可接受的」及以上；喂水白名单改成图形化勾选子页（实测五百七十三）；喂水走口渴模组的数据挂钩（实测五百七十一，软联动「口渴」Thirst Was Taken）。

四、配置面板与手册

• 新增「空袭数值」页（实测五百八十一）：原本写死在代码里的 34 项空袭数值全部可调——起飞段时长与仰角、起飞触发距离、占位高度容差、起跳等待、烟花/羽扇间隔、收翅俯冲距离、猛击命中判定与强制命中半径、猛击段上限、猛击下落加成门槛（重锤特有）、俯仰限幅、盘旋半径、期望盘旋高度、高度修正增益与偏置、掉高容差、盘旋俯仰上下限、掉高补推间隔与抬头窗口、补推仰角、开火间隔、弓弩射程、弹开半径/速度/抬升/时长、冲刺距离。位置：战斗与自保 → 空袭数值（六小节，每项都带说明）。默认值与原硬编码一字未改，改完立即生效。
• 面板归位与修复：「排班表」从「移动与行为」挪到「生产与工作」；喂食/喂水子页在窄窗口下文字溢出的问题修掉（实测五百七十五）。
• 手册：空袭章新增 ⑨「空袭状态下的法术怎么用（配装 + 节奏 + 排查）」与【空袭数值面板】两节，章末「⚙ 配置入口」直接跳到对应配置页；空袭里的传送描述纠错（飞行期间"自动传送让位"、但手动「一键集合」与主人死亡传送照常生效，实测五百七十五）。

五、兼容与稳定性修复

• Sable 同装时全图扫描被拒查（实测五百六十四，PR #9）：一大片功能静默失效、日志被刷爆；改用 getAllEntities() 口径后恢复。
• 客户端实体丢失（实测五百六十六，PR #10）：服务端照打、客户端却没有她 → 新增重同步兜底，并加了 /maid_smart resync 命令（诊断 + 急救）；女仆重新入世界时也自动补一次实体包。
• 主人被自家女仆的重锤风爆波及（实测五百七十三）：原版风爆爆炸没有来源实体，两道"友军免伤"闸门全落空 → 改为按位置与归属把关（从此女仆砸怪不再把你震上天）。
• TACZ 弹药箱兼容（实测五百六十八）：弹药箱也算"有子弹"，空袭与枪械两道判定门放行。
• 中键工位标记 × 河童的罗盘（实测五百七十三）：两者写的是同一份排班锚点，谁后写谁生效——加了让位开关与说明。
• 1.20.1 侧还有两条独有修复（魂符放出后模型变默认、法术层签名问题），1.21.1 不受影响。

六、新增 4 个 AI 工具（对话直接下命令，现在共 21 个）

• smart_switch_task：换任务/工作模式（带安全闸：排班表这类不该被对话改的会明确拒绝）；
• smart_air_raid：起飞空袭 / 停止空袭（近战或远程可选、可锁定目标，并如实回报"缺不缺件"）；
• smart_work_area：指定 / 查询工位（不选点时明确说明，绝不瞎猜一个坐标）；
• smart_readiness：状态自检——回家/在外、装备与弹药、背包余量一目了然。

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

• 空袭默认飞得更高：远程空袭的期望盘旋高度默认从目标上方 3.5 格变成 10 格（掉高容差 0.5）——命中判定不受影响（那是 3D 24 格），但如果你的打法依赖"贴着敌人转圈"，可以在「空袭数值」页把它调回去；
• 喂食/喂水不再消耗"用完还在"的物品：以前会扣掉 1 个（多用途容器直接被扣整件），现在按物品自己的语义结算——如果你以前靠"喂一次扣一个"来处理某些物品，行为会不一样；
• 位移法术优先于烟花与羽扇：盘旋掉高时先用位移法术补（不烧燃料），只在法术不可用时才放烟花——烟花消耗会明显变少；
• 起飞/补高不受法术自身冷却限制：这是"不带烟花也能平地起飞"的前提（对齐激流三叉戟忽略"必须在水中/雨中"的既有先例）；不喜欢可以关掉整个「位移法术·起飞/补高」开关。

致谢（法术兼容这一块不是我写的）

特别感谢 @rodericksthescriptkid（B 站：Roderick32）——本版的法术兼容主要由他写成：空袭途中顺手放法术（PR #8）、位移类法术当推进器（PR #11）都是他的贡献，本版另外两个兼容修复（Sable 全图扫描 #9、客户端实体丢失与召回兜底 #10）也出自他手里。

我对魔法方面并不是很了解，法术兼容这一块就交给他接手了；我在这里的作用只有两件：在实战方面做了一定程度上的战术改良（法术该在空袭的哪一段放、怎么配合起飞与俯冲、掉高补推窗口怎么用），以及把这份兼容移植到 1.20.1。功劳主要在他。

已知限制（法术部分）

• 施法吟唱期间朝向由法术模组接管，盘旋/爬升轨迹会受一点影响（已用"只在面向目标的相位发起"把影响压到最小）；
• 位移法术是一次性冲量（向冲量插值 75%，不是持续推力）：高速滑翔时那一口甚至可能削速，低速度时它最有效（持续爬升靠【升腾】那 4 秒的悬浮）；
• 烈焰冲锋的冲量公式把水平放大 3 倍，所以"抬头 62°"的实际轨迹约 45°——它毕竟不是烟花。

完整逐条更新日志（含每一条的取证过程）见仓库 CHANGELOG.md。

主要功能一览

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

测试环境声明

模组	关系	测试通过的版本
Touhou Little Maid（车万女仆）	必装前置	1.5.3-neoforge（NeoForge 1.21.1）
车万女仆：万法皆通（touhou_little_maid_spell）	软联动（法术兼容，非必需）	1.8.4-neoforge（NeoForge 1.21.1）

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

反馈

问题与建议请到 GitHub Issues：https://github.com/fadersketch/Promaid-mod/issues

许可证

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

---

2026-09-20 重传说明（版本号不变，仍是 v1.2.2）：本页附件已换成重新构建的 jar——在 v1.2.2 的基础上修正了 GitHub 上的 4 条反馈：

• #12 蓝图含墙上告示牌 / 墙上火把时永远报缺料（材料链按方块名搜物品 + 「没有对应物品 → 跳过」那条分支其实是死代码，会让整份计划永久卡住）；
• #13 指标石锁定后若再也瞄不到那一格就永久死锁、退出世界也无效（补上"进世界 / 换维度时同步"，并新增 潜行 + 右键 = 强制解锁）；
• #15 图纸流体的保留 / 剥离原本只看文件名关键词且完全静默（新增 keepFluids = auto / always / never，auto 档还会看图纸内容，剥离时写明剥掉多少格）；
• #14 缺料材料匹配新增档位 looseMaterials：机器蓝图里同类方块（告示牌 / 树叶 / 羊毛 / 地毯 / 染色玻璃）可互相顶替，建筑图纸保持严格。

另有两处小修：放置侧改用蓝图里的方块（红石线 / 水桶 / 墙上告示牌这类不再取到空气或立式版本）、缺料提示改念物品名（"红石墙火把"→"红石火把"）。

已经下载过 v1.2.2 的话：删掉 mods 里的旧 jar，换这一份即可（同 modId 两个 jar 共存会启动失败）；不想折腾可以等下一个版本号。逐条更新日志见仓库 CHANGELOG.md 的「实测五百八十三 ~ 五百八十六」。