1.5.3 更新日志

• 为智能体异步工具调用添加了备用机制，确保最终结果始终在主线程中返回。
• 修复了背包缓存中因循环引用导致的内存泄漏问题（#1096），感谢 @CentaureaHO。
  • 新增对旅行者背包（Traveler's Backpack）的兼容性支持。
• 修复了两个网站相关问题：
  • 修复了与 DeepSeek 网站的兼容性问题；现已支持新版 v4 API。
  • 修复了与 Fish Audio 网站的兼容性问题；文本转语音（TTS）功能将不再触发 400 错误。
• 修改默认大语言模型（LLM）网站提示语，改为引导玩家注册 DeepSeek 账户。
• 调整上下文压缩机制：由原先按对话轮次检测，改为按 token 数量检测，显著提升了长任务中的逻辑连贯性。
• 修正部分提示语。
• 修正默认模型的 Molang 表达式。
• 更新部分翻译（#1094）。

1.5.3 更新日志

• 为智能体异步工具调用增加了备用机制，确保最终结果始终在主线程中返回。
• 修复了背包缓存中因循环引用导致的内存泄漏问题（#1096），感谢 @CentaureaHO。
  • 新增对旅行者背包（Traveler's Backpack）的兼容性支持。
• 修复了两个网站相关的问题：
  • 修复了与 DeepSeek 网站的兼容性问题；现已支持新版 v4 API。
  • 修复了与 Fish Audio 网站的兼容性问题；文本转语音（TTS）功能将不再触发 400 错误。
• 修改默认大语言模型（LLM）网站提示语，改为引导玩家注册 DeepSeek 账户。
• 调整上下文压缩机制：由原先按对话轮次检测改为按 token 数量检测，大幅提升了长任务中的连贯性。
• 修正部分提示语。
• 修正默认模型的 Molang 表达式。
• 更新部分翻译（#1094）。

小女仆 1.5.2 版本更新

• 修复：酒狐的铁系魔法动画缺失问题
• 新增：Minecraft Wiki 查询工具，女仆 AI 聊天现可调用该网站查询信息
• 调整：工具调用现已支持异步阻塞执行
• 优化：精简提示词，降低 Token 消耗
• 优化：聊天气泡中的工具调用字段现支持本地化字符串，提升显示友好性
• 优化：耗时较长的工具调用过程中，显示更友好的提示信息
• 优化：新增更多翻译条目

小女仆 1.5.2 版本更新

• 修复：酒狐的铁系魔法动画缺失问题
• 新增：Minecraft Wiki 查询工具，女仆 AI 聊天现可调用该网站查询信息
• 调整：工具调用现已支持异步阻塞执行
• 优化：精简提示词，降低 token 消耗
• 优化：聊天气泡中的工具调用字段现支持本地化字符串，提升用户友好度
• 优化：耗时较长的工具调用过程中，显示更友好的提示信息
• 优化：新增更多翻译条目

1.5.1 车万女仆 — 更新日志

错误修复

女仆行为修复

• 已修复：女仆进食时偷取自身食物，导致进食动画无限循环
• 已修复：女仆手持《沉浸式奏乐》乐器时右键点击，导致乐器掉落
• 已修复：安装饰品模组（Curios）时，女仆死亡后饰品无法正确掉落（由 CentaureaHO 提供）
• 已修复：安装配饰模组（Accessorify）后，女仆进食完毕时食物完全消失
• 已修复：AI聊天中人格系统提示过长引发游戏崩溃

模型与渲染修复

• 已修复：部分默认模型问题——健康值过低时“婚嫁狐妖”模型无法正常渲染

Create 模组兼容性修复

• 已修复：破坏 Create 旋转展示台方块时额外掉落一个手办物品
• 已修复：女仆乘坐 Create 座椅时，不随整体结构朝向同步旋转

方块与物品修复

• 已修复：零食柜被破坏时不掉落其内部物品

模组兼容性修复

• 已修复：NeoForge 1.21.1 下饰品栏（Curios）无法翻页
• 已修复：与《Alex 的洞穴》共存时扫帚碰撞箱异常（由 CentaureaHO 提供）
• 已修复：扫帚骑乘功能与《Leawind 的第三人称》存在冲突（由 CentaureaHO 提供）

AI / 网络接口修复

• 已修复：SiliconFlow 语音识别返回 HTTP 422 错误
• 已修复：使用新版大模型（如 GPT-4.5）配合更新后的 OpenAI API 时出现的多项兼容性问题

性能优化

• 已优化：重构物品形态渲染逻辑，显著降低手办与座椅类物品的渲染耗时
• 已优化：改进女仆属性值显示逻辑，防止因数值溢出导致 UI 显示异常

AI 智能体更新

本次更新对女仆 AI 聊天功能进行了全面重构，并依据主流智能体（Agent）架构设计原则进行系统性优化。目前仅已知 车万女仆：纸短情长 扩展包存在兼容性崩溃；其余所有扩展包均兼容。

支持的 AI 提供商更新

• 更新阿里云、SiliconFlow、OpenAI 等提供商的模型列表至最新版本
• 移除腾讯混元（Hunyuan）提供商
• 新增以下默认提供商：
  • Gemini
  • Grok
  • OpenRouter
  • GLM
  • MiniMax（同时支持大语言模型与语音合成）
  • KiMi
  • 腾讯云（仅支持语音识别 ASR）

