snowy-yang
fcd4cb4649
配置见 pyproject.toml：
- line-length=100：贴着现有代码定。若用默认的 88 会重排 122 行，
噪音淹没真正有价值的修复。
- 启用 E/W/F/I/UP/B/C4/SIM/RET/PERF/RUF；**不**启用 PTH。因为本项目的路径
多是"字符串身份"——要塞进 subprocess 命令行、写进 JSON 存档、打印给用户，
全换 pathlib 只是包一层再拆一层，换来 70 处纯风格改动。
- 忽略 RUF001/002/003：中文全角标点是正确写法，不是"歧义字符"。
- 忽略 PERF203：剩下两处都是"逐项容错"语义（逐个牧场存档要立刻上报失败、
收获全部要跳过失败地块）。把 try 提到循环外会毁掉"一项失败不影响其它项"
这个行为，是错的优化。
自动修复 358 项：Dict/List/Optional 换成 PEP 585/604 写法、导入排序、
失效的 noqa、空占位 f-string 等。
手工修复的（这些是真问题，不是风格偏好）：
- B904 x9：except 中 raise 补异常链。刻意区分——网络/IO 失败用 from exc 保留
根因；参数解析失败用 from None，因为底层 ValueError 对玩家只是噪音。
- RUF012 x2：StateView 的 plots/animals 原本是**类级共享可变列表**，
改成在 __init__ 里初始化（apply({}) 会提前返回，所以必须显式摆好）。
- F841：TUI 里一个赋值后再没用过的死变量。
- SIM105 x11：try/except/pass 统一改成 contextlib.suppress。
- SIM115：日志句柄改用 with。Popen 已把 fd 复制给子进程，父进程可安全关闭。
- E501 x7：拆超长行；main.py 那处顺手提取变量，避免超长嵌套表达式。
- E741：把 l/r 改成 left_line/right_line。
- 其余：RUF046 / PERF401 / RET504 / RUF005 / UP031 / B007。
ruff format 重排 24 个文件。
验证：97 项测试全绿。
90 lines
3.2 KiB
Python
90 lines
3.2 KiB
Python
#!/usr/bin/env python3
|
|
"""外挂式 AI/机器人玩家——完全通过 HTTP + WebSocket 接口参与游戏。
|
|
|
|
这个脚本**不**导入任何游戏规则代码，只用接口。换句话说：
|
|
它对服务器来说和一个远程 LLM Agent 没有任何区别。
|
|
|
|
用法
|
|
----
|
|
python ai_player.py # 连本机 default 牧场
|
|
python ai_player.py --farm ai-1 --minutes 5 # 经营 ai-1 五分钟
|
|
python ai_player.py --url http://10.0.0.5:8765 --farm my-bot
|
|
|
|
策略在哪里
|
|
----------
|
|
决策逻辑在 :mod:`farm.bot` 的 ``RuleBot.score()``：那是一张"什么该先做"的
|
|
打分表。想换成真 LLM，只需要把「读 /api/actions 之后选哪个」这一步换成模型
|
|
调用——接口调用序列完全一样：
|
|
|
|
读 GET /api/actions → 挑一个 → POST /api/actions → 读回执里的 state
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import json
|
|
import sys
|
|
|
|
from farm.bot import RuleBot, random_bot
|
|
from farm.client import RemoteFarm
|
|
from farm.engine import GameError
|
|
|
|
|
|
def build_parser() -> argparse.ArgumentParser:
|
|
parser = argparse.ArgumentParser(
|
|
prog="python ai_player.py",
|
|
description="通过 HTTP/WebSocket 接口参与 SimpleFarm 的机器人玩家",
|
|
)
|
|
parser.add_argument("--url", default="http://127.0.0.1:8765", help="服务器地址")
|
|
parser.add_argument("--farm", default="ai-1", help="经营哪个牧场，默认 ai-1")
|
|
parser.add_argument("--token", default=None, help="访问令牌（服务器启用时必填）")
|
|
parser.add_argument("--rounds", type=int, default=0, help="最多执行多少轮，0 表示不限")
|
|
parser.add_argument("--minutes", type=float, default=0.0, help="最多跑多少分钟，0 表示不限")
|
|
parser.add_argument("--pause", type=float, default=0.25, help="动作间隔（秒）")
|
|
parser.add_argument("--random", action="store_true", help="用随机策略（对照组）")
|
|
parser.add_argument("--quiet", action="store_true", help="只输出结果，不打过程")
|
|
return parser
|
|
|
|
|
|
def main(argv=None) -> int:
|
|
args = build_parser().parse_args(argv)
|
|
|
|
try:
|
|
client = RemoteFarm(
|
|
endpoint=args.url,
|
|
farm=args.farm,
|
|
token=args.token,
|
|
name=f"bot-{args.farm}",
|
|
realtime=False,
|
|
)
|
|
except GameError as exc:
|
|
print(f"✗ 连不上服务器：{exc.message}", file=sys.stderr)
|
|
print(" 先启动：python main.py serve --daemon", file=sys.stderr)
|
|
return 2
|
|
|
|
snapshot = client.snapshot()
|
|
print(
|
|
f"已连接 {args.url} · 牧场「{args.farm}」· 第 {snapshot.get('day')} 天 · "
|
|
f"金币 {snapshot.get('gold')}"
|
|
)
|
|
|
|
factory = random_bot if args.random else RuleBot
|
|
bot = factory(client, verbose=not args.quiet, pause=args.pause, name=args.farm)
|
|
try:
|
|
summary = bot.run(rounds=args.rounds, max_minutes=args.minutes)
|
|
except KeyboardInterrupt:
|
|
bot.stop()
|
|
summary = {
|
|
"name": args.farm,
|
|
"actions": bot.actions_executed,
|
|
"failures": bot.failures,
|
|
"interrupted": True,
|
|
}
|
|
|
|
print(json.dumps(summary, ensure_ascii=False, indent=2))
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|