🧩 自定义功能
用 mods 里的插件给侧边栏加一个新入口
插件适合程序里原来没有的功能。它不会变成一张收文件的资源页,而是自己登记一个侧边栏入口,点进去打开自己的页面。
插件放在哪
放在应用根目录的 mods 文件夹。创意工坊页面可以打开这个文件夹。每个插件是一个子文件夹,里面至少要有 manifest.json 和入口脚本,默认是 index.js。
让它出现在列表里
放好后,在创意工坊点「刷新」。新插件默认是关的,打开开关才会加载。关掉开关会卸载插件,并拿掉它注册的侧边栏入口。
入口要导出什么
index.js 使用 export default。加载时调用 onLoad(api),卸载时调用 onUnload(api)。脚本里不要写 import,加载器不会去找外部模块。
记下自己的数据
api.storage.get、set、remove。数据写在本机,键名会自动加上插件编号,避免和别的插件撞车。
在侧边栏加一个入口
api.navigation.register,传入 id、name、icon 和 onClick。不用时调用 api.navigation.unregister。
弹出提示
api.ui.showNotification(标题, 类型, { message })。类型可以是 success、info 或 error。
打开自己的页面
api.ui.showCustomView({ title, content, onMount })。content 是一段 HTML。onMount 会拿到页面容器,用来给按钮绑定点击。
发布到公共工坊
在插件自己的 GitHub 仓库发布 Release,把 manifest.json、入口脚本和可选的 styles.css 作为资源上传,再把仓库写进 workshop/community-mods.json。客户端会从最新 Release 读取文件和版本。