插件格式（format 2）

插件包是扩展名为 .melodiaplugin 的 zip 文件，在「设置 → 插件」（桌面端）或「设置 → 扩展 → 插件」（Android）中导入。导入时会先显示插件需要的权限，确认后才安装并启用。

包结构

整个包最多 64 个文件，解压后不超过 10MB，原生插件不超过 200MB。沙盒插件不能包含 plugin.jar 和动态库。白名单之外的文件会被忽略，并在导入时提示。

清单

{
  "format": 1,
  "id": "com.example.lastfm",
  "name": "Last.fm 记录",
  "version": "1.0.0",
  "author": "someone",
  "description": "把听过的歌记录到 Last.fm",
  "minAppVersion": "1.6.0",
  "permissions": ["network", "playback.read", "storage"],
  "network": { "hosts": ["ws.audioscrobbler.com"] },
  "contributes": {
    "playerLayouts": { "desktop.playerBar": "ui/bar.json" },
    "pages": [{ "id": "stats", "title": "听歌统计", "icon": "chart", "ui": "ui/stats.json", "placement": "sidebar" }],
    "audioSources": [{ "id": "main", "name": "示例音源" }],
    "lyricsSources": [{ "id": "main", "name": "示例歌词" }],
    "events": ["songChanged", "playStateChanged"]
  }
}

format 1 的插件继续有效，其中的 kind、platforms、apiVersion 会被忽略。

contributes

• playerLayouts：key 为区域名（android.fullPlayer、android.fullPlayerWide、android.miniPlayer、android.lyrics、desktop.playerBar、desktop.nowPlaying、desktop.lyricsView），值为 ui/ 下的文件路径，或直接内联的描述对象。
• pages：每项需要 id（小写字母、数字、-、_，不超过 32 个字符）、title 与 ui。placement 可选，取值为 sidebar（默认）、nowPlayingCard 或 settings（API 1.4 起）。原生插件可以写 "compose": true 代替 ui，见「原生插件」一节，这种页面只能放在侧栏。
• audioSources / lyricsSources：每项需要 id，name 可选。
• events：songChanged、playStateChanged、progress。
• commands（format 2）：每项需要 id 与 title，脚本用 melodia.register.command 实现。
• menus（format 2）：每项需要 command 与 location。location 取 song 或 toolbar。只显示脚本已注册的命令。song 出现在桌面歌曲右键菜单、Android 歌曲「更多」弹层与全屏播放页「更多」弹层（播客节目除外）；toolbar 在桌面是顶栏按钮，在 Android 是「设置 → 扩展 → 插件」里的「插件命令」。
• settings（format 2）：插件设置项，见「设置」一节。
• contentSources（format 2）：第三方内容，见「内容源」一节。每项需要 id，name 可选，search 为 true 时参与搜索。
• backdrops（format 2）：窗口动态背景，见「动态背景」一节。
• layoutActions（format 2）：播放器布局的手势里用到 script: 动作时写 true，插件需要带 main.js，见「手势」。

单项写错时只忽略这一项，并在导入时提示。

权限

提供了某项能力却没有申请对应权限时，整个插件无效。插件升级后如果申请了新的权限，导入预览会标出新增的权限。native 权限由 kind 决定，沙盒插件申请时会被忽略。

脚本

main.js 在隔离的 JS 环境中运行：Android 上是无界面的 WebView，桌面端是 GraalJS。脚本不能访问文件系统、Cookie、账号信息与宿主类，只能通过全局对象 melodia 调用宿主能力。所有调用都返回 Promise。

await melodia.http.request({ url, method, headers, body })   // 返回 { status, headers, body }
await melodia.storage.get(key)
await melodia.storage.set(key, value)                        // value 为 null 等同于删除
await melodia.storage.remove(key)
await melodia.player.current()                               // { id, songId, title, artist, cover } 或 null
await melodia.player.state()                                 // { playing, positionMs, durationMs }
await melodia.player.play() / pause() / next() / previous()
await melodia.player.enqueue({ songId, title, artist, cover })
await melodia.ui.setState(pageId, patch)                     // 浅合并到页面数据
await melodia.ui.toast(text)                                 // 不超过 120 个字符
await melodia.ui.openUrl(url)                                // 只接受 https，需要 API 1.4
await melodia.settings.get(key)
await melodia.settings.all()
await melodia.netease.call(method, params)
await melodia.library.likedSongIds()
await melodia.library.playlists()
await melodia.content.open(source, id, title)
melodia.on('songChanged', handler)
melodia.register.audioSource('main', { resolve, search })
melodia.register.lyricsSource('main', { fetch })
melodia.register.action('refresh', handler)
melodia.register.command('share', handler)
melodia.register.contentSource('main', { search, playlist, resolve })

