2024-08-17 01:28:57 +08:00
<!doctype html>
< html lang = "en-US" data-theme = "light" >
< head >
< meta charset = "utf-8" / >
< meta name = "viewport" content = "width=device-width,initial-scale=1" / >
< meta name = "generator" content = "VuePress 2.0.0-rc.9" / >
< meta name = "theme" content = "VuePress Theme Hope 2.0.0-rc.32" / >
< style >
html {
background: var(--bg-color, #fff);
}
html[data-theme="dark"] {
background: var(--bg-color, #1d1e1f);
}
body {
background: var(--bg-color);
}
< / style >
< script >
const userMode = localStorage.getItem("vuepress-theme-hope-scheme");
const systemDarkMode =
window.matchMedia & &
window.matchMedia("(prefers-color-scheme: dark)").matches;
if (userMode === "dark" || (userMode !== "light" & & systemDarkMode)) {
document.documentElement.setAttribute("data-theme", "dark");
}
< / script >
2024-08-17 02:40:51 +08:00
< link rel = "alternate" hreflang = "zh-cn" href = "https://vuepress-theme-hope-docs-demo.netlify.app/dev/dev_lyplugin.html" > < meta property = "og:url" content = "https://vuepress-theme-hope-docs-demo.netlify.app/en/dev/dev_lyplugin.html" > < meta property = "og:site_name" content = "LiteyukiBot" > < meta property = "og:title" content = "Liteyuki Plugin" > < meta property = "og:description" content = "简介 轻雪插件是轻雪内置的一部分功能，运行在主进程中，可以很高程度地扩展轻雪的功能 开始 创建插件 在标准项目中， ， > < meta property = "og:type" content = "article" > < meta property = "og:locale" content = "en-US" > < meta property = "og:locale:alternate" content = "zh-CN" > < meta property = "og:updated_time" content = "2024-08-16T18:24:25.000Z" > < meta property = "article:modified_time" content = "2024-08-16T18:24:25.000Z" > < script type = "application/ld+json" > { "@context" : "https://schema.org" , "@type" : "Article" , "headline" : "Liteyuki Plugin" , "image" : [ "" ] , "dateModified" : "2024-08-16T18:24:25.000Z" , "author" : [ ] } < / script > < script src = "/js/en/get_data.js" type = "module" > < / script > < script src = "/js/style.js" type = "module" > < / script > < link rel = "icon" href = "https://cdn.liteyuki.icu/favicon.ico" > < link rel = "stylesheet" href = "https://cdn.bootcdn.net/ajax/libs/firacode/6.2.0/fira_code.min.css" > < meta name = "viewport" content = "width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" > < title > Liteyuki Plugin | LiteyukiBot< / title > < meta name = "description" content = "简介 轻雪插件是轻雪内置的一部分功能，运行在主进程中，可以很高程度地扩展轻雪的功能 开始 创建插件 在标准项目中， ， >
2024-08-17 01:28:57 +08:00
< link rel = "preload" href = "/assets/style-CSEr-Ojo.css" as = "style" > < link rel = "stylesheet" href = "/assets/style-CSEr-Ojo.css" >
2024-08-18 23:55:23 +08:00
< link rel = "modulepreload" href = "/assets/app-Bk1i6mNH.js" > < link rel = "modulepreload" href = "/assets/dev_lyplugin.html-Dj33Cf-H.js" >
< link rel = "prefetch" href = "/assets/index.html-_uY4fxPi.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-CYlyVOMk.js" as = "script" > < link rel = "prefetch" href = "/assets/config.html-C6xf-_cf.js" as = "script" > < link rel = "prefetch" href = "/assets/fandq.html-CVaXyDLQ.js" as = "script" > < link rel = "prefetch" href = "/assets/install.html-CnSd2vav.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-BxZ2QaQw.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_comm.html-BUHuoi-N.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_lyfunc.html-Bz-YvQqy.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_lyplugin.html-CgjV1ddB.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_resource_pack.html-DFOq9a3x.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-8fyHEzWB.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-uOhf5lYI.js" as = "script" > < link rel = "prefetch" href = "/assets/plugin.html-BXaN_N6O.js" as = "script" > < link rel = "prefetch" href = "/assets/resource.html-DgeiLlrs.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-CCJctvef.js" as = "script" > < link rel = "prefetch" href = "/assets/agreement.html-DJfTXcGV.js" as = "script" > < link rel = "prefetch" href = "/assets/basic_command.html-CgS-B7zJ.js" as = "script" > < link rel = "prefetch" href = "/assets/extra_command.html-BBtEISKo.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-Ceb-Xg5f.js" as = "script" > < link rel = "prefetch" href = "/assets/config.html-B8pLTmlP.js" as = "script" > < link rel = "prefetch" href = "/assets/fandq.html-DC8ZLLoQ.js" as = "script" > < link rel = "prefetch" href = "/assets/install.html-CG5fhwfV.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-D_oEW9DN.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_comm.html-pn6twGQI.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_lyfunc.html-DLMH8sRT.js" as = "script" > < link rel = "prefetch" href = "/assets/dev_resource_pack.html-CWB8kc3r.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-BbVUwY3y.js" as = "script" > < link rel = "prefetch" href = "/assets/plugin.html-DRpIpZAD.js" as = "script" > < link rel = "prefetch" href = "/assets/resource.html-D8A823VM.js" as = "script" > < link rel = "prefetch" href = "/assets/index.html-awbsld8L.js" as = "script" > < link rel = "prefetch" href = "/assets/agreement.html-BQxmZuPj.js" as = "script" > < link rel = "prefetch" href = "/assets/basic_command.html-DXvZ6CRl.js" as = "script" > < link rel = "prefetch" href = "/assets/extra_command.html-M5BhFOH-.js" as = "script" > < link rel = "prefetch" href = "/assets/404.html-DOXZ4XWm.js" as = "script" > < link rel = "prefetch" href = "/assets/giscus-7BMGhbDA.js" as = "script" > < link rel = "prefetch" href = "/assets/index-Cw_AvLww.js" as = "script" > < link rel = "prefetch" href = "/assets/photoswipe.esm-SzV8tJDW.js" as = "script" >
2024-08-17 01:28:57 +08:00
< / head >
< body >
2024-08-17 02:40:51 +08:00
< div id = "app" > <!-- [ --> <!-- [ --> <!-- [ --> < span tabindex = "-1" > < / span > < a href = "#main-content" class = "vp-skip-link sr-only" > Skip to main content< / a > <!-- ] --> < div class = "theme-container has-toc" > <!-- [ --> < header id = "navbar" class = "vp-navbar" > < div class = "vp-navbar-start" > < button type = "button" class = "vp-toggle-sidebar-button" title = "Toggle Sidebar" > < span class = "icon" > < / span > < / button > <!-- [ --> <!-- --> <!-- ] --> <!-- [ --> < a class = "route-link vp-brand" href = "/en/" > < img class = "vp-nav-logo" src = "https://cdn.liteyuki.icu/static/img/liteyuki_icon_640.png" alt > <!-- --> < span class = "vp-site-name hide-in-pad" > LiteyukiBot< / span > < / a > <!-- ] --> <!-- [ --> <!-- --> <!-- ] --> < / div > < div class = "vp-navbar-center" > <!-- [ --> <!-- --> <!-- ] --> <!-- [ --> < nav class = "vp-nav-links" > < div class = "nav-item hide-in-mobile" > < a class = "route-link nav-link" href = "/en/" aria-label = "Home" > < span class = "font-icon icon fa-fw fa-sm fas fa-home" style = "" > < / span > Home<!-- --> < / a > < / div > < div class = "nav-item hide-in-mobile" > < a class = "route-link nav-link" href = "/en/deploy/" aria-label = "Deploy" > <!-- --> Deploy<!-- --> < / a > < / div > < div class = "nav-item hide-in-mobile" > < a class = "route-link nav-link" href = "/en/usage/" aria-label = "Usage" > <!-- --> Usage<!-- --> < / a > < / div > < div class = "nav-item hide-in-mobile" > < a class = "route-link nav-link" href = "/en/store/" aria-label = "Extensions" > <!-- --> Extensions<!-- --> < / a > < / div > < div class = "nav-item hide-in-mobile" > < a class = "route-link nav-link active" href = "/en/dev/" aria-label = "Contribute" > <!-- --> Contribute<!-- --> < / a > < / div > < / nav > <!-- ] --> <!-- [ --> <!-- --> <!-- ] --> < / div > < div class = "vp-navbar-end" > <!-- [ --> <!-- --> <!-- ] --> <!-- [ --> < div class = "nav-item" > < div class = "dropdown-wrapper i18n-dropdown" > < button type = "button" class = "dropdown-title" aria-label = "Select language" > <!-- [ --> < svg xmlns = "http://www.w3.org/2000/svg" class = "icon i18n-icon" viewBox = "0 0 1024 1024" fill = "currentColor" aria-label = "i18n icon" style = "width:1rem;height:1rem;vertical-align:middle;" > < path d = "M379.392 460.8 494.08 575.488l-42.496 102.4L307.2 532.48 138.24 701.44l-71.68-72.704L234.496 460.8l-45.056-45.056c-27.136-27.136-51.2-66.56-66.56-108.544h112.64c7.68 14.336 16.896 27.136 26.112 35.84l45.568 46.08 45.056-45.056C382.976 312.32 409.6 247.808 409.6 204.8H0V102.4h256V0h102.4v102.4h256v102.4H512c0 70.144-37.888 161.28-87.04 210.944L378.88 460.8zM576 870.4 512 1024H409.6l256-614.4H768l256 614.4H921.6l-64-153.6H576zM618.496 768h196.608L716.8 532.48 618.496 768z" > < / path > < / svg > <!-- ] --> < span class = "arrow" > < / span > < ul class = "nav-dropdown" > < li class = "dropdown-item" > < a class = "route-link nav-link" href = "/dev/dev_lyplugin.html" aria-label = "简体中文" > <!-- --> 简体中文<!-- --> < / a > < / li > < li class = "dropdown-item" > < a class = "route-link nav-link active" href = "/en/dev/dev_lyplugin.html" aria-label = "English" > <!-- --> English<!-- --> < / a > < / li > < / ul > < / button > < / div > < / div > < div class = "nav-item vp-repo" > < a class = "vp-repo-link" href = "https://github.com/LiteyukiStudio/LiteyukiBot" target = "_blank" rel = "noopener noreferrer" aria-label = "GitHub" > < svg xmlns = "http://www.w3.org/2000/svg" class = "icon github-icon" viewBox = "0 0 1024 1024" fill = "currentColor" aria-label = "github icon" style = "width:1.25rem;height:1.25rem;vertical-align:middle;" > < path d = "M511.957 21 . 333C241 . 024 21 . 333 21 . 333 240 . 981 21 . 333 512c0 216 . 832 140 . 544 400 . 725 335 . 574 465 . 664 24 . 49 4 . 395 32 . 256-10 . 07 32 . 256-23 . 083 0-11 . 69 . 256-44 . 245 0-85 . 205-136 . 448 29 . 61-164 . 736-64 . 64-164 . 736-64 . 64-22 . 315-56 . 704-54 . 4-71 . 765-54 . 4-71 . 765-44 . 587-30 . 464 3 . 285-29 . 824 3 . 285-29 . 824 49 . 195 3 . 413 75 . 179 50 . 517 75 . 179 50 . 517 43 . 776 75 . 008 114 . 816 53 . 333 142 . 762 40 . 79 4 . 523-31 . 66 17 . 152-53 . 377 31 . 19-65 . 537-108 . 971-12 . 458-223 . 488-54 . 485-223 . 488-242 . 602 0-53 . 547 19 . 114-97 . 323 50 . 517-131 . 67-5 . 035-12 . 33-21 . 93-62 . 293 4 . 779-129 . 834 0 0 41 . 258-13 . 184 134 . 912 50 . 346a469 . 803 469 . 803 0 0 1 122 . 88-16 . 554c41 . 642 . 213 83 . 626 5 . 632 122 . 88 16 . 554 93 . 653-63 . 488 134 . 784-50 . 346 134 . 784-50 . 346 26 . 752 67 . 541 9 . 898 117 . 504 4 . 864 129 . 834 31 . 402 34 . 347 50 . 474 78 . 123 50 . 474 131 . 67 0 188 . 586-114 . 73 230 . 016-224 . 042 242 . 09 17 . 578 15 . 232 33 . 578 44 . 672 33 . 578 90 . 454v135 . 85c0 13 . 142 7 . 936 27 . 606 32 . 854 22 . 87C862 . 25 912 . 597 1002 . 667 728 . 74
2024-08-17 01:28:57 +08:00
< span class = "token comment" > # 定义插件元数据，推荐填写< / span >
__plugin_meta__ < span class = "token operator" > =< / span > PluginMetadata< span class = "token punctuation" > (< / span >
name< span class = "token operator" > =< / span > < span class = "token string" > " NoneDog" < / span > < span class = "token punctuation" > ,< / span > < span class = "token comment" > # 插件名称< / span >
version< span class = "token operator" > =< / span > < span class = "token string" > " 1.0.0" < / span > < span class = "token punctuation" > ,< / span > < span class = "token comment" > # 插件版本< / span >
description< span class = "token operator" > =< / span > < span class = "token string" > " A simple plugin for nonebot developer" < / span > < span class = "token comment" > # 插件描述< / span >
< span class = "token punctuation" > )< / span >
< span class = "token comment" > # 你的插件代码< / span >
< span class = "token punctuation" > .< / span > < span class = "token punctuation" > .< / span > < span class = "token punctuation" > .< / span >
< / code > < / pre > < div class = "line-numbers" aria-hidden = "true" > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < / div > < / div > < h3 id = "编写逻辑部分" tabindex = "-1" > < a class = "header-anchor" href = "#编写逻辑部分" > < span > 编写逻辑部分< / span > < / a > < / h3 > < p > 轻雪主进程不涉及聊天部分，因此插件主要是一些后台任务或者与聊天机器人的通信 以下我们会编写一个简单的插件， < / p > < div class = "language-python line-numbers-mode" data-ext = "py" data-title = "py" > < pre class = "language-python" > < code > < span class = "token keyword" > import< / span > os
< span class = "token keyword" > from< / span > liteyuki< span class = "token punctuation" > .< / span > dev < span class = "token keyword" > import< / span > observer < span class = "token comment" > # 导入文件系统观察器< / span >
< span class = "token keyword" > from< / span > liteyuki < span class = "token keyword" > import< / span > get_bot< span class = "token punctuation" > ,< / span > logger < span class = "token comment" > # 导入轻雪Bot和日志< / span >
< span class = "token keyword" > from< / span > watchdog< span class = "token punctuation" > .< / span > events < span class = "token keyword" > import< / span > FileSystemEvent < span class = "token comment" > # 导入文件系统事件< / span >
liteyuki < span class = "token operator" > =< / span > get_bot< span class = "token punctuation" > (< / span > < span class = "token punctuation" > )< / span > < span class = "token comment" > # 获取唯一的轻雪Bot实例< / span >
exclude_extensions < span class = "token operator" > =< / span > < span class = "token punctuation" > (< / span > < span class = "token string" > " .pyc" < / span > < span class = "token punctuation" > ,< / span > < span class = "token string" > " .pyo" < / span > < span class = "token punctuation" > )< / span > < span class = "token comment" > # 排除的文件扩展名< / span >
< span class = "token comment" > # 用observer的on_file_system_event装饰器监听文件系统事件< / span >
< span class = "token decorator annotation punctuation" > @observer< span class = "token punctuation" > .< / span > on_file_system_event< / span > < span class = "token punctuation" > (< / span >
directories< span class = "token operator" > =< / span > < span class = "token punctuation" > (< / span > < span class = "token string" > " src/nonebot_plugins" < / span > < span class = "token punctuation" > ,< / span > < span class = "token punctuation" > )< / span > < span class = "token punctuation" > ,< / span >
event_filter< span class = "token operator" > =< / span > < span class = "token keyword" > lambda< / span > event< span class = "token punctuation" > :< / span > < span class = "token keyword" > not< / span > event< span class = "token punctuation" > .< / span > src_path< span class = "token punctuation" > .< / span > endswith< span class = "token punctuation" > (< / span > exclude_extensions< span class = "token punctuation" > )< / span > < span class = "token keyword" > and< / span > < span class = "token punctuation" > (< / span > < span class = "token string" > " __pycache__" < / span > < span class = "token keyword" > not< / span > < span class = "token keyword" > in< / span > event< span class = "token punctuation" > .< / span > src_path< span class = "token punctuation" > )< / span > < span class = "token keyword" > and< / span > os< span class = "token punctuation" > .< / span > path< span class = "token punctuation" > .< / span > isfile< span class = "token punctuation" > (< / span > event< span class = "token punctuation" > .< / span > src_path< span class = "token punctuation" > )< / span >
< span class = "token punctuation" > )< / span >
< span class = "token keyword" > def< / span > < span class = "token function" > restart_nonebot_process< / span > < span class = "token punctuation" > (< / span > event< span class = "token punctuation" > :< / span > FileSystemEvent< span class = "token punctuation" > )< / span > < span class = "token punctuation" > :< / span >
logger< span class = "token punctuation" > .< / span > debug< span class = "token punctuation" > (< / span > < span class = "token string-interpolation" > < span class = "token string" > f" File < / span > < span class = "token interpolation" > < span class = "token punctuation" > {< / span > event< span class = "token punctuation" > .< / span > src_path< span class = "token punctuation" > }< / span > < / span > < span class = "token string" > changed, reloading nonebot..." < / span > < / span > < span class = "token punctuation" > )< / span >
liteyuki< span class = "token punctuation" > .< / span > restart_process< span class = "token punctuation" > (< / span > < span class = "token string" > " nonebot" < / span > < span class = "token punctuation" > )< / span > < span class = "token comment" > # 调用重启进程方法< / span >
2024-08-17 02:40:51 +08:00
< / code > < / pre > < div class = "line-numbers" aria-hidden = "true" > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < div class = "line-number" > < / div > < / div > < / div > < h3 id = "加载插件" tabindex = "-1" > < a class = "header-anchor" href = "#加载插件" > < span > 加载插件< / span > < / a > < / h3 > < p > 在配置文件中的< code > liteyuki.plugins< / code > 中添加你的插件路径，例如< code > watchdog_plugin< / code > ， ， < code > test.py< / code > ， ， < / p > < / div > <!-- [ --> <!-- --> <!-- ] --> < footer class = "page-meta" > < div class = "meta-item edit-link" > < a href = "https://github.com/LiteyukiStudio/LiteyukiBot/edit/main/docs/en/dev/dev_lyplugin.md" rel = "noopener noreferrer" target = "_blank" aria-label = "在 GitHub 上编辑" class = "nav-link label" > <!-- [ --> < svg xmlns = "http://www.w3.org/2000/svg" class = "icon edit-icon" viewBox = "0 0 1024 1024" fill = "currentColor" aria-label = "edit icon" > < path d = "M430.818 653.65a60.46 60.46 0 0 1-50.96-93.281l71.69-114.012 7.773-10.365L816.038 80.138A60.46 60.46 0 0 1 859.225 62a60.46 60.46 0 0 1 43.186 18.138l43.186 43.186a60.46 60.46 0 0 1 0 86.373L588.879 565.55l-8.637 8.637-117.466 68.234a60.46 60.46 0 0 1-31.958 11.229z" > < / path > < path d = "M728.802 962H252.891A190.883 190.883 0 0 1 62.008 771.98V296.934a190.883 190.883 0 0 1 190.883-192.61h267.754a60.46 60.46 0 0 1 0 120.92H252.891a69.962 69.962 0 0 0-69.098 69.099V771.98a69.962 69.962 0 0 0 69.098 69.098h475.911A69.962 69.962 0 0 0 797.9 771.98V503.363a60.46 60.46 0 1 1 120.922 0V771.98A190.883 190.883 0 0 1 728.802 962z" > < / path > < / svg > <!-- ] --> 在 GitHub 上编辑< span > < svg class = "external-link-icon" xmlns = "http://www.w3.org/2000/svg" aria-hidden = "true" focusable = "false" x = "0px" y = "0px" viewBox = "0 0 100 100" width = "15" height = "15" > < path fill = "currentColor" d = "M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z" > < / path > < polygon fill = "currentColor" points = "45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9" > < / polygon > < / svg > < span class = "external-link-icon-sr-only" > open in new window< / span > < / span > <!-- --> < / a > < / div > < div class = "meta-item git-info" > < div class = "update-time" > < span class = "label" > Last update: < / span > <!-- --> < / div > < div class = "contributors" > < span class = "label" > Contributors: < / span > <!-- [ --> <!-- [ --> < span class = "contributor" title = "email: snowykami@outlook.com" > snowy< / span > <!-- ] --> <!-- ] --> < / div > < / div > < / footer > < nav class = "vp-page-nav" > < a class = "route-link nav-link prev" href = "/en/dev/dev_lyfunc.html" aria-label = "Liteyuki Function" > < div class = "hint" > < span class = "arrow start" > < / span > Prev< / div > < div class = "link" > < span class = "font-icon icon fa-fw fa-sm fas fa-code" style = "" > < / span > Liteyuki Function< / div > < / a > < a class = "route-link nav-link next" href = "/en/dev/dev_comm.html" aria-label = "Communication" > < div class = "hint" > Next< span class = "arrow end" > < / span > < / div > < div class = "link" > Communication< span class = "font-icon icon fa-fw fa-sm fas fa-exchange-alt" style = "" > < / span > < / div > < / a > < / nav > < div id = "vp-comment" class = "giscus-wrapper input-top" style = "display:block;" > < svg xmlns = "http://www.w3.org/2000/svg" width = "32" height = "32" preserveAspectRatio = "xMidYMid" viewBox = "0 0 100 100" > < circle cx = "28" cy = "75" r = "11" fill = "currentColor" > < animate attributeName = "fill-opacity" begin = "0s" dur = "1s" keyTimes = "0;0.2;1" repeatCount = "indefinite" values = "0;1;1" > < / animate > < / circle > < path fill = "none" stroke = "#88baf0" stroke-width = "10" d = "M28 47a28 28 0 0 1 28 28" > < animate attributeName = "stroke-opacity"
2024-08-18 23:55:23 +08:00
< script type = "module" src = "/assets/app-Bk1i6mNH.js" defer > < / script >
2024-08-17 01:28:57 +08:00
< / body >
< / html >
