插件系统

插件系统

Qomicex 支持插件扩展：安装社区插件获得新功能，或自己动手开发。

安装插件

插件以 .qplugin 文件分发（本质是 zip 包），有三种安装途径：

• 插件商店（若可用）：浏览社区插件一键安装
• 本地安装：设置 → 插件 → 插件管理 子 tab → 上传 .qplugin 文件
• 开发调试：安装到启动器的插件统一放在 <数据目录>/plugins；开发期用 qomicex dev 走调试 harness（见 qomicex CLI 工具参考）

安装后需 启用 插件才生效；停用不删除数据，重新启用即恢复。

插件能做什么

权限说明

部分能力需要授权，启动器会弹窗询问：

• 文件读写：插件请求读写某个文件/目录时逐次授权
• 网络代理：插件经启动器代理访问外网
• 执行命令：调用系统命令（PowerShell/Shell），默认 15 秒超时

插件拥有较强的系统能力（文件、网络、命令执行）。安装来源不明的插件前请确认其可信。

管理插件

在 设置 → 插件 中：

• 启用 / 停用 / 卸载
• 修改插件设置：切到「插件设置」子 tab，左侧选择插件，右侧即该插件提供的设置界面（该 tab 仅在插件声明了 contributes.settingsPages 时才有内容）
• 查看插件权限与依赖关系

带依赖的插件会自动检查前置：缺前置时拒装并提示；前置被停用时插件自动禁用。

自己开发

面向开发者的完整指南（manifest、插件 API、主页小组件开发、CLI 工具）见 插件开发 分区。