• 网络请求不会自动跟随到白名单外的域名；每次重定向都会重新核对域名。响应体上限 4MB。
• 宿主调用失败时 Promise 会被拒绝，错误信息说明原因（如缺少权限、不允许访问的域名）。
• 脚本加载失败（语法错误、加载时抛错或超过 8 秒）时，插件会被自动停用。
• 宿主调用插件注册的能力时，如果插件出错或超时，计为一次失败；连续失败 5 次后插件会被自动停用。重新启用后计数清零。
• 订阅了播放事件的插件，脚本连续 5 次超过 2 秒没有响应时也会被自动停用。
• 同一时间未完成的宿主调用不能超过 512 个，超出时插件会被自动停用。
• 脚本只能经 melodia.http.request 联网。Android 沙盒里 fetch、XMLHttpRequest、WebSocket、外部图片和页面跳转都不可用；localStorage 只有插件自己能读写，删除插件时清除，需要长期保存的数据请用 melodia.storage。
• 沙盒插件给出的封面地址同样要在 network.hosts 内，否则按没有封面处理。

音源

melodia.register.audioSource('main', {
  resolve: async function(song) {
    // song: { songId, title, artists, album, durationMs, origin, quality }
    return 'https://...';            // 或 { url: 'https://...' }
  }
});

• 只在官方链接不可用或只有试听、且开启了换源时调用，与 LX 插件一起参与社区源轮询；用户打开「插件优先于官方音源」后，每首歌都会先调用。
• origin 为 songId 所属平台（netease、qq、kugou、kuwo、migu）；quality 为当前音质档位（standard、exhigh、lossless、hires）。
• 只接受 http(s) 链接；返回空、试听链接或超过 8 秒没有返回时视为没有结果，继续尝试下一个音源。
• 多个插件音源按插件名称顺序尝试；register 的名称必须在清单 audioSources 里声明过。

歌词源

melodia.register.lyricsSource('main', {
  fetch: async function(song) {
    // song: { songId, title, artists, album, durationMs, origin }
    return '[00:01.00]第一句';       // LRC 文本，或 { lrc: '...' } / { ttml: '...' }
  }
});

• 与网易、AMLL、QQ 歌词同时查询，优先级最低：只有其他来源都没有歌词时才使用插件歌词。
• 多个插件歌词源并发查询，按插件名称顺序取第一份非空结果；单个歌词源超过 8 秒按没有结果处理。

网易接口

插件拿不到 Cookie 和登录凭证，只能调用下表方法。未登录时调用会被拒绝，响应只包含表里列出的数据。

const page = await melodia.netease.call('search', { keyword: '晴天', type: 'song' });
await melodia.netease.call('song.like', { id: page.items[0].songId, like: true });

写方法的限制：

• 导入时确认权限后，插件第一次写入还会再弹一次确认，同意后记住，重新安装插件时失效。
• playlist.delete 每次都要用户确认，不能删除「我喜欢的音乐」。
• playlist.addTracks、removeTracks、delete 只能操作用户自己创建的歌单。
• 每个插件每分钟最多写入 30 次、读取 120 次，超出时调用被拒绝。
• 用户拒绝写入后 30 秒内，新的写入请求直接失败，不再弹窗。
• 确认弹窗 60 秒未响应按拒绝处理。

歌曲对象为 { songId, title, artist, artists, album, albumId, cover, durationMs }。

内容源

内容源让第三方平台的内容进入应用：搜索结果显示在搜索页的「自定义插件」标签，歌单在原生详情页打开，歌曲可以播放和加入队列。

melodia.register.contentSource('main', {
  search: async function(query) {            // { keyword, offset, limit }，清单里 search 为 true 才调用
    return [{ id: '1', title: '歌名', artist: '歌手', album: '专辑', cover: 'https://...', durationMs: 200000 }];
  },
  playlist: async function(args) {           // { id }
    return { name: '歌单', cover: 'https://...', description: '简介', tracks: [/* 同上 */] };
  },
  resolve: async function(track) {           // { id, quality }
    return 'https://...';                   // 或 { url: 'https://...' }
  }
});

