注册一个消息事件响应器，并且当消息以指定命令开头时响应。 命令匹配规则参考: `命令形式匹配 `_ 参数: cmd: 指定命令内容 aliases: 命令别名 force_whitespace: 是否强制命令后必须有指定空白符 rule: 事件响应规则 permission: 事件响应权限 handlers: 事件处理函数列表 temp: 是否
(
self,
cmd: str | tuple[str, ...],
aliases: set[str | tuple[str, ...]] | None = None,
force_whitespace: str | bool | None = None,
**kwargs,
)
| 719 | return matcher |
| 720 | |
| 721 | def on_command( |
| 722 | self, |
| 723 | cmd: str | tuple[str, ...], |
| 724 | aliases: set[str | tuple[str, ...]] | None = None, |
| 725 | force_whitespace: str | bool | None = None, |
| 726 | **kwargs, |
| 727 | ) -> type[Matcher]: |
| 728 | """注册一个消息事件响应器，并且当消息以指定命令开头时响应。 |
| 729 | |
| 730 | 命令匹配规则参考: `命令形式匹配 <rule.md#command-command>`_ |
| 731 | |
| 732 | 参数: |
| 733 | cmd: 指定命令内容 |
| 734 | aliases: 命令别名 |
| 735 | force_whitespace: 是否强制命令后必须有指定空白符 |
| 736 | rule: 事件响应规则 |
| 737 | permission: 事件响应权限 |
| 738 | handlers: 事件处理函数列表 |
| 739 | temp: 是否为临时事件响应器（仅执行一次） |
| 740 | expire_time: 事件响应器最终有效时间点，过时即被删除 |
| 741 | priority: 事件响应器优先级 |
| 742 | block: 是否阻止事件向更低优先级传递 |
| 743 | state: 默认 state |
| 744 | """ |
| 745 | final_kwargs = self._get_final_kwargs(kwargs, exclude={"type"}) |
| 746 | matcher = on_command( |
| 747 | cmd, aliases=aliases, force_whitespace=force_whitespace, **final_kwargs |
| 748 | ) |
| 749 | self.matchers.append(matcher) |
| 750 | return matcher |
| 751 | |
| 752 | def on_shell_command( |
| 753 | self, |
no test coverage detected