diff --git a/zh-CN/api/glossary.md b/zh-CN/api/glossary.md index bfe3d24ce45a..5bec0ee9f7d1 100644 --- a/zh-CN/api/glossary.md +++ b/zh-CN/api/glossary.md @@ -77,7 +77,7 @@ Koishi 设计了一整套对象关系映射 (ORM) 接口,它易于扩展并广 ## 过滤器 (Filter) {#filter} -- [入门 > 过滤器](../manual/usage/customize.md#过滤器) +- [入门 > 过滤器](../manual/usage/customize.md#filters) - [开发 > 模块化 > 过滤器](../guide/plugin/filter.md) - [API > 内置服务 > 过滤器](./service/filter.md) diff --git a/zh-CN/guide/plugin/filter.md b/zh-CN/guide/plugin/filter.md index 864555b30a39..4f8170319973 100644 --- a/zh-CN/guide/plugin/filter.md +++ b/zh-CN/guide/plugin/filter.md @@ -1,7 +1,7 @@ # 过滤器 ::: tip -在学习本节之前,建议先完整阅读 [入门 > 过滤器](../../manual/usage/customize.md#过滤器)。 +在学习本节之前,建议先完整阅读 [入门 > 过滤器](../../manual/usage/customize.md#filters)。 ::: 默认情况下,一个会话事件、中间件或者指令都对所有的会话生效。但如果我们希望这些功能只对部分群聊或者用户生效,我们就需要用到 **过滤器**。 diff --git a/zh-CN/manual/recipe/multiple.md b/zh-CN/manual/recipe/multiple.md index a6deda290eb8..f023dd4a4648 100644 --- a/zh-CN/manual/recipe/multiple.md +++ b/zh-CN/manual/recipe/multiple.md @@ -16,8 +16,8 @@ 与此同时,绝大多数插件都是不可重用的。对于这类插件,你只能同时拥有一份运行中的配置。如果已经有一份正在运行的配置,那么你会在其他配置处看到一行提示「此插件正在运行且不可重用」。当然,你仍然可以准备多份配置,并在合适的时机将一份配置停用,并启用另一份。 -对于那些不可重用的插件,如果希望在不同的场景下切换到不同的配置,就需要插件作者提供带有 [过滤器](../usage/customize.md#过滤器) 的配置项。如果你想要修改的配置不支持过滤器,那么你可以考虑向插件作者提出建议,或采用下面介绍的 [多实例](#多实例) 方案。 +对于那些不可重用的插件,如果希望在不同的场景下切换到不同的配置,就需要插件作者提供带有 [过滤器](../usage/customize.md#filters) 的配置项。如果你想要修改的配置不支持过滤器,那么你可以考虑向插件作者提出建议,或采用下面介绍的 [多实例](#multiple-instances) 方案。 -## 多实例 +## 多实例 {#multiple-instances} 另一种方案是同时运行多个 Koishi 应用。这样做的好处是,你可以在不同的应用中使用完全不同的插件配置,甚至启用完全不同的插件组合。但与之相对的,你需要额外维护多个应用,而且每个应用都需要一个独立的端口。 diff --git a/zh-CN/manual/recipe/server.md b/zh-CN/manual/recipe/server.md index 1298643d4bea..1806d8e1787d 100644 --- a/zh-CN/manual/recipe/server.md +++ b/zh-CN/manual/recipe/server.md @@ -11,7 +11,7 @@ Koishi 应用默认情况下只能在本机访问。而对于某些需求,你 将 Koishi 不受限制地暴露在公网上可能会导致你的服务器受到攻击。因此,你需要妥善配合用户登录等方式以限制控制台功能的访问能力。 -在 [前面的章节](../usage/platform.md#控制台登录) 中,我们已经介绍了 [auth](../../plugins/console/auth.md) 插件的使用方法。 +在 [前面的章节](../usage/platform.md#console-login) 中,我们已经介绍了 [auth](../../plugins/console/auth.md) 插件的使用方法。 ## 配置服务器地址 diff --git a/zh-CN/manual/usage/command.md b/zh-CN/manual/usage/command.md index 35cedd348da9..9ba4f1b349de 100644 --- a/zh-CN/manual/usage/command.md +++ b/zh-CN/manual/usage/command.md @@ -121,7 +121,7 @@ help 指令后还可以添加一个参数,用于查看特定指令的帮助信 1. `prefix` 是一个列表,默认值为 `['']` 表示无需前缀也能触发;将列表清空会导致所有指令都无法通过 `prefix` 触发 (但仍然可以通过私聊或 `nickname` 或 @机器人 触发) 2. 如果你在 `prefix` 中设置了多个值,例如 `['.', '/', '']`,那么 `.`, `/` 或无前缀都能触发指令;但由于 Koishi 是按顺序匹配各个前缀的,因此空串 `''` 必须写在最后一个 -3. 可以为不同的会话设置不同的 `prefix`,具体请参考 [过滤器](./customize.md#过滤器) 一节 +3. 可以为不同的会话设置不同的 `prefix`,具体请参考 [过滤器](./customize.md#filters) 一节 ::: ## 子指令 diff --git a/zh-CN/manual/usage/customize.md b/zh-CN/manual/usage/customize.md index 13bdf3159092..232a3d4f2c7d 100644 --- a/zh-CN/manual/usage/customize.md +++ b/zh-CN/manual/usage/customize.md @@ -50,7 +50,7 @@ Koishi 内部有一套默认的权限系统,它为每个用户赋予了一个 上述两个配置项都支持 [计算属性](#计算属性),这也意味着你可以在不同的聊天环境中配置不同的行为。 -## 过滤器 +## 过滤器 {#filters} 很多时候,我们会希望某些功能只能对于某些群聊或私聊使用。使用权限管理意味着引入数据库,而更轻量的方式是通过 **过滤器 (Filter)** 直接影响插件的作用范围。 diff --git a/zh-CN/manual/usage/market.md b/zh-CN/manual/usage/market.md index 1f88207f7ef8..26666ff4b70a 100644 --- a/zh-CN/manual/usage/market.md +++ b/zh-CN/manual/usage/market.md @@ -84,7 +84,7 @@ Koishi 在安装时预先配置了一些分组,而新安装的插件会放置 创建新的分组同样很简单。点击「全局配置」或任意分组名后,点击右上角的「创建分组」按钮可以在此创建一个新的插件分组。新分组的名字是随机生成的,但你可以点击名字修改成你喜欢的名字。分组可以在左侧栏中点击小三角来控制展开和收起。 -此外,[过滤器](../usage/customize.md#过滤器) 机制也可用于分组,便于控制一系列插件的行为。 +此外,[过滤器](../usage/customize.md#filters) 机制也可用于分组,便于控制一系列插件的行为。 ### 添加更多插件 diff --git a/zh-CN/manual/usage/platform.md b/zh-CN/manual/usage/platform.md index fd562db60e51..9828a9d7e1fd 100644 --- a/zh-CN/manual/usage/platform.md +++ b/zh-CN/manual/usage/platform.md @@ -28,7 +28,7 @@ Koishi 说自己是一个「跨平台」的框架,但是这个「跨平台」 如果你要进行登录或者绑定,这里的「平台名」和「用户 ID」会很有用。 -## 控制台登录 +## 控制台登录 {#console-login} [auth](../../plugins/console/auth.md) 插件允许任何用户在控制台登录 Koishi 账号并管理自己的用户信息。此外,该插件还自带了一个管理员账号,对于刚刚搭建好 Koishi 的用户来说,这是最方便的提权方式。