Skip to content

Docs: 完善对「发布插件」章节的文档描述#3865

Open
NCBM wants to merge 3 commits intomasterfrom
NCBM/issue3824
Open

Docs: 完善对「发布插件」章节的文档描述#3865
NCBM wants to merge 3 commits intomasterfrom
NCBM/issue3824

Conversation

@NCBM
Copy link
Member

@NCBM NCBM commented Feb 14, 2026

Fixes #3824

@NCBM NCBM requested a review from yanyongyu February 14, 2026 19:22
@github-actions
Copy link
Contributor

🚀 Deployed to https://deploy-preview-3865--nonebot2.netlify.app

@yanyongyu yanyongyu added the documentation Improvements or additions to documentation label Feb 16, 2026
Copy link
Member

@yanyongyu yanyongyu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

把文档中的「有权」「整改」都统一改一下吧

:::warning 警告
如果你的插件只是满足自用需求,则完全可以选择**不发布插件**。发布插件**不是**使用插件的必要条件。

NoneBot 社区对于插件有一定质量要求,对于不符合要求的插件,社区成员有权要求整改,直至符合要求后才能通过审核;如果长期未更新整改,社区有权关闭当前请求,之后如需发布请重新提交发布插件请求。相应的质量要求会在本章节介绍。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
NoneBot 社区对于插件有一定质量要求,对于不符合要求的插件,社区成员有权要求整改,直至符合要求后才能通过审核;如果长期未更新整改,社区有权关闭当前请求,之后如需发布请重新提交发布插件请求。相应的质量要求会在本章节介绍
NoneBot 社区对于插件有一定质量要求,对于不符合要求的插件,社区成员将会要求修改,直至符合要求后才能通过审核;如果长期未更新整改,社区将会关闭当前请求,之后如需发布请重新提交发布插件请求。相应的要求会在本章节以下部分介绍


#### 不能零配置加载的插件

如果插件需要必要配置项才能正常导入,则**必须**在插件元数据中填写 `config` 字段,并且在商店提交表单中填写必要的配置项内容。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

config 元数据字段是只要有配置项就得填写

# 发布必填。

config=Config,
# 插件配置项类,如无需配置可不填写。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这里也是


## 质量要求

以下内容**强烈建议**完成,否则社区成员有权要求整改:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
以下内容**强烈建议**完成,否则社区成员有权要求整改
以下内容**强烈建议**完成,否则社区成员将会要求修改


NoneBot 是一个异步框架,插件中**禁止**使用任何可能阻塞事件循环的同步操作,例如:
- 同步 HTTP 请求(如 `requests` 库);
- 同步文件操作(如 `open()` 函数);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

open 这个问题不大,去掉吧

)
```

## 质量要求
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

漏了个 localstore 数据/缓存/配置文件存储路径要求

@NCBM NCBM requested a review from yanyongyu February 18, 2026 03:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Development

Successfully merging this pull request may close these issues.

Docs: 建议完善对「发布插件」章节的文档描述

2 participants

Comments