docs: 添加 DicePP 机器人功能列表文档

Author: pear-studio

src/plugins/DicePP/docs/README.md

@@ -4,6 +4,7 @@
 
 ## 文档目录
 
+- [功能列表](./feature_list.md) - 机器人所有功能汇总
 - [架构总览](./architecture.md) - 项目整体架构介绍
 - [命令模式](./command_pattern.md) - 命令系统的设计与实现
 - [命令示例：以掷骰为例](./example_roll.md) - 以 `.r` 掷骰命令为例详解

src/plugins/DicePP/docs/feature_list.md

@@ -0,0 +1,254 @@
+# DicePP 机器人功能列表
+
+本文档列出 DicePP 机器人的所有功能。
+
+---
+
+## 目录
+
+1. [骰子系统](#1-骰子系统)
+2. [角色卡系统](#2-角色卡系统)
+3. [跑团日志](#3-跑团日志)
+4. [先攻系统](#4-先攻系统)
+5. [卡牌与随机生成](#5-卡牌与随机生成)
+6. [数据查询](#6-数据查询)
+7. [群管理功能](#7-群管理功能)
+8. [通用工具](#8-通用工具)
+9. [Master 指令](#9-master-指令)
+10. [外部 API](#10-外部-api)
+11. [多机器人互联](#11-多机器人互联)
+
+---
+
+## 1. 骰子系统
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 基础掷骰 | `.r` / `.roll` | 支持多种骰子表达式，如 `3d6+5`、`4d6k3` 等 |
+| 随机选择 | `.choose` / `.pick` | 从选项中随机选择，如 `.choose A B C` |
+| 骰池 | `.pool` | 骰池投掷，用于 DND 5E 等规则 |
+| 默认骰设置 | `.set` | 设置默认骰子面数 |
+| 业力骰子 | `.karma` | Karma 系统，记录玩家运气值 |
+
+### 骰子表达式支持
+
+- 基础骰子：`d4`, `d6`, `d8`, `d10`, `d12`, `d20`, `d100`
+- 掷骰数量：`3d6` 表示掷 3 个 6 面骰
+- 加减修正：`+5`, `-2`
+- 优势/劣势：`2d20kh1` (优势), `2d20kl1` (劣势)
+- 掷骰原因：`3d6+5 力量检定`
+
+---
+
+## 2. 角色卡系统
+
+### DND 5E 角色卡
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 创建角色卡 | `.角色卡` | 创建新的 DND 5E 角色卡 |
+| 属性检定 | `.力量` / `.敏捷` 等 | 进行属性检定 |
+| 技能检定 | `.攀爬` / `.游泳` 等 | 进行技能检定 |
+| 豁免检定 | `.力量豁免` 等 | 进行豁免检定 |
+| 攻击检定 | `.攻击` / `.攻击优势` | 进行攻击检定 |
+| 生命骰 | `.生命骰` / `.1#生命骰` | 使用生命骰恢复生命值 |
+| 长休 | `.长休` | 长时间休息，恢复所有生命值和生命骰 |
+| 生命值管理 | `.hp` | 查看/调整生命值 |
+
+### COC 角色卡
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 生命值管理 | `.hp` | COC 角色的生命值管理 |
+
+### 属性生成
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| COC 属性生成 | `.coc` | 生成 7 个 COC 属性 (4D6K3) |
+| DND 属性生成 | `.dnd` | 生成 6 个 DND 属性 (4D6K3) |
+
+---
+
+## 3. 跑团日志
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 创建日志 | `.log create` | 创建新的跑团日志 |
+| 记录片段 | `.log add` | 向日志中添加片段 |
+| 导出日志 | `.log export` | 导出日志为文件 |
+| 查看日志 | `.log view` | 查看日志内容 |
+| 删除日志 | `.log delete` | 删除日志 |
+| 日志统计 | `.log stat` | 统计日志信息 |
+
+---
+
+## 4. 先攻系统
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 先攻列表 | `.先攻` | 显示当前战斗轮先攻列表 |
+| 添加角色 | `.先攻 add 角色名` | 添加角色到先攻列表 |
+| 移除角色 | `.先攻 del 角色名` | 从先攻列表移除 |
+| 下一轮 | `.先攻 next` | 进入下一战斗轮 |
+| 战斗轮 | `.战斗轮` | 快速进行一轮战斗 |
+
+---
+
+## 5. 卡牌与随机生成
+
+### 抽卡系统
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 抽卡 | `.draw` / `.抽卡` | 从卡组中抽取卡牌 |
+| 卡组管理 | `.deck` | 管理自定义卡组 |
+
+### 随机生成器
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 随机生成 | `.gen` | 随机生成各种内容 |
+| NPC 生成 | `.gen npc` | 生成随机 NPC |
+| 物品生成 | `.gen item` | 生成随机物品 |
+
+---
+
+## 6. 数据查询
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 资料查询 | `.查询` / `.q` | 根据关键字查找资料 |
+| 全文搜索 | `.搜索` / `.s` | 全文搜索资料库 |
+| 私设资料 | `.私设` / `.hb` | 管理自定义资料 (需权限) |
+
+### 内置数据库
+
+- DND 5E 怪物图鉴
+- DND 5E 法术列表
+- COC 怪物图鉴
+- 其他 TRPG 资料
+
+---
+
+## 7. 群管理功能
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 群配置 | `.config` / `.c` | 查看/修改群设置 |
+| 模式切换 | `.mode` | 切换群预设模式 (dnd/coc/ygo 等) |
+| 欢迎词 | `.welcome` | 设置入群欢迎词 |
+| 激活状态 | `.on` / `.off` | 开启/关闭机器人响应 |
+| 自定义对话 | `.chat` | 设置自动回复对话 |
+
+---
+
+## 8. 通用工具
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 今日人品 | `.jrrp` | 每日随机人品值 |
+| 宏定义 | `.define` / `.def` | 定义自定义宏 |
+| 变量 | `.set` / `.get` | 用户自定义变量 |
+| 昵称 | `.nn` | 设置用户昵称 |
+| 好感度 | `.好感` | 记录角色好感度 |
+| 点数 | `.point` | 记录和分配点数 |
+| 帮助 | `.help` / `.帮助` | 查看帮助信息 |
+| 统计 | `.统计` | 查看个人/群聊使用统计 |
+
+---
+
+## 9. Master 指令
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| 发送消息 | `.master send` | 向指定用户/群发送消息 |
+| 重启 | `.master reboot` | 重启机器人 |
+| 静默模式 | `.master silent` | 开启/关闭静默模式 |
+| 清理日志 | `.master log clean` | 清理日志文件 |
+| 管理员 | `.admin` | 管理员相关功能 |
+
+---
+
+## 10. 外部 API
+
+机器人提供 FastAPI 接口供外部调用：
+
+- `/api/roll` - 掷骰接口
+- `/api/query` - 查询接口
+- `/api/character` - 角色卡接口
+
+详见 [FastAPI 模块](./fastapi.md)
+
+---
+
+## 11. 多机器人互联
+
+| 功能 | 命令 | 说明 |
+|------|------|------|
+| Hub 连接 | `.hub` | 连接多个 DicePP 机器人 |
+| 跨机器人掷骰 | - | 支持互相转发掷骰请求 |
+
+---
+
+## 指令一览表
+
+```
+.r/.roll        - 掷骰
+.choose/.pick   - 随机选择
+.pool           - 骰池
+.set            - 默认骰设置
+.karma          - 业力骰子
+
+.角色卡         - DND5E 角色卡
+.hp             - 生命值管理
+.coc            - COC 属性生成
+.dnd            - DND 属性生成
+
+.log            - 跑团日志
+
+.先攻           - 先攻列表
+.战斗轮         - 战斗轮
+
+.draw/.抽卡     - 抽卡
+.deck           - 卡组管理
+.gen            - 随机生成
+
+.q/.查询        - 资料查询
+.s/.搜索        - 全文搜索
+.私设/.hb       - 私设资料
+
+.config/.c      - 群配置
+.mode           - 模式切换
+.welcome        - 欢迎词
+.on/.off        - 激活状态
+
+.jrrp           - 今日人品
+.define/.def    - 宏定义
+.set/.get       - 变量
+.nn             - 昵称
+.好感           - 好感度
+.point          - 点数
+.help           - 帮助
+.统计           - 统计信息
+```
+
+---
+
+## 附录
+
+### 数据存储
+
+机器人使用 JSON 格式存储以下数据：
+
+- 用户数据 (`DC_USER_DATA`)
+- 群组数据 (`DC_GROUP_DATA`)
+- 昵称 (`DC_NICKNAME`)
+- 宏定义 (`DC_MACRO`)
+- 变量 (`DC_VARIABLE`)
+- 角色卡 (`DC_CHAR_DND`)
+- 生命值 (`DC_CHAR_HP`)
+
+### 国际化
+
+支持多语言文本，可通过 `LocalizationManager` 管理。