https://nonebot.dev/assets/js/09142b9d.9766096f.js

1"use strict";(self.webpackChunknonebot=self.webpackChunknonebot||[]).push([["2099"],{82074(e,n,r){r.r(n),r.d(n,{metadata:()=>s,default:()=>a,frontMatter:()=>c,contentTitle:()=>i,toc:()=>t,assets:()=>h});var s=JSON.parse('{"id":"best-practice/scheduler","title":"\u5B9A\u65F6\u4EFB\u52A1","description":"\u5B9A\u65F6\u6267\u884C\u4EFB\u52A1","source":"@site/versioned_docs/version-2.4.3/best-practice/scheduler.md","sourceDirName":"best-practice","slug":"/best-practice/scheduler","permalink":"/docs/2.4.3/best-practice/scheduler","draft":false,"unlisted":false,"editUrl":"https://github.com/nonebot/nonebot2/edit/master/website/versioned_docs/version-2.4.3/best-practice/scheduler.md","tags":[],"version":"2.4.3","lastUpdatedBy":"pre-commit-ci[bot]","lastUpdatedAt":1789135437000,"sidebarPosition":0,"frontMatter":{"sidebar_position":0,"description":"\u5B9A\u65F6\u6267\u884C\u4EFB\u52A1"},"sidebar":"tutorial","previous":{"title":"\u4E8B\u4EF6\u54CD\u5E94\u5668\u5B58\u50A8","permalink":"/docs/2.4.3/advanced/matcher-provider"},"next":{"title":"\u6570\u636E\u5B58\u50A8","permalink":"/docs/2.4.3/best-practice/data-storing"}}'),d=r(62540),l=r(43023);let c={sidebar_position:0,description:"\u5B9A\u65F6\u6267\u884C\u4EFB\u52A1"},i="\u5B9A\u65F6\u4EFB\u52A1",h={},t=[{value:"\u5B89\u88C5\u63D2\u4EF6",id:"\u5B89\u88C5\u63D2\u4EF6",level:2},{value:"\u4F7F\u7528\u63D2\u4EF6",id:"\u4F7F\u7528\u63D2\u4EF6",level:2},{value:"\u5BFC\u5165\u8C03\u5EA6\u5668",id:"\u5BFC\u5165\u8C03\u5EA6\u5668",level:3},{value:"\u6DFB\u52A0\u5B9A\u65F6\u4EFB\u52A1",id:"\u6DFB\u52A0\u5B9A\u65F6\u4EFB\u52A1",level:3},{value:"\u914D\u7F6E\u9879",id:"\u914D\u7F6E\u9879",level:3},{value:"apscheduler_autostart",id:"apscheduler_autostart",level:4},{value:"apscheduler_log_level",id:"apscheduler_log_level",level:4},{value:"apscheduler_config",id:"apscheduler_config",level:4}];function o(e){let n={a:"a",admonition:"admonition",code:"code",h1:"h1",h2:"h2",h3:"h3",h4:"h4",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,l.R)(),...e.components};return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(n.header,{children:(0,d.jsx)(n.h1,{id:"\u5B9A\u65F6\u4EFB\u52A1",children:"\u5B9A\u65F6\u4EFB\u52A1"})}),"\n",(0,d.jsxs)(n.p,{children:[(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/3.x/",children:"APScheduler"})," (Advanced Python Scheduler) \u662F\u4E00\u4E2A Python \u7B2C\u4E09\u65B9\u5E93\uFF0C\u5176\u5F3A\u5927\u7684\u5B9A\u65F6\u4EFB\u52A1\u529F\u80FD\u88AB\u5E7F\u6CDB\u5E94\u7528\u4E8E\u5404\u4E2A\u573A\u666F\u3002\u5728 NoneBot \u4E2D\uFF0C\u5B9A\u65F6\u4EFB\u52A1\u4F5C\u4E3A\u4E00\u4E2A\u989D\u5916\u529F\u80FD\uFF0C\u4F9D\u8D56\u4E8E\u57FA\u4E8E APScheduler \u5F00\u53D1\u7684 ",(0,d.jsx)(n.a,{href:"https://github.com/nonebot/plugin-apscheduler",children:(0,d.jsx)(n.code,{children:"nonebot-plugin-apscheduler"})})," \u63D2\u4EF6\u8FDB\u884C\u652F\u6301\u3002"]}),"\n",(0,d.jsx)(n.h2,{id:"\u5B89\u88C5\u63D2\u4EF6",children:"\u5B89\u88C5\u63D2\u4EF6"}),"\n",(0,d.jsxs)(n.p,{children:["\u5728\u4F7F\u7528\u524D\u8BF7\u5148\u5B89\u88C5 ",(0,d.jsx)(n.code,{children:"nonebot-plugin-apscheduler"})," \u63D2\u4EF6\u81F3\u9879\u76EE\u73AF\u5883\u4E2D\uFF0C\u53EF\u53C2\u8003",(0,d.jsx)(n.a,{href:"/docs/2.4.3/tutorial/store#%E5%AE%89%E8%A3%85%E6%8F%92%E4%BB%B6",children:"\u83B7\u53D6\u5546\u5E97\u63D2\u4EF6"}),"\u6765\u4E86\u89E3\u5E76\u9009\u62E9\u5B89\u88C5\u63D2\u4EF6\u7684\u65B9\u5F0F\u3002\u5982\uFF1A"]}),"\n",(0,d.jsxs)(n.p,{children:["\u5728",(0,d.jsx)(n.strong,{children:"\u9879\u76EE\u76EE\u5F55"}),"\u4E0B\u6267\u884C\u4EE5\u4E0B\u547D\u4EE4\uFF1A"]}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-bash",children:"nb plugin install nonebot-plugin-apscheduler\n"})}),"\n",(0,d.jsx)(n.h2,{id:"\u4F7F\u7528\u63D2\u4EF6",children:"\u4F7F\u7528\u63D2\u4EF6"}),"\n",(0,d.jsxs)(n.p,{children:[(0,d.jsx)(n.code,{children:"nonebot-plugin-apscheduler"})," \u672C\u8D28\u4E0A\u662F\u5BF9 ",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/3.x/",children:"APScheduler"})," \u8FDB\u884C\u4E86\u5C01\u88C5\u4EE5\u9002\u7528\u4E8E NoneBot \u5F00\u53D1\uFF0C\u56E0\u6B64\u5176\u4F7F\u7528\u65B9\u5F0F\u4E0E APScheduler \u672C\u8EAB\u5E76\u65E0\u663E\u8457\u533A\u522B\u3002\u5728\u6B64\u6211\u4EEC\u4F1A\u7B80\u8981\u4ECB\u7ECD\u5176\u8

1C03\u7528\u65B9\u6CD5\uFF0C\u66F4\u591A\u7684\u4F7F\u7528\u65B9\u9762\u7684\u529F\u80FD\u8BF7\u53C2\u8003",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/3.x/userguide.html",children:"APScheduler \u5B98\u65B9\u6587\u6863"}),"\u3002"]}),"\n",(0,d.jsx)(n.h3,{id:"\u5BFC\u5165\u8C03\u5EA6\u5668",children:"\u5BFC\u5165\u8C03\u5EA6\u5668"}),"\n",(0,d.jsxs)(n.p,{children:["\u7531\u4E8E ",(0,d.jsx)(n.code,{children:"nonebot_plugin_apscheduler"})," \u4F5C\u4E3A\u63D2\u4EF6\uFF0C\u56E0\u6B64\u9700\u8981\u5728\u4F7F\u7528\u524D\u5BF9\u5176\u8FDB\u884C",(0,d.jsx)(n.strong,{children:"\u52A0\u8F7D"}),"\u5E76",(0,d.jsx)(n.strong,{children:"\u5BFC\u5165"}),"\u5176\u4E2D\u7684 ",(0,d.jsx)(n.code,{children:"scheduler"})," \u8C03\u5EA6\u5668\u6765\u521B\u5EFA\u5B9A\u65F6\u4EFB\u52A1\u3002\u4F7F\u7528 ",(0,d.jsx)(n.code,{children:"require"})," \u65B9\u6CD5\u53EF\u8F7B\u677E\u5B8C\u6210\u8FD9\u4E00\u8FC7\u7A0B\uFF0C\u53EF\u53C2\u8003 ",(0,d.jsx)(n.a,{href:"/docs/2.4.3/advanced/requiring",children:"\u8DE8\u63D2\u4EF6\u8BBF\u95EE"})," \u4E00\u8282\u8FDB\u884C\u4E86\u89E3\u3002"]}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-python",children:'from nonebot import require\n\nrequire("nonebot_plugin_apscheduler")\n\nfrom nonebot_plugin_apscheduler import scheduler\n'})}),"\n",(0,d.jsx)(n.h3,{id:"\u6DFB\u52A0\u5B9A\u65F6\u4EFB\u52A1",children:"\u6DFB\u52A0\u5B9A\u65F6\u4EFB\u52A1"}),"\n",(0,d.jsxs)(n.p,{children:["\u5728 ",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/3.x/userguide.html#adding-jobs",children:"APScheduler \u5B98\u65B9\u6587\u6863"})," \u4E2D\u63D0\u4F9B\u4E86\u4EE5\u4E0B\u4E24\u79CD\u76F4\u63A5\u6DFB\u52A0\u4EFB\u52A1\u7684\u65B9\u5F0F\uFF1A"]}),"\n",(0,d.jsx)(n.pre,{children:(0,d.jsx)(n.code,{className:"language-python",children:'from nonebot import require\n\nrequire("nonebot_plugin_apscheduler")\n\nfrom nonebot_plugin_apscheduler import scheduler\n\n\n# \u57FA\u4E8E\u88C5\u9970\u5668\u7684\u65B9\u5F0F\[email protected]_job("cron", hour="*/2", id="job_0", args=[1], kwargs={arg2: 2})\nasync def run_every_2_hour(arg1: int, arg2: int):\n    pass\n\n\n# \u57FA\u4E8E add_job \u65B9\u6CD5\u7684\u65B9\u5F0F\ndef run_every_day(arg1: int, arg2: int):\n    pass\n\n\nscheduler.add_job(\n    run_every_day, "interval", days=1, id="job_1", args=[1], kwargs={arg2: 2}\n)\n'})}),"\n",(0,d.jsxs)(n.admonition,{title:"\u6CE8\u610F",type:"warning",children:[(0,d.jsxs)(n.p,{children:["\u7531\u4E8E APScheduler \u7684\u5B9A\u65F6\u4EFB\u52A1\u5E76\u4E0D\u662F",(0,d.jsx)(n.strong,{children:"\u7531\u4E8B\u4EF6\u54CD\u5E94\u5668\u6240\u89E6\u53D1\u7684\u4E8B\u4EF6"}),"\uFF0C\u56E0\u6B64\u5176\u4EFB\u52A1\u51FD\u6570\u65E0\u6CD5\u540C",(0,d.jsx)(n.a,{href:"/docs/2.4.3/tutorial/handler#%E4%BA%8B%E4%BB%B6%E5%A4%84%E7%90%86%E5%87%BD%E6%95%B0",children:"\u4E8B\u4EF6\u5904\u7406\u51FD\u6570"}),"\u4E00\u6837\u901A\u8FC7",(0,d.jsx)(n.a,{href:"/docs/2.4.3/tutorial/event-data#%E8%AE%A4%E8%AF%86%E4%BE%9D%E8%B5%96%E6%B3%A8%E5%85%A5",children:"\u4F9D\u8D56\u6CE8\u5165"}),"\u83B7\u53D6\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF0C\u4E5F\u65E0\u6CD5\u901A\u8FC7\u4E8B\u4EF6\u54CD\u5E94\u5668\u5BF9\u8C61\u7684\u65B9\u6CD5\u8FDB\u884C\u4EFB\u4F55\u64CD\u4F5C\uFF0C\u56E0\u6B64\u6211\u4EEC\u9700\u8981\u4F7F\u7528",(0,d.jsx)(n.a,{href:"/docs/2.4.3/appendices/api-calling#%E8%B0%83%E7%94%A8%E5%B9%B3%E5%8F%B0-api",children:"\u8C03\u7528\u5E73\u53F0 API"}),"\u7684\u65B9\u5F0F\u6765\u83B7\u53D6\u4FE1\u606F\u6216\u6536\u53D1\u6D88\u606F\u3002"]}),(0,d.jsxs)(n.p,{children:["\u76F8\u5BF9\u4E8E\u4E8B\u4EF6\u5904\u7406\u4F9D\u8D56\u800C\u8A00\uFF0C\u7F16\u5199\u5B9A\u65F6\u4EFB\u52A1\u66F4\u50CF\u662F\u7F16\u5199\u666E\u901A\u7684\u51FD\u6570\uFF0C\u9700\u8981\u6211\u4EEC\u81EA\u884C\u83B7\u53D6\u4FE1\u606F\u4EE5\u53CA\u53D1\u9001\u4FE1\u606F\uFF0C\u8BF7",(0,d.jsx)(n.strong,{children:"\u4E0D\u8981"}),"\u5C06\u4E8B\u4EF6\u5904\u7406\u4F9D\u8D56\u7684\u7279\u6B8A\u8BED\u6CD5\u7528\u4E8E\u5B9A\u65F6\u4EFB\u52A1\uFF01"]})]}),"\n",(0,d.jsxs)(n.p,{children:["\u5173\u4E8E APScheduler \u7684\u66F4\u591A\u4F7F\u7528\u65B9\u6CD5\uFF0C\u53EF\u4EE5\u53C2\u8003 ",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/3.x/index.html",children:"APScheduler \u5B98\u65B9\u6587\u6863"})," \u8FDB\u884C\u4E86\u89E3\u3002"]}),"\n",(0,d.jsx)(n.h3,{id:"\u914D\u7F6E\u9879",children:"\u914D\u7F6E\u9879"}),"\n",(0,d.jsx)(n.h4,{id:"apscheduler_autostart",children:"apscheduler_autostart"}),"\n",(0,d.jsxs)(n.ul,{children:["\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u7C7B\u578B"}),": ",(0,d.jsx)(n.code,{children:"bool"})]}),"\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u9ED8\u8BA4\u503C"}),": ",(0,d.jsx)(n.code,{children:"True"})]}),"\n"]}),"\n",(0,d.jsxs)(n.p,{children:["\u662F\u5426\u81EA\u52A8\u542F\u52A8 ",(0,d.jsx)(n.code,{children:"scheduler"})," \uFF0C\u82E5\u4E0D\u542F\u52A8\u9700\u8981\u81EA\u884C\u8C03\u7528 ",(0,d.jsx)(n.code,{children:"scheduler.start()"}),"\u3002"]}),"\n",(0,d.jsx)(n.h4,{id:"apscheduler_log_level",children:"apscheduler_log_level"}),"\n",(0,d.jsxs)(n.ul,{children:["\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u7C7B\u578B"}),": ",(0,d.jsx)(n.code,{children:"int"})]}),"\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u9ED8\u8BA4\u503C"}),": ",(0,d.jsx)(n.code,{children:"30"})]}),"\n"]}),"\n",(0,d.jsx)(n.p,{children:"apscheduler \u8F93\u51FA\u7684\u65E5\u5FD7\u7B49\u7EA7"}),"\n",(0,d.jsxs)(n.ul,{children:["\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.code,{children:"WARNING"})," = ",(0,d.jsx)(n.code,{children:"30"}

1)," (\u9ED8\u8BA4)"]}),"\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.code,{children:"INFO"})," = ",(0,d.jsx)(n.code,{children:"20"})]}),"\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.code,{children:"DEBUG"})," = ",(0,d.jsx)(n.code,{children:"10"})," (\u53EA\u6709\u5728\u5F00\u542F nonebot \u7684 debug \u6A21\u5F0F\u624D\u4F1A\u663E\u793A debug \u65E5\u5FD7)"]}),"\n"]}),"\n",(0,d.jsx)(n.h4,{id:"apscheduler_config",children:"apscheduler_config"}),"\n",(0,d.jsxs)(n.ul,{children:["\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u7C7B\u578B"}),": ",(0,d.jsx)(n.code,{children:"dict"})]}),"\n",(0,d.jsxs)(n.li,{children:[(0,d.jsx)(n.strong,{children:"\u9ED8\u8BA4\u503C"}),": ",(0,d.jsx)(n.code,{children:'{ "apscheduler.timezone": "Asia/Shanghai" }'})]}),"\n"]}),"\n",(0,d.jsxs)(n.p,{children:[(0,d.jsx)(n.code,{children:"apscheduler"})," \u7684\u76F8\u5173\u914D\u7F6E\u3002\u53C2\u8003",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/latest/userguide.html#scheduler-config",children:"\u914D\u7F6E\u8C03\u5EA6\u5668"}),", ",(0,d.jsx)(n.a,{href:"https://apscheduler.readthedocs.io/en/latest/modules/schedulers/base.html#apscheduler.schedulers.base.BaseScheduler",children:"\u914D\u7F6E\u53C2\u6570"})]}),"\n",(0,d.jsxs)(n.p,{children:["\u914D\u7F6E\u9700\u8981\u5305\u542B ",(0,d.jsx)(n.code,{children:"apscheduler."})," \u4F5C\u4E3A\u524D\u7F00\uFF0C\u4F8B\u5982 ",(0,d.jsx)(n.code,{children:"apscheduler.timezone"}),"\u3002"]})]})}function a(e={}){let{wrapper:n}={...(0,l.R)(),...e.components};return n?(0,d.jsx)(n,{...e,children:(0,d.jsx)(o,{...e})}):o(e)}},43023(e,n,r){r.d(n,{R:()=>c,x:()=>i});var s=r(63696);let d={},l=s.createContext(d);function c(e){let n=s.useContext(l);return s.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function i(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(d):e.components||d:c(e.components),s.createElement(l.Provider,{value:n},e.children)}}}]);