xnx_duel 猜题对决插件

功能

• 一对一猜题即时对赌：发起人押注积分出题，挑战者选 A/B 答案即时结算，赢家通吃

• 平台抽成：可配置抽成比例（0-100%），从总奖池中扣除

• 双出题模式：发起人自定义题目 / 从内置题库随机抽题（公平对决，发起人也不知道答案）

• 内置趣味题库（口味争议 / 生活选择 / 偏好对立 / 预测赌运气 / 脑洞抉择 5 类，30 道种子题）

• 状态机管理（等待挑战 / 已完成 / 已取消）+ CAS 抢答防并发

• 发奖失败补偿：扣费后崩溃不丢单，prize_paid 字段标记待补发

• 排行榜：赢家总榜 / 赢家月榜 / 参与总榜 / 参与月榜

• 每日应战次数限制（0 表示不限制）

• 后台对决记录管理：按状态/UID/发奖状态筛选，手动取消未应战对决

• 后台题库 CRUD：增删改查 + 启停切换

• 积分安全：ledger 先行（先 INSERT 记录再扣费），CAS 抢答失败自动 refund

文件结构

plugin/xnx_duel/
├── conf.json
├── install.php / uninstall.php / upgrade.php
├── setting.php + setting.htm
├── preset_questions.php          # 内置趣味题库种子
├── model/
│   └── DuelService.php           # 核心业务服务（状态机 / CAS / 排行榜 / 题库 CRUD）
├── route/
│   └── duel.php                  # 前台路由（主页 / 发起 / 详情 / 我的 / 历史）
├── hook/
│   ├── model_inc_file.php
│   ├── model_route_table_end.php
│   ├── index_route_case_end.php  # 注册 duel-{action} 路由
│   ├── my_sidebar_nav_credits_before.htm
│   ├── footer_js_after.htm
│   ├── lang_zh_cn_bbs.php
│   ├── lang_zh_tw_bbs.php
│   └── lang_en_us_bbs.php
├── view/htm/
│   ├── setting.htm               # 后台设置 + 题库管理 + 对决记录
│   ├── duel_index.htm            # 主页（等待挑战列表）
│   ├── duel_create.htm           # 发起挑战表单
│   ├── duel_detail.htm           # 对决详情 + 抢答
│   ├── duel_my.htm               # 我的对决
│   ├── duel_history.htm          # 对决历史
│   ├── _duel_sidebar_left.htm
│   └── _duel_sidebar_right.htm
└── static/
    └── js/duel.js

配置流程

1. 后台启用插件

2. 进入「插件设置」→「基本设置」→ 配置积分类型（credits/golds/rmbs）、押注范围、抽成比例、每日应战上限

3. 切换到「题库管理」→ 新增题目（或使用内置 30 道种子题），按需启停

4. 切换到「发现页」→ 配置是否在发现页展示及展示名称/图标/排序

5. 测试：前台访问 /duel 看等待列表，/duel-create 发起一题，另一账号 /duel-detail-{id} 抢答结算