UI 交互改进

本次更新大幅降低了 AI 相关功能的配置门槛，显著提升了易用性。

• 所有 AI 聊天相关设置已统一整合至面向女仆时按 T 键打开的 UI 面板中；女仆原始 GUI 中对应的功能标签页已被移除
• 面板包含：提供商设置、女仆人格提示词编辑器、聊天记录查看与删除功能、大语言模型 / 语音合成 / 语言选项、提供商配置模块
• 面板实时显示累计 Token 消耗量
• 提供商配置现加入身份验证机制，全面适配单人游戏、局域网、专用服务器主机及客户端等各类场景——服务器管理员无需再担忧密钥与配置的安全性
• 提供商配置现已支持完全在游戏内修改，无需手动编辑 JSON 配置文件
• 聊天输入框支持使用上下方向键快速调取并重新编辑历史输入内容
• 语音合成（TTS）提供商选择中新增“无”选项，允许玩家在客户端侧禁用语音合成

AI 聊天功能重构

• 提示词优化

  • 女仆现可更精准识别玩家意图，并调用正确的工具
  • 每次对话均自动注入高度相关的上下文信息，以提升指令识别效率

• 对话鲁棒性增强

  • 当大模型出现幻觉或错误调用工具时，系统将自动触发重试机制，引导模型自我修正
  • 每次对话前均校验消息历史结构，防止出现 HTTP 400 错误（此前使用 DeepSeek 等模型时常触发）
  • 若关联的女仆实体已不存在，对话会话将立即终止，避免错误调用

• 缓存命中率优化（提升缓存命中率可有效降低 API 成本并加快模型响应速度）

  • 对话缓存命中率已从约 50% 提升至约 85%

• 工具调用调整

  • 新增更多可调用工具，包括：切换女仆坐姿状态、开启/关闭归家模式、设置工作日程、设定攻击目标等
  • 提高工具调用链的最大轮数，并引入多重熔断机制，既支持 AI 组合多次工具调用完成复杂操作，又可防止因无限循环导致异常 Token 消耗
  • 部分富含游戏上下文的内容现通过工具调用机制按需获取，降低基础 Token 消耗
  • 使用命令 /tlm ai_chat context 可输出当前所有可用的游戏上下文信息
  • 使用命令 /tlm ai_chat tool 可输出当前所有可用的工具列表

• 技能系统

  • 新增技能（Skill）系统：标准技能文件可放置于配置文件夹或数据包指定路径下，系统将在适当时机将其注入对话上下文
  • 内置一个默认技能，包含关于女仆模组本身的全部知识，使女仆能够准确回答有关该模组的问题
  • 使用命令 /tlm ai_chat skill 可输出当前已加载的所有技能

• 上下文压缩

  • 当对话历史达到一定长度时，系统将自动压缩并总结历史记录，在保持对话连贯性的同时有效降低 Token 消耗

• UI 反馈改进

  • 女仆执行工具调用时，聊天气泡将实时刷新以显示当前工具调用状态，减少等待期间玩家困惑
  • 调整常规文本聊天气泡最大宽度，防止单行过长影响可读性

新增内容

新模型

• 更新：K 蜗牛模型
• 新增：圣洁狐妖、精灵狐妖（Starfield）、幸存者狐妖（Rosemist）、迷你狐妖（White Polarbear）、战术狐妖（Sodaball Pixel）
• 新增：年糕狐（完美冻结）
• 新增：《东方禁书目录》中缺失角色（FumoFumo）
• 更新：灵梦与魔理沙模型（CrystalSun）

精妙背包支持

新增对《精妙背包》模组的兼容支持：将精妙背包放入女仆的饰品栏（Curios slot）后，女仆即可正常与其交互，包括取出和放入物品。（由 CentaureaHO 提供）

迷你女仆妖精

当女仆妖精生成时，现存在 10% 概率生成迷你女仆妖精。迷你女仆妖精飞行速度略高于普通女仆妖精，被击杀后掉落双倍 P-点数。

回退原料（FallbackIngredient）

新增 FallbackIngredient 类型配方原料，用于在多模组环境中实现差异化合成输入（设计理念类似于 Avaritia 合成台的多模组适配方案）。

该原料类型按顺序遍历 fallbacks 列表，选取首个已安装对应模组的条目作为实际合成输入，实现“若模组 A 存在则使用其物品，否则回退至模组 B”的逻辑。

使用示例：

以下配方演示了一个祭坛配方：若安装了《森罗物语：厨房》，则使用其石磨；否则回退至原版木板（标签匹配），且始终要求一颗钻石作为固定原料：

{
  "type": "touhou_little_maid:altar_recipe",
  "output": {
    "item": "touhou_little_maid:bookshelf",
    "count": 1
  },
  "power": 0.1,
  "ingredients": [
    {
      // 必填类型参数
      "type": "touhou_little_maid:fallback_ingredient",
      // 有序列表；首个已安装模组的条目将被选为实际输入
      "fallbacks": [
        {
          // 若安装了 kaleidoscope_cookery，则使用其石磨
          "modid": "kaleidoscope_cookery",
          "value": {
            "item": "kaleidoscope_cookery:millstone"
          }
        },
        {
          // 回退方案：使用原版木板（标签匹配）
          "modid": "minecraft",
          "value": {
            "tag": "minecraft:planks"
          }
        }
      ]
    },
    // 固定原料：钻石（原版 Ingredient 语法）
    {
      "tag": "forge:gems/diamond"
    }
  ]
}