// 打开原生歌单详情页，通常放在命令或页面动作里
await melodia.content.open('main', 'playlist-1', '我的歌单');

• 歌曲的 id 与 title 必需，缺少时跳过这一项；每次最多 1000 首。
• resolve 只接受 http(s) 链接，返回空或试听链接时无法播放。
• 每次调用的上限是 8 秒，超时和出错都计入连续出错。
• 详情页没有评论、收藏和分享入口；重启应用后之前打开的插件歌单需要重新进入。
• 插件停用后，已在队列里的歌曲无法继续解析。

打开网页

await melodia.ui.openUrl('https://www.last.fm/api/auth/?api_key=...&token=...');

• 需要 ui.openUrl 权限与 API 1.4，只接受 https，网址不超过 4096 个字符；不要求在 network.hosts 内。
• 每次调用都会弹窗，显示插件名和网址的域名（不显示路径与参数），用户同意后才打开；拒绝或 60 秒未响应时 Promise 被拒绝，之后 30 秒内的调用直接失败。
• 用户拒绝后 30 秒内，同一插件的新请求直接失败，不再弹窗；同一插件已有请求在等待确认时，新请求也直接失败。
• 打开成功只代表交给了系统浏览器，插件拿不到网页里的任何内容；需要结果时自己轮询接口。
• 原生插件对应 context.ui.openUrl(url)，拒绝时抛 PluginApiException。

命令

"contributes": {
  "commands": [{ "id": "scrobble", "title": "记录到 Last.fm" }],
  "menus": [{ "command": "scrobble", "location": "song" }]
}

melodia.register.command('scrobble', async function(song) {
  // song 只在 location 为 song 时有值：{ songId, title, artist, album, cover }
});

外部平台的歌曲没有 songId。命令 5 秒内没有返回或抛错时，应用会提示执行失败，并计入连续出错。

设置

设置项写在清单里，应用生成设置页，入口在插件列表的设置按钮。

"settings": [
  { "id": "enabled", "type": "toggle", "title": "启用记录", "default": true },
  { "id": "token", "type": "text", "title": "令牌" },
  { "id": "mode", "type": "select", "title": "模式", "options": [{ "value": "fast", "label": "快速" }, { "value": "safe" }] },
  { "id": "interval", "type": "number", "title": "间隔", "min": 1, "max": 60, "step": 1, "default": 30 }
]

• 设置值保存在插件数据目录，升级时保留，不占用 storage 权限。
• 没保存过时取 default，不合法的值回到默认值；未写 default 时，toggle 为 false、text 为空、select 为第一项、number 为 min。
• 如果注册了动作 settingsChanged，每次修改都会以 { key, value } 调用一次。

播放事件

事件只通知插件，不等待处理结果，也不能改变播放行为。插件启动时不会补发当前状态，需要时调用 melodia.player.current() 与 melodia.player.state()。

播放器布局

