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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nonebot-plugin-werewolf
-Version: 1.1.11
+Version: 1.1.13
 Summary: 适用于 Nonebot2 的狼人杀插件
 Author-email: wyf7685 <wyf7685@163.com>
 License: MIT
@@ -11,9 +11,9 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: nonebot2>=2.4.0
-Requires-Dist: nonebot-plugin-alconna>=0.57.0
+Requires-Dist: nonebot-plugin-alconna>=0.58.0
 Requires-Dist: nonebot-plugin-localstore>=0.7.1
-Requires-Dist: nonebot-plugin-uninfo>=0.7.3
+Requires-Dist: nonebot-plugin-uninfo>=0.8.0
 Requires-Dist: nonebot-plugin-waiter>=0.8.0
 Requires-Dist: anyio>=4.6.0
 Dynamic: license-file
@@ -50,6 +50,22 @@ _✨ 简单的狼人杀插件 ✨_
 
 和朋友们来一场紧张刺激的狼人杀游戏
 
+<!-- ref: https://github.com/KomoriDev/Starify -->
+
+> [!IMPORTANT]
+>
+> **收藏项目**，你将从 GitHub 上无延迟地接收所有发布通知～ ⭐️
+
+<img width="100%" src="https://starify.komoridevs.icu/api/starify?owner=wyf7685&repo=nonebot-plugin-werewolf" alt="starify" />
+
+<details>
+  <summary><kbd>Star History</kbd></summary>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wyf7685/nonebot-plugin-werewolf&theme=dark&type=Date" />
+    <img width="100%" src="https://star-history.com/#wyf7685/nonebot-plugin-werewolf&Date" />
+  </picture>
+</details>
+
 ## 💿 安装
 
 > [!note]
@@ -111,17 +127,18 @@ _✨ 简单的狼人杀插件 ✨_
 
 在 nonebot2 项目的 `.env` 文件中添加如下配置:
 
-|            配置项            | 必填 | 默认值  |           类型            |              说明              |
-| :--------------------------: | :--: | :-----: | :-----------------------: | :----------------------------: |
-|   `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`    |  否  | `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__use_cmd_start`   |  否  | `None`  |      `bool \| None`       | 是否使用配置项 `COMMAND_START` 来作为命令前缀 |
 
 `werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
-`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
+`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性，如有疑问欢迎提出。
 
 <details>
 <summary> werewolf__require_at 示例 </summary>
@@ -136,15 +153,18 @@ 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`
 
