nonebot-plugin-werewolf 1.1.3__tar.gz → 1.1.6__tar.gz

{nonebot_plugin_werewolf-1.1.3 → nonebot_plugin_werewolf-1.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-werewolf
-Version: 1.1.3
+Version: 1.1.6
 Summary: 适用于 Nonebot2 的狼人杀插件
 Author-email: wyf7685 <wyf7685@163.com>
 License: MIT
@@ -12,8 +12,10 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: nonebot2>=2.3.3
 Requires-Dist: nonebot-plugin-alconna>=0.52.1
+Requires-Dist: nonebot-plugin-localstore>=0.7.1
 Requires-Dist: nonebot-plugin-uninfo>=0.4.0
 Requires-Dist: nonebot-plugin-waiter>=0.7.1
+Requires-Dist: anyio>=4.6.0
 
 <div align="center">
   <a href="https://v2.nonebot.dev/store">
@@ -42,6 +44,8 @@ _✨ 简单的狼人杀插件 ✨_
 [![pyright](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pyright.yml/badge.svg?branch=master&event=push)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pyright.yml)
 [![publish](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pypi-publish.yml/badge.svg)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pypi-publish.yml)
 
+<!-- https://github.com/lgc2333/nonebot-registry-badge -->
+
 [![NoneBot Registry](https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin%2Fnonebot-plugin-werewolf)](https://registry.nonebot.dev/plugin/nonebot-plugin-werewolf:nonebot_plugin_werewolf)
 [![Supported Adapters](https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin-adapters%2Fnonebot-plugin-werewolf)](https://registry.nonebot.dev/plugin/nonebot-plugin-werewolf:nonebot_plugin_werewolf)
 
@@ -54,7 +58,7 @@ _✨ 简单的狼人杀插件 ✨_
 ## 💿 安装
 
 > [!note]
-> 
+>
 > 请确保 NoneBot2 使用的 Python 解释器版本 >=3.10
 
 <details open>
@@ -102,17 +106,16 @@ _✨ 简单的狼人杀插件 ✨_
 
 ## ⚙️ 配置
 
-在 nonebot2 项目的 `.env` 文件中添加如下配置
+在 nonebot2 项目的 `.env` 文件中添加如下配置:
+
+|          配置项           | 必填  | 默认值  |            说明            |
+| :-----------------------: | :---: | :-----: | :------------------------: |
+|  `werewolf__enable_poke`  |  否   | `True`  | 是否使用戳一戳简化操作流程 |
+| `werewolf__enable_button` |  否   | `False` |    是否在交互中添加按钮    |
 
-|             配置项              | 必填 | 默认值 |                             说明                              |
-| :-----------------------------: | :--: | :----: | :-----------------------------------------------------------: |
-|     `werewolf__enable_poke`     |  否  | `True` | 是否使用戳一戳简化操作流程<br/>仅在 `OneBot V11` 适配器下生效 |
-|     `werewolf__role_preset`     |  否  |   -    |                    覆写插件内置的职业预设                     |
-|  `werewolf__werewolf_priority`  |  否  |   -    |                     自定义狼人职业优先级                      |
-| `werewolf__priesthood_proirity` |  否  |   -    |                     自定义神职职业优先级                      |
-|  `werewolf__joker_probability`  |  否  | `0.0`  |              小丑职业替换平民的概率, 范围`[0,1]`              |
+`werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
-`werewolf__role_preset`, `werewolf__werewolf_priority`, `werewolf__priesthood_proirity` 的配置格式请参考 [`游戏内容`](#游戏内容) 部分
+`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
 
 ## 🎉 使用
 
@@ -131,24 +134,31 @@ _✨ 简单的狼人杀插件 ✨_
 
 而对于野生机器人，现有协议端通常不支持或不建议使用临时私聊消息。
 
-在使用本插件前，应当确保机器人可以正常向玩家发送私聊消息。
+在使用本插件前，应当确保机器人可以正常向玩家发送私聊消息。~~即保证机器人与玩家为好友关系~~
 
 </details>
 
 ### 指令表
 
-|        指令         |    权限    | 需要@ | 范围 |                说明                 |
-| :-----------------: | :--------: | :---: | :--: | :---------------------------------: |
-| `werewolf`/`狼人杀` |    群员    |  是   | 群聊 |       发起游戏 (进入准备阶段)       |
-|     `开始游戏`      | 游戏发起者 |  是   | 群聊 |   _[准备阶段]_ 游戏发起者开始游戏   |
-|     `结束游戏`      | 游戏发起者 |  是   | 群聊 |   _[准备阶段]_ 游戏发起者结束游戏   |
-|     `当前玩家`      |    群员    |  是   | 群聊 | _[准备阶段]_ 列出参与游戏的玩家列表 |
-|     `加入游戏`      |    群员    |  是   | 群聊 |      _[准备阶段]_ 玩家加入游戏      |
-|     `退出游戏`      |    群员    |  是   | 群聊 |      _[准备阶段]_ 玩家退出游戏      |
+|        指令         |        权限         | 需要@ | 范围  |                   说明                    |
+| :-----------------: | :-----------------: | :---: | :---: | :---------------------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   | 群聊  |          发起游戏 (进入准备阶段)          |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊  |      _[准备阶段]_ 游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊  | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊  |    _[准备阶段]_ 列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   | 群聊  |      _[游戏内]_ 超级用户强制中止游戏      |
+|    `狼人杀预设`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏预设      |
+
+ - 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
+
+ - `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
 
-_其他交互参考游戏内提示_
+ - 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
+
+ - _其他交互参考游戏内提示_
 
-对于 `OneBot V11` 适配器, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `/stop` 命令
 
 ### 游戏内容
 
@@ -162,31 +172,22 @@ _其他交互参考游戏内提示_
 
 | 总人数 | 狼人 | 神职 | 平民 |
 | ------ | ---- | ---- | ---- |
-| 6      | 1    | 2    | 3    |
-| 7      | 2    | 2    | 3    |
-| 8      | 2    | 3    | 3    |
-| 9      | 2    | 4    | 3    |
-| 10     | 3    | 4    | 3    |
-| 11     | 3    | 5    | 3    |
-| 12     | 4    | 5    | 3    |
+| 6      | 1    | 2    | 3    |
+| 7      | 2    | 2    | 3    |
+| 8      | 2    | 3    | 3    |
+| 9      | 2    | 4    | 3    |
+| 10     | 3    | 4    | 3    |
+| 11     | 3    | 5    | 3    |
+| 12     | 4    | 5    | 3    |
 
-职业预设可以通过配置项 `werewolf__role_preset` 修改
+职业预设可以通过命令 `狼人杀预设 职业 ...` 修改
 
 <details>
 <summary>示例</summary>
 
-配置项 `werewolf__role_preset`
-
-```env
-werewolf__role_preset='
-[
-    [6, 1, 3, 2],
-    [7, 2, 3, 2]
-]
-'
-```
+ - 命令: `狼人杀预设 职业 6 1 3 2`
 
-上述配置中，`[6, 1, 3, 2]` 表示当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
+ - 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
 
 </details>
 <br/>
@@ -196,45 +197,43 @@ werewolf__role_preset='
 - `狼人`: `狼人`, `狼人`, `狼王`, `狼人`
 - `神职`: `女巫`, `预言家`, `猎人`, `守卫`, `白痴`
 
-职业分配优先级可以通过配置项 `werewolf__werewolf_priority` 和 `werewolf__priesthood_proirity` 修改
+职业分配优先级可以通过命令 `狼人杀预设 狼人/神职` 修改
 
 <details>
 <summary>示例</summary>
 
-#### 配置项 `werewolf__werewolf_priority`
+#### 命令 `狼人杀预设 狼人`
+
+ - 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
 
-```env
-werewolf__werewolf_priority=[1, 2, 1, 1]
-```
+ - 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
 
-上述配置中，`[1, 2, 1, 1]` 表示狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
+#### 命令 `狼人杀预设 神职`
 
-#### 配置项 `werewolf__priesthood_proirity`
+ - 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
 
-```env
-werewolf__priesthood_proirity=[11, 12, 13, 14, 15]
-```
+ - 上述命令指定狼人的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+
+> [!note]
+>
+> 以上两条命令均支持交互式输入
+>
+> 例：向机器人发送命令 `狼人杀预设 狼人`，在接下来的一条消息中发送 `狼人 狼王 狼人 狼人`
+>
+> 其效果等同于以上描述中的单条命令 `狼人杀预设 狼人 狼人 狼王 狼人 狼人`
 
-上述配置中，`[11, 12, 13, 14, 15]` 表示神职的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+</details>
+<br/>
 
-#### 职业与数字的对应关系
+对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 *一定概率* 将其中一个平民替换为小丑。
 
-上述配置示例中有大量~~意义不明的~~数字, 其对应的是 [`这里`](./nonebot_plugin_werewolf/constant.py) 的枚举类 `Role` 的值
+小丑属于第三方阵营，胜利条件为在投票阶段被票出，在预言家查验及游戏进程判断时视作平民。
 
-以下列出目前的枚举值供参考
+小丑生成概率可以通过命令 `狼人杀预设 小丑 <概率>` 设置，默认值为 0 (不生成小丑)。
 
-| 职业     | 枚举值 |
-| -------- | ------ |
-| `狼人`   | `1`    |
-| `狼王`   | `2`    |
-| `预言家` | `11`   |
-| `女巫`   | `12`   |
-| `猎人`   | `13`   |
-| `守卫`   | `14`   |
-| `白痴`   | `15`   |
-| `平民`   | `0`    |
+### 已知问题
 
-</details>
+- 截止 chronocat v0.2.19, 调用 [`guild.member.get`](https://github.com/chrononeko/chronocat/blob/8558ad9ff4319395d86abbfda22136939bf66780/packages/engine-chronocat-api/src/api/guild/member/get.ts) / [`user.get`](https://github.com/chrononeko/chronocat/blob/8558ad9ff4319395d86abbfda22136939bf66780/packages/engine-chronocat-api/src/api/user/get.ts) 均无法获取用户名，这将导致在交互过程中的玩家名显示为用户 ID
 
 ## 📝 更新日志
 
@@ -243,6 +242,19 @@ werewolf__priesthood_proirity=[11, 12, 13, 14, 15]
 
 <!-- CHANGELOG -->
 
+- 2024.10.31 v1.1.6
+
+  - 新增超级用户中止游戏 (#7)
+  - 新增快速发起上次游戏 (#8)
+  - 准备阶段添加可选的交互按钮
+  - 新增超级用户修改游戏预设 (#9)
+
+- 2024.10.23 v1.1.5
+
+  - 添加对 chronocat:poke 的支持
+  - 游戏内 stop 命令使用 COMMAND_START
+  - 使用 `anyio` 重写并发逻辑
+
 - 2024.10.06 v1.1.3
 
   - 使用 `RF-Tar-Railt/nonebot-plugin-uninfo` 获取用户数据

{nonebot_plugin_werewolf-1.1.3 → nonebot_plugin_werewolf-1.1.6}/README.md

@@ -25,6 +25,8 @@ _✨ 简单的狼人杀插件 ✨_
 [![pyright](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pyright.yml/badge.svg?branch=master&event=push)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pyright.yml)
 [![publish](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pypi-publish.yml/badge.svg)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/pypi-publish.yml)
 
+<!-- https://github.com/lgc2333/nonebot-registry-badge -->
+
 [![NoneBot Registry](https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin%2Fnonebot-plugin-werewolf)](https://registry.nonebot.dev/plugin/nonebot-plugin-werewolf:nonebot_plugin_werewolf)
 [![Supported Adapters](https://img.shields.io/endpoint?url=https%3A%2F%2Fnbbdg.lgc2333.top%2Fplugin-adapters%2Fnonebot-plugin-werewolf)](https://registry.nonebot.dev/plugin/nonebot-plugin-werewolf:nonebot_plugin_werewolf)
 
@@ -37,7 +39,7 @@ _✨ 简单的狼人杀插件 ✨_
 ## 💿 安装
 
 > [!note]
-> 
+>
 > 请确保 NoneBot2 使用的 Python 解释器版本 >=3.10
 
 <details open>
@@ -85,17 +87,16 @@ _✨ 简单的狼人杀插件 ✨_
 
 ## ⚙️ 配置
 
-在 nonebot2 项目的 `.env` 文件中添加如下配置
+在 nonebot2 项目的 `.env` 文件中添加如下配置:
+
+|          配置项           | 必填  | 默认值  |            说明            |
+| :-----------------------: | :---: | :-----: | :------------------------: |
+|  `werewolf__enable_poke`  |  否   | `True`  | 是否使用戳一戳简化操作流程 |
+| `werewolf__enable_button` |  否   | `False` |    是否在交互中添加按钮    |
 
-|             配置项              | 必填 | 默认值 |                             说明                              |
-| :-----------------------------: | :--: | :----: | :-----------------------------------------------------------: |
-|     `werewolf__enable_poke`     |  否  | `True` | 是否使用戳一戳简化操作流程<br/>仅在 `OneBot V11` 适配器下生效 |
-|     `werewolf__role_preset`     |  否  |   -    |                    覆写插件内置的职业预设                     |
-|  `werewolf__werewolf_priority`  |  否  |   -    |                     自定义狼人职业优先级                      |
-| `werewolf__priesthood_proirity` |  否  |   -    |                     自定义神职职业优先级                      |
-|  `werewolf__joker_probability`  |  否  | `0.0`  |              小丑职业替换平民的概率, 范围`[0,1]`              |
+`werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
-`werewolf__role_preset`, `werewolf__werewolf_priority`, `werewolf__priesthood_proirity` 的配置格式请参考 [`游戏内容`](#游戏内容) 部分
+`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
 
 ## 🎉 使用
 
@@ -114,24 +115,31 @@ _✨ 简单的狼人杀插件 ✨_
 
 而对于野生机器人，现有协议端通常不支持或不建议使用临时私聊消息。
 
-在使用本插件前，应当确保机器人可以正常向玩家发送私聊消息。
+在使用本插件前，应当确保机器人可以正常向玩家发送私聊消息。~~即保证机器人与玩家为好友关系~~
 
 </details>
 
 ### 指令表
 
-|        指令         |    权限    | 需要@ | 范围 |                说明                 |
-| :-----------------: | :--------: | :---: | :--: | :---------------------------------: |
-| `werewolf`/`狼人杀` |    群员    |  是   | 群聊 |       发起游戏 (进入准备阶段)       |
-|     `开始游戏`      | 游戏发起者 |  是   | 群聊 |   _[准备阶段]_ 游戏发起者开始游戏   |
-|     `结束游戏`      | 游戏发起者 |  是   | 群聊 |   _[准备阶段]_ 游戏发起者结束游戏   |
-|     `当前玩家`      |    群员    |  是   | 群聊 | _[准备阶段]_ 列出参与游戏的玩家列表 |
-|     `加入游戏`      |    群员    |  是   | 群聊 |      _[准备阶段]_ 玩家加入游戏      |
-|     `退出游戏`      |    群员    |  是   | 群聊 |      _[准备阶段]_ 玩家退出游戏      |
+|        指令         |        权限         | 需要@ | 范围  |                   说明                    |
+| :-----------------: | :-----------------: | :---: | :---: | :---------------------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   | 群聊  |          发起游戏 (进入准备阶段)          |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊  |      _[准备阶段]_ 游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊  | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊  |    _[准备阶段]_ 列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   | 群聊  |      _[游戏内]_ 超级用户强制中止游戏      |
+|    `狼人杀预设`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏预设      |
+
+ - 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
+
+ - `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
 
-_其他交互参考游戏内提示_
+ - 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
+
+ - _其他交互参考游戏内提示_
 
-对于 `OneBot V11` 适配器, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `/stop` 命令
 
 ### 游戏内容
 
@@ -145,31 +153,22 @@ _其他交互参考游戏内提示_
 
 | 总人数 | 狼人 | 神职 | 平民 |
 | ------ | ---- | ---- | ---- |
-| 6      | 1    | 2    | 3    |
-| 7      | 2    | 2    | 3    |
-| 8      | 2    | 3    | 3    |
-| 9      | 2    | 4    | 3    |
-| 10     | 3    | 4    | 3    |
-| 11     | 3    | 5    | 3    |
-| 12     | 4    | 5    | 3    |
+| 6      | 1    | 2    | 3    |
+| 7      | 2    | 2    | 3    |
+| 8      | 2    | 3    | 3    |
+| 9      | 2    | 4    | 3    |
+| 10     | 3    | 4    | 3    |
+| 11     | 3    | 5    | 3    |
+| 12     | 4    | 5    | 3    |
 
-职业预设可以通过配置项 `werewolf__role_preset` 修改
+职业预设可以通过命令 `狼人杀预设 职业 ...` 修改
 
 <details>
 <summary>示例</summary>
 
-配置项 `werewolf__role_preset`
-
-```env
-werewolf__role_preset='
-[
-    [6, 1, 3, 2],
-    [7, 2, 3, 2]
-]
-'
-```
+ - 命令: `狼人杀预设 职业 6 1 3 2`
 
-上述配置中，`[6, 1, 3, 2]` 表示当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
+ - 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
 
 </details>
 <br/>
@@ -179,45 +178,43 @@ werewolf__role_preset='
 - `狼人`: `狼人`, `狼人`, `狼王`, `狼人`
 - `神职`: `女巫`, `预言家`, `猎人`, `守卫`, `白痴`
 
-职业分配优先级可以通过配置项 `werewolf__werewolf_priority` 和 `werewolf__priesthood_proirity` 修改
+职业分配优先级可以通过命令 `狼人杀预设 狼人/神职` 修改
 
 <details>
 <summary>示例</summary>
 
-#### 配置项 `werewolf__werewolf_priority`
+#### 命令 `狼人杀预设 狼人`
+
+ - 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
 
-```env
-werewolf__werewolf_priority=[1, 2, 1, 1]
-```
+ - 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
 
-上述配置中，`[1, 2, 1, 1]` 表示狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
+#### 命令 `狼人杀预设 神职`
 
-#### 配置项 `werewolf__priesthood_proirity`
+ - 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
 
-```env
-werewolf__priesthood_proirity=[11, 12, 13, 14, 15]
-```
+ - 上述命令指定狼人的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+
+> [!note]
+>
+> 以上两条命令均支持交互式输入
+>
+> 例：向机器人发送命令 `狼人杀预设 狼人`，在接下来的一条消息中发送 `狼人 狼王 狼人 狼人`
+>
+> 其效果等同于以上描述中的单条命令 `狼人杀预设 狼人 狼人 狼王 狼人 狼人`
 
-上述配置中，`[11, 12, 13, 14, 15]` 表示神职的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+</details>
+<br/>
 
-#### 职业与数字的对应关系
+对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 *一定概率* 将其中一个平民替换为小丑。
 
-上述配置示例中有大量~~意义不明的~~数字, 其对应的是 [`这里`](./nonebot_plugin_werewolf/constant.py) 的枚举类 `Role` 的值
+小丑属于第三方阵营，胜利条件为在投票阶段被票出，在预言家查验及游戏进程判断时视作平民。
 
-以下列出目前的枚举值供参考
+小丑生成概率可以通过命令 `狼人杀预设 小丑 <概率>` 设置，默认值为 0 (不生成小丑)。
 
-| 职业     | 枚举值 |
-| -------- | ------ |
-| `狼人`   | `1`    |
-| `狼王`   | `2`    |
-| `预言家` | `11`   |
-| `女巫`   | `12`   |
-| `猎人`   | `13`   |
-| `守卫`   | `14`   |
-| `白痴`   | `15`   |
-| `平民`   | `0`    |
+### 已知问题
 
-</details>
+- 截止 chronocat v0.2.19, 调用 [`guild.member.get`](https://github.com/chrononeko/chronocat/blob/8558ad9ff4319395d86abbfda22136939bf66780/packages/engine-chronocat-api/src/api/guild/member/get.ts) / [`user.get`](https://github.com/chrononeko/chronocat/blob/8558ad9ff4319395d86abbfda22136939bf66780/packages/engine-chronocat-api/src/api/user/get.ts) 均无法获取用户名，这将导致在交互过程中的玩家名显示为用户 ID
 
 ## 📝 更新日志
 
@@ -226,6 +223,19 @@ werewolf__priesthood_proirity=[11, 12, 13, 14, 15]
 
 <!-- CHANGELOG -->
 
+- 2024.10.31 v1.1.6
+
+  - 新增超级用户中止游戏 (#7)
+  - 新增快速发起上次游戏 (#8)
+  - 准备阶段添加可选的交互按钮
+  - 新增超级用户修改游戏预设 (#9)
+
+- 2024.10.23 v1.1.5
+
+  - 添加对 chronocat:poke 的支持
+  - 游戏内 stop 命令使用 COMMAND_START
+  - 使用 `anyio` 重写并发逻辑
+
 - 2024.10.06 v1.1.3
 
   - 使用 `RF-Tar-Railt/nonebot-plugin-uninfo` 获取用户数据

{nonebot_plugin_werewolf-1.1.3 → nonebot_plugin_werewolf-1.1.6}/nonebot_plugin_werewolf/__init__.py

@@ -2,6 +2,7 @@ from nonebot import require
 from nonebot.plugin import PluginMetadata, inherit_supported_adapters
 
 require("nonebot_plugin_alconna")
+require("nonebot_plugin_localstore")
 require("nonebot_plugin_uninfo")
 require("nonebot_plugin_waiter")
 
@@ -9,7 +10,7 @@ from . import matchers as matchers
 from . import players as players
 from .config import Config
 
-__version__ = "1.1.3"
+__version__ = "1.1.6"
 __plugin_meta__ = PluginMetadata(
     name="狼人杀",
     description="适用于 Nonebot2 的狼人杀插件",
@@ -24,6 +25,7 @@ __plugin_meta__ = PluginMetadata(
     ),
     extra={
         "Author": "wyf7685",
+        "Version": __version__,
         "Bug Tracker": "https://github.com/wyf7685/nonebot-plugin-werewolf/issues",
     },
 )

nonebot_plugin_werewolf-1.1.6/nonebot_plugin_werewolf/config.py

@@ -0,0 +1,45 @@
+import json
+
+from nonebot import get_plugin_config, logger
+from nonebot.compat import model_dump, type_validate_json
+from nonebot_plugin_localstore import get_plugin_data_file
+from pydantic import BaseModel, Field
+from typing_extensions import Self
+
+from .constant import (
+    default_priesthood_proirity,
+    default_role_preset,
+    default_werewolf_priority,
+)
+from .models import Role
+
+
+class PresetData(BaseModel):
+    role_preset: dict[int, tuple[int, int, int]] = default_role_preset.copy()
+    werewolf_priority: list[Role] = default_werewolf_priority.copy()
+    priesthood_proirity: list[Role] = default_priesthood_proirity.copy()
+    joker_probability: float = Field(default=0.0, ge=0.0, le=1.0)
+
+    @classmethod
+    def load(cls) -> Self:
+        return type_validate_json(cls, preset_data_file.read_text())
+
+    def save(self) -> None:
+        preset_data_file.write_text(json.dumps(model_dump(self)))
+
+
+class PluginConfig(BaseModel):
+    enable_poke: bool = True
+    enable_button: bool = False
+
+
+class Config(BaseModel):
+    werewolf: PluginConfig = PluginConfig()
+
+
+preset_data_file = get_plugin_data_file("preset.json")
+if not preset_data_file.exists():
+    PresetData().save()
+
+config = get_plugin_config(Config).werewolf
+logger.debug(f"加载插件配置: {config}")

nonebot_plugin_werewolf-1.1.6/nonebot_plugin_werewolf/constant.py

@@ -0,0 +1,74 @@
+import nonebot
+
+from .models import GameStatus, KillReason, Role, RoleGroup
+
+COMMAND_START = next(
+    iter(sorted(nonebot.get_driver().config.command_start, key=len)), ""
+)
+STOP_COMMAND_PROMPT = f"{COMMAND_START}stop"
+STOP_COMMAND = "{{stop}}"
+
+
+role_name_conv: dict[Role | RoleGroup, str] = {
+    Role.Werewolf: "狼人",
+    Role.WolfKing: "狼王",
+    Role.Prophet: "预言家",
+    Role.Witch: "女巫",
+    Role.Hunter: "猎人",
+    Role.Guard: "守卫",
+    Role.Idiot: "白痴",
+    Role.Joker: "小丑",
+    Role.Civilian: "平民",
+    RoleGroup.Werewolf: "狼人",
+    RoleGroup.GoodGuy: "好人",
+    RoleGroup.Others: "其他",
+}
+
+role_emoji: dict[Role, str] = {
+    Role.Werewolf: "🐺",
+    Role.WolfKing: "🐺👑",
+    Role.Prophet: "🔮",
+    Role.Witch: "🧙‍♀️",
+    Role.Hunter: "🕵️",
+    Role.Guard: "🛡️",
+    Role.Idiot: "👨🏻‍🦲",
+    Role.Joker: "🤡",
+    Role.Civilian: "👨🏻‍🌾",
+}
+
+game_status_conv: dict[GameStatus, str] = {
+    GameStatus.GoodGuy: "好人",
+    GameStatus.Werewolf: "狼人",
+    GameStatus.Joker: "小丑",
+}
+
+report_text: dict[KillReason, tuple[str, str]] = {
+    KillReason.Werewolf: ("🔪", "刀了"),
+    KillReason.Poison: ("🧪", "毒死"),
+    KillReason.Shoot: ("🔫", "射杀"),
+    KillReason.Vote: ("🗳️", "票出"),
+}
+
+default_role_preset: dict[int, tuple[int, int, int]] = {
+    # 总人数: (狼, 神, 民)
+    6: (1, 2, 3),
+    7: (2, 2, 3),
+    8: (2, 3, 3),
+    9: (2, 4, 3),
+    10: (3, 4, 3),
+    11: (3, 5, 3),
+    12: (4, 5, 3),
+}
+default_werewolf_priority: list[Role] = [
+    Role.Werewolf,
+    Role.Werewolf,
+    Role.WolfKing,
+    Role.Werewolf,
+]
+default_priesthood_proirity: list[Role] = [
+    Role.Witch,
+    Role.Prophet,
+    Role.Hunter,
+    Role.Guard,
+    Role.Idiot,
+]

{nonebot_plugin_werewolf-1.1.3 → nonebot_plugin_werewolf-1.1.6}/nonebot_plugin_werewolf/exception.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from .constant import GameStatus
+    from .models import GameStatus
 
 
 class Error(Exception):