1.5.1 车万女仆 — 更新日志

错误修复

女仆行为修复

• 修复：女仆进食时偷取自身食物，导致进食动画无限循环
• 修复：女仆手持《沉浸式奏乐》乐器时右键点击会导致乐器掉落
• 修复：女仆死亡时饰品栏（Curios）中的配饰无法正确掉落（由 CentaureaHO 提供）
• 修复：安装《配饰》（Accessorify）后，女仆进食完毕时食物完全消失
• 修复：AI聊天中人格系统提示过长导致游戏崩溃

模型与渲染修复

• 修复：部分默认模型问题——健康值过低时“新娘狐狸”模型无法正常渲染

Create模组兼容性修复

• 修复：破坏Create旋转展示台方块时额外掉落一个手办物品
• 修复：女仆骑乘Create座椅时无法随整体结构朝向同步旋转

方块与物品修复

• 修复：零食柜被破坏时不掉落其内部物品

模组兼容性修复

• 修复：NeoForge 1.21.1下饰品栏（Curios）配件槽无法翻页
• 修复：安装《Alex的洞穴》后扫帚碰撞箱异常（由 CentaureaHO 提供）
• 修复：扫帚骑乘功能与《Leawind的第三人称》存在冲突（由 CentaureaHO 提供）

AI / 网络接口修复

• 修复：SiliconFlow语音识别返回HTTP 422错误
• 修复：使用新版模型（如GPT-4.5）配合更新后的OpenAI API时出现的多项兼容性问题

性能优化

• 优化：重构物品形态渲染逻辑，显著降低手办与座椅类物品的渲染耗时
• 优化：改进女仆属性值显示逻辑，防止因数值溢出导致UI显示异常

AI智能体更新

本次更新对女仆AI聊天功能进行了大规模重构，系统性地基于主流Agent架构设计原则进行优化。目前仅已知《车万女仆：纸短情长》附加组件存在兼容性崩溃问题；其余所有附加组件均兼容。

支持的AI服务商更新

• 更新阿里云、SiliconFlow、OpenAI等服务商的模型列表至最新版本
• 移除腾讯混元服务商
• 新增以下默认服务商：
  • 双子
  • Grok
  • OpenRouter
  • GLM
  • MiniMax（支持大语言模型与语音合成双模式）
  • KiMi
  • 腾讯云（仅支持语音识别ASR）

UI交互改进

本次更新大幅降低了AI相关功能的配置门槛，显著提升了易用性。

• 所有AI聊天相关设置已统一整合至面向女仆时按 T 键打开的UI面板中；女仆原始GUI中对应的标签页已被移除
• 该面板包含：服务商设置、女仆人格提示词编辑器、聊天记录查看与删除功能、大语言模型/语音合成/语言选项、服务商配置模块
• 面板实时显示累计Token消耗量
• 服务商配置现已加入认证机制，并全面适配单人游戏、局域网、专用服务器主机及客户端等多种场景——服务器管理员无需再担忧密钥与配置的安全性
• 服务商配置现可在游戏中直接完整修改，无需手动编辑JSON配置文件
• 聊天输入框支持使用上下方向键快速调取并重新编辑历史输入内容
• TTS服务商选择中新增“无”选项，允许玩家在客户端侧禁用语音合成

AI聊天功能重构

• 提示词优化

  • 女仆现可更精准识别玩家意图并调用正确工具
  • 每次对话中自动注入高度相关的上下文信息，提升指令识别效率

• 对话鲁棒性增强

  • 当大模型产生幻觉或错误调用工具时，系统将自动触发重试机制，引导模型自我修正
  • 每次对话前验证消息历史结构，避免HTTP 400错误（此前使用DeepSeek等模型时频繁触发）
  • 若关联的女仆实体已不存在，对话会话将立即终止，防止错误调用

• 缓存命中率优化（提升缓存命中率可有效降低API成本并加快模型响应速度）

  • 对话缓存命中率已从约50%提升至约85%

• 工具调用调整

  • 新增更多可调用工具，包括：切换女仆坐姿状态、家园模式、工作排程、设定攻击目标等
  • 提高工具调用链最大轮数，并引入多重熔断机制，支持AI组合多次工具调用完成复杂操作，同时防止因无限循环导致异常Token消耗
  • 部分富含游戏上下文的内容现通过工具调用机制按需获取，降低基础Token消耗
  • 使用命令 /tlm ai_chat context 输出当前所有可用游戏上下文信息
  • 使用命令 /tlm ai_chat tool 输出当前所有可用工具列表

• 技能系统

  • 新增技能系统：标准技能文件可放置于配置文件夹或数据包指定路径内，系统将在适当时机将其注入对话上下文
  • 内置一个默认技能，涵盖女仆模组本身的相关知识，使女仆能够准确回答有关本模组的问题
  • 使用命令 /tlm ai_chat skill 输出当前所有已加载的技能

• 上下文压缩

  • 当对话历史达到一定长度时，系统将自动压缩并摘要历史记录，在保持对话连贯性的同时有效降低Token消耗

