手动加载本地 .abp 插件文件——绕过市场直接装

为什么手动安装

你可能需要手动安装 .abp 格式的插件，而不是通过插件市场：

• 插件还没上架市场（内测 / Alpha / Beta 版本）
• 插件作者只在 GitHub / QQ 群分发
• 私有插件 / 仅给特定用户使用
• 想抢先体验新 API Level 4 插件

获取 .abp 文件

常见来源：

• GitHub Releases——插件作者的仓库 Releases 页面
• QQ / Telegram 群文件——社区分发
• 作者直接发给你——付费 / 内测渠道

文件扩展名应该是 .abp。如果是 .zip，先解压看看里面有没有 .abp 文件。

安装步骤

第一步：准备 .abp 文件

把 .abp 文件存到你容易找到的位置——桌面、Downloads 文件夹都行。

第二步：进入插件管理页

在 AstroBox 中打开插件页面（注意：是已安装插件的管理页面，不是插件市场）：

• 电脑端：左侧导航栏找到「插件」图标（一般在插件市场旁边）
• 手机端：底部 Tab 栏找到「插件」

第三步：点击加号

在插件管理页面，找到右上角的加号按钮：

第四步：选择文件

在弹出的文件选择器中：

1. 找到存放 .abp 文件的位置
2. 选中文件
3. 点击「打开」或「确认」

第五步：重启 AstroBox

选完文件后 AstroBox 会提示「需要重启」：

1. 保存好当前工作
2. 关闭 AstroBox
3. 重新打开

第六步：同意权限申请

重启后，AstroBox 会弹出插件的权限申请窗口。仔细看一下申请了什么权限——没有明显问题就全部同意。

第七步：验证生效

重启完成后：

1. 进入「插件」管理页面
2. 应该能看到新装的插件出现在列表里
3. 检查插件功能是否正常（比如资源源插件 → 全部资源页切换源选择器）

.abp 文件是什么格式

.abp 是 AstroBox 插件的打包格式（AstroBox Plugin 的缩写）。内部一般是：

• 编译好的 .wasm 模块
• manifest.json（插件元信息：名称、版本、API Level、权限声明等）
• 可选的资源文件（图标、UI 资源等）

打包工具由 AstroBox SDK 提供，开发者写好插件后 cargo build --release + abox pack 就能生成 .abp。

版本兼容性

手动安装时注意：

如果装了不兼容的插件，AstroBox 会在加载时提示版本不匹配，不会让整个应用崩溃。

安全提醒

手动安装意味着你跳过了插件市场的社区审核（虽然市场也没有严格的安全审计）。建议：

• 只从可信来源（GitHub Releases、知名社区群）获取 .abp 文件
• 安装前先看 manifest.json 里声明了什么权限
• 如果某个插件申请的权限让你感到奇怪（比如一个表盘管理插件要申请网络 + 文件系统写权限），仔细想想再同意

手动卸载

1. 插件管理页面找到要卸载的插件
2. 点击右侧的卸载按钮
3. 可能需要重启