/br test

/br story

/br start

/br explore  →  探索楼层（搜集物品、了解环境）
/br exit     →  寻找出口（切入下一层）
/br status   →  随时查看探员状态和背包

nodes = [
    {
        "user_id": "标识",
        "user_nickname": "昵称",
        "content": [{"type": "text", "data": "消息内容"}],
    },
]

"capabilities": [
  "send.text",
  "send.forward",
  ...
]

backrooms_escape/
│
├── plugin.py                  # 插件主入口
│                              游戏逻辑、命令注册、数据持久化
│
├── renderer.py                # 消息渲染器 + 拓展模块加载入口
│                              格式化所有回复文本；从 renderer_load/ 导入并透出所有拓展类
│
├── config.py                  # 配置模型
│                              PluginConfigBase 子类，定义 [plugin]/[game]/[whitelist]/[blacklist]
│
├── renderer_load/             # 拓展功能模块目录
│   ├── __init__.py            # 统一导出（上层只需 import renderer_load 即可）
│   ├── state_machine.py       # 有限状态机 — GameState / GameEvent / GameStateMachine
│   ├── shut.py                # 群聊静默管理 — ShutManager
│   ├── story_manage.py        # 数据加载层 — StoryManager / PeopleStoryMgmt /
│   │                          #               QuestManager / WorkManager / BaseWorkStoryManager
│   └── people_manage.py       # 角色业务层 — CharacterEncounterService / CHARACTERS 注册表
│
├── br_story/                  # 故事/剧情/数据目录
│   ├── level_story/           # 后室背景故事纸条文本
│   │   └── l1_story.txt ~ l11_story.txt
│   ├── people_story/          # NPC 角色剧情 + 任务数据 + 人物关系数据
│   │   ├── ankexin.txt
│   │   ├── anjinian.txt
│   │   ├── people_quests.json
│   │   └── people_relationship.json
│   └── base_story/            # 基地工作解谜数据 + 解锁故事
│       ├── base_work.json
│       └── work_W001_story.txt ~ work_W005_story.txt
│
├── config.toml                # 插件配置文件（启动时自动读取）
├── _manifest.json             # 插件元信息（ID、版本、兼容性声明）
├── backrooms_data.json        # 物品/实体数据池
├── br_data/                   # 玩家存档（运行时自动创建）
│   └── *.json
└── .gitignore

┌─────────────────────────────────────────────────────┐
│                   plugin.py                          │
│   命令路由 + 状态管理 + 存档读写 + 游戏流程编排         │
│   依赖: renderer, config                             │
└─────────────────────────┬───────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────┐
│                   renderer.py                        │
│   消息格式化 + 拓展模块统一加载入口                     │
│   从 renderer_load/ 导入并透出所有类                   │
└─────────────────────────┬───────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          ▼               ▼               ▼
┌─────────────────┐ ┌──────────┐ ┌──────────────────┐
│  renderer_load/  │ │ config   │ │ renderer_load/   │
│  state_machine   │ │          │ │ shut             │
│  (FSM)           │ └──────────┘ │ (群聊静默)        │
└─────────────────┘              └──────────────────┘
                                  ┌──────────────────┐
                                  │ renderer_load/   │
                                  │ story_manage     │
                                  │ (数据加载层)       │
                                  │  .StoryManager    │
                                  │  .PeopleStoryMgmt │
                                  │  .QuestManager    │
                                  │  .WorkManager     │
                                  │  .BaseWorkStory   │
                                  └────────┬─────────┘
                                           │ 调用获取数据
                                           ▼
                                  ┌──────────────────┐
                                  │ renderer_load/   │
                                  │ people_manage    │
                                  │ (角色业务层)       │
                                  │  .CHARACTERS      │
                                  │  .EncounterService│
                                  └──────────────────┘

用户命令 → plugin.py (命令处理)
            │
            ├──→ renderer.xxx()       ← 格式化回复消息
            ├──→ fsm.apply(event)     ← 状态转移
            ├──→ story_manage.xxx()   ← 读取故事/任务/工作数据
            ├──→ people_manage.xxx()  ← 角色遭遇/礼品/任务发放
            ├──→ _save_player()       ← 持久化存档
            └──→ _send()              ← 发送回复

NOT_STARTED ──start──▶ ALIVE ──reach_399──▶ AT_399 ──exit_399──▶ ESCAPED
                         │                                              │
                         │ die                                           │ restart
                         ▼                                              │
                       DEAD ◀────────────────────────────────────────────┘
                         │
                         └── restart ──▶ ALIVE