• UI反馈改进

  • 女仆执行工具调用时，聊天气泡将实时刷新以显示当前工具调用状态，减少等待期间玩家困惑
  • 调整普通文字聊天气泡的最大宽度，防止单行过长影响可读性

新增内容

新模型

• 更新：K蜗牛模型
• 新增：圣狐、精灵狐（星域）、幸存者狐（玫瑰雾）、迷你狐（白北极熊）、战术狐（Sodaball像素风）
• 新增：年糕狐（完美冻结）
• 新增：《东方金剛經》中缺失角色（FumoFumo）
• 更新：博丽灵梦与雾雨魔理沙模型（CrystalSun）

《高级背包》兼容支持

新增对《高级背包》（Sophisticated Backpacks）的兼容支持：将高级背包放入女仆的饰品栏（Curios）后，女仆可正常与其交互，包括取出与存入物品。（由 CentaureaHO 提供）

迷你女仆仙子

当女仆仙子生成时，现存在 10% 概率生成迷你女仆仙子。迷你女仆仙子飞行速度略高于普通女仆仙子，被击杀后掉落双倍P点。

备用原料（FallbackIngredient）

新增 FallbackIngredient 类型的合成原料，用于在多模组环境中实现差异化合成输入（设计理念类似于Avaritia合成台的多模组适配方案）。

该原料类型按顺序遍历 fallbacks 列表，选取首个对应模组已安装的条目作为实际合成输入，实现“若安装模组A则使用其物品，否则回退至B”等逻辑。

使用示例：

以下配方演示了一个祭坛合成配方：若安装了《森罗物语：厨房》，则使用其磨石；否则回退至原版木板；同时始终要求一颗钻石作为固定原料：

{
  "type": "touhou_little_maid:altar_recipe",
  "output": {
    "item": "touhou_little_maid:bookshelf",
    "count": 1
  },
  "power": 0.1,
  "ingredients": [
    {
      // 必填类型参数
      "type": "touhou_little_maid:fallback_ingredient",
      // 有序列表；选取首个已安装模组对应的条目作为实际输入
      "fallbacks": [
        {
          // 若存在则使用《森罗物语：厨房》的磨石
          "modid": "kaleidoscope_cookery",
          "value": {
            "item": "kaleidoscope_cookery:millstone"
          }
        },
        {
          // 回退：使用原版木板（标签匹配）
          "modid": "minecraft",
          "value": {
            "tag": "minecraft:planks"
          }
        }
      ]
    },
    // 固定原料：钻石（原版Ingredient语法）
    {
      "tag": "forge:gems/diamond"
    }
  ]
}

车万女仆（Touhou Little Maid）1.5.0 更新日志

---

新增特性

零食柜

• 零食柜提供27格存储空间
• 当在顶部放置方块类食物时，将渲染两种显示窗口

女仆进食机制

• 女仆现在会从自身物品栏中取出食物并放置到特定方块上
• 女仆现在会悄悄从特定方块上取走食物
• 支持的方块：
  • 车万女仆（Touhou Little Maid）中的零食柜
  • Kaleidoscope Cookery 中的所有桌子
• 支持的食物来源：
  • 原版蛋糕
  • Kaleidoscope Cookery 中的方块类食物
  • [JMC] Just More Cakes! 中的蛋糕（部分效果也将生效）
  • Farmer's Delight 中的方块类食物：包括盛宴类食物及三种派类食物，可能兼容部分附加模组

灵魂封印所有者校验机制

• 初始灵魂法术现将绑定至玩家
• 当所有者不匹配时，将显示提示信息

新增女仆属性

完整集成 Maid Attributes 模组的女仆属性系统，现支持更多属性调整（默认无变化）。感谢 墨染琴弦

ID	名称	描述
touhou_little_maid:maid_crossbow_attack_speed	女仆弩弓攻击速度	女仆使用弩弓射击的速度倍率
touhou_little_maid:maid_gun_attack_speed	女仆枪械攻击速度	女仆使用枪械射击的速度倍率（TaCZ/Excellent Front）（不可超过枪械最大射速）
touhou_little_maid:maid_passive_use_shield_tick	女仆持盾持续时间	女仆单次举盾的持续时间
touhou_little_maid:maid_pickup_range	女仆拾取范围	女仆拾取掉落物/经验球/P点的范围
touhou_little_maid:maid_shoot_cooldown	女仆射击冷却	单次射击（弓/弩）后的冷却时间
touhou_little_maid:maid_trident_cooldown	女仆三叉戟投掷冷却	投掷三叉戟后的冷却时间
touhou_little_maid:maid_use_item_speed	女仆使用物品速度	女仆使用物品的速度倍率
touhou_little_maid:maid_hunger	女仆饥饿值	当前模组未使用该属性，供其他模组调用

• 女仆近战攻击现受武器攻击速度影响
• 玩家可打开女仆GUI的距离现受 entity_reach 属性影响

路径寻路与传送方块黑名单

为女仆路径寻路与传送新增方块黑名单机制，有效防止女仆传送或寻路至危险方块。感谢 炜尔 协助添加

当前已加入以下模组中的危险方块：

