# AVA2 自动洗练适配进度（v1，不含属性锁定）

2026-10-15。修改了 metin2-client 和 metin2-server，AVA2 代码只作参考。服务端规则和协议见 `metin2-server/docs/FEATURE-SWITCHBOT.md`。

## 与 AVA2 的差异

| 项目 | AVA2 | 本实现 |
| --- | --- | --- |
| 窗口 | 新增 SWITCHBOT 物品窗口，5 个物品槽加 1 个道具槽 | 不新增窗口类型，物品留在背包，按物品 ID 绑定；每个角色同一时间只洗 1 件 |
| 洗练执行 | 自己实现消耗和 ChangeAttribute，绕过手动检查和 ItemLog | 每次都调用原 `UseItem`，检查、概率、日志、扣道具都和手动洗练一样；71151/76023 仍只能洗等级上限 ≤40 的武器和衣服 |
| 速度 | 0.1 秒一次 | 0.25 秒一次（约 4 次/秒） |
| 物品被移动 | 拦截移动、交易、出售等路径 | 每次洗练前重新检查：物品不在背包、已装备、易主时停止（item_gone）；交易、商店、仓库、合成界面打开时停止（busy） |
| 换线 / 下线 | 通过 P2P 转移，继续洗 | 直接停止，不离线洗练 |

匹配规则和 AVA2 相同：最多 2 套方案，每套 1–5 条“属性 ≥ 阈值”；任意一套全部达标就停止，只看前 5 条普通属性。

## 客户端

- 模块 `mt_switchbot`（`src/platform/ScriptLib/SwitchbotScript.inc`），在 `PythonBoot.cpp` 中安装。入口是小地图旁“百科”按钮下方的“洗练”按钮。
- 物品：扫描背包里至少有一条属性的武器和防具，用 `<` `>` 切换。洗练道具：扫描子类型为 USE_CHANGE_ATTRIBUTE 的道具，显示数量。次数上限可选 10、50、100、200、500、1000。
- 可选属性和最大值由服务端 `attrs` 下发，客户端不自己推算。添加属性时分页点选；阈值用 －/＋ 调整，步长为最大值的 1/5，默认取最大值。
- 运行时锁定所有设置，实时显示次数、剩余道具、停止原因和当前 5 条属性。停止时在聊天框提示；达标时如果窗口已关闭，会自动打开。
- 命令间隔至少 0.3 秒，同一时间只有一个请求在等待回复。4 秒没有回复就显示“服务器尚未启用自动洗练”。`attrs` 只接受完整、连续的回复，不完整的整批丢弃。
- 文字都用 GBK 可编码的字符（不用 ◀/▶/⚠）。

## 证据

- `tests/wiki/test_switchbot.py`（CTest：`port.switchbot`）共 6 项通过，覆盖：
  - 请求节流和合并；
  - 不完整的 attrs 回复被拒绝；
  - start 命令的拼装和校验；
  - state/error 解析和超时；
  - 和服务端的原因码、错误码、上限一致；
  - 窗口流程：扫描 → 读取属性 → 选属性 → 开始 → 达标提示。
- 脚本能在 Python 2.7 下编译。`tests/wiki/test_service.py` 仍然通过。
- 2026-10-15 联机测试（203 额外开的测试核心 channel5/first，端口 13040，使用隔离编译的 game；macOS 原生客户端，账号 admin，物品为背包 33 格的剑 279，道具 71084）：
  - 上限 10 次：洗满 10 次后停止（limit），约 4 次/秒。
  - 两套方案、阈值 1：第 18 次达标（matched）。
  - 已经达标的物品：0 次就停止，不扣道具。
  - 洗练中把物品从 33 格移到 90 格：继续洗，窗口跟到 90 格；点停止后显示 stopped。
  - 洗练中退出客户端：服务端立即停止。
  - log.log 中 CHANGE_ATTRIBUTE 共 72 行，和总次数一致。
  - busy：洗练中摆摊（先给 50200 摊位包袱；没有它 `OpenMyShop` 会提前返回、摊位不会开，第一次测试就是这样误判的），摊位开出约 1 秒后停止（busy），共洗 6 次。
  - no_scroll：用 76014（共 6 张）、上限 10，洗 6 次后停止（no_scroll），道具剩 0。
  - rejected：对 90 级剑用 71151（原路径只允许等级 <= 40）：0 次就停止（rejected），道具未扣。
  - 截图里窗口布局正常。仓库自带的 `Client` 是英文 cp1252 locale，所以中文显示为 `????`；需要 zh locale 客户端才能看到中文。
- 联机测试发现并修复了两个窗口问题，`test_switchbot.py` 已加回归用例：
  - 洗练中移动物品后，选中项会跳到别的物品：现在按服务端报告的格子跟随。
  - 空闲时移动物品后选中项丢失：现在退而按相同 vnum 匹配。
- 服务端 `tests/features/test_switchbot.py` 和 `test_queries.py` 通过。203 的隔离目录 `/root/metin2-features-dev` 完整编译通过。

## 未完成

- Android 真机测试。
- macOS 构建需要 `-DMT_40250_SOURCE=<含 EterPack/EterPack.cpp 的源码目录>` 来生成 pack 密钥，否则 system.py 读不出来（RunMain Error）。本机没有 40250 源码，这次用的是 AVA2 的 `TEST/3. Source BIN/Client`，两者密钥相同。
- 服务端还没有部署到 203 正式环境。
- 属性锁定（阶段 6 后半）：需要单独的存储设计。