agentmc

Files

JianFeeeee 94bcd37e66 M7：面向 LLM 的 API 形状（23 个工具）+ 17 项判据

新增 mcfold/api.py：把 M3/M4/M5/M6 包成 agent 能自己摸清的工具箱
- 观察 14：where_am_i/block_at/column/see/raycast/walkable/slice/
            nearby_blocks/nearby_entities/inventory/surroundings/look_at
- 事件  1：events（含细分层按前缀查）
- 操作  7：chat/command/look/look_at/move/dig/place/use_item/select_slot
- 会话  2：status/describe
- call(name, **kwargs) 派发入口

照 plan §1d 五个维度落地：
- 参数：全部 keyword-only（坐标必须按名字传，LLM 不会搞混 x/y/z）
- 返回：每条带 describe（人类可读摘要）
- 失败：永不抛异常 → ok:false + why + how_to
- 规模：限量 + total/remaining/truncated，明说被截断
- 发现：describe() 一次列全工具 + 约定字典 + 4 条提示；目录与实现双向一致

判据抓到的真问题：坐标工具原允许位置传参 ⇒ 已全改 keyword-only。
★ 判据自身也修正过一次：我把「不能有必填参数」误当成规则，
  实际要判的是参数**种类**（关键字专用）——「坐标必需」与「可位置传」是两件事。

★ 操作失误：变异测试用过期 /tmp 备份覆盖了 state.py（丢 113 行），
  导致一个变异「被抓」其实是坏代码造成 ⇒ 恢复必须用 git，
  且每个变异单独确认基线绿。重做该变异后才确认判据有效。

163 项全通过；5 项变异全被抓

2026-09-26 13:17:17 +08:00

backends

实例创建接口（Python 层）+ 后端透传新参数

2026-09-26 10:18:26 +08:00

__init__.py

feat(mcfold): 最小客户端 + 跨实现互操作测试（Python 客户端握手 Node 服务端成功）

2026-09-25 14:12:06 +08:00

actions.py

M5：操作层（真能改世界）+ 16 项判据

2026-09-26 12:44:08 +08:00

anvil.py

架构重构：差异全部下移到 Java，Python 只做路由