-## 🎉 使用
+- 一般情况下不需要修改此配置, 插件的默认优先级可以参考 [这里](./nonebot_plugin_werewolf/config.py) 的 `MatcherPriorityConfig`
+- 如果遇到与其他插件的命令冲突, 可考虑修改此处的优先级配置
+- 配置应填入 JSON 对象, 可用键: `start` `terminate` `preset` `behavior` `in_game` `stop`
+
+`werewolf__use_cmd_start` 为 `None` 时，使用 alc 的 [全局配置](https://nonebot.dev/docs/next/best-practice/alconna/config#alconna_use_command_start)
+
+## 🚀 使用
 
 > [!note]
 >
@@ -165,19 +185,19 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 </details>
 
-### 指令表
+### 📋 指令表
 
-|        指令         |        权限         | 需要@ | 范围 |                   说明                    |
-| :-----------------: | :-----------------: | :---: | :--: | :---------------------------------------: |
-| `werewolf`/`狼人杀` |        群员         |  是   | 群聊 |          发起游戏 (进入准备阶段)          |
-|     `开始游戏`      |     游戏发起者      |  否   | 群聊 |      _[准备阶段]_ 游戏发起者开始游戏      |
-|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
-|     `当前玩家`      |        群员         |  否   | 群聊 |    _[准备阶段]_ 列出参与游戏的玩家列表    |
-|     `加入游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家加入游戏         |
-|     `退出游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家退出游戏         |
-|     `中止游戏`      |      超级用户       |  是   | 群聊 |      _[游戏内]_ 超级用户强制中止游戏      |
-|    `狼人杀预设`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏预设      |
-|    `狼人杀配置`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏配置      |
+|        指令         |        权限         | 需要@ |       范围        |             说明             |
+| :-----------------: | :-----------------: | :---: | :---------------: | :--------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   |  群聊 _[游戏外]_  |   发起游戏 (进入准备阶段)    |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊 _[准备阶段]_ |      游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 _[准备阶段]_ | 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊 _[准备阶段]_ |    列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊 _[准备阶段]_ |         玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊 _[准备阶段]_ |         玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   |  群聊 _[游戏内]_  |     超级用户强制中止游戏     |
+|    `狼人杀预设`     |      超级用户       |  否   |  任意 _[游戏外]_  |     超级用户编辑游戏预设     |
+|    `狼人杀配置`     |      超级用户       |  否   |  任意 _[游戏外]_  |     超级用户编辑游戏配置     |
 
 - `超级用户` 为 nonebot2 配置项中的 `SUPERUSERS`, 配置说明参考 [官方文档](https://nonebot.dev/docs/appendices/config#superusers)
 
@@ -191,7 +211,7 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 - _其他交互参考游戏内提示_
 
-### 游戏内容
+### 🎭 游戏内容
 
 > [!note]
 >
@@ -202,14 +222,14 @@ werewolf__require_at='{"start": true, "terminate": false}'
 插件中保存了一份 [职业预设](./nonebot_plugin_werewolf/constant.py), 内容如下
 
 | 总人数 | 狼人 | 神职 | 平民 |
-| ------ | ---- | ---- | ---- |
-| 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   |
 
 职业预设可以通过命令 `狼人杀预设 职业 ...` 修改
 
@@ -254,7 +274,6 @@ werewolf__require_at='{"start": true, "terminate": false}'
 > 其效果等同于以上描述中的单条命令 `狼人杀预设 狼人 狼人 狼王 狼人 狼人`
 
 </details>
-<br/>
 
 对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 _一定概率_ 将其中一个平民替换为小丑。
 
@@ -262,12 +281,14 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 小丑生成概率可以通过命令 `狼人杀预设 小丑 <概率>` 设置，默认值为 0 (不生成小丑)。
 
-### 已知问题
+### 🔧 已知问题
 
 <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
+- 截止 chronocat [v0.2.19](https://github.com/chrononeko/chronocat/tree/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
+
+- v1.1.6 添加的按钮操作在 `discord` 适配器中不可用, 已在 v1.1.12 禁用 (2e31d43)
 
 </details>
 
@@ -278,6 +299,15 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 <!-- CHANGELOG -->
 
+- 2025.06.04 v1.1.13
+
+  - 添加配置项 `werewolf__use_cmd_start`, 用于配置插件命令前缀
+  - 调整 v1.1.11 优先级配置的默认值
+
+- 2025.06.01 v1.1.12
+
+  - 禁用 `discord` 适配器中的按钮操作 ~~以后会写适配的...吗?~~
+
 - 2025.04.20 v1.1.11
 
   - 添加配置项 `werewolf__require_at`, 用于配置命令是否需要 at 机器人触发
@@ -362,7 +392,7 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 </details>
 
-## 鸣谢
+## 🎉 鸣谢
 
 - [`nonebot/nonebot2`](https://github.com/nonebot/nonebot2): 跨平台 Python 异步机器人框架
 - [`nonebot/plugin-alconna`](https://github.com/nonebot/plugin-alconna): 跨平台的消息处理接口

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

@@ -30,6 +30,22 @@ _✨ 简单的狼人杀插件 ✨_
 
 和朋友们来一场紧张刺激的狼人杀游戏
 
+<!-- ref: https://github.com/KomoriDev/Starify -->
+
+> [!IMPORTANT]
+>
+> **收藏项目**，你将从 GitHub 上无延迟地接收所有发布通知～ ⭐️
+
+<img width="100%" src="https://starify.komoridevs.icu/api/starify?owner=wyf7685&repo=nonebot-plugin-werewolf" alt="starify" />
+
+<details>
+  <summary><kbd>Star History</kbd></summary>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wyf7685/nonebot-plugin-werewolf&theme=dark&type=Date" />
+    <img width="100%" src="https://star-history.com/#wyf7685/nonebot-plugin-werewolf&Date" />
+  </picture>
+</details>
+
 ## 💿 安装
 
 > [!note]
@@ -91,17 +107,18 @@ _✨ 简单的狼人杀插件 ✨_
 
 在 nonebot2 项目的 `.env` 文件中添加如下配置:
 
-|            配置项            | 必填 | 默认值  |           类型            |              说明              |
-| :--------------------------: | :--: | :-----: | :-----------------------: | :----------------------------: |
-|   `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`    |  否  | `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__use_cmd_start`   |  否  | `None`  |      `bool \| None`       | 是否使用配置项 `COMMAND_START` 来作为命令前缀 |
 
 `werewolf__enable_poke` 仅在 `OneBot V11` 适配器 / `Satori/chronocat` 下生效
 
-`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性。如有疑问欢迎提出。
+`werewolf__enable_button` 仅在 `Telegram` 适配器下通过测试，不保证在其他适配器的可用性，如有疑问欢迎提出。
 
 <details>
 <summary> werewolf__require_at 示例 </summary>
@@ -116,15 +133,18 @@ 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`
 
-## 🎉 使用
+- 一般情况下不需要修改此配置, 插件的默认优先级可以参考 [这里](./nonebot_plugin_werewolf/config.py) 的 `MatcherPriorityConfig`
+- 如果遇到与其他插件的命令冲突, 可考虑修改此处的优先级配置
+- 配置应填入 JSON 对象, 可用键: `start` `terminate` `preset` `behavior` `in_game` `stop`
+
+`werewolf__use_cmd_start` 为 `None` 时，使用 alc 的 [全局配置](https://nonebot.dev/docs/next/best-practice/alconna/config#alconna_use_command_start)
+
+## 🚀 使用
 
 > [!note]
 >
@@ -145,19 +165,19 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 </details>
 
-### 指令表
+### 📋 指令表
 
-|        指令         |        权限         | 需要@ | 范围 |                   说明                    |
-| :-----------------: | :-----------------: | :---: | :--: | :---------------------------------------: |
-| `werewolf`/`狼人杀` |        群员         |  是   | 群聊 |          发起游戏 (进入准备阶段)          |
-|     `开始游戏`      |     游戏发起者      |  否   | 群聊 |      _[准备阶段]_ 游戏发起者开始游戏      |
-|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 | _[准备阶段]_ 游戏发起者/超级用户 结束游戏 |
-|     `当前玩家`      |        群员         |  否   | 群聊 |    _[准备阶段]_ 列出参与游戏的玩家列表    |
-|     `加入游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家加入游戏         |
-|     `退出游戏`      |        群员         |  否   | 群聊 |         _[准备阶段]_ 玩家退出游戏         |
-|     `中止游戏`      |      超级用户       |  是   | 群聊 |      _[游戏内]_ 超级用户强制中止游戏      |
-|    `狼人杀预设`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏预设      |
-|    `狼人杀配置`     |      超级用户       |  否   | 任意 |      _[游戏外]_ 超级用户编辑游戏配置      |
+|        指令         |        权限         | 需要@ |       范围        |             说明             |
+| :-----------------: | :-----------------: | :---: | :---------------: | :--------------------------: |
+| `werewolf`/`狼人杀` |        群员         |  是   |  群聊 _[游戏外]_  |   发起游戏 (进入准备阶段)    |
+|     `开始游戏`      |     游戏发起者      |  否   | 群聊 _[准备阶段]_ |      游戏发起者开始游戏      |
+|     `结束游戏`      | 游戏发起者/超级用户 |  否   | 群聊 _[准备阶段]_ | 游戏发起者/超级用户 结束游戏 |
+|     `当前玩家`      |        群员         |  否   | 群聊 _[准备阶段]_ |    列出参与游戏的玩家列表    |
+|     `加入游戏`      |        群员         |  否   | 群聊 _[准备阶段]_ |         玩家加入游戏         |
+|     `退出游戏`      |        群员         |  否   | 群聊 _[准备阶段]_ |         玩家退出游戏         |
+|     `中止游戏`      |      超级用户       |  是   |  群聊 _[游戏内]_  |     超级用户强制中止游戏     |
+|    `狼人杀预设`     |      超级用户       |  否   |  任意 _[游戏外]_  |     超级用户编辑游戏预设     |
+|    `狼人杀配置`     |      超级用户       |  否   |  任意 _[游戏外]_  |     超级用户编辑游戏配置     |
 
 - `超级用户` 为 nonebot2 配置项中的 `SUPERUSERS`, 配置说明参考 [官方文档](https://nonebot.dev/docs/appendices/config#superusers)
 
@@ -171,7 +191,7 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 - _其他交互参考游戏内提示_
 
-### 游戏内容
+### 🎭 游戏内容
 
 > [!note]
 >
@@ -182,14 +202,14 @@ werewolf__require_at='{"start": true, "terminate": false}'
 插件中保存了一份 [职业预设](./nonebot_plugin_werewolf/constant.py), 内容如下
 
 | 总人数 | 狼人 | 神职 | 平民 |
-| ------ | ---- | ---- | ---- |
-| 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   |
 
 职业预设可以通过命令 `狼人杀预设 职业 ...` 修改
 
@@ -234,7 +254,6 @@ werewolf__require_at='{"start": true, "terminate": false}'
 > 其效果等同于以上描述中的单条命令 `狼人杀预设 狼人 狼人 狼王 狼人 狼人`
 
 </details>
-<br/>
 
 对于 `小丑` 职业，当预设中的平民数量大于或等于 2 时，将有 _一定概率_ 将其中一个平民替换为小丑。
 
@@ -242,12 +261,14 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 小丑生成概率可以通过命令 `狼人杀预设 小丑 <概率>` 设置，默认值为 0 (不生成小丑)。
 
-### 已知问题
+### 🔧 已知问题
 
 <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
+- 截止 chronocat [v0.2.19](https://github.com/chrononeko/chronocat/tree/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
+
+- v1.1.6 添加的按钮操作在 `discord` 适配器中不可用, 已在 v1.1.12 禁用 (2e31d43)
 
 </details>
 
@@ -258,6 +279,15 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 <!-- CHANGELOG -->
 
+- 2025.06.04 v1.1.13
+
+  - 添加配置项 `werewolf__use_cmd_start`, 用于配置插件命令前缀
+  - 调整 v1.1.11 优先级配置的默认值
+
+- 2025.06.01 v1.1.12
+
+  - 禁用 `discord` 适配器中的按钮操作 ~~以后会写适配的...吗?~~
+
 - 2025.04.20 v1.1.11
 
   - 添加配置项 `werewolf__require_at`, 用于配置命令是否需要 at 机器人触发
@@ -342,7 +372,7 @@ werewolf__require_at='{"start": true, "terminate": false}'
 
 </details>
 
-## 鸣谢
+## 🎉 鸣谢
 
 - [`nonebot/nonebot2`](https://github.com/nonebot/nonebot2): 跨平台 Python 异步机器人框架
 - [`nonebot/plugin-alconna`](https://github.com/nonebot/plugin-alconna): 跨平台的消息处理接口

{nonebot_plugin_werewolf-1.1.11 → nonebot_plugin_werewolf-1.1.13}/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.11"
+__version__ = "1.1.13"
 __plugin_meta__ = PluginMetadata(
     name="狼人杀",
     description="适用于 Nonebot2 的狼人杀插件",

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

@@ -1,10 +1,11 @@
 import json
+import warnings
 from pathlib import Path
 from typing import Any, ClassVar, Final, Literal
 from typing_extensions import Self
 
 import nonebot
-from nonebot.compat import model_dump, type_validate_json
+from nonebot.compat import model_dump, model_validator, type_validate_json
 from nonebot_plugin_localstore import get_plugin_data_file
 from pydantic import BaseModel, Field
 
@@ -12,37 +13,36 @@ from .constant import (
     DEFAULT_PRIESTHOOD_PRIORITY,
     DEFAULT_ROLE_PRESET,
     DEFAULT_WEREWOLF_PRIORITY,
-    stop_command_prompt,
 )
 from .models import Role
 
 
 class ConfigFile(BaseModel):
-    FILE: ClassVar[Path]
-    _cache: ClassVar[Self | None] = None
+    _file_: ClassVar[Path]
+    _cache_: ClassVar[Self | None] = None
 
     def __init_subclass__(cls, **kwargs: Any) -> None:  # noqa: ANN401
         super().__init_subclass__(**kwargs)
-        if not cls.FILE.exists():
+        if not cls._file_.exists():
             cls().save()
 
     @classmethod
     def load(cls) -> Self:
-        return type_validate_json(cls, cls.FILE.read_text())
+        return type_validate_json(cls, cls._file_.read_text())
 
     @classmethod
     def get(cls, *, use_cache: bool = True) -> Self:
-        if cls._cache is None or not use_cache:
-            cls._cache = cls.load()
-        return cls._cache
+        if cls._cache_ is None or not use_cache:
+            cls._cache_ = cls.load()
+        return cls._cache_
 
     def save(self) -> None:
-        self.FILE.write_text(json.dumps(model_dump(self)))
-        type(self)._cache = self  # noqa: SLF001
+        self._file_.write_text(json.dumps(model_dump(self)))
+        type(self)._cache_ = self
 
 
 class PresetData(ConfigFile):
-    FILE: ClassVar[Path] = get_plugin_data_file("preset.json")
+    _file_: ClassVar[Path] = get_plugin_data_file("preset.json")
 
     role_preset: dict[int, tuple[int, int, int]] = DEFAULT_ROLE_PRESET.copy()
     werewolf_priority: list[Role] = DEFAULT_WEREWOLF_PRIORITY.copy()
@@ -50,36 +50,33 @@ class PresetData(ConfigFile):
     jester_probability: float = Field(default=0.0, ge=0.0, le=1.0)
 
 
+class _Timeout(BaseModel):
+    prepare: int = Field(default=5 * 60, ge=5 * 60)
+    speak: int = Field(default=60, ge=60)
+    group_speak: int = Field(default=120, ge=120)
+    interact: int = Field(default=60, ge=60)
+    vote: int = Field(default=60, ge=60)
+    werewolf: int = Field(default=120, ge=120)
+
+    @property
+    def speak_timeout_prompt(self) -> str:
+        return f"限时{self.speak / 60:.1f}分钟, 发送 “{stop_command_prompt}” 结束发言"
+
+    @property
+    def group_speak_timeout_prompt(self) -> str:
+        return (
+            f"限时{self.group_speak / 60:.1f}分钟, "
+            f"全员发送 “{stop_command_prompt}” 结束发言"
+        )
+
+
 class GameBehavior(ConfigFile):
-    FILE: ClassVar[Path] = get_plugin_data_file("behavior.json")
+    _file_: ClassVar[Path] = get_plugin_data_file("behavior.json")
 
     show_roles_list_on_start: bool = False
     speak_in_turn: bool = False
     dead_channel_rate_limit: int = 8  # per minute
     werewolf_multi_select: bool = False
-
-    class _Timeout(BaseModel):
-        prepare: int = Field(default=5 * 60, ge=5 * 60)
-        speak: int = Field(default=60, ge=60)
-        group_speak: int = Field(default=120, ge=120)
-        interact: int = Field(default=60, ge=60)
-        vote: int = Field(default=60, ge=60)
-        werewolf: int = Field(default=120, ge=120)
-
-        @property
-        def speak_timeout_prompt(self) -> str:
-            return (
-                f"限时{self.speak / 60:.1f}分钟, "
-                f"发送 “{stop_command_prompt()}” 结束发言"
-            )
-
-        @property
-        def group_speak_timeout_prompt(self) -> str:
-            return (
-                f"限时{self.group_speak / 60:.1f}分钟, "
-                f"全员发送 “{stop_command_prompt()}” 结束发言"
-            )
-
     timeout: Final[_Timeout] = _Timeout()
 
 
@@ -94,7 +91,18 @@ class MatcherPriorityConfig(BaseModel):
     preset: int = 1
     behavior: int = 1
     in_game: int = 10
-    stop: int = 10
+    stop: int = 9
+
+    @model_validator(mode="after")
+    @classmethod
+    def _validate(cls, model: Self) -> Self:
+        if model.in_game <= model.stop:
+            model.in_game = model.stop + 1
+            warnings.warn(
+                "in_game 的优先级必须低于 stop，已自动调整为 stop + 1",
+                stacklevel=2,
+            )
+        return model
 
 
 class PluginConfig(BaseModel):
@@ -103,6 +111,7 @@ class PluginConfig(BaseModel):
     stop_command: str | set[str] = "stop"
     require_at: bool | RequireAtConfig = True
     matcher_priority: MatcherPriorityConfig = MatcherPriorityConfig()
+    use_cmd_start: bool | None = None
 
     def get_stop_command(self) -> list[str]:
         return (
@@ -123,3 +132,8 @@ class Config(BaseModel):
 
 config = nonebot.get_plugin_config(Config).werewolf
 nonebot.logger.debug(f"加载插件配置: {config}")
+
+stop_command_prompt = (
+    next(iter(sorted(nonebot.get_driver().config.command_start, key=len)), "")
+    + config.get_stop_command()[0]
+)

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

@@ -1,25 +1,8 @@
-import functools
-from typing import TYPE_CHECKING
-
 from .models import GameStatus, KillReason, Role, RoleGroup
 
 STOP_COMMAND = "{{stop}}"
 
 
-def stop_command_prompt() -> str:
-    import nonebot
-
-    from .config import config  # circular import
-
-    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:
-    stop_command_prompt = functools.cache(stop_command_prompt)
-del TYPE_CHECKING
-
-
 ROLE_NAME_CONV: dict[Role | RoleGroup, str] = {
     Role.WEREWOLF: "狼人",
     Role.WOLFKING: "狼王",