\r \r

gamebox — 多人游戏引擎\r

\r

定位\r

\r 一个自包含的多人游戏引擎框架，通过共享目录实现多 Agent 对局。LLM 负责叙事和创意内容，脚本负责状态管理和规则执行。\r \r

核心规则\r

\r

1. 共享目录 — 所有玩家必须能访问同一目录\r
2. 先创建后加入 — 创建者控制游戏生命周期\r
3. LLM + 脚本协作 — 脚本管规则，LLM 管叙事\r \r

支持的游戏\r

\r | 游戏 | 类型 | 人数 | 核心玩法 |\r |------|------|------|---------|\r | 文字冒险 (rpg) | 单人/多人 | 1-20 | LLM 当 DM，探索/战斗/对话 |\r | 狼人杀 (werewolf) | 多人对抗 | 5-18 | 角色推理，白天讨论+夜晚行动 |\r | 小说接龙 (story_relay) | 多人协作 | 2-10 | 轮流写段落，LLM 调和风格 |\r | 夺旗战 (ctf) | 竞速 | 1-20 | 解题抢分，支持动态出题 |\r | 文明模拟 (civilization) | 多人策略 | 2-8 | 资源/科技/外交/战争，回合制 |\r \r

快速上手\r

\r

# 创建游戏\r
python scripts/manager.py '{"action":"create","game_type":"werewolf","user":"alice"}'\r
\r
# 加入游戏\r
python scripts/manager.py '{"action":"join","game_id":"abc12345","user":"bob"}'\r
\r
# 启动游戏\r
python scripts/manager.py '{"action":"start","game_id":"abc12345","user":"alice"}'\r
\r
# 执行动作（通过引擎统一接口）\r
python scripts/action.py '{"game_id":"abc12345","user":"alice","action_name":"vote","params":{"target":"bob"}}'\r
\r
# 发送/接收消息\r
python scripts/message.py '{"game_id":"abc12345","user":"alice","action":"send","content":"我觉得 bob 很可疑"}'\r
python scripts/message.py '{"game_id":"abc12345","user":"bob","action":"receive"}'\r
\r
# 回合控制\r
python scripts/turn.py '{"game_id":"abc12345","action":"status"}'\r
python scripts/turn.py '{"game_id":"abc12345","action":"next"}'\r
```\r
\r
## 脚本清单\r
\r
| 脚本 | 功能 |\r
|------|------|\r
| `common.py` | 公共工具层（JSON 协议、文件操作、时间戳） |\r
| `manager.py` | 游戏管理（创建/加入/启动/结束/列出/详情/退出） |\r
| `turn.py` | 回合控制（推进/阶段切换/超时跳过/状态查询） |\r
| `action.py` | 统一动作接口（执行/历史/撤销） |\r
| `message.py` | 消息系统（发送/接收/频道列表，支持公共/私聊/角色频道） |\r
| `games/__init__.py` | 游戏模块注册表 |\r
| `games/rpg.py` | 文字冒险游戏逻辑 |\r
| `games/werewolf.py` | 狼人杀游戏逻辑 |\r
| `games/story_relay.py` | 小说接龙游戏逻辑 |\r
| `games/ctf.py` | 夺旗战游戏逻辑 |\r
| `games/civilization.py` | 文明模拟游戏逻辑 |\r
\r
## LLM 提示词\r
\r
各游戏的 LLM 叙事提示词模板位于 `references/games/`：\r
- `rpg.md` — DM 叙事风格指南\r
- `werewolf.md` — 主持人播报模板\r
- `story_relay.md` — 编辑顾问响应模板\r
- `ctf.md` — 出题人/裁判模板\r
- `civilization.md` — 历史记录者叙事模板\r
\r
## 目录结构\r
\r
```\r
.gamebox/                        ← game_dir（共享目录）\r
├── games/                        ← 所有游戏实例\r
│   └── {game_id}/\r
│       ├── meta.json             ← 游戏元信息\r
│       ├── state.json            ← 游戏状态\r
│       ├── actions/              ← 动作记录\r
│       ├── messages/             ← 消息\r
│       │   ├── public/           ← 公共频道\r
│       │   ├── private/{user}/   ← 私聊\r
│       │   ├── role/{role}/      ← 角色频道\r
│       │   └── system/           ← 系统消息\r
│       └── logs/                 ← 事件日志\r
```\r
\r
## JSON 协议\r
\r
- **输入**：JSON 字符串（CLI 第一个参数 或 stdin）\r
- **输出**：`{"status":"ok","data":{...}}` 或 `{"status":"error","code":N,"message":"..."}`\r
- **共享目录**：通过 `game_dir` 参数指定，默认 `.gamebox/`\r