• Create：动力锯、粉碎轮
• Create Crafts & Additions：铁丝网
• The Bumblezone：重力空气、风力空气
• Farmer's Delight：灶炉
• Twilight Forest：树篱、炽铁装饰方块、骑士金属存储方块
• Alex's Caves：原始岩浆块
• Mekanism：聚变堆框架、超临界移相器外壳
• Immersive Engineering：刀片刺网
• Iron's Spells 'n Spellbooks：火盆、灵魂火盆
• Mob Grinding Utils：尖刺、锯

Iron's Spells 动画兼容性

待车万女仆：法术及其他相关模组更新至下一版本后，女仆施放法术时将播放对应动画。感谢动画师 艾雷克亚

该API亦可供其他模组扩展更多动画。感谢 Gardel 设计此API。使用方法详见：#994

Curios 模组兼容性

• 新增配置选项，支持选择性禁用 Curios 兼容性
• Curios 模组仅保证不会引发严重问题（如游戏崩溃），功能性无法完全保障
• 已测试四十余个相关模组，均未发现崩溃现象。感谢 炜尔 协助测试
• 公共链接：腾讯文档 - 车万女仆 Curios 兼容性对照表

默认模型更新

• 同步不同 YSM 狐狸的睡眠动画。感谢 小莫莫
• 新增九尾酒狐，修复并更新魔酒狐。感谢 星海境
• 新增婚庆酒狐。感谢 羊毛 Official
• 新增旧大正狐模型。感谢 亚利特泽克西斯
• 新增部分东方Project角色模型。感谢 Cyra

---

优化改进

女仆AI对话优化

感谢 Minner2018

• 函数调用功能现默认启用，使女仆能更准确理解并执行玩家指令
• 优化指令执行逻辑，避免重复操作
• 通过AI对话切换工作模式时，现支持在全部工作模式间切换（不限于战斗模式），并自动选取合适工具
• 新增通过对话切换跟随状态的功能
• 提升女仆指令识别准确性

女仆表情更新

更新女仆表情系统。感谢 萌玖moe

沉浸式奏乐（Immersive Melodies）模组动画

• 现采用与 YSM 2.6 相同的动画。感谢动画师 星屑海螺
• 为沉浸式奏乐模组添加部分 Molang 支持

同步 YSM Molang 函数与变量

• 同步一阶与二阶函数
• 同步 ysm.input_vertical 与 ysm.input_horizontal

基岩版模型渲染

• 修复基岩版模型渲染异常问题
• 新增对 uv_rotation 参数的支持

其他优化

• 配饰槽位（含女仆自身配饰槽与 Curios 配饰槽）现优先响应 Shift+点击操作，将物品直接放入配饰槽
• 祭坛建造判定条件更宽松，只要点击中间两块羊毛即可，不再限制朝向
• 启用实体持久化，可能解决偶发性女仆实体丢失问题
• 女仆不再因接触浆果丛而受伤（但仍会主动避开）
• 御币耐久度由300提升至1200点

---

错误修复

• 修复祭坛KJS中女仆合成输出错误的问题。感谢 XiaoDengPiaoPiao
• 修复女仆与玩家骑乘扫帚时乘坐苦力怕后被强制下马的问题
• 修复号角与铃铛无法召回已骑乘女仆的问题
• 修复女仆进食异常状态问题（#1017）。感谢 ethan_trum

---

其他

• 新增额外本地化翻译

小女仆 1.5.0 更新日志

---

新增特性

零食柜

• 零食柜提供27格存储空间
• 当在顶部放置方块类食物时，将渲染两种显示窗口

女仆进食机制

• 女仆现在会从自身物品栏中取出食物并放置到特定方块上
• 女仆现在会偷偷从特定方块上取走食物
• 支持的方块：
  • 小女仆模组中的零食柜
  • 森罗物语：厨房模组中的全部桌子
• 支持的食物来源：
  • 原版蛋糕
  • 森罗物语：厨房模组中的方块类食物
  • [JMC] 只是更多的蛋糕！模组中的蛋糕（部分效果也将生效）
  • 农夫乐事模组中的方块类食物：包括盛宴类食物及三种派类食物，可能兼容部分附加模组

灵魂封印归属检查机制

• 初始灵魂法术现将绑定至玩家
• 当归属者不匹配时，将显示提示信息

新增女仆属性

完整整合饰品栏模组中的女仆属性系统，现支持更丰富的属性调整（默认无变更）。感谢 墨染琴弦

ID	名称	描述
touhou_little_maid:maid_crossbow_attack_speed	女仆弩攻击速度	女仆使用弩射击的速度倍率
touhou_little_maid:maid_gun_attack_speed	女仆枪攻击速度	女仆使用枪械射击的速度倍率（TaCZ/Excellent Front）（不可超过枪械最大射速）
touhou_little_maid:maid_passive_use_shield_tick	女仆持盾持续时间	女仆单次举盾的持续时间
touhou_little_maid:maid_pickup_range	女仆拾取范围	女仆拾取掉落物、经验球及P点的范围
touhou_little_maid:maid_shoot_cooldown	女仆射击冷却	单次射击（弓、弩）后的冷却时间
touhou_little_maid:maid_trident_cooldown	女仆三叉戟投掷冷却	投掷三叉戟后的冷却时间
touhou_little_maid:maid_use_item_speed	女仆使用物品速度	女仆使用物品的速度倍率
touhou_little_maid:maid_hunger	女仆饥饿值	当前模组未使用该属性，可供其他模组调用

