fix: 用户可见的操作提示统一为 uv run 前缀

项目由 uv 管理,依赖装在 .venv。此前各处的提示语仍写作 `python main.py ...`,用户若在未激活虚拟环境时照抄,会因缺少 fastapi 而失败——这是正确性问题,不只是措辞。

涉及:main.py(12 行,含 prog 与各条 hint)、ai_player.py(5 行)、farm/client.py、farm/server/__main__.py(3 行,含 prog)、farm/server/__init__.py、farm/server/daemon.py、README(4 处示例与目录树注释)。

刻意保留 main.py:26 与 README:49 的「没装 uv?」兜底说明,那里 `python main.py` 是正确写法。

验收:ruff 全通过 / format 26 文件无改动 / pyright 0 错误 / 97 项测试通过。
This commit is contained in:
snowy-yang committed 2026-09-18 21:25:52 +08:00
1 parent d7a7107b0a
commit c414db4217
7 files changed
+27 -27

No files matched your search

+5 -5
View File
@@ -6,9 +6,9 @@
用法
----
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
uv run ai_player.py # 连本机 default 牧场
uv run ai_player.py --farm ai-1 --minutes 5 # 经营 ai-1 五分钟
uv run ai_player.py --url http://10.0.0.5:8765 --farm my-bot
策略在哪里
----------
@@ -32,7 +32,7 @@ from farm.engine import GameError
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(
prog="python ai_player.py",
prog="uv run ai_player.py",
description="通过 HTTP/WebSocket 接口参与 SimpleFarm 的机器人玩家",
)
parser.add_argument("--url", default="http://127.0.0.1:8765", help="服务器地址")
@@ -59,7 +59,7 @@ def main(argv=None) -> int:
)
except GameError as exc:
print(f"✗ 连不上服务器:{exc.message}", file=sys.stderr)
print(" 先启动:python main.py serve --daemon", file=sys.stderr)
print(" 先启动:uv run main.py serve --daemon", file=sys.stderr)
return 2
snapshot = client.snapshot()