agentmc

jianf/agentmc

Fork 0

Commit Graph

Author	SHA1	Message	Date
JianFeeeee	1a6f197572	M5：操作层（真能改世界）+ 16 项判据新增 mcfold/actions.py（16 个操作：look/move/move_and_look/look_at/ jump/sneak/sprint/select_slot/use_item/swing/dig/place/interact_block/ attack/use_entity/interact_entity_at + chat/command）新增 mcfold/textcomp.py（1.20.3+ 的 NBT 文本组件渲染，查 language.json） ★★ 最关键发现：teleport_confirm 是必需前置包 1.19+ 的 position 带 teleportId，必须回 confirm，否则服务端默默忽略所有方块操作。症状是「操作没反应、零报错」，与权限/物品/位置问题无法区分。定位过程：先猜了 5 轮（包名/字段顺序/face 类型/sequence/位置与面）都不对；最后拿 minecraft-protocol 对照，发现它也失败 ⇒ 排除我的包有问题；再用 data get entity 排除权限与物品 ⇒ 补 confirm 后立刻成功。其他真 bug： - packet_interact/swing/animation 在 1.21.1 都不存在（应是 use_entity/arm_animation） - dig 原写成 block_place + 多余 varint（应为独立 packet_block_dig）→ 断连 - use_entity(mouse=0) 也带 hand 字段，我漏了 → 少 1 字节 - 背包字段是 itemId（驼峰），我写 item_id → 永远判「空手」 - window0 的 slot 36..44 才是热键栏 - 聊天 NBT 组件三重漏（空串/键名/空键参数）→ 现在正确渲染人话判据：126 项全通过；5 项变异全被抓。核心判据「16 个包能被官方 protodef 精确解回（0 余字节）」—— 唯一能离线证明「包写对了」的办法	2026-09-26 12:44:08 +08:00
JianFeeeee	d2b4c5029d	M4：事件层（可按需排空的日志 + 游标）+ 16 项判据新增 mcfold/events.py：EventLog（环形缓冲 + seq + 游标） - 不做回调式推送：LLM 是回合制的，回调会让事件在两次观察之间静默丢失 - drain(limit) 只取本轮、剩余留待下次（不丢） - 细分层（block_changed❌y:z）独立可查，不污染粗粒度流 - render_events() 输出紧凑文本行，省 token session 接线：block_change / multi_block_change / chat / damage / entity spawn·move·destroy / held_item_slot，并加 chat()/command() 发送修的真 bug： - dropped 恒 0：deque(maxlen=) 丢元素无声 ⇒ 改手动计数（事件丢了必须说） - 事件键 to_state_id 与渲染器的 to 不一致 ⇒ 显示 None，改为解出方块名； from 区分「未加载/界外」而非裸 None - run_tests.sh 只数 ✓ 不数 ★ ⇒ 判据少报（98 修正为 110）实测：/setblock 后事件正确报 grass_block→stone→air，与状态层一致判据：110 项全通过；4 项变异全部被抓	2026-09-26 12:27:28 +08:00

Author

SHA1

Message

Date

JianFeeeee

1a6f197572

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

新增 mcfold/actions.py（16 个操作：look/move/move_and_look/look_at/
jump/sneak/sprint/select_slot/use_item/swing/dig/place/interact_block/
attack/use_entity/interact_entity_at + chat/command）
新增 mcfold/textcomp.py（1.20.3+ 的 NBT 文本组件渲染，查 language.json）

★★ 最关键发现：teleport_confirm 是必需前置包
1.19+ 的 position 带 teleportId，必须回 confirm，否则服务端**默默忽略所有方块操作**。
症状是「操作没反应、零报错」，与权限/物品/位置问题无法区分。
定位过程：先猜了 5 轮（包名/字段顺序/face 类型/sequence/位置与面）都不对；
最后拿 minecraft-protocol 对照，发现它也失败 ⇒ 排除我的包有问题；
再用 data get entity 排除权限与物品 ⇒ 补 confirm 后立刻成功。

其他真 bug：
- packet_interact/swing/animation 在 1.21.1 都不存在（应是 use_entity/arm_animation）
- dig 原写成 block_place + 多余 varint（应为独立 packet_block_dig）→ 断连
- use_entity(mouse=0) 也带 hand 字段，我漏了 → 少 1 字节
- 背包字段是 itemId（驼峰），我写 item_id → 永远判「空手」
- window0 的 slot 36..44 才是热键栏
- 聊天 NBT 组件三重漏（空串/键名/空键参数）→ 现在正确渲染人话

判据：126 项全通过；5 项变异全被抓。核心判据「16 个包能被官方 protodef
精确解回（0 余字节）」—— 唯一能离线证明「包写对了」的办法

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

JianFeeeee

d2b4c5029d

M4：事件层（可按需排空的日志 + 游标）+ 16 项判据

新增 mcfold/events.py：EventLog（环形缓冲 + seq + 游标）
- 不做回调式推送：LLM 是回合制的，回调会让事件在两次观察之间静默丢失
- drain(limit) 只取本轮、剩余留待下次（不丢）
- 细分层（block_changed❌y:z）独立可查，不污染粗粒度流
- render_events() 输出紧凑文本行，省 token

session 接线：block_change / multi_block_change / chat / damage /
entity spawn·move·destroy / held_item_slot，并加 chat()/command() 发送

修的真 bug：
- dropped 恒 0：deque(maxlen=) 丢元素无声 ⇒ 改手动计数（事件丢了必须说）
- 事件键 to_state_id 与渲染器的 to 不一致 ⇒ 显示 None，改为解出方块名；
  from 区分「未加载/界外」而非裸 None
- run_tests.sh 只数 ✓ 不数 ★ ⇒ 判据少报（98 修正为 110）

实测：/setblock 后事件正确报 grass_block→stone→air，与状态层一致
判据：110 项全通过；4 项变异全部被抓

2026-09-26 12:27:28 +08:00

2 Commits