为《车万女仆》(Touhou Little Maid, TLM) 制作的扩展模组，让女仆真正"活"起来——会建造、会干活、会记事儿、会说话，还会在危险时保你的命。
- 1.20.1 版：Minecraft 1.20.1 · Forge 47.4.x · 前置 TLM ≥ 1.5.0（实测 1.5.3）· 版本 v1.2.2
- 1.21.1 版：Minecraft 1.21.1 · NeoForge 21.1.250 · 前置 TLM ≥ 1.5.0（实测 1.5.3-neoforge）· 版本 v1.2.2
- 许可证：MIT · 仓库：github.com/fadersketch/Promaid-mod
纯独立前置：只要求原版车万女仆（TLM），不对任何其他模组做专属联动（曾经的第三方软联动已全部移除）。不过武器判定基于原版攻击力属性，所以 tacz / 卓越前线 / 拔刀剑 / 史诗战斗 / 万法皆通等模组的武器天然可用，无需专门适配。
开发过程中使用了 AI 辅助编程工具；作者并非专业程序员，代码中可能存在缺陷。开发者平时只玩单人模式，未针对多人服务器做优化，有此类问题请多加谅解，也欢迎到 Issues 反馈。
Promaid 按「要不要 AI」分两大类功能：
- 不需要 LLM，配好就能用：空袭（会飞的女仆）、三叉戟激流旋转冲击、建造执行、挖矿、伐木、烧制、酿造、农场、宰杀、战斗自保、单兵战术、武器/工具自动切换、被动保命技能、贴身辅助、感知播报、情绪、TTS 与内置日语语音包、排班调度、指标石、女仆管理；
- 需要先配 LLM 站点：主动对话、工作播报、自主决策、AI 记忆、AI 工具（对话直接下命令）、LLM 现场生成蓝图、AI 设计器。
进游戏就会收到一本《Promaid 手册》（丢了用 /give @p maid_smart:blueprint_book，或工作台「书 + 纸」合成），里面有 32 章保姆式教学，每章先讲「是什么」再手把手教「怎么用」，关键步骤都配了【举例】。
从零做了两个飞行攻击模式，本版近 40 条改动都在打磨它。给女仆穿上鞘翅、带上武器和可以飞行的道具（烟花火箭 / 孔雀羽扇 / 能上天的位移类法术任一），她自己飞起来打怪——不再贴地追着砍。装备不齐她不会飞，而且切到任务当场就报缺哪一件（缺飞行手段时气泡只说「没有可以飞行的道具」）。
| 模式 | 怎么打 | 武器位 |
|---|---|---|
| 近战空袭 | 爬到敌人上方 → 收翅俯冲 → 触底前一记近战 → 再起飞，循环 | 任意近战武器（剑/斧/三叉戟/重锤/模组近战） |
| 远程空袭 | 在天上盘旋并用手里的远程武器持续开火 | 任意远程武器（弓/弩/御币/三叉戟/模组弹射/枪械） |
- 三件套：鞘翅（切任务后她自己穿到胸甲槽）+ 武器 + 可以飞行的道具（烟花火箭 / 暮色森林孔雀羽扇 / 位移类法术，放背包就行）；远程空袭额外需要弹药，御币/三叉戟不消耗弹药；不响应自主切换（不会被"主动参战"改任务、也不会自己换掉你给的武器）；
- 收翅俯冲那一击：1.21.1 手持重锤时按玩家同款的重锤下落加成结算（还有风爆的原地爆炸 + 自我顶起），而且她按本轮最高点算落差——飞得越高这一锤越狠，不设上限；其它武器按原版暴击 ×1.5 + 附魔。命中率有三道保险（判定距离 4 格 / 收翅 2 tick 即可出手 / 对身边 2.5 格内其他合法敌对目标补一记，女仆一律跳过、绝不误伤主人与宠物，且要过视线）；
- 远程空袭：绕目标约 10 格盘旋、维持在目标上方 10 格（实测五百七十九 从 3.5 提高：3.5 格太薄，滑翔一转弯就低于敌人）；掉出高度带 0.5 格就补推（烟花/羽扇/位移类法术任一，法术优先——不消耗燃料，不是无脑烧）；怪物贴到 3 格内时弹开她自己（只弹她不弹怪，狭小空间里敌人仍有机会命中）；开火走 TLM 自己的通道，附魔照常生效，御币的扇形分档规则照搬原版（单挑单发 / 3~5 只同种怪 8 发扇形 / 超过 5 只 32 发大扇形），装了 TACZ / 卓越前线的女仆能拿枪在空中开火；弩还能射攻击性烟花（带烟火之星的那种）当弹药——普通烟花默认不烧（原版任何版本里它都是 0 伤害，白烧一枚飞行燃料），想按原版玩家口径把普通烟花也当弹药可在面板里开；
- 索敌：以她自己为圆心、半径 50 格的球，锁定即持续瞄准——不再走 TLM"按排班活动决定扫描盒"那套（旧机制在她飞高后会因扫描盒只有 4 格高而丢目标、在空中飘走）；视线只作为新锁定的门槛，"隔墙不出手"依然成立；
- 空袭牵引绳（新增）：空袭期间以她为圆心、半径 100 格（可调，0 = 关闭）内找不到主人，就立刻把她传送回你身边——与排班表那次人工传送同一条链路（强制生效、无视地块、可以空中传送）。防的是"她飞太高把目标打死后自己回不来"；距离按 3D 算，飞太高本身也会触发；
- 空袭途中顺带放法术（需装《车万女仆：万法皆通》touhou_little_maid_spell）：飞行武器照打（近战空袭照样俯冲砸、远程空袭照样盘旋射），法术书放背包或饰品栏就顺手把法术也放了——法术模组自己会扫她的背包与饰品栏，不看主手，所以不占武器位；放哪个法术由它决定（从她的法术书里随机挑一个不在冷却、不在黑名单的），女仆没有法力条，只受冷却限制；只在"本来就对着目标"的两段发起（远程在盘旋开火前、近战在已爬到目标上方准备俯冲时）——法术吟唱期间会把她的朝向拧向目标，而鞘翅是顺着视线飞的，爬到一半被掰朝向会毁了这一轮；爬升段与收翅俯冲那一记刻意不施法。三个开关在「单兵战术」：空袭顺带施法（默认开）/ 空袭施法间隔（默认 20 tick）/ 空袭施法距离（默认 24 格）。
- 位移类法术当推进器（需装《车万女仆：万法皆通》+ 位移类法术）：空袭把位移法术当成和烟花同一套口径的推进器——同一触发（掉出盘旋高度带）、同一朝向（起飞/补高照抄烟花起飞那套：地面目标背离+抬头、目标高 10 格以上朝目标+抬头；盘旋里用烟花掉高窗口那 45° 抬头）、同一窗口（法术成功时自己开那个抬头窗口，所以只带法术不带烟花也进得来），而且优先于烟花/羽扇——不消耗燃料、也不占烟花冷却。两张表：提供高度（默认【升腾】
irons_spellbooks:ascension＋【烈焰冲锋】irons_spellbooks:burning_dash）用于平地起飞 / 空中补高 / 盘旋续航，提供速度（默认【烈焰冲锋】）在掉高窗口里补速度（窗口外不放，免得她从盘旋圈上切进去）。两条必须知道的口径：① 烈焰冲锋的冲量是normalize(视线×(3,1,3))+(0,0.25,0)再乘(15+法强)/12——水平被放大 3 倍，所以「抬头 62°」的实际轨迹约 45°；且它是一次性冲量（向冲量插值 75%）不是烟花的持续推力，持续爬升靠升腾那 4 秒悬浮（重力×0.15），高速滑翔时那一口甚至可能削速；② 盘旋掉高的补推阈值已修（旧版 3.0 与期望高度 3.5 相消 = 必须几乎贴地才补，所以「低于期望高度就补」从来没生效过、每次都是掉地上再补）——现在比高度带低半格就补。另有「位移法术间隔」（默认 40 tick）与「尊重法术自身冷却」（默认开，只管「提供速度」那一类；起飞/补高从不看它）。日志搜「空袭·位移」（起飞/补高/冲刺）与「掉高·位移法术顶高度」（盘旋续航）。 - 空袭期间的传送口径：自动传送一律让位（跟随拉回 / 跨维跟随 / 「搭太高」拉回 / 自保归位），但让位有界——持续滞空超过 15 秒就强制拉回（防「飞太高打完回不来」），落地即清零；玩家手动「⚑ 一键集合」与主人死亡传送照常生效（人工/紧急意图优先），另有上面那条「空袭牵引绳」也会把她捞回来、不触发自保（但不免疫真实伤害，照样会被打下来）、滑翔/悬空/俯冲时不搭方块、落地自己放水/细雪接住；
- 默认开着「空袭免疫摔落伤害」：空袭整条链路是"高空盘旋 + 收翅俯冲"，落地缓冲万一没接住（背包没桶/落点被占/被打断）代价是十几点伤害甚至摔死——想按原版吃摔伤可在「生存与复活 → 落地缓冲」里关掉。
症状：她还在干活（方块在动、怪在掉血、/tp 找得到她），但看不到模型、
按 F3+B 也没有碰撞箱——这是客户端实体丢失：服务端一切正常，只是客户端那侧没有这个实体。
为什么会这样：法术模组（touhou_little_maid_spell）在女仆"离开世界"（区块卸载 / 维度切换等）时会发一个 包让客户端删掉她的实体；而它自己给客户端补回实体的链路只对带"锚核"的女仆生效—— 没带锚核的女仆被删掉后、随后又被加回同一个 level 时，原版追踪表未必再发一次生成包， 于是"服务端好好的、客户端永远没有她"，直到重登游戏。
处理（游戏内执行，需 OP / 单人作弊）：
/maid_smart resync # 你名下的女仆
/maid_smart resync all # 全服所有女仆
/maid_smart resync <UUID> # 指定女仆（跨维度也能找到）
命令会打印每只女仆的维度 / 坐标（顺带用反射问 Sable"她是否被判在 sub-level 内"，
用于排除追踪位置误判），并对同维度的主人客户端强制补一次实体包——通常当场恢复可见；
若无效，退出重进游戏一定恢复。本模组还会在女仆离场 / 入世界时自动补包，
过程写进 logs/promaid.log（搜「离场」「重同步」）。
另外两条相关的健壮性修复：空袭召回超时兜底（她被困在远处/异维度时， 空中让位不再"永久禁传"——超过 15 秒即强制拉回）与 Sable 兼容 （全图扫描不再被 Sable 拒查，详见 CHANGELOG 实测五百六十三/五百六十四/五百六十五）。
新道具指标石（9 块平滑石头 3×3 合成）：手持它，视线指到的方块显示绿色框 → 右键锁定成红色框（再右键取消；可以锁很远的方块，但不能锁空气）→ 再右击你自己的女仆绑定 → 从她脚下到锁定点之间所有空气方块变成橙色幽灵方块，她立刻一格一格填过去。
- 材料不固定：先从她背包拿，不够从你的背包拉，选的是背包里"数量最多、有碰撞体积"的方块（沙/砾石/TNT/仙人掌等自动排除）；创造模式视为无限；
- 一个玩家同时只能有一个"锁定 + 绑定"，搭完（或取消）自动还原她的原任务与作息；想换目标必须先右键那个锁定方块解除；
- 中途被收回/死亡/材料不够会明确报告搭了多少块再收尾，不会卡死。
新物品排班表（纸 + 墨囊合成，开局也会和手册一起自动送进背包一次）：手持右键打开全部女仆列表（跨维度也在列），点一只进去给她排一整天。
- 列表页：搜索框按名字过滤、每行显示血量与所在维度、全员一键切早班/晚班/全天、批量应用任务、一键集合（含其他维度的女仆，按最后出现位置自动强载区块送来）；
- 详情页实时坐标 + 「去她身边」（v1.2.0）：她那一页顶部每秒刷新当前维度与 X Y Z；新增「去她身边」把你传送过去，与「召她过来」成一对、都跨维度可用（顺带修掉了单人世界里打开排班表会让世界暂停的老问题）；
- 快捷设置页：直接遥控她「现在」干什么——工作模式与任务都有 ◀ ▶ 左右箭头快速切换；
- 排班页：选班次（早班/晚班/全天），把工作时间平均分成 6 个任务时段（全天每份 4 小时、早晚班 2 小时），点任务名整页跳转任务选择器，任务可重复；当前时段整行绿色高亮，一眼看到她现在在干什么；保存后每到时段边界自动切换（按游戏内时间，一天 = 现实 20 分钟）；
- 让位规则：自保保命 > 排班表 > 主动战斗还原 > 你手动切的任务；
- 排班锁定：排班开着的女仆，任务/工作模式按钮锁定，在原版界面硬改会被当场弹回；
- 自动在家模式：排班期间自动守家按日程干活，不跟主人乱跑、不被集合/死亡传送带走；关闭排班即解除；
- 大范围活动与空闲散步：活动半径最低 32 格（原版只有 8~16），空闲时自己散步不站桩发呆。
女仆能按蓝图把建筑一块一块真实搭出来，材料从背包真实消耗，缺料会暂停并告诉你补什么。
- 四种蓝图来源：① 随模组附赠 81 套已授权蓝图（房屋/地形/天空/树木/武器/水/红石/节日/装饰/载具/雕像，从中世纪庄园、上海中心大厦到天空之城、巨型载具都有，首次运行自动解压开箱即用）；② LLM 对话现场生成（「造一个 5x5 现代小屋」）；③ 外部图纸文件（
.nbt/.snbt/.litematic/.schem/.json，放进config/maid_smart/blueprints/即用）；④ AI 设计器（「设计一个中式庭院」）； - 工地预览：金色框预览占地 + 青色幽灵方块投影，Z 键整体旋转 90°；确认后变红色区块框钉在工地，走出区块也能看清轮廓；
- 工头模式：一个区块一只工头，缺料/跳过/完成统一汇报；多只女仆可绑同一区块一起建；
- 进度持久化：材料表、进度条（百分比 + 速度 + 预计完成时间）随女仆存档，重启继续；
- 缺料自动替代：同族材料（任意木板顶橡木板）→ 自定义替代方块；机械蓝图按「结构→惰性机构→活动件→传感件→动力源」六层自下而上，动力源最后落地避免半途通电误触；
- 不得把方块搭在主人身上（v1.2.0，默认开）：目标格被主人的碰撞箱真正占着时不搭方块（防把她挤住、卡住或盖住头）。判据取"碰撞箱真正交叠"，所以主人站在方块上不会被误判他脚下那格，正常垫脚搭路不受影响；
- 还有极速模式、放置配额、区块冻结防崩溃等细节。
挖矿：切「挖矿」任务，她扫描找矿 → 走性价比最高的矿 → 持镐开采。只挖矿表白名单里的矿石（价值分可调，钻石 500 / 铁金 250 / 煤 100…），综合价值、距离、深度惩罚、穿透预算评分选矿。
- 连锁采集（矿脉一次挖完）、自动收集（掉落直接进背包）、透视感知（默认关，开启后可隔墙挖穿取矿）、搭方块防掉落 + 自动回收、软方块不耗耐久、废石保留量防背包塞满；
- 发呆看门狗（默认 8 秒）：原地卡死自动重置挖矿状态重新找矿，不用收魂符重放救她；
- 经验球归属：8 格内有玩家玩家优先，否则最近挖矿女仆吸收。
伐木：切「伐木」任务，找树 → 持斧砍 → 连锁砍完整棵树（树叶不挡视线）。
- 模组原木默认自动识别（带原版
#logs标签的都认），也可精确配置木材表； - 连锁砍伐、自动收集、透视感知（默认开）、废石保留、发呆看门狗；
- 随手种树：自动捡起地上树苗并补种，森林越砍越有；种点会筛选「真正长得成」的格子（3×3 无碰撞方块、正上方 7 格净空、光照达标）；深色橡树苗不种不捡（单株不生长）；
- 骨粉催熟：背包有骨粉时自动催熟身边树苗（每 0.5 秒一株，不受光照限制）。
- 烧制：切「烧制」任务，在附近找熔炉/高炉/烟熏炉，把背包里的生食烤熟、矿石烧成锭。v1.1.0 起什么能烧就烧什么（当前世界熔炉配方里非装备类都能喂，含模组食材/粗矿）；多只女仆各占一个炉子，不抢炉不顶号、消息不刷屏；
- 酿造：切「酿造」任务，找酿造台按配方下料。批量模式（有什么正向材料就酿什么）或定向模式（只按目标药水的配方链精确下料，缺料停止等待、补料自动继续）——用女仆药剂手册（水瓶 + 书本合成）右击女仆配置；成品药水当基底下料（如 3 分钟夜视 + 红石自动延长成 8 分钟）。
- 农场连锁收获 / 批量种植（收割蔓延整片田、空耕地一次全种上，种子真实消耗）；
- 耕地标记制（v1.1.0）：只锄「曾经是耕地」的地块——超平坦地形不再连锁扩散成一片耕地；自然生成的耕地自动补标，草径也认；
- 锄地索敌：主动走向 16 格内可锄地块；作物骨粉催熟：自动给未成熟作物施肥；
- 宰杀任务（v1.1.0，新工作模式）：检测周围牲畜按种类计数，某一种超过阈值时每 3 秒随机宰杀一只（正常掉落 + 挥臂动画），没活时四处闲逛；驯服宠物与亡灵马不会误杀。
- 被动保命系统（默认开，优先级压过一切状态）：血量低于触发线（默认 30%）进入保命——回血、垫高躲怪、逃跑，环境危险（岩浆/溺水/窒息）自救，威胁消失且血回安全线才解除；
- 回血阶梯：增益药水 → 治疗药水 → 金苹果 → 治疗食物；
- 逃生手段：末影珍珠脱身、传送回家（主人旁有安全落点才传，传送有冷却）、窒息上浮、着火时自动灭火（附近有水源直接传进水）；
- 保命道具优先（v1.1.0）：带着绀珠之药/不死图腾时低血不逃跑，死不了就留下来继续打；
- 致死自动回魂符（v1.1.0，全新）：受到会致命的那一击且身上没有保命物品时，当场自动收回魂符——不用再跑去神龛复活，你从魂符重新放出即可；重新释放后有冷却（默认 60 秒，从释放时刻起算）；
- 女仆自动复活（v1.1.0 起，v1.2.0 修口径）：如果回魂符也没能救下（她真的死了），墓碑会在延迟时间到期时自动消失（默认 60 秒），她随即复活——落点有两种：你的重生点可用（床 / 重生锚）就落在你复活时站的那一格；重生点不可用（床被拆 / 重生锚没电 / 维度不允许 / 从没设过）就直接在主人所在位置复活（强制生效、不看地形，主人在高空 / 岩浆边也照落）。复活时背包 / 饰品 / 任务 / 模型全部原样恢复（按死亡瞬间的完整存档还原），血量默认满血（可调）；复活瞬间她会说话告诉主人（气泡「主人，我回来啦！」+ 一条带名字的系统消息「你的女仆 XX 已复活」）；主人不在线时墓碑保留、等她上线再复活，不丢女仆。v1.2.0 同时删除了原先那套"复活后很快又死就把下次复活推迟 1 分钟起、逐次翻倍"的退避机制（它的副作用比它防的问题更严重；「复活延迟」「复活时机」两个配置项保留）；
- 环境伤害软处理（v1.1.0 新口径）：踩仙人掌/轻微摔伤等小伤害不再触发整套逃跑，脱离危险源后原地休整回血；真正的持续威胁仍按完整自保处理；
- 主动切换战斗（v1.1.0，默认开）：你被有来源的攻击打（怪物/玩家/弹射物）或攻击敌对生物时，附近 16 格内女仆无论干什么都立即切战斗来保护你，威胁消失约 10 秒后自动还原原任务；选战斗模式时扫描背包所有攻击类任务，背包里有模组武器必定切它专属的战斗模式（拔刀剑→拔刀剑模式、史诗战斗→战斗模式），敌人远选远程、近身选近战，战中还会动态换战术；
- 激流三叉戟旋转冲击（v1.2.0）：详见下面「三叉戟」一节。
三叉戟在本模组里有三条明确分工，近战与空袭两条线都能用：
- 当近战武器：攻击模式 / 近战空袭都认它（原版三叉戟的近战伤害与附魔照常结算）；三叉戟的武器归类按"近战武器"走，所以她在攻击模式下会拿它贴脸打，不会站着原地转圈；
- 当远程武器：远程空袭里它能投掷，而且不消耗弹药（免检，不会误报"缺弹药"）。注意附了激流就投不出去——那是原版"水里突进"的设定；
- 激流旋转冲击（默认开，可在配置面板关掉）：主手拿着带激流附魔的三叉戟时，她那一记普通挥砍会被替换成旋转冲击——也就是把玩家那套"激流突进"搬成了女仆的独立攻击链路：
- 触发就是她的攻击时机：近身 4 格内替换（地面要站在地上）；空袭的收翅俯冲那一记在空中也替换（那一下本来就在空中，实战价值更大），空中旋转期间不会自我摔伤；起不了手就照常挥砍；
- 旋转 16 tick，与玩家同款（平躺 + 高速自转），撞到谁就结算一次伤害（攻击力 + 附魔），同一目标每次突进只打一下；
- 原来那一记普通挥砍由这条链路取代（走路、索敌、排班一律不变）；关掉「激流三叉戟旋转冲击」即恢复普通三叉戟挥砍；
- 视觉上照抄了官方那圈"激流特效"（是个独立的渲染图层），旋转枢轴也抬高过——不会看起来像嵌进地里。
女仆绝不伤害主人与同主女仆——这是针对实测 bug（带女仆到雪地打雪仗后，她会对主人跳劈）的专门加固：
- 伤害事件总闸：女仆造成的主人/友方伤害在攻击/受伤/结算三处直接取消；
- 全部攻击注入点过滤：战术跳劈、近战横扫、中立威胁反击、自保反击（含弹幕/射箭）、LLM 攻击工具，目标为主人/友方时一律不执行；
- 定期清除仇恨：每 2 秒把主人/友方从
ATTACK_TARGET、实体目标、复仇目标里清掉。
结果：雪地打雪仗只会扔雪球，绝不会对主人挥刀；同主人的女仆之间也互不误伤。
- 单兵战术（PVP 式走位，默认开）：近战贴脸绕圈侧移 + 打一刀退一步 + 跳劈（剑单敌 100% 空中暴击）；远程保持理想射程放风筝 + 横移绕圈；攻击冷却间隙举盾格挡、冷却满放盾攻击；装上 TACZ/卓越前线时枪械任务全套战术照常生效；
- 贴身辅助：你饱食度低时自动投喂（有音效 + 系统消息）、自动治疗、战斗任务下自动配盾。投喂不再只认原版食物（v1.2.0）：判定改为「有食物属性 + 不在黑名单」（与 TLM 自己"女仆饿了吃"完全同口径），三明治 / 模组料理 / 模组水果全都认；默认不喂腐肉、蜘蛛眼、毒马铃薯、河豚、紫颂果、可疑炖菜、各种生肉生鱼，以及金苹果/附魔金苹果（留着走"治疗链"）。配置面板里是勾选面板（
战斗与自保 → 贴身辅助 → 投喂食物勾选）：列出全部带食物属性的物品，点图标切换能不能吃（绿框 ✔ / 红框 ✖），支持搜索翻页，底部实时显示"共 X 种食物，当前可喂 Y 种"； - 女仆支援喂食 = 她自己吃（v1.2.0）：喂给另一个女仆的食物，回血量与她自己吃逐行同源（此前投喂走的是原版
eat()，漏掉了 TLM 餐食系统里那一记"吃食物回血"——一根胡萝卜实际少回 1.32 点）。金苹果那条刻意不补（她自己吃金苹果同样只走eat()）； - 武器与工具自动切换：干活/战斗前自动换最合适的工具——近战武器按 DPS（最终伤害 × 攻速）> 附魔词条 > 剩余耐久评分；挖矿发现目标矿才换合适的镐；伐木自动换斧；剪刀任务自动拿剪刀（认
forge:shears标签的模组剪刀）；盾牌爆了自动补；只剩 ≤10% 耐久才拉黑，主手快坏会提前换下一把。判定全部基于原版属性系统，没有任何武器黑名单——其他模组的武器只要带攻击力属性就正常使用。
不用切任何任务，任何状态下都生效：
- 落地水（默认开）：背包有水桶时坠落超过阈值（默认 4 格）自动放水缓冲，水桶不消耗、落地后收回；落地雪（默认开）：有细雪桶时在落点铺 1×1 雪垫接住自己（下界也能用，水会蒸发、细雪不会）——v1.2.0 起落地雪有了自己的三项数值（触发高度 4 格 / 保持 5 tick / 下探 2 格），与落地水各读各值；两者都有时优先用水（水会流动自己铺开，细雪不流动、容错只有一格）；
- 岩浆逃生放水：垫高自救后周围没水源且包里有水桶，就地放水灭火（1 秒后收回）；
- 主人死亡传送：主人死亡时无视距离强制传送到重生点（床/重生锚，跨维度通用）；home 看家/坐着/骑乘中的女仆保持原位；
- 搭路（v1.1.0，默认关）：背包有可放置方块且周围无敌对生物时，只要与你隔沟/隔空就朝你方向铺方块并踩上去一路接近（平地跟踪距离无上限，像僵尸搭桥追人）；你远高于她时垫方块搭高靠近；垫的方块会自动回收，不破坏地形；挂着战斗任务但没在真打时也照常搭路，一旦接战立即停搭转入战斗。
女仆会把重要的事记下来，下次对话还记得——这是她「有人味」的核心（需 LLM）。
- 记什么：重要事实段落、关系三元组（主人-喜欢-红茶）、主人画像、工作笔记；
- 怎么记：对话积累到阈值（默认 10 条）LLM 自动提取、她主动调用
remember工具、感知/情绪系统写入； - 记忆日记（多级索引）：把每天的事写成第一人称日记——日/3日/周/月四级，跨度越大压缩越狠；可用
query_memory_index翻旧日记回答「上个月我们做了什么」； - 睡一觉自动整理：全员真实睡过夜后生成当日日记，并把够重要的记忆沉淀为长期（不再随时间淡忘）；服务器上玩家登出也算一天结束；
- 人格种子：每只女仆独立的人设文件，与聊天记忆分离，聊天不改写人格；情绪快照：每条新记忆附带当时的 PAD 情绪；
- 链路调试：手册「女仆记忆」页可对单条记忆上调/下调重要度、标记删除、恢复、强化；
- 遗忘：记忆按衰减周期（默认 7 天）慢慢淡出，重要度高的保留。
女仆会自己开口说话（气泡 + TTS），不用你先搭话（需 LLM）：
- 主动对话：关心你重伤、夜晚困倦、好感升级、长时间沉默找话题；日上限与冷却可调；击杀邀功默认关（想听可在面板打开）；
- 工作播报：干活卡住时用气泡解释原因（缺什么料/够不到/被挡路）；
- 自主决策（必须 LLM）：空闲 + 白天 + 主人在 16 格内时，她自己判断该干什么并换任务（去种地/去挖矿），默认 10 分钟冷却、日上限 10 次；
- 回复反馈学习：你说「别说了/好烦」她记住不再提该话题；说「谢谢」强化记忆；还会记录你多久没理她；
- 输出语言：可强制中文或跟随游戏语言；所有主动发言共用 API 日配额（默认 40 次/天，0 = 不限）控 LLM 成本。
- 感知系统（纯规则、零 token）：女仆会「注意到」敌人出现/靠近/离开、主人受伤/低血/盯着她看、天气变化并播报/记入记忆（同类事件有限频防刷屏）；
- 情绪系统（PAD 三维模型）：愉悦-唤醒-支配独立于 TLM 好感等既有数值，由事件驱动（你喂她/夸她/打她都会改变），无事件时缓慢回归，情绪会注入对话上下文让她说话带着当下心情。
需要 LLM，直接对她说就行，每个都能在配置面板单独关掉：
| 工具 | 说什么 |
|---|---|
smart_move_to |
「过来我身边」 |
smart_give_item |
「给我钻石/给我一组圆石」 |
smart_set_pickup |
「别捡东西了/开始捡」 |
smart_report |
「汇报你的状态」 |
smart_attack |
「去打那只怪/攻击最近的怪」 |
smart_craft |
「帮我合成一把石剑」 |
smart_place |
「帮我把这里填上」 |
smart_build / smart_build_list |
「照着图纸建」/「列出你能建的建筑」 |
smart_design |
「设计一个 X」 |
remember |
「记住我喜欢喝红茶」 |
working_note |
「记下我们在挖钻石」 |
query_memory |
「你还记得上次我们…吗」 |
query_memory_index |
「上周/这个月我们都做了什么」 |
perception_query |
「先看看周围地形再建」 |
work_list |
「你现在在干什么/还缺什么材料」 |
smart_owner_inventory |
「我背包里有什么/我还有钻石吗」 |
smart_switch_task |
「去挖矿/切空袭/跟着我别干活了」 |
smart_air_raid |
「起飞打那只僵尸」/「别飞了，回来打」 |
smart_work_area |
「这儿归你管」/「别干活了跟着我」/「你的工作区在哪」 |
smart_readiness |
「你能飞吗/带够箭了吗」 |
- 音量倍率：TLM 原始语音偏小，默认放大到 2.0 倍（0.1~5.0 可调）；
- 系统消息朗读：感知/工作/自保等规则气泡也能播语音（独立冷却防轰炸）；
- 系统语音包（自建）：把常用系统消息预制成 ogg 音频放进
config/maid_smart/system_voice/（manifest.json映射文本→音频），命中直接播放、免 TTS，一次制作永久使用；面板里有「选择文件导入」按钮直接选 zip； - 内置日语语音包（随 jar 分发，开箱即用）：122 条常用系统消息与贴身气泡直接打包在模组里（敌袭 / 自保 / 建造 / 搭路 / 挖矿 / 伐木 / 酿造 / 投喂 / 图腾 / 天气 / 复活 / 排班闲聊 / 拥抱摸头等），命中即播、不联网、也不需要配 TTS；分五档情绪语气（战斗·紧张 / 关心·温柔 / 俏皮·日常 / 干活·汇报 / 请求·为难），响度已统一归一化；系统消息朗读的三条关键短句（落地水 / 落地雪 / 敌袭）豁免最小间隔；不想要可以在面板里关掉，改用自己的语音包或 TTS；
- 语音缓存：生成的音频缓存复用，上限可调，超出删最旧。
摸摸头 / 抱抱（默认键位 G / H，对准女仆）、蛋糕互动（喂女儿吃蛋糕加好感，v1.2.0 起是可配置开关）、床铺互通（v1.2.0：女仆能睡原版 16 色床，玩家也能睡女仆床并把它设为重生点）、女仆互助（把饮用型药水直接喂给受伤/战斗中的姐妹，战斗姐妹血不满时喂食续航——喂食回血与她自己吃同源）、手持光源发实光、宠物保护（命名/驯服的宠物女仆不伤害不仇恨，含 AOE）、挖矿拾取优先级、跨维度跟随与远距拉回（同维度 48 格 + Y 轴 16 格双门槛，主人旁有安全落点才传；空袭期间由「空袭牵引绳」另行处理）、聊天气泡上限、运行日志（排班/战斗/险境脱离/空袭牵引绳等状态变化写入 logs/promaid.log，反馈问题时附上便于对账）。
所有有主女仆所在区块持续保持加载（停放的女仆周边农场/熔炉照常运转，也随时可被集合/召回/救援找到）；寻路会主动绕开危险方块（岩浆/火/仙人掌等，默认 9 种可自行添加模组方块），站在危险格上时自动挪到最近安全格并灭火，搭方块绝不垫这些方块；被困下界基岩顶层或掉出世界底部时自动救援传回。
游戏内 Promaid 手册内置 32 章保姆式教学：功能总览（一键跳转配置）、开发者寄语、这是什么、配置 LLM、手册使用指南、建造系统（含完整例子）、指标石（即兴临时搭建）、女仆管理与区块、挖矿系统、伐木系统、烧制与酿造、农场与杂项、排班表、战斗与自保、空袭与飞行作战（会飞的女仆）、被动技能、女仆自动复活、床铺互通、贴身辅助、单兵战术、武器与工具切换、AI 记忆、主动对话/工作播报/自主决策、感知与情绪、AI 工具大全、语音系统、配置面板导航、专业术语，外加三篇细则（药水与投喂规则、建造运作逻辑、记忆与对话成本控制），以及完整逐版本更新日志。
全部功能都在游戏内配置面板里逐项开关（手册 → 模组详细配置，或 Forge 模组列表 → Config）：v1.1.1 起面板改为两级菜单（7 大类 / 28 小类），手册正文里的「配置入口」链接可以一键跳到对应参数行；改完点「保存并返回」立即生效，不用重启游戏。
v1.1.0 起已修复两个服务端崩溃：
- 主类内联配置界面 lambda 触发
RuntimeDistCleaner拦截 → 客户端类型签名全部移入客户端专类； - 主动对话调用 TLM 客户端专用方法
ChatClientInfo.fromMaid→ 改为服务端安全构造。
说明：开发者平时只玩单人模式，未对服务器做专门优化，若服务器上遇到其他问题，欢迎到 Issues 反馈，并请多加谅解。
- 安装对应版本的 Minecraft / 加载器（1.20.1 + Forge 47.4.x，或 1.21.1 + NeoForge 21.1.250）；
- 安装前置《车万女仆》TLM（1.20.1 用 Forge 版，1.21.1 用 NeoForge 版）；
- 把
promaid-*.jar放入mods文件夹（必须在游戏完全退出后替换——运行中换 jar 会让 ModLauncher 按旧偏移读到坏数据，表现为加载阶段莫名崩掉）； - 进游戏拿手册；想用 AI 功能（对话/记忆/工具/自主决策），先按手册第 3 章把 OpenAI 兼容 API 站点配好。
- 「是，史蒂夫模型」(YSM)：不会崩——v1.2.0（实测五百四十八）修掉了导致黑屏进不去游戏的
ClassCastException（TLM 检测到 YSM 会把女仆交给 YSM 渲染器，而我们的鞘翅图层把渲染器类型写死成了 Gecko 的）。但要注意：鞘翅与激流旋转特效在 YSM 模型上不会绘制——YSM 模型没有 Gecko 骨骼表，硬画只会把翅膀堆在原点，所以那两个图层在 YSM 渲染器下主动跳过；女仆的背部物品/鞘翅由 TLM 自己的 YSM 图层负责。1.20.1 与 1.21.1 同步修复； - 其他模组武器：武器判定基于原版攻击力属性，tacz / 卓越前线 / 拔刀剑 / 史诗战斗 / 万法皆通等模组武器天然可用，无需专门适配（本模组不对任何模组做专属联动）。
完整逐版本更新日志见仓库 CHANGELOG.md；问题与建议请到 Issues。
MIT © 2026 —— 开源地址：https://github.com/fadersketch/Promaid-mod