BeiChen-CN / AppHarbor

# AppHarbor
基于 **Kotlin Multiplatform** 的现代化跨平台应用商店，支持 **Android** 与 **Desktop (JVM)**。采用 **miuix** 设计语言，拥有流畅优雅的视觉交互，聚合多家主流应用源。
当前版本：**2.8.0（234）**。
本次更新：
- 新增聚合更新，支持测试版开关、固定更新来源及失败来源重试。
- 评论来源可独立选择，评分与评论统计分别展示。
- 首页统一为推荐，支持多源切换、下拉刷新和浏览位置恢复。
- 新增仅非计费网络下载，优化卡片显示并整理设置分组。
> [!NOTE]
>
> 本仓库 Fork 自上游 YXBwbWFya2V0/AppMarket，并在其基础上持续开发：新增 F-Droid 来源（索引缓存更新检查 + 签名门控）、历史版本多源路由、好游快爆来源等。上游 remote 已配置（`upstream`），便于同步上游更新。
 -brightgreen.svg?logo=android>)
---
> [!IMPORTANT]
>
> ### 免责与分发来源声明
>
> 1. **零中转服务器**：本应用是一个**纯客户端工具**，本项目**不设立、不运营、不持有任何用于存储、托管或分发第三方应用安装包的服务器**。
> 2. **数据源直连**：应用内展示的所有应用信息、元数据、图标截图、评论以及 APK 安装包 / 增量差分补丁，**全部直接源自对应应用源**。
> 3. **原包与安全**：客户端不对提供的任何应用进行二次打包、注入或篡改；增量更新（差分补丁）均在用户本地与已安装的原版 APK 完成合成。
> 4. **版权与合规**：所有应用、图标、商标等的版权均归各自原厂商/开发者所有。用户需自行判断应用的合法性，并遵守应用源的服务条款与版权规范。
---
## 目录
- AppHarbor
 - 目录
 - 特性概览
 - 支持的应用源
 - 安装方式与安装器
 - 编译与开发
 - 环境要求
 - 常用命令
 - Desktop 端
 - Android 端
 - 运行要求
 - 开源引用
 - 免责声明
---
## 特性概览
- **聚合更新**：可选择参与来源、是否包含测试版，并为应用固定更新来源；支持检查进度、取消与仅重试失败来源。下载跟随实际来源，GitHub / GitLab 需先关联仓库。
- **独立评论来源**：可在设置选择「跟随应用来源」、小米或好游快爆，也可在应用详情右上角快捷切换，不影响下载来源和原商店的评分统计。
- **多源推荐**：推荐页采用封面渐变与应用信息卡片，右上角可切换小米、vivo、OPPO、TapTap 或好游快爆；与设置中的「推荐来源」同步，支持下拉刷新、分来源缓存与浏览位置恢复。
- **多源聚合与自由定制**：支持独立为「搜索来源」、「更新来源」以及「推荐来源」指定不同的商店源，各取所长。
- **搜索页快捷换源**：点击搜索页右上角「换源」选择来源，与设置同步，并自动重新搜索当前关键词。
- **流量下载提醒**：Android 在移动数据或计费网络下开始下载前提示确认，显示应用数量和预计大小；可继续或取消；也可开启「仅非计费网络下载」，切换到计费网络时暂停并保留续传数据。
- **开源应用与仓库订阅**：支持 F-Droid、IzzyOnDroid，以及 GitHub / GitLab 公开 Release 中的 APK，关联仓库后可检查应用更新。
- **切换震动反馈**：底栏与侧栏切换时提供轻触震动，重复点击当前页不触发。
- **纯客户端增量更新**：内置多套差分算法还原引擎，可用时下载补丁包并于本地合成为完整 APK，节省 70%~90% 流量。
- **全场景安装器支持**：支持系统标准 PackageInstaller、Shizuku 免 Root 静默安装、Root 极速静默安装以及第三方安装器交接。
- **纯净体验与结果净化**：
 - **去除推广应用**：自动隐藏搜索结果中的广告推广。
 - **过滤快应用**：一键隐藏免安装快应用结果。
 - **过滤预约应用**：过滤尚未上线的预注册应用。
 - **优化应用名称**：智能裁剪应用名称后携带的营销副标题与推广宣传语。
- **历史版本回退**：接入海量应用历史库，支持按版本追溯并下载历史版本 APK。
- **设备指纹与机型模拟**：内置预设及自定义 `MarketProfile`（机型、Android 版本、SDK、分辨率、区域等），解决特定厂商或生态专属应用不可见问题。
- **系统生态深度优化**：支持小米 HyperOS 超级岛优化、焦点通知优化等。
- **设置分组**：按「来源与内容」「更新与安装」「外观与交互」整理，常用页面保留快捷换源。
- **跨平台一致体验**：基于 Compose Multiplatform 打造，同时支持 Android 移动端与桌面端（Windows / macOS / Linux）。
---
## 支持的应用源
| 应用源 | 标识 | 搜索 / 详情 | 更新检查 | 增量更新 | 历史版本 | 推荐内容 | 真实评论 | 区域切换 | 过滤净化 |
| :------------------------- | :---------: | :---------: | :------: | :------: | :------: | :---------: | :------: | :------: | :------: |
| **小米应用商店** (Xiaomi) | `xiaomi` | ✅ | ✅ | ✅ | ❌ | ✅ (金米奖) | ✅ | — | ✅ |
| **vivo 应用商店** (vivo) | `vivo` | ✅ | ✅ | ✅ | ❌ | ✅ (极光奖) | ❌ | — | ✅ |
| **OPPO 软件商店** (OPPO) | `oppo` | ✅ | ✅ | ✅ | ❌ | ✅ (至美奖) | ✅ | ✅ | ✅ |
| **TapTap** | `taptap` | ✅ | ✅ | ✅ | ❌ | ✅ (推荐流) | ❌ | — | — |
| **华为应用市场** (Huawei) | `huawei` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | — | ✅ |
| **荣耀应用市场** (Honor) | `honor` | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | — | ✅ |
| **三星应用商店** (Samsung) | `samsung` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | — |
| **豌豆荚** (Wandoujia) | `wandoujia` | ✅ | ✅\* | ❌ | ✅ | ❌ | ❌ | — | — |
| **好游快爆** (Kuaibao) | `kuaibao` | ✅ | ✅\* | ❌ | ❌ | ✅ (推荐流) | ✅ | — | — |
| **F-Droid** | `fdroid` |