diff --git a/README.md b/README.md index 0841d2b..c31debe 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,20 @@ - 3次答题机会 - 关键词智能匹配 +### 🀄 成语接龙 +- 支持多音字和谐音接龙 +- 全局黑名单系统 +- 实时状态显示 +- 参与者统计排行 +- 支持指定下一位接龙者 + +### ⚫ 五子棋 +- 标准15×15棋盘 +- 黑方禁手规则(三三、四四、长连) +- 多轮对战同时进行 +- 完整的战绩统计 +- 实时棋盘显示 + ## 🚀 快速开始 ### 环境要求 @@ -50,6 +64,8 @@ cd WPSBotGame # 使用conda环境 conda activate liubai pip install -r requirements.txt + +# 注意:成语接龙游戏需要pypinyin库进行拼音处理 ``` 3. **配置环境变量** @@ -90,6 +106,13 @@ MESSAGE_RATE_LIMIT=20 # 日志配置 LOG_LEVEL=INFO + +# 游戏配置(可选,使用默认值) +# 成语接龙最大历史显示数量 +IDIOM_MAX_HISTORY_DISPLAY=10 + +# 五子棋最大并发游戏数 +GOMOKU_MAX_CONCURRENT_GAMES=5 ``` ### WPS机器人配置 @@ -148,6 +171,32 @@ LOG_LEVEL=INFO .quiz 答案 # 回答问题 ``` +### 成语接龙 + +``` +.idiom start [成语] # 开始游戏(可指定起始成语) +.idiom [成语] # 接龙 +.idiom [成语] @某人 # 接龙并指定下一位 +.idiom stop # 结束游戏 +.idiom status # 查看游戏状态 +.idiom reject [词语] # 拒绝词语加入黑名单(仅发起人) +.idiom blacklist # 查看黑名单 +.idiom next @某人 # 指定下一位(仅最后接龙者) +``` + +### 五子棋 + +``` +.gomoku challenge # 发起挑战 +.gomoku accept # 接受挑战 +.gomoku A1 # 在A1位置落子 +.gomoku show # 显示当前棋盘 +.gomoku resign # 认输 +.gomoku cancel # 取消自己的挑战 +.gomoku list # 列出所有进行中的对战 +.gomoku stats # 查看个人战绩 +``` + ## 🏗️ 项目结构 ``` @@ -155,6 +204,7 @@ WPSBotGame/ ├── app.py # FastAPI主应用 ├── config.py # 配置管理 ├── requirements.txt # Python依赖 +├── env.example # 环境变量模板 ├── core/ # 核心模块 │ ├── database.py # SQLite数据库 │ ├── models.py # 数据模型 @@ -167,15 +217,28 @@ WPSBotGame/ │ ├── parser.py # 指令解析 │ └── rate_limit.py # 限流控制 ├── games/ # 游戏模块 +│ ├── base.py # 游戏基类 │ ├── dice.py # 骰娘系统 │ ├── rps.py # 石头剪刀布 │ ├── fortune.py # 运势占卜 │ ├── guess.py # 猜数字 -│ └── quiz.py # 问答游戏 -└── data/ # 数据文件 - ├── bot.db # SQLite数据库 - ├── fortunes.json # 运势数据 - └── quiz.json # 问答题库 +│ ├── quiz.py # 问答游戏 +│ ├── idiom.py # 成语接龙 +│ ├── gomoku.py # 五子棋 +│ └── gomoku_logic.py # 五子棋逻辑 +├── data/ # 数据文件 +│ ├── bot.db # SQLite数据库 +│ ├── fortunes.json # 运势数据 +│ ├── quiz.json # 问答题库 +│ └── idiom_blacklist.json # 成语黑名单 +├── deploy/ # 部署配置 +│ ├── install.sh # 安装脚本 +│ ├── manage.sh # 管理脚本 +│ ├── nginx/ # Nginx配置 +│ └── systemd/ # systemd服务配置 +└── Convention/ # 通用工具库 + ├── Runtime/ # 运行时工具 + └── Image/ # 图像处理工具 ``` ## 🔧 部署 @@ -256,11 +319,12 @@ curl http://localhost:8000/stats ## 📈 性能指标 -- **内存占用**:150-250MB +- **内存占用**:150-300MB(包含拼音处理库) - **响应时间**:<500ms - **并发支持**:5-10个同时请求 - **用户规模**:50-100个活跃用户 - **消息限制**:20条/分钟(WPS限制) +- **支持游戏**:7种游戏类型(骰子、石头剪刀布、运势、猜数字、问答、成语接龙、五子棋) ## 🤝 贡献