Verity 扩展增强 5.1

Verity 扩展增强 5.1 — 本地工具、战斗系统、球体动作、VBM 适配

适用于 Minecraft 1.20.1 / Forge 47.3+，需要原版 Verity 6.0.0。

5.1 — 2026-10-31

功能版。给 Verity 加了 11 个本地工具（真的能看世界、能改方块、能跑长任务）、
一套战斗系统（日常护主 + 残血深渊觉醒），以及一整套球体动作。
另外给 Verity JE (VBM Preview) 这类整活构建做了专属适配，装上去不再崩启动。
配置项从 187 增至 190，云端白名单仍是 21 项。

产物：Verity扩展增强-5.1.jar（27.4 MB）
SHA-256 1283770951ce3d2dde12831177b7ad932a6a29395191b68c0a3decc676054243

新增功能

AI 能力扩展：11 个本地工具

类别	工具	作用
感知（只读）	scan_area / find_block / inspect_container / check_inventory / read_sign	扫地形、找方块、读容器、看背包、读告示牌
改造（有边界）	harvest_area / plant_crop / tidy_containers	采集自然方块、种地、按种类整理箱子
长任务	start_task / task_status / cancel_task	一句话拆成多步后台执行，可查进度、可取消

• 采集不再是「隔空挖」：走真正的行为流——导航过去 → 转头看着方块 → 破坏 → 下一个，
  玩家能看到她一块块挖
• 安全边界是硬约束：采集只认白名单（原木/树叶/矿石/作物），整理只认箱子/木桶/潜影盒，
  全部限制在玩家所在维度、16 格内、单次 128 个方块
• 两个开关：ai_extensions.localToolsEnabled（总开关）、ai_extensions.worldEditEnabled
  （关掉后只剩 5 个只读工具）。都在注入层生效，关掉时模型根本看不到这些工具

战斗系统

• 日常护主：你被敌对生物打中时锁定攻击者还手，伤害 = 目标最大生命 8%（保底 3 点）
• 残血深渊觉醒：四种触发——攻击者 ≥200 血（Boss）、≥100 血且你 ≤40%、
  你 ≤20% 被任何敌对生物打中、或这一击会把你打死。触发后召唤原版 verity:verity_demon
  （500 血 / 20 攻），给你抗性提升 5 级 3 秒 + 瞬间治疗，还能亲手杀掉它触发原版剧情
• 召唤的恶魔只听指挥：清空索敌表、服务端 tick 末尾锁目标、保持可移动状态、
  屏蔽追击音效与恐怖等级、绝不伤害主人
• 命令：/verity-combat on|off|status|test

球体动作

• 走路一颠一颠、下落拉长、落地压扁回弹、撞墙会晃、说话逐字 Q 弹
• 全部由同一条欠阻尼弹簧驱动，动作结束会自己回弹两下再稳下来
• 纯客户端渲染：碰撞箱、寻路、伤害都不变

兼容

