插件管理

插件给 iRightMenu Pro 加新功能——重命名、格式转换、重新签名 IPA 这类,装上就是一条新菜单。这份文档讲怎么装、怎么管、权限怎么回事

想自己写插件,看插件开发快速开始


界面

主窗口第三个页签「插件管理」,三栏:

位置 是什么
左:分类 已安装 / 可更新 / 全部,以及按用途分的图片、开发、系统、文件、其他
中:插件列表 名称、状态、版本、作者
右:插件详情 选中插件的完整信息和操作

顶部有搜索框。三栏宽度都能拖,退出后记住。


装一个插件

  1. 左栏点「全部」浏览,或用搜索框找
  2. 选中想要的插件,右侧看它的说明、菜单和权限
  3. 安装

装完插件提供的菜单会自动出现在菜单编辑器的左栏「插件」分组里,把它拖进你的菜单就能用。

装完没看到菜单? 多数插件的菜单需要你手动加进菜单树——插件只是提供菜单模板,放哪由你决定。少数插件(下面说的常驻插件)会自己出现在状态栏。


管理已装的插件

选中插件后在右侧操作:

操作 说明
启用 详情页右下角的勾选框。取消勾选后插件的菜单不再出现,配置和数据都留着,随时勾回来
卸载 详情页右下角的按钮,彻底删除。插件自己存的数据也会一并清掉
设置… 只有提供了设置界面的插件才有。点开是插件自己画的表单
+ / - 列表左下角。 从本地 .rmx 文件安装, 卸载选中的插件
检查更新 列表右下角。有新版的插件会归到左栏「可更新」,版本列显示 1.5.2 → 1.6.0
重新加载 重新扫描并重载所有插件的 Lua 环境。改了插件代码想立刻看到效果时用

详情页有什么

详情页顶部三个页签:

  • 概览 —— 插件说明、版本、作者、标识、签名状态、安装和更新时间;有新版时还会显示更新内容
  • 权限 —— 它声明要用哪些能力,以及你的授权状态
  • 菜单 —— 这个插件提供哪些菜单项


权限

插件跑的是真实代码,能读写文件、执行命令、访问网络。所以每个插件必须在自己的清单里声明要用哪些能力,用到没声明的会被直接拒绝。

能力分三档:

档位 例子 什么时候问你
始终可用 写日志、弹对话框、读当前选中的文件 不问。这些做不了什么坏事
声明即用 读写文件、发网络请求、存密钥 不单独问,但会列在详情页的「权限」里,装之前能看到
安装时警告 执行 Shell 命令、操作数据库、管理进程 安装时明确提示,你同意才装

「权限」页签分两部分:

  • 顶部列出这个插件声明要用的全部能力,按风险配色(例如「命令行」是橙色, 代表敏感)。装之前就能在这里看清它要什么
  • 「权限授权」下面是敏感能力的开关,一条一个。只有需要你点头的那档才出现在这里

关掉某一条,插件用到它时会被拒绝——插件通常会提示功能不可用,而不是崩掉。

重置所有授权:把这个插件的所有授权记录清空,下次它用到敏感能力时重新问你一遍。装完之后想重新审一遍它要什么,用这个。

签名

商店里的插件都带签名,能验证来源可信内容没被改过。详情页会显示签名状态。

签名验证失败的插件无法启用——可能是文件损坏,也可能被人动过手脚,两种情况都不该跑。

想装自己写的、没有签名的插件,要先去设置 → 高级打开「允许安装未签名的插件」。那个开关默认关着是有理由的,看清风险再开。


常驻插件

少数插件带「常驻」标记。它们和普通插件有两点不同:

  1. 只出现在状态栏菜单,不进右键菜单
  2. 随应用启动就在后台跑,不是点一下才执行

适合做持续性的事——监视某个文件夹、定时同步、显示实时状态。「桌面图标开关」这类切换开关也是常驻的,因为它需要知道当前状态才能显示正确的标题。

因为常驻插件一直在跑,装之前更值得看清它要什么权限。


遇到问题

装完插件的菜单不出现

多数插件的菜单要自己加:去菜单编辑器左栏找「插件」分组,把它拖进中间的菜单树。常驻插件除外,它们直接在状态栏。

插件提示功能不可用

多半是权限被关了。去详情页的「权限授权」看看对应的那条是不是关着。

插件签名验证失败,无法启用

文件损坏或被改过。卸载了重新装一次。自己写的插件需要在设置里放开未签名插件。

插件报错

设置 → 诊断把日志等级调到 DEBUG,重现一次问题,然后「导出诊断日志」发给我们。插件自己的日志在日志文件夹的 Plugins 子目录里。

更多见常见问题

开发者文档
使用帮助
使用说明 菜单编辑器指南 插件管理 设置说明 脚本菜单 常见问题
脚本开发
开发指南
插件开发
快速开始 开发指南 示例插件
API 参考
概览 API 查询 插件信息 日志 Finder 上下文 插件设置 国际化
UI 与交互
对话框 进度条 系统通知 选择器 WebView 状态栏 Dock
文件与路径
文件操作 路径工具 Finder 操作 废纸篓 扩展属性 元数据 文件监听
数据格式
JSON Plist CSV XML PDF 图片
文本与编码
字符串 正则表达式 日期时间 颜色 加密编码
系统
Shell 命令 进程管理 应用管理 系统信息 AppleScript 快捷指令
系统信息
网络信息 电源/电池 屏幕/外观 音频控制 蓝牙设备 位置服务
网络
HTTP 请求 WebSocket URL 工具
输入与剪贴板
键盘模拟 鼠标模拟 全局热键 剪贴板 窗口管理
存储
SQLite Keychain UserDefaults
媒体
文字识别 二维码
工具
归档 类型标识 分享 定时器 防休眠 并发/协程