from dataclasses import dataclass, field
from .renderer import GameStateMachine

@dataclass
class PlayerState:
    fsm: GameStateMachine = field(default_factory=GameStateMachine)
    # ... 其他字段

# 守卫检查（替代旧的 game_started 判断）
if not player.fsm.is_playable():
    # 拒绝操作

[plugin]
output_mode = "text"      # 普通文本消息（默认）
# output_mode = "forward" # 合并转发消息（所有回复以合并转发形式发送）

最终概率 = min(base_exit_chance + 尝试次数 × exit_chance_increment, 1.0)

实际遭遇概率 = entity_encounter_chance × 当前楼层危险系数

判定流程：
  ┌─ random < 0.08  ──→ 🟦 大型物资箱（必出杏仁水）
  ├─ random < 0.23  ──→ 🟩 中型物资箱（必出杏仁水）
  ├─ random < 0.48  ──→ 🟨 小型物资箱（必出杏仁水）
  └─ 以上均未通过 ──→  空箱（"里面已经空了"）

某物品概率 = 该物品权重 ÷ 所有物品权重之和

# 示例：仅允许群号 123456789 和 987654321 的群使用
[whitelist]
enabled = true
group_ids = ["123456789", "987654321"]
user_ids = []

# 示例：仅允许 QQ 号 10001 私聊使用，不限群组
[whitelist]
enabled = true
group_ids = []
user_ids = ["10001"]

# 示例：禁止群号 111222333 和用户 444555666 使用
[blacklist]
enabled = true
group_ids = ["111222333"]
user_ids = ["444555666"]

backrooms_escape/
├── br_story/base_story/
│   ├── work_W001_story.txt      ← 坐标校准工作故事（占位符）
│   ├── work_W002_story.txt      ← 气候识别工作故事（占位符）
│   ├── work_W003_story.txt      ← 时区推算工作故事（占位符）
│   ├── work_W004_story.txt      ← 气流分析工作故事（占位符）
│   └── work_W005_story.txt      ← 路线规划工作故事（占位符）

backrooms_escape/
├── br_story/
│   ├── level_story/
│   │   └── l1_story.txt ~ l11_story.txt  ← 故事纸条
│   ├── base_story/
│   │   ├── base_work.json                ← 基地工作解谜数据
│   │   └── work_W001_story.txt ~ W005    ← 基地工作故事
│   └── people_story/
│       ├── ankexin.txt                   ← 安可欣剧情
│       ├── anjinian.txt                  ← 安继年剧情
│       ├── people_quests.json            ← 任务数据
│       └── people_relationship.json      ← 人物关系数据
├── backrooms_data.json                   ← 物品/实体数据
├── plugin.py
├── config.py
├── config.toml

===STORY_001===
第一条故事内容……

===STORY_002===
第二条故事内容……

===STORY_009===
你的故事文本写在这里。
可以写多行。
不需要转义，直接写中文即可。

backrooms_escape/
├── br_story/people_story/
│   ├── ankexin.txt             ← 安可欣（信息分析组探员，7段剧情）
│   ├── anjinian.txt            ← 安继年（工程部技师，7段剧情）
│   └── people_relationship.json  ← 人物关系配置文件（JSON 格式）
└── ...

===CHARACTER_001===
你走进了 Alpha 基地的休息区……

===CHARACTER_002===
…

backrooms_escape/
├── br_data/              ← 存档目录（插件首次加载时自动创建）
│   ├── 123456789.json    ← 用户 QQ 号对应的存档文件
│   └── 987654321.json
├── plugin.py
├── config.py
└── ...

{
  "user_id": "123456789",
  "current_level": 5,
  "health": 85,
  "sanity": 72,
  "inventory": [
    {
      "name": "o1",
      "type": "consumable",
      "effect": "sanity_restore",
      "value": 30,
      "display_name": "杏仁水",
      "description": "后室中最常见的补给品…"
    }
  ],
  "exit_attempts": 2,
  "pending_note": null,
  "state": "ALIVE",
  "unlocked_chars": ["ankexin"],
  "currency": 85,
  "active_quests": ["M001"],
  "completed_quests": [],
  "pending_quest_offer": null,
  "available_works": ["W001", "W002"],
  "completed_works": [],
  "work_stories": []
}