nonebot-plugin-werewolf 1.1.9__tar.gz → 1.1.11__tar.gz

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-werewolf
-Version: 1.1.9
+Version: 1.1.11
 Summary: 适用于 Nonebot2 的狼人杀插件
 Author-email: wyf7685 <wyf7685@163.com>
 License: MIT
@@ -10,11 +10,11 @@ Project-URL: bug-tracker, https://github.com/wyf7685/nonebot-plugin-werewolf/iss
 Requires-Python: >=3.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: nonebot2>=2.4.0
+Requires-Dist: nonebot-plugin-alconna>=0.57.0
 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: nonebot-plugin-uninfo>=0.7.3
+Requires-Dist: nonebot-plugin-waiter>=0.8.0
 Requires-Dist: anyio>=4.6.0
 Dynamic: license-file
 
@@ -39,7 +39,8 @@ _✨ 简单的狼人杀插件 ✨_
 [![pre-commit](https://results.pre-commit.ci/badge/github/wyf7685/nonebot-plugin-werewolf/master.svg)](https://results.pre-commit.ci/latest/github/wyf7685/nonebot-plugin-werewolf/master)
 [![lint](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/lint.yml/badge.svg?branch=master&event=push)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/lint.yml)
 
-<!-- https://github.com/lgc2333/nonebot-registry-badge -->
+<!-- ref: 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)
 
@@ -53,7 +54,7 @@ _✨ 简单的狼人杀插件 ✨_
 
 > [!note]
 >
-> 请确保 NoneBot2 使用的 Python 解释器版本 >=3.10
+> 请确保 [NoneBot2](https://nonebot.dev/) 使用的 Python 解释器版本 >=3.10
 
 <details open>
 <summary>使用 nb-cli 安装</summary>
@@ -65,12 +66,14 @@ _✨ 简单的狼人杀插件 ✨_
 
 <details>
 <summary>使用包管理器安装</summary>
+<!-- 会用包管理器的用户真的需要这节吗 -->
+
 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
 
-<details>
-<summary>pip</summary>
+<details open>
+<summary>uv</summary>
 
-    pip install nonebot-plugin-werewolf
+    uv add nonebot-plugin-werewolf
 
 </details>
 <details>
@@ -90,6 +93,12 @@ _✨ 简单的狼人杀插件 ✨_
 
     conda install nonebot-plugin-werewolf
 
+</details>
+<details>
+<summary>pip</summary>
+
+    pip install nonebot-plugin-werewolf
+
 </details>
 
 打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
@@ -102,16 +111,39 @@ _✨ 简单的狼人杀插件 ✨_
 
 在 nonebot2 项目的 `.env` 文件中添加如下配置:
 
-|          配置项           | 必填  | 默认值  |             说明             |
-| :-----------------------: | :---: | :-----: | :--------------------------: |
-|  `werewolf__enable_poke`  |  否   | `True`  |  是否使用戳一戳简化操作流程  |
-| `werewolf__enable_button` |  否   | `False` |     是否在交互中添加按钮     |
-| `werewolf__stop_command`  |  否   | `stop`  | 修改游戏进程中的 `stop` 命令 |
+|            配置项            | 必填 | 默认值  |           类型            |              说明              |
+| :--------------------------: | :--: | :-----: | :-----------------------: | :----------------------------: |
+|   `werewolf__enable_poke`    |  否  | `True`  |          `bool`           |   是否使用戳一戳简化操作流程   |
+|  `werewolf__enable_button`   |  否  | `False` |          `bool`           |      是否在交互中添加按钮      |
+|   `werewolf__stop_command`   |  否  | `stop`  |     `str \| set[str]`     |  修改游戏进程中的 `stop` 命令  |
+|    `werewolf__require_at`    |  否  | `True`  | `bool \| RequireAtConfig` | 部分命令是否需要 at 机器人触发 |
+| `werewolf__matcher_priority` |  否  |    -    |  `MatcherPriorityConfig`  | 配置插件 matcher 注册的优先级  |
 
 `werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
 `werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
 
+<details>
+<summary> werewolf__require_at 示例 </summary>
+
+```ini
+# 所有命令均需 at 触发
+werewolf__require_at=true
+
+# 所有命令均不需 at 触发
+werewolf__require_at=false
+
+# 狼人杀命令需要 at, 中止游戏命令不需要 at
+werewolf__require_at='{"start": true, "terminate": false}'
+```
+</details>
+<br/>
+
+`werewolf__matcher_priority` 的 matcher 优先级参考 [官方文档](https://nonebot.dev/docs/advanced/matcher#%E5%93%8D%E5%BA%94%E4%BC%98%E5%85%88%E7%BA%A7)
+  - 一般情况下不需要修改此配置, 插件的默认优先级可以参考 [这里](./nonebot_plugin_werewolf/config.py) 的 `MatcherPriorityConfig`
+  - 如果遇到与其他插件的命令冲突, 可考虑修改此处的优先级配置
+  - 配置应填入 JSON 对象, 可用键: `start` `terminate` `preset` `behavior` `in_game` `stop`
+
 ## 🎉 使用
 
 > [!note]
@@ -135,28 +167,29 @@ _✨ 简单的狼人杀插件 ✨_
 
 ### 指令表
 
-|        指令         |        权限         | 需要@ | 范围  |                   说明                    |
-| :-----------------: | :-----------------: | :---: | :---: | :---------------------------------------: |
-| `werewolf`/`狼人杀` |        群员         |  是   | 群聊  |          发起游戏 (进入准备阶段)          |
-|     `开始游戏`      |     游戏发起者      |  否   | 群聊  |      _[准备阶段]_ 游戏发起者开始游戏      |
-|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊  | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
-|     `当前玩家`      |        群员         |  否   | 群聊  |    _[准备阶段]_ 列出参与游戏的玩家列表    |
-|     `加入游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家加入游戏         |
-|     `退出游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家退出游戏         |
-|     `中止游戏`      |      超级用户       |  是   | 群聊  |      _[游戏内]_ 超级用户强制中止游戏      |
-|    `狼人杀预设`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏预设      |
-|    `狼人杀配置`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏配置      |
+|        指令         |        权限         | 需要@ | 范围 |                   说明                    |
+| :-----------------: | :-----------------: | :---: | :--: | :---------------------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   | 群聊 |          发起游戏 (进入准备阶段)          |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊 |      _[准备阶段]_ 游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊 |    _[准备阶段]_ 列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   | 群聊 |      _[游戏内]_ 超级用户强制中止游戏      |
+|    `狼人杀预设`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏预设      |
+|    `狼人杀配置`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏配置      |
 
- - 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
+- `超级用户` 为 nonebot2 配置项中的 `SUPERUSERS`, 配置说明参考 [官方文档](https://nonebot.dev/docs/appendices/config#superusers)
 
- - `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
+- 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
 
- - `狼人杀配置` 命令用法可通过 `狼人杀预设 --help` 获取
+- `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
 
- - 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
+- `狼人杀配置` 命令用法可通过 `狼人杀预设 --help` 获取
 
- - _其他交互参考游戏内提示_
+- 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
 
+- _其他交互参考游戏内提示_
 
 ### 游戏内容
 
@@ -183,9 +216,9 @@ _✨ 简单的狼人杀插件 ✨_
 <details>
 <summary>示例</summary>
 
- - 命令: `狼人杀预设 职业 6 1 3 2`
+- 命令: `狼人杀预设 职业 6 1 3 2`
 
- - 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
+- 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
 
 </details>
 <br/>
@@ -202,19 +235,19 @@ _✨ 简单的狼人杀插件 ✨_
 
 #### 命令 `狼人杀预设 狼人`
 
- - 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
+- 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
 
- - 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
+- 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
 
 #### 命令 `狼人杀预设 神职`
 
- - 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
+- 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
 
- - 上述命令指定狼人的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+- 上述命令指定神职的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
 
 > [!note]
 >
-> 以上两条命令均支持交互式输入
+> 以上两条命令均支持交互式输入 ~~waiter 真好用~~
 >
 > 例：向机器人发送命令 `狼人杀预设 狼人`，在接下来的一条消息中发送 `狼人 狼王 狼人 狼人`
 >
@@ -223,7 +256,7 @@ _✨ 简单的狼人杀插件 ✨_
 </details>
 <br/>
 
-对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 *一定概率* 将其中一个平民替换为小丑。
+对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 _一定概率_ 将其中一个平民替换为小丑。
 
 小丑属于第三方阵营，胜利条件为在投票阶段被票出，在预言家查验及游戏进程判断时视作平民。
 
@@ -231,8 +264,13 @@ _✨ 简单的狼人杀插件 ✨_
 
 ### 已知问题
 
+<details>
+    <summary>已知问题</summary>
+
 - 截止 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
 
+</details>
+
 ## 📝 更新日志
 
 <details>
@@ -240,11 +278,21 @@ _✨ 简单的狼人杀插件 ✨_
 
 <!-- CHANGELOG -->
 
+- 2025.04.20 v1.1.11
+
+  - 添加配置项 `werewolf__require_at`, 用于配置命令是否需要 at 机器人触发
+  - 添加配置项 `werewolf__matcher_priority`, 用于配置插件 matcher 注册优先级
+
+- 2025.04.17 v1.1.10
+
+  - 添加狼人多选目标配置项显示
+  - 在游戏开始时打乱并固定轮流发言模式的发言顺序 (#20)
+
 - 2025.04.15 v1.1.9
 
   - 添加游戏行为配置 `werewolf_multi_select`
   - 重构玩家类
-  - 添加轮流发言模式缺失的 at 消息段
+  - 添加轮流发言模式缺失的 at 消息段 (#19)
 
 - 2025.02.13 v1.1.8
 
@@ -254,7 +302,7 @@ _✨ 简单的狼人杀插件 ✨_
 
 - 2024.10.31 v1.1.7
 
-  - *Bug fix*
+  - _Bug fix_
 
 - 2024.10.31 v1.1.6
 

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/README.md

@@ -19,7 +19,8 @@ _✨ 简单的狼人杀插件 ✨_
 [![pre-commit](https://results.pre-commit.ci/badge/github/wyf7685/nonebot-plugin-werewolf/master.svg)](https://results.pre-commit.ci/latest/github/wyf7685/nonebot-plugin-werewolf/master)
 [![lint](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/lint.yml/badge.svg?branch=master&event=push)](https://github.com/wyf7685/nonebot-plugin-werewolf/actions/workflows/lint.yml)
 
-<!-- https://github.com/lgc2333/nonebot-registry-badge -->
+<!-- ref: 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)
 
@@ -33,7 +34,7 @@ _✨ 简单的狼人杀插件 ✨_
 
 > [!note]
 >
-> 请确保 NoneBot2 使用的 Python 解释器版本 >=3.10
+> 请确保 [NoneBot2](https://nonebot.dev/) 使用的 Python 解释器版本 >=3.10
 
 <details open>
 <summary>使用 nb-cli 安装</summary>
@@ -45,12 +46,14 @@ _✨ 简单的狼人杀插件 ✨_
 
 <details>
 <summary>使用包管理器安装</summary>
+<!-- 会用包管理器的用户真的需要这节吗 -->
+
 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
 
-<details>
-<summary>pip</summary>
+<details open>
+<summary>uv</summary>
 
-    pip install nonebot-plugin-werewolf
+    uv add nonebot-plugin-werewolf
 
 </details>
 <details>
@@ -70,6 +73,12 @@ _✨ 简单的狼人杀插件 ✨_
 
     conda install nonebot-plugin-werewolf
 
+</details>
+<details>
+<summary>pip</summary>
+
+    pip install nonebot-plugin-werewolf
+
 </details>
 
 打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
@@ -82,16 +91,39 @@ _✨ 简单的狼人杀插件 ✨_
 
 在 nonebot2 项目的 `.env` 文件中添加如下配置:
 
-|          配置项           | 必填  | 默认值  |             说明             |
-| :-----------------------: | :---: | :-----: | :--------------------------: |
-|  `werewolf__enable_poke`  |  否   | `True`  |  是否使用戳一戳简化操作流程  |
-| `werewolf__enable_button` |  否   | `False` |     是否在交互中添加按钮     |
-| `werewolf__stop_command`  |  否   | `stop`  | 修改游戏进程中的 `stop` 命令 |
+|            配置项            | 必填 | 默认值  |           类型            |              说明              |
+| :--------------------------: | :--: | :-----: | :-----------------------: | :----------------------------: |
+|   `werewolf__enable_poke`    |  否  | `True`  |          `bool`           |   是否使用戳一戳简化操作流程   |
+|  `werewolf__enable_button`   |  否  | `False` |          `bool`           |      是否在交互中添加按钮      |
+|   `werewolf__stop_command`   |  否  | `stop`  |     `str \| set[str]`     |  修改游戏进程中的 `stop` 命令  |
+|    `werewolf__require_at`    |  否  | `True`  | `bool \| RequireAtConfig` | 部分命令是否需要 at 机器人触发 |
+| `werewolf__matcher_priority` |  否  |    -    |  `MatcherPriorityConfig`  | 配置插件 matcher 注册的优先级  |
 
 `werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
 `werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
 
+<details>
+<summary> werewolf__require_at 示例 </summary>
+
+```ini
+# 所有命令均需 at 触发
+werewolf__require_at=true
+
+# 所有命令均不需 at 触发
+werewolf__require_at=false
+
+# 狼人杀命令需要 at, 中止游戏命令不需要 at
+werewolf__require_at='{"start": true, "terminate": false}'
+```
+</details>
+<br/>
+
+`werewolf__matcher_priority` 的 matcher 优先级参考 [官方文档](https://nonebot.dev/docs/advanced/matcher#%E5%93%8D%E5%BA%94%E4%BC%98%E5%85%88%E7%BA%A7)
+  - 一般情况下不需要修改此配置, 插件的默认优先级可以参考 [这里](./nonebot_plugin_werewolf/config.py) 的 `MatcherPriorityConfig`
+  - 如果遇到与其他插件的命令冲突, 可考虑修改此处的优先级配置
+  - 配置应填入 JSON 对象, 可用键: `start` `terminate` `preset` `behavior` `in_game` `stop`
+
 ## 🎉 使用
 
 > [!note]
@@ -115,28 +147,29 @@ _✨ 简单的狼人杀插件 ✨_
 
 ### 指令表
 
-|        指令         |        权限         | 需要@ | 范围  |                   说明                    |
-| :-----------------: | :-----------------: | :---: | :---: | :---------------------------------------: |
-| `werewolf`/`狼人杀` |        群员         |  是   | 群聊  |          发起游戏 (进入准备阶段)          |
-|     `开始游戏`      |     游戏发起者      |  否   | 群聊  |      _[准备阶段]_ 游戏发起者开始游戏      |
-|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊  | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
-|     `当前玩家`      |        群员         |  否   | 群聊  |    _[准备阶段]_ 列出参与游戏的玩家列表    |
-|     `加入游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家加入游戏         |
-|     `退出游戏`      |        群员         |  否   | 群聊  |         _[准备阶段]_ 玩家退出游戏         |
-|     `中止游戏`      |      超级用户       |  是   | 群聊  |      _[游戏内]_ 超级用户强制中止游戏      |
-|    `狼人杀预设`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏预设      |
-|    `狼人杀配置`     |      超级用户       |  否   | 任意  |      _[游戏外]_ 超级用户编辑游戏配置      |
+|        指令         |        权限         | 需要@ | 范围 |                   说明                    |
+| :-----------------: | :-----------------: | :---: | :--: | :---------------------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   | 群聊 |          发起游戏 (进入准备阶段)          |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊 |      _[准备阶段]_ 游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊 |    _[准备阶段]_ 列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   | 群聊 |      _[游戏内]_ 超级用户强制中止游戏      |
+|    `狼人杀预设`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏预设      |
+|    `狼人杀配置`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏配置      |
 
- - 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
+- `超级用户` 为 nonebot2 配置项中的 `SUPERUSERS`, 配置说明参考 [官方文档](https://nonebot.dev/docs/appendices/config#superusers)
 
- - `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
+- 发起游戏时添加 `restart`/`重开`, 可加载上一次游戏的玩家列表, 快速发起游戏。例: `werewolf restart`/`狼人杀 重开`
 
- - `狼人杀配置` 命令用法可通过 `狼人杀预设 --help` 获取
+- `狼人杀预设` 命令用法可通过 `狼人杀预设 --help` 获取，或参考 [游戏内容](#游戏内容) 部分的介绍
 
- - 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
+- `狼人杀配置` 命令用法可通过 `狼人杀预设 --help` 获取
 
- - _其他交互参考游戏内提示_
+- 对于 `OneBot V11` 适配器和 `Satori` 适配器的 `chronocat`, 启用配置项 `werewolf__enable_poke` 后, 可以使用戳一戳代替 _准备阶段_ 的 `加入游戏` 操作 和 游戏内的 `stop` 命令
 
+- _其他交互参考游戏内提示_
 
 ### 游戏内容
 
@@ -163,9 +196,9 @@ _✨ 简单的狼人杀插件 ✨_
 <details>
 <summary>示例</summary>
 
- - 命令: `狼人杀预设 职业 6 1 3 2`
+- 命令: `狼人杀预设 职业 6 1 3 2`
 
- - 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
+- 上述命令指定当总人数为 6 时，狼人、神职、平民的数量分别为 1、3、2
 
 </details>
 <br/>
@@ -182,19 +215,19 @@ _✨ 简单的狼人杀插件 ✨_
 
 #### 命令 `狼人杀预设 狼人`
 
- - 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
+- 命令: `狼人杀预设 狼人 狼 狼王 狼 狼`
 
- - 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
+- 上述命令指定狼人的职业优先级为 `狼人`, `狼王`, `狼人`, `狼人`
 
 #### 命令 `狼人杀预设 神职`
 
- - 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
+- 命令: `狼人杀预设 神职 预言家 女巫 猎人 守卫 白痴`
 
- - 上述命令指定狼人的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
+- 上述命令指定神职的职业优先级为 `预言家`, `女巫`, `猎人`, `守卫`, `白痴`
 
 > [!note]
 >
-> 以上两条命令均支持交互式输入
+> 以上两条命令均支持交互式输入 ~~waiter 真好用~~
 >
 > 例：向机器人发送命令 `狼人杀预设 狼人`，在接下来的一条消息中发送 `狼人 狼王 狼人 狼人`
 >
@@ -203,7 +236,7 @@ _✨ 简单的狼人杀插件 ✨_
 </details>
 <br/>
 
-对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 *一定概率* 将其中一个平民替换为小丑。
+对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 _一定概率_ 将其中一个平民替换为小丑。
 
 小丑属于第三方阵营，胜利条件为在投票阶段被票出，在预言家查验及游戏进程判断时视作平民。
 
@@ -211,8 +244,13 @@ _✨ 简单的狼人杀插件 ✨_
 
 ### 已知问题
 
+<details>
+    <summary>已知问题</summary>
+
 - 截止 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
 
+</details>
+
 ## 📝 更新日志
 
 <details>
@@ -220,11 +258,21 @@ _✨ 简单的狼人杀插件 ✨_
 
 <!-- CHANGELOG -->
 
+- 2025.04.20 v1.1.11
+
+  - 添加配置项 `werewolf__require_at`, 用于配置命令是否需要 at 机器人触发
+  - 添加配置项 `werewolf__matcher_priority`, 用于配置插件 matcher 注册优先级
+
+- 2025.04.17 v1.1.10
+
+  - 添加狼人多选目标配置项显示
+  - 在游戏开始时打乱并固定轮流发言模式的发言顺序 (#20)
+
 - 2025.04.15 v1.1.9
 
   - 添加游戏行为配置 `werewolf_multi_select`
   - 重构玩家类
-  - 添加轮流发言模式缺失的 at 消息段
+  - 添加轮流发言模式缺失的 at 消息段 (#19)
 
 - 2025.02.13 v1.1.8
 
@@ -234,7 +282,7 @@ _✨ 简单的狼人杀插件 ✨_
 
 - 2024.10.31 v1.1.7
 
-  - *Bug fix*
+  - _Bug fix_
 
 - 2024.10.31 v1.1.6
 

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/nonebot_plugin_werewolf/__init__.py

@@ -10,7 +10,7 @@ from . import matchers as matchers
 from . import players as players
 from .config import Config
 
-__version__ = "1.1.9"
+__version__ = "1.1.11"
 __plugin_meta__ = PluginMetadata(
     name="狼人杀",
     description="适用于 Nonebot2 的狼人杀插件",

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/nonebot_plugin_werewolf/config.py

@@ -1,6 +1,6 @@
 import json
 from pathlib import Path
-from typing import Any, ClassVar, Final
+from typing import Any, ClassVar, Final, Literal
 from typing_extensions import Self
 
 import nonebot
@@ -83,10 +83,26 @@ class GameBehavior(ConfigFile):
     timeout: Final[_Timeout] = _Timeout()
 
 
+class RequireAtConfig(BaseModel):
+    start: bool = True
+    terminate: bool = True
+
+
+class MatcherPriorityConfig(BaseModel):
+    start: int = 1
+    terminate: int = 1
+    preset: int = 1
+    behavior: int = 1
+    in_game: int = 10
+    stop: int = 10
+
+
 class PluginConfig(BaseModel):
     enable_poke: bool = True
     enable_button: bool = False
     stop_command: str | set[str] = "stop"
+    require_at: bool | RequireAtConfig = True
+    matcher_priority: MatcherPriorityConfig = MatcherPriorityConfig()
 
     def get_stop_command(self) -> list[str]:
         return (
@@ -95,6 +111,11 @@ class PluginConfig(BaseModel):
             else sorted(self.stop_command, key=len)
         )
 
+    def get_require_at(self, cmd: Literal["start", "terminate"]) -> bool:
+        if isinstance(self.require_at, bool):
+            return self.require_at
+        return getattr(self.require_at, cmd)
+
 
 class Config(BaseModel):
     werewolf: PluginConfig = PluginConfig()

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/nonebot_plugin_werewolf/constant.py

@@ -1,20 +1,18 @@
 import functools
 from typing import TYPE_CHECKING
 
-import nonebot
-
 from .models import GameStatus, KillReason, Role, RoleGroup
 
 STOP_COMMAND = "{{stop}}"
-COMMAND_START = next(
-    iter(sorted(nonebot.get_driver().config.command_start, key=len)), ""
-)
 
 
 def stop_command_prompt() -> str:
+    import nonebot
+
     from .config import config  # circular import
 
-    return COMMAND_START + config.get_stop_command()[0]
+    cmd_starts = sorted(nonebot.get_driver().config.command_start, key=len)
+    return next(iter(cmd_starts), "") + config.get_stop_command()[0]
 
 
 if not TYPE_CHECKING:

{nonebot_plugin_werewolf-1.1.9 → nonebot_plugin_werewolf-1.1.11}/nonebot_plugin_werewolf/game.py

@@ -1,7 +1,7 @@
 import contextlib
 import functools
 import secrets
-from collections import defaultdict
+from collections import Counter
 from typing import NoReturn, final
 from typing_extensions import Self
 
@@ -10,8 +10,8 @@ import nonebot
 from nonebot.adapters import Bot
 from nonebot.utils import escape_tag
 from nonebot_plugin_alconna import At, Target, UniMessage
-from nonebot_plugin_alconna.uniseg.message import Receipt
-from nonebot_plugin_uninfo import Interface, SceneType
+from nonebot_plugin_alconna.uniseg.receipt import Receipt
+from nonebot_plugin_uninfo import Interface, Scene, SceneType
 
 from .config import GameBehavior, PresetData
 from .constant import GAME_STATUS_CONV, REPORT_TEXT, ROLE_EMOJI, ROLE_NAME_CONV
@@ -162,11 +162,10 @@ class Game:
         self.state = GameState(0)
         self.killed_players = []
         self._player_map: dict[str, Player] = {}
-        self._scene = None
-        self._finished = None
-        self._task_group = None
-        self._send_handler = _SendHandler()
-        self._send_handler.update(group, bot)
+        self._shuffled: list[Player] = []
+        self._scene: Scene | None = None
+        self._finished = self._task_group = None
+        self._send_handler = _SendHandler(group, bot)
 
     @final
     @classmethod
@@ -185,6 +184,7 @@ class Game:
 
         self.players = await init_players(bot, self, players, interface)
         self._player_map |= {p.user_id: p for p in self.players}
+        self._shuffled = self.players.shuffled
 
         return self
 
@@ -258,12 +258,9 @@ class Game:
         )
 
         if self.behavior.show_roles_list_on_start:
-            role_cnt: dict[Role, int] = defaultdict(lambda: 0)
-            for role in sorted((p.role for p in self.players), key=lambda r: r.value):
-                role_cnt[role] += 1
-
             msg.text("\n\n📚职业列表:\n")
-            for role, cnt in role_cnt.items():
+            counter = Counter(p.role for p in self.players)
+            for role, cnt in sorted(counter.items(), key=lambda x: x[0].value):
                 msg.text(f"- {ROLE_EMOJI[role]}{ROLE_NAME_CONV[role]}x{cnt}\n")
 
         async with anyio.create_task_group() as tg:
@@ -340,23 +337,24 @@ class Game:
         timeout = self.behavior.timeout
 
         if not self.behavior.speak_in_turn:
-            speak_timeout = timeout.group_speak
             await self.send(
                 f"💬接下来开始自由讨论\n{timeout.group_speak_timeout_prompt}",
                 stop_btn_label="结束发言",
             )
-            await self.wait_stop(*self.players.alive(), timeout_secs=speak_timeout)
+            await self.wait_stop(
+                *self.players.alive(),
+                timeout_secs=timeout.group_speak,
+            )
         else:
             await self.send("💬接下来开始轮流发言")
-            speak_timeout = timeout.speak
-            for player in self.players.alive().sorted:
+            for player in filter(lambda p: p.alive, self._shuffled):
                 await self.send(
                     UniMessage.text("💬")
                     .at(player.user_id)
                     .text(f"\n轮到你发言\n{timeout.speak_timeout_prompt}"),
                     stop_btn_label="结束发言",
                 )
-                await self.wait_stop(player, timeout_secs=speak_timeout)
+                await self.wait_stop(player, timeout_secs=timeout.speak)
             await self.send("💬所有玩家发言结束")
 
     async def run_vote(self) -> None: