chatgame CLI 用法
安装
python3 -m venv .venv
. .venv/bin/activate
pip install chatgame
命令总览
chatgame --version
chatgame --help
chatgame --tree
chatgame --tree-brief
chatgame games
chatgame solve <IMAGE> [-g] [-n] [-o] [-v]
chatgame web setup
chatgame web serve [--host] [--port] [--reload]
求解类
chatgame --tree / chatgame --tree-brief
打印真实注册的命令树。--tree 包含参数签名，--tree-brief 显示同一命令面但省略签名；完整说明见 CLI 树。
chatgame --tree
chatgame --tree-brief
chatgame games
列出已支持的游戏。
$ chatgame games
已支持游戏：
cow-puzzle 牛牛摆放谜题
chatgame solve <IMAGE>
从游戏截图解析并求解，打印点击顺序。
| 选项 | 默认 | 说明 |
|---|---|---|
-g / --game |
cow-puzzle |
游戏类型 |
-n / --size |
自动推断 | 棋盘边长 N |
-o / --output |
— | 标注结果图保存路径 |
-v / --verbose |
关 | 打印颜色矩阵等调试信息 |
chatgame solve level24.png
chatgame solve level24.png -o solved.png
chatgame solve level24.png -n 10 -v
Web 类
chatgame web setup
检查安装态 Web 运行环境：
chatgame包本身fastapiuvicorn- 包内静态资源
chatgame/web_static
chatgame web setup
chatgame web serve
启动安装态 Web 服务，默认直接服务包内静态资源。
| 选项 | 默认 | 说明 |
|---|---|---|
--host |
127.0.0.1 |
服务监听地址；局域网/IP 访问可设为 0.0.0.0 |
--port |
8000 |
Web/API 端口 |
chatgame web serve
chatgame web serve --port 9000
chatgame web serve --host 0.0.0.0 --port 8000
典型工作流
# 1. 检查安装态环境
chatgame web setup
# 2. 启动 Web UI
chatgame web serve
# 3. 纯 CLI 求解
chatgame solve screenshot.png -o result.png