场景插件 是MN5推出的新的插件类型,安装方式与经典插件 相同。本文中无特殊声明,所述“插件”均为场景插件。
插件结构
场景插件相比经典插件要简单的多,下面是一个场景插件的最简目录结构:project
mnaddon.json
index.html
window上注入了mn对象的 HTML 网页面板。
如果将这些项目下文件打包到 zip 文件根目录,并更改扩展名为.mnaddon便是一个符合标准的插件。
如果想使用插件,需点击设置右侧三个点→插件→导入 进行安装,并在场景模板中启用该插件。
上述插件安装后运行效果
上述插件安装后运行效果

清单字段
- addonid: 插件的唯一名称,id 相同即为同一插件,id 不同即为不同插件。
- title: 插件在 MN 内显示的名称
- version: 插件在 MN 内显示的版本号
- author: 插件在 MN 内显示的作者名
- marginnote_version_min: 插件要求的最低 MN 版本
- immersiveOnly: 仅在沉浸模式(MN5 的新界面)下可用,默认为 false。建议场景插件开启此选项。
- panel: 指定插件面板的 html 文件位置
- icon: 指定插件图标位置
- panelWidth: 面板宽度,默认为 380
- panelMaxHeight: 页面高度的上限,默认为 560
- events: 声明可注册事件列表,默认为[]
- excerptClaim: 声明可接收的摘录。
{"hashtag": "#X", "configKey": "k"},其中configKey可选。详见事件系统 - cardCommands:卡片菜单里的命令,详见卡片与摘录菜单命令