• 女仆近战攻击现受武器攻击速度影响
• 玩家可打开女仆GUI的距离现受 entity_reach 属性影响

寻路与传送方块黑名单

新增女仆寻路与传送的方块黑名单机制，有效防止女仆传送到危险方块或在危险方块上寻路。感谢 炜尔 协助添加

当前已加入以下模组中的危险方块：

• 机械动力：动力锯、粉碎轮
• 机械动力：工艺与附属：铁丝网
• 蜜蜂领域：重力空气、风力空气
• 农夫乐事：灶台
• 暮色森林：树篱、炽铁装饰方块、骑士金属存储方块
• Alex 的洞穴：原始岩浆块
• 通用机械：聚变堆框架、超临界移相器外壳
• 沉浸工程：刀片刺网
• Iron的法术与魔法书：火盆、灵魂火盆
• 刷怪塔实用设备：尖刺、锯

Iron的法术与魔法书动画兼容性

待小女仆：法术及其他相关模组更新至下一版本后，女仆施法时将播放对应动画。感谢动画师 艾雷克亚

该API亦可供其他模组调用以添加更多动画。感谢 Gardel 设计此API。使用方法详见：#994

饰品栏模组兼容性

• 新增配置选项，可选择性禁用饰品栏兼容性
• 饰品栏模组仅保证不会引发严重问题（如游戏崩溃），实际可用性不作保证
• 已测试四十余款相关模组，均未发现崩溃现象。感谢 炜尔 协助测试
• 公开链接：腾讯文档 - 小女仆饰品栏兼容性对照表

默认模型更新

• 同步不同YSM九尾狐的睡眠动画。感谢 小莫莫
• 新增九尾酒狐，修复并更新魔酒狐。感谢 星海境
• 新增婚庆酒狐。感谢 羊毛 Official
• 新增旧式大正狐模型。感谢 亚利特泽克西斯
• 新增部分东方Project角色。感谢 Cyra

---

优化改进

女仆AI对话优化

感谢 Minner2018

• 函数调用功能现默认启用，使女仆能更准确理解并执行玩家指令
• 优化指令执行逻辑，避免重复操作
• 通过AI对话切换工作模式时，现支持在全部工作模式间切换（不仅限于攻击模式），并将自动选取合适工具
• 新增通过对话切换跟随状态的功能
• 提升女仆指令识别准确性

女仆表情更新

更新女仆表情系统。感谢 萌玖moe

沉浸旋律模组动画

• 现采用与YSM 2.6相同的动画。感谢动画师 星屑海螺
• 为沉浸旋律模组添加部分Molang支持

同步YSM Molang函数与变量

• 同步一阶与二阶函数
• 同步 ysm.input_vertical 与 ysm.input_horizontal

基岩版模型渲染

• 修复基岩版模型渲染问题
• 新增对 uv_rotation 参数的支持

其他优化

• 配饰槽位（含女仆自身配饰槽与饰品栏）现优先在Shift+点击时将物品放入配饰槽
• 祭坛建造检测更为宽松，只要点击中间两块羊毛即可，朝向不再受限
• 启用实体持久化，可能解决难以复现的女仆实体丢失问题
• 女仆不再因接触浆果丛而受伤（但仍会主动避开）
• 御币耐久度由300点提升至1200点

---

Bug修复

• 修复祭坛KJS中女仆合成输出错误的问题。感谢 XiaoDengPiaoPiao
• 修复女仆与玩家骑乘扫帚时乘坐苦力怕会意外下马的问题
• 修复号角与铃铛无法召回骑乘状态女仆的问题
• 修复女仆进食异常状态问题（#1017）。感谢 ethan_trum

---

其他

• 新增额外本地化翻译

1.4.6 更新日志

• 修复了女仆无法跨越某些碰撞体积小于0.5的特殊方块（例如各类模组管道）的问题（感谢 @guapi-exe）
• 全面更换为 Nanaya 制作的新表情包
• 修复了大正女仆酒狐的贴图问题（感谢 @Tex_official）
• 修复了在打开携带熔炉和工作台背包的女仆界面时，JEI、REI 和 EMI 崩溃的问题
• 修复了女仆死亡通知消息显示错误的问题
• 修复了与 KubeJS 7.2 版本（1.21.1 NeoForge）的兼容性问题（感谢 @LootDust）
• 更新了部分翻译文本

1.4.6 更新日志

• 修复了女仆无法跨越某些碰撞体积小于 0.5 的特殊方块（例如各类模组管道）的问题（感谢 @guapi-exe）
• 全面更换为 Nanaya 制作的新表情包
• 修复了大正女仆酒狐的贴图问题（感谢 @Tex_official）
• 修复了在打开携带熔炉和工作台背包的女仆界面时，JEI、REI 和 EMI 崩溃的问题
• 修复了女仆死亡提示消息显示错误的问题
• 修复了与 KubeJS 7.2 版本（1.21.1 NeoForge）的兼容性问题（感谢 @LootDust）
• 更新了部分翻译文本

• 回滚了邻居节点缓存功能，并移除了相关代码，以防止女仆突然停止寻路并卡住
• 拴绳现已固定在女仆的手上
• 新增了一套女仆GIF表情符号包

