(window.webpackJsonp=window.webpackJsonp||[]).push([[34],{428:function(s,t,a){"use strict";a.r(t);var e=a(55),r=Object(e.a)({},function(){var s=this,t=s.$createElement,a=s._self._c||t;return a("ContentSlotsDistributor",{attrs:{"slot-key":s.$parent.slotKey}},[a("h1",{attrs:{id:"nonebot-default-config"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#nonebot-default-config","aria-hidden":"true"}},[s._v("#")]),s._v(" nonebot.default_config")]),s._v(" "),a("p",[s._v("默认配置。")]),s._v(" "),a("p",[s._v("任何自定义配置都必须从此模块导入所有内容，然后设置自定义值来覆盖默认值。")]),s._v(" "),a("p",[s._v("例如:")]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" nonebot"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("default_config "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("*")]),s._v("\n\nHOST "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'0.0.0.0'")]),s._v("\nPORT "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("8080")]),s._v("\nSUPERUSERS "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("12345678")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\nCOMMAND_START "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("''")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'!'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'／'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'！'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])]),a("h2",{attrs:{id:"var-api-root"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-api-root","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("API_ROOT")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" str")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("CQHTTP 插件的 HTTP 接口地址，如果不使用 HTTP 通信，则无需设置。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("''")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("API_ROOT "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'http://127.0.0.1:5700'")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("告诉 NoneBot CQHTTP 插件的 HTTP 服务运行在 "),a("code",[s._v("http://127.0.0.1:5700")]),s._v("。")])])]),s._v(" "),a("h2",{attrs:{id:"var-access-token"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-access-token","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("ACCESS_TOKEN")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" str")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("需要和 CQHTTP 插件的配置中的 "),a("code",[s._v("access_token")]),s._v(" 相同。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("''")])])])]),s._v(" "),a("h2",{attrs:{id:"var-secret"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-secret","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SECRET")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" str")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("需要和 CQHTTP 插件的配置中的 "),a("code",[s._v("secret")]),s._v(" 相同。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("''")])])])]),s._v(" "),a("h2",{attrs:{id:"var-host"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-host","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("HOST")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" str")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("NoneBot 的 HTTP 和 WebSocket 服务端监听的 IP／主机名。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("'127.0.0.1'")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("HOST "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'0.0.0.0'")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("监听服务器的所有 IP。")])])]),s._v(" "),a("h2",{attrs:{id:"var-port"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-port","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("PORT")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" int")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("NoneBot 的 HTTP 和 WebSocket 服务端监听的端口。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("8080")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("PORT "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("9876")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("监听 9876 端口。")])])]),s._v(" "),a("h2",{attrs:{id:"var-debug"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-debug","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("DEBUG")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" bool")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("是否以调试模式运行，生产环境需要设置为 "),a("code",[s._v("False")]),s._v(" 以提高性能。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("True")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("DEBUG "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token boolean"}},[s._v("False")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("不使用调试模式运行。")])])]),s._v(" "),a("h2",{attrs:{id:"var-superusers"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-superusers","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SUPERUSERS")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" Collection[int] "),a("Badge",{attrs:{text:"1.7.0+"}})],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("超级用户的 QQ 号，用于命令的权限检查。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("set()")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("SUPERUSERS "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("12345678")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("87654321")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("设置 "),a("code",[s._v("12345678")]),s._v(" 和 "),a("code",[s._v("87654321")]),s._v(" 为超级用户。")])])]),s._v(" "),a("h2",{attrs:{id:"var-nickname"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-nickname","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("NICKNAME")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" str | Iterable[str]")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("机器人的昵称，用于辨别用户是否在和机器人说话。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("''")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("NICKNAME "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'奶茶'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'小奶茶'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("用户可以通过「奶茶」或「小奶茶」来呼唤机器人。")])])]),s._v(" "),a("h2",{attrs:{id:"var-command-start"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-command-start","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("COMMAND_START")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" Iterable[str | Pattern]")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令的起始标记，用于判断一条消息是不是命令。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("{'/', '!', '／', '！'}")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("COMMAND_START "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("''")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'/'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'!'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("允许使用 "),a("code",[s._v("/")]),s._v("、"),a("code",[s._v("!")]),s._v(" 作为命令起始符，或不用发送起始符。")])])]),s._v(" "),a("h2",{attrs:{id:"var-command-sep"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-command-sep","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("COMMAND_SEP")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" Iterable[str | Pattern]")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令的分隔标记，用于将文本形式的命令切分为元组（实际的命令名）。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("{'/', '.'}")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("COMMAND_SEP "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("{")]),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'.'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("}")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("将 "),a("code",[s._v("note.add")]),s._v(" 这样的命令解析为 "),a("code",[s._v("('note', 'add')")]),s._v("。")])])]),s._v(" "),a("h2",{attrs:{id:"var-default-command-permission"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-default-command-permission","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("DEFAULT_COMMAND_PERMISSION")]),s._v(" "),a("Badge",{attrs:{text:"1.9.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-permissionpolicy-t"}},[s._v("PermissionPolicy_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令处理器的缺省权限。默认为允许所有用户触发。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("lambda _: True")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("DEFAULT_COMMAND_PERMISSION "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("lambda")]),s._v(" s"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(":")]),s._v(" s"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(".")]),s._v("is_superuser\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("调用 "),a("code",[s._v("on_command")]),s._v(" 而不提供 "),a("code",[s._v("permission")]),s._v(" 参数时，命令仅能被超级用户触发。")])])]),s._v(" "),a("h2",{attrs:{id:"var-default-nlp-permission"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-default-nlp-permission","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("DEFAULT_NLP_PERMISSION")]),s._v(" "),a("Badge",{attrs:{text:"1.9.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-permissionpolicy-t"}},[s._v("PermissionPolicy_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("自然语言处理器的缺省权限。默认为允许所有用户触发。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("lambda _: True")])])])]),s._v(" "),a("h2",{attrs:{id:"var-session-expire-timeout"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-session-expire-timeout","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SESSION_EXPIRE_TIMEOUT")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" datetime.timedelta | None")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令会话的过期超时时长，超时后会话将被移除。"),a("code",[s._v("None")]),s._v(" 表示不超时。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("datetime.timedelta(minutes=5)")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" datetime "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" timedelta\nSESSION_EXPIRE_TIMEOUT "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" timedelta"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("minutes"),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("2")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("设置过期超时为 2 分钟，即用户 2 分钟不发消息后，会话将被关闭。")])])]),s._v(" "),a("h2",{attrs:{id:"var-session-run-timeout"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-session-run-timeout","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SESSION_RUN_TIMEOUT")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" datetime.timedelta | None")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令会话的运行超时时长，超时后会话将被移除，命令处理函数会被异常所中断。此时用户可以调用新的命令，开启新的会话。"),a("code",[s._v("None")]),s._v(" 表示不超时。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("None")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("from")]),s._v(" datetime "),a("span",{pre:!0,attrs:{class:"token keyword"}},[s._v("import")]),s._v(" timedelta\nSESSION_RUN_TIMEOUT "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" timedelta"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("seconds"),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("10")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br")])]),a("p",[s._v("设置运行超时为 10 秒，即命令会话运行达到 10 秒，NoneBot 将认为它已经结束。")])])]),s._v(" "),a("h2",{attrs:{id:"var-session-running-expression"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-session-running-expression","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SESSION_RUNNING_EXPRESSION")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-expression-t"}},[s._v("Expression_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("当有命令会话正在运行时，给用户新消息的回复。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("'您有命令正在执行，请稍后再试'")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("SESSION_RUNNING_EXPRESSION "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("''")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("设置为空，表示当有命令会话正在运行时，不回复用户的新消息。")])])]),s._v(" "),a("h2",{attrs:{id:"var-short-message-max-length"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-short-message-max-length","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SHORT_MESSAGE_MAX_LENGTH")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" int")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("短消息的最大长度。默认情况下（"),a("code",[s._v("only_short_message")]),s._v(" 为 "),a("code",[s._v("True")]),s._v("），自然语言处理器只会响应消息中纯文本部分的长度总和小于等于此值的消息。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("50")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("SHORT_MESSAGE_MAX_LENGTH "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token number"}},[s._v("100")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("设置最大长度为 100。")])])]),s._v(" "),a("h2",{attrs:{id:"var-default-validation-failure-expression"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-default-validation-failure-expression","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("DEFAULT_VALIDATION_FAILURE_EXPRESSION")]),s._v(" "),a("Badge",{attrs:{text:"1.2.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-expression-t"}},[s._v("Expression_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令参数验证失败（验证器抛出 "),a("code",[s._v("ValidateError")]),s._v(" 异常）、且验证器没有指定错误信息时，默认向用户发送的错误提示。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("'您的输入不符合要求，请重新输入'")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("DEFAULT_VALIDATION_FAILURE_EXPRESSION "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'你发送的内容格式不太对呢，请检查一下再发送哦～'")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br")])]),a("p",[s._v("设置更亲切的默认错误提示。")])])]),s._v(" "),a("h2",{attrs:{id:"var-max-validation-failures"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-max-validation-failures","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("MAX_VALIDATION_FAILURES")]),s._v(" "),a("Badge",{attrs:{text:"1.3.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" int")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令参数验证允许的最大失败次数，用户输入错误达到这个次数之后，将会提示用户输入错误太多次，并结束命令会话。")]),s._v(" "),a("p",[s._v("设置为 "),a("code",[s._v("0")]),s._v(" 将不会检查验证失败次数。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("3")])])])]),s._v(" "),a("h2",{attrs:{id:"var-too-many-validation-failures-expression"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-too-many-validation-failures-expression","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("TOO_MANY_VALIDATION_FAILURES_EXPRESSION")]),s._v(" "),a("Badge",{attrs:{text:"1.3.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-expression-t"}},[s._v("Expression_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("命令参数验证失败达到 "),a("code",[s._v("MAX_VALIDATION_FAILURES")]),s._v(" 次之后，向用户发送的提示。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("'您输入错误太多次啦，如需重试，请重新触发本功能'")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("TOO_MANY_VALIDATION_FAILURES_EXPRESSION "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'你输错太多次啦，需要的时候再叫我吧'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'你输错太多次了，建议先看看使用帮助哦～'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br")])])])]),s._v(" "),a("h2",{attrs:{id:"var-session-cancel-expression"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-session-cancel-expression","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("SESSION_CANCEL_EXPRESSION")]),s._v(" "),a("Badge",{attrs:{text:"1.3.0+"}})],1),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" "),a("RouterLink",{attrs:{to:"/api/typing.html#var-expression-t"}},[s._v("Expression_T")])],1)]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[a("code",[s._v("nonebot.command.argfilter.controllers.handle_cancellation()")]),s._v(" 控制器在用户发送了 "),a("code",[s._v("算了")]),s._v("、"),a("code",[s._v("取消")]),s._v(" 等取消指令后，结束当前命令会话时，向用户发送的提示。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("'好的'")])])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("用法")])]),s._v(" "),a("div",{staticClass:"language-python line-numbers-mode"},[a("pre",{pre:!0,attrs:{class:"language-python"}},[a("code",[s._v("SESSION_CANCEL_EXPRESSION "),a("span",{pre:!0,attrs:{class:"token operator"}},[s._v("=")]),s._v(" "),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v("(")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'好的'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'好的吧'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'好吧，那奶茶就不打扰啦'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n    "),a("span",{pre:!0,attrs:{class:"token string"}},[s._v("'那奶茶先不打扰小主人啦'")]),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(",")]),s._v("\n"),a("span",{pre:!0,attrs:{class:"token punctuation"}},[s._v(")")]),s._v("\n")])]),s._v(" "),a("div",{staticClass:"line-numbers-wrapper"},[a("span",{staticClass:"line-number"},[s._v("1")]),a("br"),a("span",{staticClass:"line-number"},[s._v("2")]),a("br"),a("span",{staticClass:"line-number"},[s._v("3")]),a("br"),a("span",{staticClass:"line-number"},[s._v("4")]),a("br"),a("span",{staticClass:"line-number"},[s._v("5")]),a("br"),a("span",{staticClass:"line-number"},[s._v("6")]),a("br")])])])]),s._v(" "),a("h2",{attrs:{id:"var-apscheduler-config"}},[a("a",{staticClass:"header-anchor",attrs:{href:"#var-apscheduler-config","aria-hidden":"true"}},[s._v("#")]),s._v(" "),a("em",[s._v("var")]),s._v(" "),a("code",[s._v("APSCHEDULER_CONFIG")])]),s._v(" "),a("ul",[a("li",[a("p",[a("strong",[s._v("类型:")]),s._v(" dict[str, Any]")])]),s._v(" "),a("li",[a("p",[a("strong",[s._v("说明")])]),s._v(" "),a("p",[s._v("APScheduler 的配置对象，见 "),a("a",{attrs:{href:"https://apscheduler.readthedocs.io/en/latest/userguide.html#configuring-the-scheduler",target:"_blank",rel:"noopener noreferrer"}},[s._v("Configuring the scheduler"),a("OutboundLink")],1),s._v("。")]),s._v(" "),a("p",[a("strong",[s._v("默认值:")]),s._v(" "),a("code",[s._v("{'apscheduler.timezone': 'Asia/Shanghai'}")])])])])])},[],!1,null,null,null);t.default=r.exports}}]);