布局是由容器和组件组成的树，写在 ui/*.json 里，或直接内联在清单的 playerLayouts 下。只提供布局的插件不需要 main.js，也不需要申请权限。

{
  "type": "row", "padding": [0, 16], "spacing": 12, "align": "center", "height": 96,
  "children": [
    { "type": "cover", "shape": "circle", "maxSize": 64 },
    { "type": "songInfo", "weight": 1 },
    { "type": "column", "weight": 2, "align": "center", "children": [
      { "type": "controls", "buttons": ["shuffle", "previous", "playPause", "next", "repeat"], "size": "large" },
      { "type": "progress", "showTime": false }
    ]},
    { "type": "actions", "buttons": ["queue", "volume"] }
  ]
}

外框与变体

API 1.5 起，区域的值也可以写成带 layout 字段的对象，用来调整宿主保留的部分，或按尺寸换一套布局。直接写布局树的旧写法等于只写了 layout。

"android.fullPlayer": {
  "frame": { "header": "none", "cards": false },
  "layout": { "type": "column", "children": [] },
  "variants": [
    { "when": { "orientation": "landscape" }, "layout": { "type": "row", "children": [] } }
  ]
}

• frame：区域外框，各区域支持的字段见下表，写了不支持的字段会被忽略并提示。
• variants：最多 4 条，按顺序取第一条满足 when 的替换 layout，都不满足时用 layout。条件可写 minWidth、maxWidth（区域实际宽度，单位 dp）与 orientation（portrait、landscape）。每条单独校验，某条无效只跳过这一条。桌面区域 API 1.6 起支持，宽度取窗口里该区域的宽度，orientation 恒为 landscape。
• styles：具名样式，见下文「样式」（API 1.7）。
• 节点上的 animation 与 onTap、onDoubleTap、onLongPress 见下文「动效」「手势」（API 1.8）。

header 为 none 而布局里没有一定看得见的 collapseButton 时，宿主会在左上角补一个收起按钮。放在 pager 里、写了 visible 条件、不透明度低于 0.5、宽高小于 16 或静止时被动效淡出、缩小的都不算看得见；autoHide 由宿主控制，照常算。必需组件按同样的规则判断，被这样隐藏的播放/暂停按钮或进度条不算数，整个布局无效。下拉收起与返回键始终可用。

区域

两个歌词页区域替换整页内容，下拉收起、返回键、页面背景与留边不变；布局里没有一定看得见的 collapseButton 时，宿主同样在左上角补一个。这里的 lyricsView 就是歌词页原有的歌词列表，collapseButton 关闭歌词页。android.lyrics 的 actions 另有 lyricsSettings（打开歌词设置，需写明）；desktop.lyricsView 的 actions 为 lyricsSettings、fullscreen、share，没写 buttons 时为后两个。

桌面区域不支持 collapseButton、moreButton、sourceLabel、lyricsView；time 与 playMode 按钮 API 1.7 起可用；desktop.nowPlaying 的 pager 放在可滚动的面板里，高度按页面内容取。

desktop.playerBar 根节点的 height 即播放栏高度，范围 64–160，默认 80。android.miniPlayer 根节点的 height 范围 48–140，controls 只支持 previous、playPause、next；左右滑动切歌仍然可用，但封面和标题不会跟手移动。

android.fullPlayer 占满一屏，默认顶部保留收起和更多按钮，下方的信息卡片不变；放了 lyricsCard 时，卡片列表里不再重复显示歌词卡；关掉卡片后，点 miniLyric 打开全屏歌词。手机横屏仍使用这个区域，可以用 orientation: landscape 的变体单独排版。android.fullPlayerWide 只在平板侧栏铺开到全屏时出现，只替换左栏，右栏歌词与卡片不变。

通用属性

节点

size 取 small、medium、large。没写 buttons 时使用该区域的全部按钮，但 API 1.6 新增的 playMode、sleepTimer、comments、lyrics 需要写明才会出现。

播放状态绑定

API 1.6 起，播放器区域里 text 的文字和任意节点的 visible 可以写成 $player.xxx：

{ "type": "text", "text": "$player.quality", "visible": "$player.quality" }

写了不存在的字段，或在播放器区域用 $state / $item 时，这一项会被忽略并提示。进度不开放绑定，用 time 组件显示。桌面 API 1.7 起也可以绑定。

颜色

API 1.7 起，background、contentColor、border 的颜色和渐变色都可以写：

渐变写成 { "gradient": ["cover.base", "pane"], "angle": 90 }，2–4 个颜色，线性；angle 为 0 时从左到右，90 时从上到下，默认 90。

样式

API 1.7 起，区域外壳可以写 styles，节点用 class 引用：

{
  "styles": {
    "muted": { "contentColor": "textTertiary", "opacity": 0.8 },
    "accent": { "extends": "muted", "contentColor": { "light": "#2E8B57", "dark": "#4DAF7C" } }
  },
  "layout": { "type": "time", "class": "accent" }
}

• 样式就是一组节点属性，节点自己写的同名属性优先。不能写 type、children、buttons、bind、action、visible。
• extends 继承另一个样式，最多 4 层；出现循环或继承的样式不存在时，这个样式无效。
• 一个区域最多 32 个样式，layout 与各条变体共用；引用无效样式时忽略并提示。

动效

API 1.8 起，任意节点可以写 animation，只改变绘制，不影响布局；旋转、缩放后可能超出父容器，需要自己留出空间。layout 与每条变体各自最多 16 个节点带动效。用户关闭「界面动画」后，动效停在静止状态。

预设写成 "animation": "rotateWhilePlaying" 或 { "preset": "rotateWhilePlaying", "period": 12 }：

关键帧：

"animation": {
  "keyframes": [{ "at": 0, "rotate": -25 }, { "at": 1, "rotate": 0 }],
  "duration": 600, "easing": "easeOut", "repeat": "once", "trigger": "playing"
}

songChange 与 tap 在触发前停在最后一帧。关闭界面动画时，只播一次的动效停在最后一帧，循环的停在第一帧，playing 按播放状态停在首帧或末帧。

手势

API 1.8 起，任意节点可以写 onTap、onDoubleTap、onLongPress，桌面上右键等同长按，右键不会触发 onTap。自带点击的组件（按钮、歌名等）先处理自己的点击，这时节点上的手势不触发；分页器的左右滑动、下拉收起与返回键不受影响。

区域不支持的动作会被忽略并提示。沙盒插件用 script: 动作时，要在清单的 contributes 里写 "layoutActions": true 并带上 main.js，否则这些动作会被忽略；原生插件用 context.extensions.action 注册的动作同样可以调用，不需要声明 layoutActions。

校验与回退

• 树不超过 8 层、128 个节点，layout 与每条变体分别计算；超限或缺少必需组件时，这个区域回到内置布局，其他区域不受影响。
• 未知组件、不支持的按钮与无效参数只忽略这一项，并在导入时提示；数值超出范围时收到边界内。
• 同一区域有多个插件提供布局时，默认使用最近启用的插件，也可以在插件设置里按区域选择，或改回内置布局。

页面

页面描述的写法与播放器布局相同，可用容器 column、row、box，以及 spacer、text 和下面的组件。提供页面的插件需要 main.js。

{
  "type": "column", "spacing": 12, "children": [
    { "type": "heading", "text": "$state.title" },
    { "type": "loading", "visible": "$state.loading" },
    { "type": "button", "text": "刷新", "action": "refresh" },
    { "type": "list", "bind": "$state.items", "spacing": 6, "children": [
      { "type": "row", "children": [
        { "type": "text", "text": "$item.name", "weight": 1 },
        { "type": "button", "text": "删除", "action": "remove" }
      ]}
    ]}
  ]
}

• 绑定：$state.xxx 取页面数据，$item.xxx 取列表当前项，可以用点号取下一层。text 可以写固定文字，也可以整段写成绑定。
• visible：任何节点都可以写，值为绑定，取到空、false、0 或空数组时不显示。
• 数据：脚本用 melodia.ui.setState(pageId, patch) 更新页面数据，渲染时不会调用脚本。
• 动作：用 melodia.register.action(name, handler) 注册，名称只能用字母、数字、_、:、-，5 秒内没有返回按失败处理。
• 打开页面：如果注册了 open:<页面 id>，每次打开页面都会调用一次，可以用来刷新数据。
• 入口：placement 为 sidebar 时，桌面端在音乐库侧栏底部的「插件」分组，Android 在「设置 → 扩展 → 插件」；为 nowPlayingCard 时，页面作为卡片显示在桌面「正在播放」面板与 Android 全屏播放页，可以在卡片编辑器里排序和隐藏。宽屏播放页的插件卡片排在内置卡片之后。为 settings 时，页面不进侧栏，插件列表里这个插件会出现设置按钮，点开后在设置弹窗里显示页面；同时声明了 settings 设置项时，设置项排在页面下方。每个插件只取第一个 settings 页面。

动态背景

替换窗口背景，优先于皮肤的背景图。目前只有桌面端生效。多个背景在「设置 → 插件 → 动态背景」里选择，默认用最近启用的插件，也可以选「不使用」。

"backdrops": [
  { "id": "rain", "name": "雨夜", "fps": 12, "dim": 0.4, "paneOpacity": 0.6, "frames": ["assets/rain1.png", "assets/rain2.png"] }
]

原生插件可以不写 frames，改用代码逐帧渲染：

context.extensions.backdropSource("aurora", object : BackdropSource {
    override val maxWidth = 320

    override fun render(frame: BackdropFrame) {
        // 把不透明的 ARGB 写进 frame.pixels，长度为 width * height
    }
})

render 在后台线程调用，帧率与遮罩来自清单，宿主把画面拉伸铺满。窗口隐藏或最小化时不调用；关闭界面动画时只渲染一帧。需要 API 1.1。沙盒脚本不能逐帧绘制。

分发

除了手动导入，还可以提交到插件目录，见 plugin-catalog.md。升级时保留上一版本，可以在插件列表里回退，插件数据不变。

原生插件

只有桌面端支持，用于沙盒做不到的场景。原生插件在主进程运行，等同于运行任意程序：权限声明只对通过 API 的调用生效，无法真正限制它。Android 导入时直接拒绝。

要先在「设置 → 插件」开启「允许原生插件」（默认关闭）才能导入和加载。

class HelloPlugin : MelodiaPlugin {
    override fun onLoad(context: PluginContext) {
        context.extensions.command("hello") {
            context.ui.toast("你好")
        }
    }
}

完整示例在 plugin-sample 模块，gradlew :plugin-sample:packagePlugin 生成可导入的包。

• 编译依赖：compileOnly(project(":plugin-api"))。宿主提供 plugin-api、Kotlin 标准库、kotlinx.coroutines 和 Compose（runtime、ui、foundation、animation、material3 与 Skia），这些不要打进 plugin.jar；其他依赖打进 JAR，包括 Compose 图标库。应用内部的类对插件不可见。
• Compose 页面：清单写 { "id": "panel", "title": "面板", "compose": true }，代码里调用 context.extensions.composePage("panel") { ... }。需要 API 1.2，用与应用相同的 Compose 版本（当前 1.10）编译，Compose 有不兼容升级时 API 主版本会提升。页面在独立的窗口层渲染：出错只影响这个页面，但不继承应用主题，自己铺背景，也盖在应用内的弹层和菜单上方。
• 入口：main 指向实现 MelodiaPlugin 的类，需要公开的无参构造函数。onLoad 要在 10 秒内返回，耗时工作放进 context.scope。
• 扩展：通过 context.extensions 注册音源、歌词源、内容源、命令、页面动作、动态背景和播放监听。除页面动作外，都要先在清单 contributes 里声明，否则加载失败。界面可以用声明式页面或 Compose 页面。
• 宿主能力：除频谱外，context 提供 player、library、netease、storage、settings、ui、logger，与沙盒 API 一一对应，同样要在清单里申请权限；网易写入同样限频和确认。
• 频谱：context.spectrum.frames() 返回 Flow<SpectrumFrame>，约 30 帧/秒，含 64 个对数频段（20 Hz–16 kHz，0–1）和最近 1024 个单声道采样（-1–1）。需要 API 1.3 和 playback.read 权限，缺权限或系统不支持时收集会抛 PluginApiException。收集时才采集，来不及处理的帧会被丢弃，无声时停发；数组由所有订阅者共用，不要修改。数据取自实际输出，随音量变化；优先只录 Melodia 自己的声音，系统不支持时退回默认输出设备的混音，这时会混入其他应用的声音。沙盒脚本和 Android 不提供。
• 动态库：用 context.nativeLibrary("x.dll") 取路径，在插件代码里调用 System.load。
• 可用的 JDK 模块：java.base、java.datatransfer、java.desktop、java.instrument、java.logging、java.management、java.naming、java.prefs、java.security.sasl、java.sql、java.transaction.xa、java.xml、jdk.crypto.ec、jdk.management、jdk.unsupported。超出范围的类运行时找不到。
• 生命周期：只在应用启动时加载。导入、升级和重新启用都要重启才生效；停用、删除和关闭总开关时立即调用 onUnload 并注销扩展，已加载的类要到重启才释放。
• 出错处理：回调抛异常或超时按没有结果处理，连续 5 次自动停用。加载时导致应用退出的插件，下次启动自动停用。用 --safe-mode 启动可以跳过所有原生插件。回调阻塞时宿主按超时返回，但线程无法结束；DLL 崩溃和主线程阻塞无法拦截。
• 完整性：不做签名校验。列表显示来源文件名和 plugin.jar 的 SHA-256；文件与安装时不一致时拒绝加载，需要重新导入。

存储

• 已安装的插件放在应用数据目录的 plugins/<id>/ 下，启用状态与已确认的权限记录在 plugins/.state.json。
• 原生插件运行时使用 plugins/.native/run/<id>/ 下的副本，每次启动重建。
• 插件数据放在 plugins/.data/<id>/，升级时保留，删除插件时一并删除。
• 导出时只打包安装文件，不包含插件数据。

在 GitHub 上编辑此页