独立的《杀戮尖塔 2》猜卡机器人项目，基于 NoneBot2 + OneBot V11 + NapCatQQ。
这个仓库从更大的机器人项目中拆分而来，只保留《杀戮尖塔 2》猜卡玩法所需的最小代码、数据和测试，方便单独维护与开源。
如果有更新的卡牌数据库来源，欢迎联系我为这个项目做出 contributions ，这对我来说很重要！
当前支持的命令：
@机器人 /猜卡@机器人 /提示@机器人 /结束猜卡@机器人 /猜卡测试 <卡牌名或ID>/猜卡 helppython scripts/test_sts_card_guess_local.py --card 暴走
玩法规则摘要：
- 开局随机给出 3 条基础提示
- 10 秒后补齐第 4 条基础提示
- 之后每 60 秒揭示一部分卡牌描述
- 同一群同一时间只允许进行一局
STSBot/
├─ bot.py
├─ pyproject.toml
├─ requirements.txt
├─ .env.example
├─ README.md
├─ data/
│ └─ sts_card_guess/
│ └─ cards/
├─ scripts/
│ └─ test_sts_card_guess_local.py
├─ src/
│ └─ plugins/
│ └─ sts_card_guess/
└─ tests/
└─ test_sts_card_guess.py
Python 3.10+- 推荐配合
NapCatQQ + OneBot V11 正向 WebSocket
安装依赖：
pip install -r requirements.txt将 .env.example 复制为 .env 后至少配置以下字段：
ENVIRONMENT=dev
LOG_LEVEL=DEBUG
HOST=127.0.0.1
PORT=8080
COMMAND_START=["/"]
ONEBOT_ACCESS_TOKEN=your-token
ADMIN_QQ=123456789
STS_CARD_DATA_DIR=data/sts_card_guess/cards字段说明：
PORT：需与 NapCatQQ 的 OneBot V11 正向 WebSocket 端口一致ONEBOT_ACCESS_TOKEN：需与 NapCatQQ Access Token 一致ADMIN_QQ：允许使用/猜卡测试的管理员 QQ 号STS_CARD_DATA_DIR：卡牌 JSON 目录，默认使用仓库内置卡池
在 NapCatQQ 中启用 OneBot V11 的正向 WebSocket，并确保以下配置与 .env 一致：
- 地址：
127.0.0.1:8080 - Access Token：与你的
ONEBOT_ACCESS_TOKEN一致
python bot.py或：
nb run --reload运行单元测试：
python -m unittest tests.test_sts_card_guess运行本地交互测试：
python scripts/test_sts_card_guess_local.py --card 暴走仓库内置了一份 STS2 卡牌 JSON 数据，位于 data/sts_card_guess/cards/。该目录直接从原项目复制而来，仅作为猜卡玩法的数据源。
本仓库只包含《杀戮尖塔 2》猜卡功能本身，不包含原机器人项目中的其它插件、私有配置或运行数据。
本项目使用 MIT License