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:
1 parent
d7a7107b0a
commit
c414db4217
7 files changed
+27
-27
No files matched your search
@@ -84,7 +84,7 @@ uv run main.py solo # 本地引擎 + 终端界面,不开
|
||||
**TUI 是纯客户端**:它通过 WebSocket 订阅状态、通过 WebSocket/HTTP 提交动作,
|
||||
自己不持有任何游戏状态。所以:
|
||||
|
||||
* 服务端可以在另一台机器上,`python main.py play --url http://10.0.0.5:8765 --farm alice`;
|
||||
* 服务端可以在另一台机器上,`uv run main.py play --url http://10.0.0.5:8765 --farm alice`;
|
||||
* 关掉 TUI 不会影响服务器,你的牧场继续按时间生长;
|
||||
* 你在 TUI 里操作的同时,AI 可以对同一个牧场操作,双方立刻能看到对方的结果。
|
||||
|
||||
@@ -113,7 +113,7 @@ uv run main.py solo # 本地引擎 + 终端界面,不开
|
||||
实例:
|
||||
|
||||
```bash
|
||||
$ python main.py actions
|
||||
$ uv run main.py actions
|
||||
牧场 default · 第 3 天 · 金币 96 · 行动点 7/10
|
||||
共 9 个候选动作:
|
||||
|
||||
@@ -123,7 +123,7 @@ $ python main.py actions
|
||||
4 号地空闲,可种小麦
|
||||
...
|
||||
|
||||
$ python main.py do harvest '{"plot":2}'
|
||||
$ uv run main.py do harvest '{"plot":2}'
|
||||
✓ 收获 2 份胡萝卜(丰收!),获得 104 金币 (0.01s)
|
||||
第 3 天 · 金币 200 · 行动点 7/10 · 净资产 512.0
|
||||
```
|
||||
@@ -347,7 +347,7 @@ farm/
|
||||
hub.py WebSocket 连接池与状态推送(线程 → 事件循环的桥)
|
||||
daemon.py 守护进程:start / stop / status / 日志 / pid
|
||||
webui.py 内嵌网页客户端(单页,原生 JS + WebSocket)
|
||||
__main__.py python -m farm.server(前台运行)
|
||||
__main__.py uv run python -m farm.server(前台运行)
|
||||
tools/
|
||||
preview_tui.py 把 TUI 渲染成文本(--url 可连真实服务器)
|
||||
ws_demo.py 最小 WebSocket 客户端,验证协议
|
||||
|
||||
Reference in new issue
Block a user