Phira-mp + 项目概览
项目结构
Phira-mp-plus/
│
├── Cargo.toml # 工作区根 (workspace)
├── Cargo.lock
├── LICENSE # AGPL-3.0
├── README.md
│
├── server_config.yml # YAML 配置文件（首次运行自动生成默认模板）
├── data/ # 运行时数据目录
│ ├── extensions.json # 插件扩展数据持久化
│ ├── rounds/ # 轮次 Touches/Judges 记录
│ └── plugins/ # 插件私有数据
├── log/ # 运行日志（每小时轮转）
│
├── phira-mp-plus-server/ # 服务端核心
│ ├── Cargo.toml # axum / tokio / wasmtime / clap 等依赖
│ ├── locales/ # Fluent i18n 翻译文件
│ │ ├── en-US.ftl
│ │ ├── zh-CN.ftl
│ │ └── zh-TW.ftl
│ └── src/
│ ├── main.rs # 进程入口与生命周期
│ ├── logging.rs # tracing 输出与日志轮转
│ ├── terminal.rs # 终端能力检测与 Screen 降级策略
│ ├── lib.rs # 模块导出
│ ├── server.rs # 服务器核心: PlusConfig / PlusServerState / PlusServer
│ │ # accept 循环、压测方法、状态查询分发
│ ├── session.rs # 会话管理: Session / User 模型、认证、命令处理
│ │ # Touches/Judges 数据流向插件事件 + 磁盘存储
│ ├── room.rs # 房间状态机: InternalRoomState / Room
│ │ # 选谱→准备→游玩→结算、玩家实时数据缓存
│ ├── plugin.rs # 插件管理器 + WASM 宿主: PluginManager / PluginHost trait
│ │ # 插件加载、事件分发、CLI/HTTP/API 注册
│ ├── plugin_http.rs # HTTP 服务装配与动态请求分发
│ ├── plugin_http/
│ │ ├── router.rs # 动态路由匹配
│ │ ├── sse.rs # SSE 事件总线、快照与流转换
│ │ └── websocket.rs # 实时 WebSocket 桥接
│ ├── wasm_host.rs # WASM 运行时: wasmtime 实例、JSON ABI、host/api 桥接
│ ├── extensions.rs # 扩展数据系统: 用户/房间 KV 存储 + auth 缓存持久化
│ ├── ban.rs # 黑名单系统: 全局封禁 + 房间黑名单
│ ├── round_store.rs # 轮次数据存储: JSONL 格式、按 round_uuid/player_id 组织
│ ├── rate_limiter.rs # 速率限制: 滑动窗口 (连接) + 令牌桶 (命令)
│ ├── cli.rs # CLI 命令处理器: 30+ 管理命令、插件扩展命令
│ ├── cli_tui.rs # TUI 终端界面: ratatui + crossterm
│ └── l10n.rs # 本地化: Fluent Bundle / tl! 宏
│
├── phira-mp-plus-server-api/ # WASM 插件共享类型 crate
│ └── src/lib.rs # PluginEvent / PluginInfo / HttpHandle
│ # ServerStateQuery / PluginApiHandler
│
├── phira-mp/ # 上游 phira-mp 子模块（协议层与原始服务端）
│ ├── phira-mp-common/ # 网络协议: 二进制编码 (BinaryData trait)、
│ │ └── src/ # 命令定义 (ClientCommand / ServerCommand)、
│ │ ├── lib.rs # Stream 帧协议、RoomId / RoomState / 消息类型
│ │ ├── command.rs
│ │ ├── bin.rs # BinaryReader / BinaryWriter (LEB128, 小端)
│ │ └── framing.rs # 打包/拆包 (VARINT 长度前缀)
│ ├── phira-mp-macros/ # #[derive(BinaryData)] 过程宏
│ ├── phira-mp-server/ # 原始单机服务端 (reference)
│ └── phira-mp-client/ # TCP 客户端库 (供游戏集成)
│
├── docs/ # 本地文档
│ ├── cli.md # CLI 命令参考
│ └── plugin-dev.md # WASM 插件开发指南 + WIT API 参考
│
└── server_config.yml # YAML 配置文件 (同级副本, 运行时读取)终端兼容性
启动时会检测 stdin/stdout、TERM、STY 与 TMUX。GNU Screen 自动切换到逐行兼容控制台，不启用颜色、备用屏幕、鼠标捕获或 Bracketed Paste；tmux 仍可使用完整 TUI。项目同时遵循 NO_COLOR，逐行输出会再次过滤残留控制序列。非交互环境同样使用逐行控制台。
SSE 房间事件
GET /rooms/listen 建立连接后先发送 ready，随后以 update_room 补发当前房间快照，再持续推送 create_room、update_room、join_room、leave_room 和 new_round。可用下列命令直接检查数据流：
bash
curl -N http://127.0.0.1:12347/rooms/listen构建特性
| 特性 | 说明 | 默认 |
|---|---|---|
plugin-system | WASM 插件支持（wasmtime） | 是 |
配置参考
完整的配置项见 server_config.yml：
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
port | u16 | 12346 | TCP 监听端口 |
http_port | u16 | 12347 | HTTP/SSE 服务端口 |
monitors | Vec<i32> | [2] | 允许旁观的用户 ID |
phira_api_endpoint | String | https://phira.5wyxi.com | Phira API 端点 |
plugins_dir | String | plugins | 插件目录 |
chat_enabled | bool | true | 聊天功能开关 |
cli_enabled | bool | true | CLI 控制台开关 |
connection_rate_limit | u32 | 30 | 连接速率限制（窗口内允许次数） |
connection_rate_window | u32 | 10 | 连接速率统计窗口（秒） |
max_users_per_room | usize | 8 | 每房间最大玩家数 |
round_data_retention_days | u32 | 7 | 轮次 Touches/Judges 保留天数（0=不保留） |
server_name | String | — | 服务器名称 |