发布

本页介绍如何把插件上架到插件市场、如何更新，以及如何下架。插件市场直接从公开的 GitHub 仓库读取插件，所以大部分工作都在你自己的仓库里完成。

提交之前复制锚点链接

请先确认以下几点：

• 每个插件是一个带 PLUGIN.md 的文件夹。frontmatter 点名的每个文件（位于 tools/、widgets/ 或 screens/）都已提交。见清单参考和声明式插件。
• 如果是远程插件，也就是 MCP（Model Context Protocol，模型上下文协议）服务器，服务器已经通过 HTTPS 部署好，或者你写清楚了如何自行部署。服务器的 name 与插件的 id 相同。可以从 templates/remote-plugin 模板开始。
• 仓库在 github.com 上是公开的。
• 插件遵守审核规则。简单地说：绝不索要校园密码，如实声明效果，工具只返回数据、不返回指令，使用云服务时写明数据说明。

提交仓库复制锚点链接

1. 打开 /marketplace/submit，粘贴 owner/repo、仓库 URL 或文件夹 URL，例如 https://github.com/owner/repo/tree/main/plugins。
2. 修好预览里显示的所有错误。每次 push 之后重新检查一遍。检查结果会缓存大约一分钟。
3. 点击提交上架。网站会在 pkuinfo/pkuharness-website 打开一个预先填好内容的 issue，并带上 plugin-submission 标签。
4. GitHub Action 会再扫描一次仓库，把报告作为评论发到 issue 上。扫描通过后，它会开一个 pull request，把仓库加进 data/sources.json。你编辑 issue 后，Action 会重新运行。
5. 维护者合并 pull request 后，插件会在网站下次部署时出现在插件市场里。

你也可以在自己的电脑上扫描并添加仓库，然后自己开 pull request：

bun scripts/marketplace.ts scan owner/repo   # 打印报告（有错误时退出码为 1）
bun scripts/marketplace.ts add owner/repo    # 扫描，然后加进 data/sources.json

不带 token 时，GitHub API 每小时只允许 60 次请求。设置 GITHUB_TOKEN（例如 GITHUB_TOKEN=$(gh auth token)）后，额度会提高到每小时 5000 次。

一个仓库放多个插件复制锚点链接

一个仓库可以放任意多个插件，不需要额外设置。扫描器会找出仓库里的每个 PLUGIN.md，每个插件都有自己的标识 owner/repo/<folder> 和自己的安装链接。

扫描器会跳过存放依赖、测试和测试数据的文件夹，例如 node_modules、tests、fixtures 和 e2e。所以你放在这些文件夹里做测试用的 PLUGIN.md 不会被上架。完整列表见清单参考。

大型 monorepo 还可以在根目录加一个 pku-harness.json，列出插件所在的文件夹。这样扫描器只按顺序检查这些文件夹，扫描更快，其他清单也不会混进来：

{ "plugins": ["services/canteen", "services/library-seat", "services/bus"] }

更新插件复制锚点链接

更新插件只需要推送到默认分支。插件市场大约每小时重新扫描一次已上架的仓库。新增插件文件夹会让新插件上架，删除文件夹则会让插件下架。

已经安装了 PLUGIN.md 插件的手机，会从插件的链接重新下载它。如果声明没有变化，App 会直接应用更新；如果插件申请了更多权限，更新要等用户同意后才生效。「更多权限」指新增的校园服务、主机或宿主能力，或者某个工具的效果比以前更强。

请让每个插件的 id 在各个版本之间保持不变。用户的安装记录、小组件和定时检查都靠 id 来找到插件。

如果某次 push 引入了错误，只有出错的那个插件会从插件市场撤下。仓库页面会显示扫描器发现的问题，方便你修复。

下架插件复制锚点链接

下架自己的插件。 删除 PLUGIN.md 文件、删除仓库，或者把仓库设为私有。下次扫描时插件就会从列表中消失。如果想把仓库条目也删掉，请开一个 pull request，从 data/sources.json 里移除它。

维护者下架。 如果插件违反了审核规则，维护者会从 data/sources.json 里删除这个仓库，还可能禁止作者再次提交。