• 修复了路径寻路过程中因缓存反射可能导致的崩溃问题
• 添加了小型狐狸模型（感谢 @Rou_Ti）

• 修复了路径寻找过程中因缓存反射可能导致的崩溃问题
• 新增小型狐狸模型（感谢 @Rou_Ti）

• 新增女仆背包物品被移除或装备时触发的 MaidBackpackChangeEvent 事件
• 新增女仆饰品物品被移除或装备时触发的 MaidBaubleChangeEvent 事件
• 在 ItemsUtil 中新增 hasBaubleItemInMaid 方法，以 O(1) 效率快速判断女仆是否佩戴饰品
• 修复了与“车万女仆：万法皆通”模组的兼容性崩溃问题

• 新增女仆背包物品被移除或装备时触发的 MaidBackpackChangeEvent 事件
• 新增女仆饰品物品被移除或装备时触发的 MaidBaubleChangeEvent 事件
• 在 ItemsUtil 中新增 hasBaubleItemInMaid 方法，以 O(1) 时间复杂度快速判断女仆是否佩戴饰品
• 修复了与“车万女仆：万法皆通”模组的兼容性崩溃问题

TLM 1.4.2 更新日志

错误修复

• 修复五子棋游戏相关问题
  • 解决在 Minecraft 1.21.1 中填满整张五子棋棋盘时导致的游戏崩溃问题
• 修复河童的罗盘坐标写入逻辑
  • 在写入后续坐标时增加维度一致性检查
• 修复装备交互问题
  • 解决按住 Shift 键点击穿卸甲时属性未更新的问题
• 修复模型显示问题
  • 解决 YSM 模型动画在雕像和车库套件中无法播放的问题

新功能

• 女仆任务列表界面优化（感谢：@sch246）
  • 左侧任务列表现支持鼠标滚轮滚动
• 女仆寻路系统性能优化（感谢：@小鱼飘飘）
  • 新增邻近节点缓存机制，提升寻路效率
  • 实现物品拾取延迟与对齐功能
  • 优化燃烧方块的查询性能
• 女仆实体备份功能
  • 为保障数据安全，女仆实体备份功能现已默认启用
• 小饰品系统全面重构
  • 小饰品插槽扩展至 30 个，显著提升模组兼容性
  • 增强小饰品界面，提供丰富的方法与事件机制，支持属性修改等高级功能
  • 全面支持 KubeJS
  • 采用可变长度 Map 数据结构存储小饰品信息，大幅提高遍历性能
  • 全新小饰品界面设计，采用独立分页布局（感谢 @YSBB 提供全新 GUI 设计）
  • 新增基于好感度的小饰品插槽解锁机制
• 开发者接口扩展
  • 新增 MaidFavorabilityLevelChangeEvent 好感度变更事件
  • 在 IMaidTask 接口中新增 isHidden 方法，支持任务隐藏功能
• 对话气泡系统重构
  • 支持通过数据包 touhou_little_maid:chat_bubble/kaomoji.json 自定义颜文字内容
  • 支持从资源包 textures/chat_bubble/maid_emoji 目录读取 PNG/GIF 表情
  • 支持通过文件名后缀自定义表情显示尺寸（例如 -64x64，最大 256 像素）
  • 新增颜文字与表情权重、显示频率等配置选项
• 模型内容更新
  • 同步 YSM 2.5.x 版本新模型：扩展酒狐与斯塔博模型，新增克鲁诺亚模型
• 象棋终局系统
  • 制图机器人房屋与要塞图书馆将随机生成终局物品
  • 终局状态物品可在对应棋盘上右键使用，以布置终局局面
  • 物品提示信息中显示终局预览缩略图
  • 支持通过数据包自定义终局，可在以下位置添加更多终局：
    • touhou_little_maid:board_states/chess.json — 国际象棋
    • touhou_little_maid:board_states/gomoku.json — 五子棋
    • touhou_little_maid:board_states/xiangqi.json — 中国象棋
  • 国际象棋采用标准 FEN 格式描述，可使用 Chess Wizard 等软件导出
  • 五子棋采用自定义格式，可在创造模式下使用木棍摆放棋子，再点击木棍盒子导出对局数据
• 用户界面优化
  • 在女仆模型切换界面中新增搜索功能（感谢：@QiChenSn）

TLM 1.4.2 更新日志

错误修复

• 修复五子棋游戏相关问题
  • 修复在 Minecraft 1.21.1 中填满整张五子棋棋盘时导致崩溃的问题
• 修复河童的罗盘坐标写入逻辑
  • 在写入后续坐标时增加维度一致性检查
• 修复装备交互问题
  • 修复按住 Shift 键点击装备/卸下护甲时属性未更新的问题
• 修复模型显示问题
  • 修复 YSM 模型动画在雕像与车库套件中无法播放的问题

新功能

• 女仆任务列表界面优化（感谢：@sch246）
  • 左侧任务列表现支持鼠标滚轮滚动
• 女仆寻路系统性能优化（感谢：@小鱼飘飘）
  • 新增邻近节点缓存机制，提升寻路效率
  • 实现物品拾取延迟与对齐功能
  • 优化对燃烧方块的查询性能
• 女仆实体备份功能
  • 女仆实体备份功能现已默认启用，以保障数据安全