• Verity JE (VBM Preview) 专属适配：检测到 varmite/verity/vbm/* 时自动让位——
  送礼交给原版 GiftService、心情提示词不重复注入、压扁状态下拒绝站头/骑乘
• 修掉装这一版崩在启动的问题（绘制调用换成 21 参重载，@Redirect 补了兜底）

修复总览

共 16 项。🔴 = 影响正常运行，🟡 = 明显影响体验，🟢 = 细节。

#	问题	级别
1	plant_crop 说「没有耕地」（z 轴区间退化成一个面）	🔴
2	tidy_containers 会往熔炉/漏斗里塞，毁掉烧炼队列	🟡
3	一条回复里的多个工具调用只执行第一个	🟡
4	觉醒完全不触发，日志里一行都没有（单人世界的 Verity 常常没有 owner）	🔴
5	召唤了但游戏里什么都没有（EntityType#create 后忘了 addFreshEntity）	🔴
6	挨打时整个战斗链路跳过（findForPlayer 返回 null）	🔴
7	召唤的恶魔回头打主人（原版自带 NearestAttackableTargetGoal<Player>）	🔴
8	召唤物站着不动（demonState != 1 会停寻路 + 速度清零）	🔴
9	一召唤就触发追击音效 / 恐怖等级拉满	🟡
10	召唤物被「跨存档追击」误认，下次登录触发「恶魔追着你」	🔴
11	装 VBM 预览版后崩在启动	🔴
12	check_inventory 少算盔甲	🟡
13	完成提示像日志：种 wheat完成：种了 16 个。	🟢
14	主动提议显示成 [Verity] 灰字，不张嘴也不出声（功能已删除）	🟡
15	站头时退出游戏，重进后 Verity 悬空不动	🟡
16	球体偶发隐身（x == Double.NaN 恒为 false 导致渲染矩阵 NaN）	🔴
17	永夜期间日志刷屏、昼夜循环被反复开关，永远「修不好」	🔴

#17 是源头修复：原版在「世界末日」状态下每 tick 关一次 doDaylightCycle
（好感 < 9000 之前世界本来就该是永夜，整个 jar 里从不设回 true），
我们之前每 tick 把它打开，双方无限对冲 —— 日志刷屏、每 tick 同步一遍 gamerule，玩家也看不到变化。
现在 VerityServerSafetyMixin 用 @Redirect 直接拦掉那个调用：
同一个 tick 里关 doMobSpawning 走的是同一个 set 方法，所以按规则实例比对，
只拦昼夜循环，变身与生物生成关闭照旧。守卫改为「原版维持永夜时让位」。

配置变更

键	默认	说明
ai_extensions.localToolsEnabled	true	11 个本地工具总开关
ai_extensions.worldEditEnabled	true	允许改动世界（采集 / 种植 / 整理）
gameplay_safety.verityDemonAwakening	true	残血深渊觉醒总开关

配置项总数 187 → 190，云端 overrides 白名单仍是 21 项，这三项都不可云端下发。
旧存档的 TOML 缺这些键时按默认值自动补上。

升级提醒

🔴 站头同步协议从 2 升到 3（新增「谁站在谁头上」下行包）。
客户端与服务端必须同时更新，否则会因协议不一致被拒连接。

---

安装：删除旧版 jar，把 Verity-Extended-5.1.jar 放进 mods。
注意：站头同步协议从 2 升到 3，多人服客户端与服务端必须同时更新。

Verity 扩展增强 5.0

大版本更新。适配原版 Verity 6.0.0，修掉 20 项问题。

亮点

• 骑乘真正可用 —— 之前的操控代码从 4.5 起就没生效过（注入打在了 Entity 上，而 Mob 重写了那个方法且不调 super）
• 新增主动行为 —— 闲置时自己在附近溜达、血量过半时主动给治疗、主人被打时冲上去还手
• 世界不再永久冻结 —— 昼夜循环被原版关掉后会立即恢复，hardcore 存档也覆盖到了
• 对话不再一直报 400 —— tool_calls 缺 tool 回复的两个方向都补齐了
• 云端下发收权 —— 从 180 项收窄到 21 项 API 连接配置，功能开关一律本机管理
• 移除插件系统 —— 能力边界太窄，维护成本一直存在

环境要求

项	要求
Minecraft	1.20.1
Forge	47.3+（47.3.x / 47.4.x 均可，编译基准 47.3.0）
Java	17+
必装	Verity JE 6.0.0、GeckoLib 4.4+
选装	PatPat（摸头联动）、《The Shooting Star》（星之遥控器）

安装

把 Verity扩展增强-5.0.jar 放进 mods/。同 modId 只能存在一个 jar，升级前请把旧版本删掉或改后缀。

校验

关于文件名：附件叫 Verity-Extended-5.0.jar。GitHub 会把非 ASCII 文件名规范化成 .，
中文名传不上去（试过会变成 Verity.-5.0.jar）。本地构建产物仍是 Verity扩展增强-5.0.jar，
内容完全相同，下载后直接用即可——Forge 只看 jar 内容，不看文件名。

SHA-256: a3fbb1430c50c91359b60c293b025fcdddd2e7b5192514df742b5788fbdec665
大小:    28,664,689 字节 (27.3 MB)

从 4.5.x 升级注意

1. 原版 Verity 必须一起升到 6.0.0（6.2 改版仍走兼容分支，但别同时启用两个 modId = verity 的 jar）
2. 若云端后台配过 overrides，5.0 只接受 21 项连接配置，功能开关类的下发会失效
3. 骑乘现在是 R 键、站头是 H 键（可在「选项 → 控制」改键）
4. 之前卡在「世界死寂」的存档，进游戏后会自动恢复昼夜循环与生物生成

完整变更见 CHANGELOG.md，排障见 docs/troubleshooting.md。

Verity 扩展增强 4.4

联网搜索新增 DeepSeek 服务商，并修掉了原来「只有说了『搜索』两个字才会搜」的判定问题。

本版重点

• 新增 DeepSeek 搜索：配置界面「搜索服务」多了第三项。端点
  POST /v1/tools/search，Bearer 鉴权，与对话共用同一个 API Key。
• 按质量过滤结果：官方把 rerank_score >= 1.5 定为优质线，低于 1.5 的软文与弱相关结果
  直接丢弃，不再塞给模型。
• 摘要优先用长摘要：取 summary（600800 字，专为模型阅读设计），
  为空时才退回 snippet（100200 字，本是给前端展示的）。
• 新增网页抓取 fetch：对应 POST /v1/tools/fetch，可针对某个链接取 Markdown 全文。
• 重做配置界面：半透明背景配不透明面板一直很违和，改成两张带描边的半透明卡片，
  世界从卡片间隙透出来；分组头与侧栏选中项也改成底色块，不再是细线。
• 联网搜索改为模型自主调用：注入 web_search 工具，由模型自己决定何时用，
  代理负责真去搜 + 回填结果 + 二次请求（仿原版 Verity 2.0 方案）。
• 联网搜索支持自定义 API：地址 / 请求体模板 / 结果路径 / 字段映射全可配，
  任何返回 JSON 的搜索接口都能接（配置项 171 → 176）。
• 整套配色重做：冷灰蓝 + 青蓝 → 暖调紫灰 + 柔和薰衣草紫；对比度逐项算过，
  全部 ≥4.6:1（危险色原来只有 3.7:1，已提亮）。
• 单人世界可用 /v：原来只索引「有 owner」的 Verity，单人里无 owner 就查不到，
  一直回「你目前没有可用的 Verity」。现在单人走兜底查找，并放行两个多人开关。
• 其余 8 个界面全部统一视觉：圆角卡片 + 圆角按钮 + 圆角输入框，半透明背景
  （资源和记忆、连接检查、对话记录、快捷命令、MMD 播放、插件管理、新建插件）。
• 说明文字改为悬停浮层：95 条说明原来各占一整行（共 2660px 滚动高度），
  现在挂到上方配置行上，鼠标移上去才浮出来，一屏能看到的配置项明显变多。
• 联网搜索改为模型自主调用：注入 web_search 工具，由模型自己决定何时用，
  代理负责真去搜 + 回填结果 + 二次请求（仿原版 Verity 2.0 方案）。
• 联网搜索支持自定义 API：地址 / 请求体模板 / 结果路径 / 字段映射全可配，
  任何返回 JSON 的搜索接口都能接（配置项 171 → 176）。
• 整套配色重做：相邻层 RGB 差距拉到 1825（旧版只差 68，导致分组头看不见）；
  分组头另加顶部 1px 强调线。
• 控件全部自绘：开关改成药丸形、按钮与输入框改圆角，不再用原版 Checkbox/Button/EditBox
  （交互、焦点、Tab 导航、朗读全部保留，只换外观）。
• 重写搜索触发判定：原来只认「搜索 / 联网查 / 查一下最新」这几个字面词，
  问「今天天气怎么样」「DeepSeek V4 什么时候发布的」反而不触发。
  现在改为「显式要求」或「疑问句 + 时效词」两类信号，明显该搜的问题能正常触发。

安装

1. Minecraft 1.20.1 + Forge 47.4.21（或更高的 47.4.x）
2. 先安装 原版 Verity 及其依赖
3. 下载本 jar 放进 mods 文件夹（先删除旧的 4.3，同 modId 只允许一个 jar）
4. 启动游戏，在「模组 → Verity 扩展增强 → Config」中配置

升级说明

• 配置项总数不变（29 项自检中的配置契约检查通过）：新增能力复用已有的
  webSearchEnabled / webSearchProvider / webSearchApiKey 三项，没有加新键。
• 旧的 webSearchProvider = "TAVILY" 继续有效；要用 DeepSeek 改成 "DEEPSEEK" 即可。
• 从 4.3 升级是纯增量，不需要改任何其它配置。

校验

SHA-256  f3dded4e9db73032533daaa0e2579f0199e8bc0ee742ff67d131717958f32380

完整变更历史见 CHANGELOG.md。

遇到问题：提交 Issue ·
常见报错排查

Verity 扩展增强 4.3

本版重点

• 骑乘与站头：潜行 + 空手右键骑到球形态的 Verity 身上；快捷键（默认 H）让她站到你头上
• 插件系统：用一句话生成规则，例如 /verity-plugin create 挖到钻石的时候提醒我
• 三种可选语音朗读方式，并支持 18 家语音服务商与音色克隆
• 双语台词：可以「写一种语言、念另一种语言」，并显示双语字幕
• 上下文管理：长对话自动裁剪与转存，降低 token 消耗
• 物品工具：全物品双语索引，模型可按中文名查物品
• 半透明界面：世界里的菜单透出世界，主菜单自动走原版背景

安装

1. Minecraft 1.20.1 + Forge 47.4.21（或更高的 47.4.x）
2. 先安装 原版 Verity 及其依赖
3. 下载本模组的 jar，放进 mods 文件夹（注意先删除旧版本，同 modId 只允许一个 jar）
4. 启动游戏，在「模组 → Verity 扩展增强 → Config」中配置

完整变更历史见 CHANGELOG.md。

校验

SHA-256  caf79c95bff26d2651f31829dd2327976b4cf5d96d5914bb798fe8b2b66e7fad

遇到问题：提交 Issue ·
常见报错排查