萌卡 NT 官网的发布表单、审核系统和框架插件市场已经打通。开发者一次填写资料并提交审核;审核通过后,官网才会原子更新线上文章和市场目录。无需手写市场 JSON,也不需要再到投稿中心重复提交。
未登录时会先进入官网登录页。插件 ID 发布后不可更换;它同时关联官网文章、安装记录、审核快照和运行配置。
发布流程
- 使用任意官网账号登录,在用户中心进入“发布插件”,无需申请开发者或投稿者身份。
- 填写基础资料、平台安装包和接入信息。官网发布固定为「一体化部署 · 自动安装」,不再提供外部部署选项。
- 核对接入模式、监听端口和 Web 后台信息;安装与配置说明、数据与目录说明为选填,无需填写 JSON。
- 点击“提交审核”。系统会保存草稿、生成详情文章并建立审核快照。
- 审批人员检查本次提交的完整详情、安装文件和接入信息。
- 审核通过后,新快照才会发布并同步到框架插件市场。
这是一条完整流程,不再需要“先保存、进入 Halo 编辑器、返回列表后再次提交”。选择各系统安装文件后即可提交,不验证指纹、不要求包内声明,也不在发布时下载整包。
表单字段
| 项目 | 填写要求 |
|---|---|
| 插件名称 | 官网文章和插件市场显示名称 |
| 插件 ID | 稳定唯一标识,例如 Bilibili-Utility-Suite |
| 插件版本 | 当前发布版本,例如 1.5.0 |
| 一句话介绍 | 插件市场卡片摘要 |
| 插件 Logo | PNG、JPG/JPEG 或 WebP,最大 5 MB;自动归一为 512×512 |
| 支持平台 | 仅 Windows、仅 Linux、Windows + Linux |
| 下载地址 | Windows x86_64、Linux x86_64、Linux ARM64 分别填写;识别后必须在候选附件中单选确认,三个目标允许选择同一个通用文件 |
| 更新日志 | 本次发布的变更说明,支持 Markdown |
| 接入模式 | 正向、反向或正向 + 反向 WebSocket |
| 监听端口 | 快捷添加服务时预填;无固定端口填 0 |
| 内置 Web 后台 | 只有插件确实提供管理页面时才选择“支持” |
| 安装与配置说明 | 选填,说明必要业务配置 |
| 数据与目录说明 | 选填,说明数据保存及额外目录需求 |
标准事件名为:group_message、friend_message、group_event、friend_event、bot_offline。
审核与插件对接
官网不再收集 API 或事件权限勾选项。接入模式、监听端口和 Web 后台信息继续保留,方便框架自动配置插件连接。
- 一体化部署自动生成实际端口、令牌及连接配置,仍使用框架现有 WS 认证和事件订阅协议。
- 框架的“插件对接”继续支持手动添加正向、反向 WS 服务。
- 旧版发布记录已下架并保留作者和内容;外部部署草稿须补齐一体化安装包,重新提交审核,不能直接恢复上架。
所有公开 action 标准名见 API 总览。
安装包与启动入口
- Windows、Linux x86_64 和 Linux ARM64 应提供与目标平台匹配的可部署成品包。
- 普通 ZIP 或 TAR.GZ 成品包即可;不要求 SHA-256、签名文件或
mengka-managed.json。 - 框架安装时自动识别 Windows 可执行程序、Linux 可执行程序或启动脚本。多个候选程序时优先匹配插件名称及 start/run/main/app;无法唯一识别时提示整理安装包,不任意启动其他程序。
- 如果包内已有
mengka-managed.json,框架可以读取其启动参数和管理接口信息,不核对包内 ID、版本或指纹。 - 自动生成的连接文件与环境变量供插件读取;尚未支持读取这些信息的插件,可在启动后的管理端完成 WS 配置。
发布更新与版本连续性
在“管理我的插件”中选择“发布更新”。表单会载入已有资料和候选安装文件,核对版本及更新日志后重新提交。
| 状态 | 官网行为 | 框架市场行为 |
|---|---|---|
| 草稿 | 仅作者可编辑 | 不显示 |
| 待审核(首次发布) | 审核人员可查看快照 | 不显示 |
| 待审核(已上架插件更新) | 新资料隔离在待审快照 | 继续显示上一审核版本 |
| 审核通过 | 同时提升待审字段、文章快照并发布 | 切换到新版本 |
| 审核驳回 | 保留线上版本,作者按原因修改 | 继续显示上一版本 |
| 已下架 | 停止公开发布 | 停止展示 |
提交审核后不能继续修改同一待审版本;这是为了保证审批人员看到的内容与最终发布内容完全一致。被驳回后可修正并再次提交。
下载与更新日志
- 单平台插件可填写直接压缩包或 Releases 页面。
- 更新日志在表单中单独填写并随本次安装包一起审核。
- 官网会为 Windows x86_64、Linux x86_64、Linux ARM64 分别识别候选附件并默认选择最匹配的文件。开发者必须在每组单选框中确认,也可以改选其他候选附件。
- 三组选择互不排斥;Shell、Java、Node.js 等真正跨平台或跨架构的成品包可以由 Windows 和两个 Linux 架构选择同一个文件。原生二进制仍应按平台和架构分别打包。
- 更新须重新提交审核,不会自动替换已审核版本。
- 一体化安装包支持 ZIP 或 TAR.GZ;不要把源码仓库首页当成安装包。
审核前自检
- 插件 ID 与历史版本及
MENGKA_PLUGIN_ID一致; - 至少一个平台下载地址有效,安装包可解压启动;
- Windows、Linux x86_64、Linux ARM64 安装包的目标架构正确,且每个包只有一个明确的启动入口;
- 接入模式和监听端口与实际运行方式一致;
- 配置密钥没有写入安装包、文章或普通配置默认值;
- 只有实际提供 Web 管理端时才启用“内置 Web 后台”;
- 更新日志、功能、安装方法和反馈渠道完整。
与其他业务的边界
- 官网开发者账号与普通用户登录共用账号体系,但发布、管理和审批分别校验权限。
- 审核人员授权不等于普通管理员权限;无审批权账号不能读取或处理待审插件。
- 普通登录用户可以发布、编辑和提交自己的插件,不能管理其他作者的插件或直接审批上架。
- 插件文章只进入
mknt-plugin-market分类,不占用普通投稿流程。 - 删除、下架和重新上架仍走独立受控流程,发布表单不会直接删除线上数据。