• 小饰品系统全面重构
  • 小饰品槽位扩展至 30 个，显著提升模组兼容性
  • 增强小饰品界面，提供丰富的方法与事件机制，支持属性修改等高级功能
  • 全面支持 KubeJS
  • 采用可变长度 Map 数据结构存储小饰品信息，大幅提升遍历性能
  • 全新小饰品界面设计，采用独立页面布局（感谢 @YSBB 提供全新 GUI 设计）
  • 新增基于好感度的小饰品槽位解锁机制
• 开发者接口扩展
  • 新增 MaidFavorabilityLevelChangeEvent 好感度变更事件
  • 在 IMaidTask 接口中新增 isHidden 方法，支持任务隐藏功能
• 对话气泡系统重构
  • 支持通过数据包 touhou_little_maid:chat_bubble/kaomoji.json 自定义颜文字内容
  • 支持从资源包 textures/chat_bubble/maid_emoji 目录读取 PNG/GIF 表情图片
  • 支持通过文件名后缀自定义表情显示尺寸（例如 -64x64，最大 256px）
  • 新增颜文字与表情权重、显示频率等配置选项
• 模型内容更新
  • 同步 YSM 2.5.x 版本新模型：扩展酒狐与斯塔博模型，新增克鲁诺亚模型
• 象棋终局系统
  • 制图机器人房屋与要塞图书馆将随机生成终局物品
  • 终局状态物品可在对应棋盘上右键放置以设置终局局面
  • 物品提示信息中显示终局预览缩略图
  • 支持通过数据包自定义终局，可在以下位置添加更多终局：
    • touhou_little_maid:board_states/chess.json — 国际象棋
    • touhou_little_maid:board_states/gomoku.json — 五子棋
    • touhou_little_maid:board_states/xiangqi.json — 中国象棋
  • 象棋游戏采用标准 FEN 格式描述，可使用 Chess Wizard 等软件导出
  • 五子棋采用自定义格式，可在创造模式中使用棍棒放置棋子，再点击装有棋子的箱子导出对局数据
• 用户界面优化
  • 在女仆模型切换界面中新增搜索功能（感谢：@QiChenSn）

修复了同时使用 KubeJS 时因加载顺序问题导致的崩溃

版本 1.4.0 更新日志

• 新增对 PatPat 模组的兼容性（感谢：未知作者）

• 修复雪球投掷动画偏移问题

• 修复默认模型动画变量报错问题

• 完成与《卓越前线》模组的兼容性适配

  • 需要《卓越前线》版本 0.8.7.1 或更高版本方可使用
  • 女仆可使用《卓越前线》中的枪械（毒刺导弹除外）
  • 当女仆弹药耗尽时，将尝试使用副手持有的 RGO 手榴弹（要求主手持有枪械，副手持有 RGO 手榴弹）
  • 拾起佩戴鞍具的女仆后，对载具右键即可让女仆直接坐入驾驶员座位
  • 玩家乘坐载具时，附近跟随的女仆可坐入乘客座位
  • 坐在驾驶员或乘客座位上的女仆可使用载具武器或手持武器进行攻击
  • 放置在背部装饰栏位的武器将在女仆背部或腰部显示

• 优化远程攻击 AI 机制

  • 远程攻击（含枪械攻击）现会考虑距离因素，避免女仆反复往返移动问题

  • 在远程模式下，女仆将优先攻击当前正在伤害自身的生物

• doMobLoot 规则现影响女仆妖精的能量点掉落

• 移除 actuallyHurt 方法，修复女仆在 Arclight 服务器上受伤即死的 Bug

• 新增对小地图模组的兼容性支持

  • 兼容 Xaero 的小地图模组实体图标，现女仆、妖精女仆、扫帚、坐垫及能量点均已拥有专属实体雷达图标
  • 兼容旅行地图模组，当女仆死亡时，死亡坐标将显示于聊天栏，便于在旅行地图中快速添加路标

• 新增女仆备份机制，可在异常情况下自动备份女仆数据，并快速恢复此前备份的女仆

  • 首先需在 touhou_little_maid-server.toml 文件中启用女仆自动备份功能（默认关闭）

    # 是否启用女仆备份机制，该机制将定期备份服务器上所有玩家的女仆数据
    MaidBackupEnable = false
    # 女仆备份机制中备份女仆数据的时间间隔（单位：秒）
    # 取值范围：> 5
    MaidBackupIntervalSeconds = 180
    # 启用女仆备份机制后，每位玩家最多保存的备份数量
    # 取值范围：1 ~ 64
    MaidBackupMaxCount = 3
    

  • 游戏随后将根据设置，在已加载的区块内定期备份女仆

    • 备份采用异步机制，避免阻塞主服务器线程导致卡顿
    • 备份时间随机分布，防止集中在同一游戏刻造成卡顿

  • 使用 /tlm backup get <玩家> 命令可查看该玩家全部备份数据，点击显示条目可进一步查询

  • 最终向命令执行者发放一张包含备份数据的女仆照片

• 修改近战伤害逻辑，新增事件

  • 现调用 net.minecraft.world.item.Item#hurtEnemy 方法，在近战攻击后触发相关逻辑（如耐久消耗）
  • 新增 MaidHurtTarget.Pre 与 MaidHurtTarget.Post 事件，用于在近战攻击过程中触发

• 更新部分模型

  • 三款琪露诺女仆模型与两款雕像坐垫模型