一、背景说明

• 旧系统（24.10 及更早）：使用 opkg，安装 .ipk 包
• 新系统（25.x+）：使用 apk，安装 .apk 包

二、需求一：增加 .apk 格式支持，适配 OpenWrt 25.x+ / iStoreOS 新版

当前遇到的问题

• .run 脚本内部调用 opkg install，但系统实际包管理器为 apk
• 安装失败或提示包格式不兼容
• 用户不得不手动解压 .run 文件，再尝试用 apk add --allow-untrusted 强制安装，体验极差且容易破坏依赖关系

期望的解决方案

1. 双格式 .run 包：参考 sirpdboy/buildrun 等项目的做法，在构建时同时输出 ipk 和 apk 两种内核的 .run 自解压包，通过文件名区分。
2. 安装脚本自适应：在 .run 包内的 install.sh 中增加系统检测逻辑，自动判断当前系统使用 opkg 还是 apk，调用对应的包管理器安装。
3. 架构覆盖：继续保留对 X86_64 和 ARM64（aarch64_cortex-a53 / aarch64_generic）的支持。

三、需求二：增加自动解压压缩包安装功能

当前遇到的问题

1. 先在其他设备上下载并解压，提取出里面的 .ipk 文件，再上传到路由器用「高级卸载」安装；或
2. 上传到路由器后，通过 SSH 命令行手动解压，但不同压缩格式的解压命令各不相同（tar -zxvf、unzip、tar -jxvf 等），对普通用户来说门槛很高，过程繁琐。

• EasyTier/luci-app-easytier 的 Releases 提供的是 .zip 格式
• sbwml/luci-app-openlist2 的 Releases 提供的是 .tar.gz 格式

期望的解决方案

.tar.gz    .tgz    .tar.bz2    .tar.xz    .tar    .zip    .gz    .bz2

1. 用户在插件界面粘贴压缩包的下载链接（如 GitHub Releases 直链）
2. 插件自动下载该压缩包到临时目录
3. 根据文件后缀识别压缩格式，调用对应的解压命令自动解压
4. 扫描解压后的目录，自动识别其中的 .ipk 或 .apk 文件
5. 根据当前系统类型（opkg 或 apk）自动选择匹配的包进行安装
6. 安装完成后清理临时文件，并提示用户安装结果

四、技术可行性参考

• sirpdboy/buildrun 项目已实现对同一插件同时构建 ipk 和 apk 两种格式的 .run 安装包，且通过文件名明确区分（如 *-ipk-x86_64-*.run 与 *-apk-x86_64-*.run）。
• apk 包的手动安装命令为：apk add --allow-untrusted xxx.apk，与 opkg install xxx.ipk 用法类似，迁移成本不高。
• 压缩包解压功能在 OpenWrt 系统中已有 tar、unzip、gzip、bzip2 等基础工具支持，无需额外安装大量依赖。

五、我的使用环境（供参考）

• 设备型号：Radxa E20C
• 系统版本：iStoreOS 25.12.5 2026080812（内核：6.12.94）
• 系统架构：aarch64_cortex-a53
• 当前包管理器：apk（运行 which apk 或 which opkg 可确认）
• 当前遇到的问题：
  • 无法通过 iStore 手动安装或命令行直接安装现有的 .run 包
  • 从 GitHub 下载的 .zip / .tar.gz 插件包需要手动解压，步骤繁琐

六、其他说明

• 「高级卸载」插件本身功能非常实用，能够彻底解决 iStoreOS 插件残留问题，避免频繁恢复出厂设置，是软路由用户的刚需工具。
• 如果短期内实现双格式构建有难度，也建议至少先提供一版 .apk 格式的手动安装包，满足 25.x 系统用户的迫切需求。
• 自动解压功能如果能实现，将极大提升用户体验，让「高级卸载」成为真正意义上的”一站式”插件管理工具。
• 社区愿意协助测试，如有测试版可及时反馈安装与卸载体验。