文档:完善 GitHub 仓库插件库提交说明

This commit is contained in:
SKYMirror committed 2026-09-13 02:55:18 +08:00
1 parent 1365083586
commit b8c865d198
1 file changed
+29 -42
+29 -42
View File
@@ -3,74 +3,63 @@
官方库:https://github.com/MCDReforged/PluginCatalogue 官方库:https://github.com/MCDReforged/PluginCatalogue
贡献指南:https://github.com/MCDReforged/PluginCatalogue/blob/master/CONTRIBUTING_zh_cn.md 贡献指南:https://github.com/MCDReforged/PluginCatalogue/blob/master/CONTRIBUTING_zh_cn.md
## 硬性前提(当前还缺) ## 当前进度
1. **必须有公开 GitHub 仓库** 仓库:https://github.com/HzSKYMirror/Iridium
官方脚本用 `GithubRepository` 拉取 Release / README。
`https://git.skymirror.top/...` **不会被收录**。
2. **GitHub Release 标签正确,且附件为 `.mcdr`** | 步骤 | 状态 |
建议 Tag:`v26.9.1`(与版本对应,带 `v` 前缀较常见)。 |------|------|
附件名建议:`Iridium-26.9.1.mcdr` 或 `Iridium.mcdr`。 | 公开 GitHub 仓库 | 已创建(当前可能仍为空,需推送) |
| `plugin_info.json` | 已写好(`catalogue/plugin_info.json`) |
| GitHub Release + `.mcdr` 附件 | **待完成** |
| 官方库 PR | **待完成** |
3. **仓库根目录有 `README.md`**(已有)。 ## 硬性前提
4. **许可** 1. **公开 GitHub 仓库**(官方脚本只认 GitHub,不认 git.skymirror.top)
官方强烈建议 OSI 开源许可。当前为 All Rights Reserved: 2. **GitHub Release 标签正确,附件为 `.mcdr`**
- 仍可提交,但审阅可能更慢 建议 Tag:`v26.9.1`;附件:`Iridium.mcdr`
- 提交即视为授权社区从 GitHub Releases 下载使用(见贡献指南) 3. **根目录有 `README.md`**(已有)
- 若希望更顺利,可改为 MIT / Apache-2.0 等后再提 PR 4. **许可**:官方强烈建议 OSI 开源许可;专有许可可提但审阅更慢,且提交即授权社区从 GitHub Releases 下载使用
5. **一个 PR 只加一个插件**
5. **一个 PR 只加一个插件**(只加 Iridium)。
## 提交步骤 ## 提交步骤
### 1. 把源码同步到 GitHub ### 1. 推送源码到 GitHub
```bash ```bash
# 在 GitHub 建公开仓库 Iridium 后
cd /Users/l3126596029/Code/MCDR_plg/Iridium cd /Users/l3126596029/Code/MCDR_plg/Iridium
git remote add github git@github.com:你的用户名/Iridium.git git remote add github https://github.com/HzSKYMirror/Iridium.git
git push -u github main git push -u github main
``` ```
### 2. 在 GitHub 发 Release ### 2. 在 GitHub 发 Release
- Tag:`v26.9.1` - Tag:`v26.9.1`
- 附件:用本地 `./pack.sh` 生成的 `Iridium.mcdr` - 附件:本地执行 `./pack.sh` 得到的 `Iridium.mcdr`
### 3. 修改 catalogue/plugin_info.json ### 3. 向官方库提 PR
把 `repository` 改成真实 GitHub 地址,例如:
```json
"repository": "https://github.com/你的用户名/Iridium"
```
`authors.link` 也可改成 GitHub 主页。
### 4. 向官方库提 PR
1. Fork https://github.com/MCDReforged/PluginCatalogue 1. Fork https://github.com/MCDReforged/PluginCatalogue
2. 在 fork 中新建路径:`plugins/iridium/plugin_info.json` 2. 新建文件:`plugins/iridium/plugin_info.json`
内容使用修改后的 `catalogue/plugin_info.json` 内容直接使用本仓库 `catalogue/plugin_info.json`
3. 向 `MCDReforged/PluginCatalogue` 的 `master` 发起 Pull Request 3. 向 `MCDReforged/PluginCatalogue` 的 `master` 发起 Pull Request
### PR 标题建议 ### PR 标题
```text ```text
Add plugin: iridium Add plugin: iridium
``` ```
### PR 描述模板 ### PR 描述
```markdown ```markdown
## Plugin ## Plugin
- ID: `iridium` - ID: `iridium`
- Name: Iridium - Name: Iridium
- Repository: https://github.com/你的用户名/Iridium - Repository: https://github.com/HzSKYMirror/Iridium
- Release: https://github.com/你的用户名/Iridium/releases/tag/v26.9.1 - Release: https://github.com/HzSKYMirror/Iridium/releases/tag/v26.9.1
- Labels: `tool` - Labels: `tool`
## Summary ## Summary
@@ -89,21 +78,19 @@ Add plugin: iridium
- [x] One plugin per PR - [x] One plugin per PR
``` ```
## 可选优化(提高过审概率) ## 可选优化
| 项 | 建议 | | 项 | 建议 |
|----|------| |----|------|
| 许可 | 改为 MIT / Apache-2.0 | | 许可 | 改为 MIT / Apache-2.0 更易过审 |
| 名称冲突 | 官方库无 `iridium`;与现有插件名称距离足够 | | 英文 README | 可另加 `README_en.md` 并写入 introduction |
| label | 用 `tool`(信息/工具类) | | label | `tool`(官方标签:information / tool / management / api / handler) |
| 英文 README | 目前 `introduction` 中英文都指向中文 README,可另加 `README_en.md` |
## 本地校验(可选) ## 本地校验(可选)
官方脚本需 Python >= 3.11: 官方脚本需 Python >= 3.11:
```bash ```bash
# 克隆官方库后
cd PluginCatalogue/scripts cd PluginCatalogue/scripts
pip3 install -r requirements.txt pip3 install -r requirements.txt
python3 main.py check --help python3 main.py check --help