https://nonebot.dev/assets/js/241d7e2a.f7a420be.js

1"use strict";(self.webpackChunknonebot=self.webpackChunknonebot||[]).push([["290"],{95460(e,n,t){t.r(n),t.d(n,{metadata:()=>r,default:()=>h,frontMatter:()=>c,contentTitle:()=>d,toc:()=>l,assets:()=>s});var r=JSON.parse('{"id":"tutorial/matcher","title":"\u4E8B\u4EF6\u54CD\u5E94\u5668","description":"\u54CD\u5E94\u63A5\u6536\u5230\u7684\u7279\u5B9A\u4E8B\u4EF6","source":"@site/docs/tutorial/matcher.md","sourceDirName":"tutorial","slug":"/tutorial/matcher","permalink":"/docs/next/tutorial/matcher","draft":false,"unlisted":false,"editUrl":"https://github.com/nonebot/nonebot2/edit/master/website/docs/tutorial/matcher.md","tags":[],"version":"current","lastUpdatedBy":"pre-commit-ci[bot]","lastUpdatedAt":1789135437000,"sidebarPosition":4,"frontMatter":{"sidebar_position":4,"description":"\u54CD\u5E94\u63A5\u6536\u5230\u7684\u7279\u5B9A\u4E8B\u4EF6","options":{"menu":[{"category":"tutorial","weight":60}]}},"sidebar":"tutorial","previous":{"title":"\u63D2\u4EF6\u7F16\u5199\u51C6\u5907","permalink":"/docs/next/tutorial/create-plugin"},"next":{"title":"\u4E8B\u4EF6\u5904\u7406","permalink":"/docs/next/tutorial/handler"}}'),o=t(62540),i=t(43023);let c={sidebar_position:4,description:"\u54CD\u5E94\u63A5\u6536\u5230\u7684\u7279\u5B9A\u4E8B\u4EF6",options:{menu:[{category:"tutorial",weight:60}]}},d="\u4E8B\u4EF6\u54CD\u5E94\u5668",s={},l=[{value:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8F85\u52A9\u51FD\u6570",id:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8F85\u52A9\u51FD\u6570",level:2},{value:"\u521B\u5EFA\u4E8B\u4EF6\u54CD\u5E94\u5668",id:"\u521B\u5EFA\u4E8B\u4EF6\u54CD\u5E94\u5668",level:2},{value:"\u4E3A\u4E8B\u4EF6\u54CD\u5E94\u5668\u6DFB\u52A0\u53C2\u6570",id:"\u4E3A\u4E8B\u4EF6\u54CD\u5E94\u5668\u6DFB\u52A0\u53C2\u6570",level:3}];function a(e){let n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",header:"header",p:"p",pre:"pre",strong:"strong",...(0,i.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.header,{children:(0,o.jsx)(n.h1,{id:"\u4E8B\u4EF6\u54CD\u5E94\u5668",children:"\u4E8B\u4EF6\u54CD\u5E94\u5668"})}),"\n",(0,o.jsxs)(n.p,{children:["\u4E8B\u4EF6\u54CD\u5E94\u5668\uFF08Matcher\uFF09\u662F\u5BF9\u63A5\u6536\u5230\u7684\u4E8B\u4EF6\u8FDB\u884C\u54CD\u5E94\u7684\u57FA\u672C\u5355\u5143\uFF0C\u6240\u6709\u7684\u4E8B\u4EF6\u54CD\u5E94\u5668\u90FD\u7EE7\u627F\u81EA ",(0,o.jsx)(n.code,{children:"Matcher"})," \u57FA\u7C7B\u3002"]}),"\n",(0,o.jsxs)(n.p,{children:["\u5728 NoneBot \u4E2D\uFF0C\u4E8B\u4EF6\u54CD\u5E94\u5668\u53EF\u4EE5\u901A\u8FC7\u4E00\u7CFB\u5217\u7279\u5B9A\u7684\u89C4\u5219",(0,o.jsx)(n.strong,{children:"\u7B5B\u9009"}),"\u51FA",(0,o.jsx)(n.strong,{children:"\u5177\u6709\u67D0\u79CD\u7279\u5F81\u7684\u4E8B\u4EF6"}),"\uFF0C\u5E76\u6309\u7167",(0,o.jsx)(n.strong,{children:"\u7279\u5B9A\u7684\u6D41\u7A0B"}),"\u4EA4\u7531",(0,o.jsx)(n.strong,{children:"\u9884\u5B9A\u4E49\u7684\u4E8B\u4EF6\u5904\u7406\u4F9D\u8D56"}),"\u8FDB\u884C\u5904\u7406\u3002\u4F8B\u5982\uFF0C\u5728",(0,o.jsx)(n.a,{href:"/docs/next/quick-start",children:"\u5FEB\u901F\u4E0A\u624B"}),"\u4E2D\uFF0C\u6211\u4EEC\u4F7F\u7528\u4E86\u5185\u7F6E\u63D2\u4EF6 ",(0,o.jsx)(n.code,{children:"echo"})," \uFF0C\u5B83\u5B9A\u4E49\u7684\u4E8B\u4EF6\u54CD\u5E94\u5668\u80FD\u54CD\u5E94\u673A\u5668\u4EBA\u7528\u6237\u53D1\u9001\u7684\u201C/echo hello world\u201D\u6D88\u606F\uFF0C\u63D0\u53D6\u201Chello world\u201D\u4FE1\u606F\u5E76\u4F5C\u4E3A\u56DE\u590D\u6D88\u606F\u53D1\u9001\u3002"]}),"\n",(0,o.jsx)(n.h2,{id:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8F85\u52A9\u51FD\u6570",children:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8F85\u52A9\u51FD\u6570"}),"\n",(0,o.jsxs)(n.p,{children:["NoneBot \u4E2D\u6240\u6709\u4E8B\u4EF6\u54CD\u5E94\u5668\u5747\u7EE7\u627F\u81EA ",(0,o.jsx)(n.code,{children:"Matcher"})," \u57FA\u7C7B\uFF0C\u4F46\u76F4\u63A5\u4F7F\u7528 ",(0,o.jsx)(n.code,{children:"Matcher.new()"})," \u65B9\u6CD5\u521B\u5EFA\u4E8B\u4EF6\u54CD\u5E94\u5668\u8FC7\u4E8E\u7E41\u7410\u4E14\u4E0D\u80FD\u8BB0\u5F55\u63D2\u4EF6\u4FE1\u606F\u3002\u56E0\u6B64\uFF0CNoneBot \u4E2D\u63D0\u4F9B\u4E86\u4E00\u7CFB\u5217\u201C\u4E8B\u4EF6\u54CD\u5E94\u5668\u8F85\u52A9\u51FD\u6570\u201D\uFF08\u4E0B\u79F0\u201C\u8F85\u52A9\u51FD\u6570\u201D\uFF09\u6765\u8F85\u52A9\u6211\u4EEC\u7528",(0,o.jsx)(n.strong,{children:"\u6700\u7B80\u7684\u65B9\u5F0F"}),"\u521B\u5EFA",(0,o.jsx)(n.strong,{children:"\u5E26\u6709\u4E0D\u540C\u89C4\u5219\u9884\u8BBE"}),"\u7684\u4E8B\u4EF6\u54CD\u5E94\u5668\uFF0C\u63D0\u9AD8\u4EE3\u7801\u53EF\u8BFB\u6027\u548C\u4E66\u5199\u6548\u7387\u3002\u901A\u5E38\u60C5\u51B5\u4E0B\uFF0C\u6211\u4EEC\u53EA\u9700\u8981\u4F7F\u7528\u8F85\u52A9\u51FD\u6570\u5373\u53EF\u5B8C\u6210\u4E8B\u4EF6\u54CD\u5E94\u5668\u7684\u521B\u5EFA\u3002"]}),"\n",(0,o.jsxs)(n.p,{children:["\u5728 NoneBot \u4E2D\uFF0C\u8F85\u52A9\u51FD\u6570\u4EE5 ",(0,o.jsx)(n.code,{children:"on()"})," \u6216 ",(0,o.jsx)(n.code,{children:"on_<type/rule>()"})," \u5F62\u5F0F\u51FA\u73B0\uFF08\u4F8B\u5982 ",(0,o.jsx)(n.code,{children:"on_command()"}),"\uFF09\uFF0C\u8C03\u7528\u540E\u6839\u636E\u4E0D\u540C\u7684\u53C2\u6570\u8FD4\u56DE\u4E00\u4E2A ",(0,o.jsx)(n.code,{children:"Type[Matcher]"})," \u7C7B\u578B\u7684\u65B0\u4E8B\u4EF6\u54CD\u5E94\u5668\u3002"]}),"\n",(0,o.jsxs)(n.p,{children:["\u76EE\u524D NoneBot \u63D0\u4F9B\u4E86\u591A\u79CD\u529F\u80FD\u5404\u5F02\u7684\u8F85\u52A9\u51FD\u6570\u3001\u5177\u6709\u5171\u540C\u547D\u4EE4\u540D\u79F0\u524D\u7F00\u7684\u547D\u4EE4\u7EC4\u4EE5\u53CA\u5177\u6709\u5171\u540C\u53C2\u6570\u7684\u54CD\u5E94\u5668\u7EC4\uFF0C\u5747\u53EF\u4EE5\u4ECE ",(0,o.jsx)(n.code,{children:"nonebot"})," \u6A21\u5757\u76F4\u63A5\u5BFC\u5165\u4F7F\u7528\uFF0C\u5177\u4F53\u5185\u5BB9\u53C2\u8003",(0,o.jsx)(n.a,{href:"/docs/next/advanced/matcher",children:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8FDB\u9636"}),"\u3002"]}),"\n",(0,o.jsx)(n.h2,{id:"\u521B\u5EFA\u4E8B\u4EF6\u54CD\u5E94\u5668",children:"\u521B\u5EFA\u4E8B\u4EF6\u54CD\u5E94\u5668"}),"\n",(0,o.jsxs)(n.p,{children:["\u5728\u4E0A\u4E00\u8282",(0,o.jsx)(n.a,{href:"/docs/next/tutorial/create-plugin#%E5%88%9B%E5%BB%BA%E6%8F%92%E4%BB%B6",children:"\u521B\u5EFA\u63D2\u4EF6"}),"\u4E2D\uFF0C\u6211\u4EEC\u521B\u5EFA\u4E86\u4E00\u4E2A ",(0,o.jsx)(n.code,{children:"weather"})," \u63D2\u4EF6\uFF0C\u73B0\u5728\u6211\u4EEC\u6765\u5B9E\u73B0\u4ED6\u7684\u529F\u80FD\u3002"]}),"\n",(0,o.jsxs)(n.p,{children:["\u6211\u4EEC\u76F4\u63A5\u4F7F\u7528 ",(0,o.jsx)(n.code,{children:"on_command()"})," \u8F85\u52A9\u51FD\u6570\u6765\u521B\u5EFA\u4E00\u4E2A\u4E8B\u4EF6\u54CD\u5E94\u5668\uFF1A"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-python",metastring:"{3} title=weather/__init__.py",children:'from nonebot import on_command\n\nweather = on_command("\u5929\u6C14")\n'})}),"\n",(0,o.jsxs)(n.p,{children:["\u8FD9\u6837\uFF0C\u6211\u4EEC\u5C31\u83B7\u5F97\u4E00\u4E2A\u540D\u4E3A ",(0,o.jsx)(n.code,{children:"weather"})," \u7684\u4E8B\u4EF6\u54CD\u5E94\u5668\u4E86\uFF0C\u8FD9\u4E2A\u4E8B\u4EF6\u54CD\u5E94\u5668\u4F1A\u5BF9 ",(0,o.jsx)(n.code,{children:"/\u5929\u6C14"})," \u5F00\u5934\u7684\u6D88\u606F\u8FDB\u884C\u54CD\u5E94\u3002"]}),"\n",(0,o.jsx)(n.admonition,{title:"\u63D0\u793A",type:"tip",children:(0,o.jsxs)(n.p,{children:["\u5982\u679C\u4E00\u6761\u6D88\u606F\u4E2D\u5305\u542B\u201C@\u673A\u5668\u4EBA\u201D\u6216\u4EE5\u201C\u673A\u5668\u4EBA\u7684\u6635\u79F0\u201D\u5F00\u59CB\uFF0C\u4F8B\u5982 ",(0,o.jsx)(n.code,{children:"@bot /\u5929\u6C14"})," \u65F6\uFF0C\u534F\u8BAE\u9002\u914D\u5668\u4F1A\u5C06 ",(0,o.jsx)(n.code,{children:"event.is_tome()"})," \u5224\u65AD\u4E3A ",(0,o.jsx)(n.code,{children:"True"})," \uFF0C\u540C\u65F6\u4E5F\u4F1A\u81EA\u52A8\u53BB\u9664 ",(0,o.jsx)(n.code,{children:"@bot"}),"\uFF0C\u5373\u4E8B\u4EF6\u54CD\u5E94\u5668\u6536\u5230\u7684\u4FE1\u606F\u5185\u5BB9\u4E3A ",(0,o.jsx)(n.code,{children:"/\u5929\u6C14"}),"\uFF0C\u65B9\u4FBF\u8FDB\u884C\u547D\u4EE4\u5339\u914D\u3002"]})}),"\n",(0,o.jsx)(n.h3,{id:"\u4E3A\u4E8B\u4EF6\u54CD\u5E94\u5668\u6DFB\u52A0\u53C2\u6570",children:"\u4E3A\u4E8B\u4EF6\u54CD\u5E94\u5668\u6DFB\u52A0\u53C2\u6570"}),"\n",(0,o.jsx)(n.p,{children:"\u5728\u8F85\u52A9\u51FD\u6570\u4E2D\uFF0C\u6211\u4EEC\u53EF\u4EE5\u6DFB\u52A0\u4E00\u4E9B\u53C2\u6570\u6765\u5BF9\u4E8B\u4EF6\u54CD\u5E94\u5668\u8FDB\u884C\u66F4\u52A0\u7CBE\u7EC6\u7684\u8C03\u6574\uFF0C\u4F8B\u5982\u4E8B\u4EF6\u54CD\u5E94\u5668\u7684\u4F18\u5148\u7EA7\u3001\u5339\u914D\u89C4\u5219\u7B49\u3002\u4F8B\u5982\uFF1A"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-python",metastring:"{4} title=weather/__init__.py",children:'from nonebot import on_command\nfrom nonebot.rule import to_me\

1n\nweather = on_command(\n    "\u5929\u6C14", rule=to_me(), aliases={"weather", "\u67E5\u5929\u6C14"}, priority=10, block=True\n)\n'})}),"\n",(0,o.jsxs)(n.p,{children:["\u8FD9\u6837\uFF0C\u6211\u4EEC\u5C31\u83B7\u5F97\u4E86\u4E00\u4E2A\u53EF\u4EE5\u54CD\u5E94 ",(0,o.jsx)(n.code,{children:"\u5929\u6C14"}),"\u3001",(0,o.jsx)(n.code,{children:"weather"}),"\u3001",(0,o.jsx)(n.code,{children:"\u67E5\u5929\u6C14"})," \u4E09\u4E2A\u547D\u4EE4\u7684\u54CD\u5E94\u89C4\u5219\uFF0C\u9700\u8981\u79C1\u804A\u6216 ",(0,o.jsx)(n.code,{children:"@bot"})," \u65F6\u624D\u4F1A\u54CD\u5E94\uFF0C\u4F18\u5148\u7EA7\u4E3A 10\uFF08\u8D8A\u5C0F\u8D8A\u4F18\u5148\uFF09\uFF0C\u963B\u65AD\u4E8B\u4EF6\u5411\u540E\u7EED\u4F18\u5148\u7EA7\u4F20\u64AD\u7684\u4E8B\u4EF6\u54CD\u5E94\u5668\u4E86\u3002\u8FD9\u4E9B\u5185\u5BB9\u7684\u610F\u4E49\u548C\u4F7F\u7528\u65B9\u6CD5\u5C06\u4F1A\u5728\u540E\u7EED\u7684\u7AE0\u8282\u4E2D\u4E00\u4E00\u4ECB\u7ECD\u3002"]}),"\n",(0,o.jsx)(n.admonition,{title:"\u63D0\u793A",type:"tip",children:(0,o.jsxs)(n.p,{children:["\u9700\u8981\u6CE8\u610F\u7684\u662F\uFF0C\u4E0D\u540C\u7684\u8F85\u52A9\u51FD\u6570\u6709\u4E0D\u540C\u7684\u53EF\u9009\u53C2\u6570\uFF0C\u5728\u4F7F\u7528\u4E4B\u524D\u53EF\u4EE5\u53C2\u8003",(0,o.jsx)(n.a,{href:"/docs/next/advanced/matcher#%E5%9F%BA%E6%9C%AC%E8%BE%85%E5%8A%A9%E5%87%BD%E6%95%B0",children:"\u4E8B\u4EF6\u54CD\u5E94\u5668\u8FDB\u9636 - \u57FA\u672C\u8F85\u52A9\u51FD\u6570"}),"\u6216 ",(0,o.jsx)(n.a,{href:"/docs/next/api/plugin/on#on",children:"API \u6587\u6863"}),"\u3002"]})})]})}function h(e={}){let{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(a,{...e})}):a(e)}},43023(e,n,t){t.d(n,{R:()=>c,x:()=>d});var r=t(63696);let o={},i=r.createContext(o);function c(e){let n=r.useContext(i);return r.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:c(e.components),r.createElement(i.Provider,{value:n},e.children)}}}]);