外观
平台与运行模式
按项目 README 的口径：Android 与 Windows / macOS / Linux 可直接使用客户端；iOS 与华为纯血鸿蒙设备需要用微信开发者工具自行编译小程序运行。
第三方音源插件有两种运行模式：本地运行 与 专属服务器。能选哪一种，取决于平台。
一张表看全
| 平台 | 怎么获取 | 插件运行模式 |
|---|---|---|
| Android | 下载安装包 | 本地运行 / 专属服务器 |
| Windows / macOS / Linux | 下载安装包 | 本地运行 / 专属服务器 |
| iOS | 编译小程序 | 专属服务器 |
| 鸿蒙 | 编译小程序 | 专属服务器 |
逐行说明：
- Android：移动端唯一能本地执行插件，内置原生 QuickJS 引擎。
- Windows / macOS / Linux（桌面端）：渲染进程不受同源策略约束，可直接请求第三方接口。
- iOS：无预编译安装包；需自备小程序 AppID，用微信开发者工具编译后扫码运行。
- 鸿蒙：华为纯血鸿蒙；暂无原生安装包，获取方式同 iOS。
小程序不是「装好就能用」
小程序没有公开发布，也不存在可以直接搜索到的版本。按 README 的流程分三步：
- 准备环境：代码下载到电脑 → 注册微信小程序开发者拿到自己的 AppID → 安装微信开发者工具并填入 AppID；
- 配置项目：开发者工具里配置「不校验合法域名」→ 点「预览」生成二维码；
- 手机端配置：扫码打开并开启开发者模式 → 选择服务器模式（专属服务器填
https://你的域名/你的API_KEY）→ 导入音源插件。
这个 AppID 不能分享给他人使用，每个使用者都需要自己注册一个。逐步操作见客户端使用教程 · 小程序。
两种运行模式各是什么
差别只有一个核心问题：插件到底在哪台机器上执行。
- 本地运行：插件直接在你的设备上跑，一个字节都不出设备。不需要部署任何服务，但需要自己在客户端导入插件；只有桌面端和 Android 能选。
- 专属服务器：插件在你自己部署的 Cloudflare Workers 实例上跑。所有平台都能用，插件在服务端后台统一管理；代价是要多一步部署，但登录、多端同步与 AI 推荐目前只能在该模式下使用。
两者不冲突：用「本地运行」时，你仍然可以另外配一台专属服务器来做账号登录与多端同步。
插件本身怎么写（支持哪些源、脚本结构与 API），见音源插件使用教程。
为什么只有桌面端和 Android 能本地运行
音源插件本质上是一段会直接请求第三方接口的 JavaScript。让它在本机跑起来要同时满足两个条件：有 JS 引擎能执行它，有不受同源策略约束的网络通道。
- 桌面端：QuickJS 的 WebAssembly 版本做引擎，渲染进程不受同源策略约束 —— 两个条件都满足。
- Android：QuickJS 原生库经原生桥调用，走原生网络栈 —— 两个条件都满足。
- iOS / 鸿蒙：走小程序运行时，没有可用的 WebAssembly 执行环境，网络请求又受域名白名单限制 —— 两者都缺，补不上。
所以这不是"还没做"，而是平台能力边界。
怎么选
- Android 手机 → 下载 APK，可选「本地运行」，导入插件即可，不需要任何服务器。
- Windows / macOS / Linux → 下载客户端，同样可以选「本地运行」；想多端同步就再配一台专属服务器。
- iPhone 或华为纯血鸿蒙 → 用微信开发者工具自行编译小程序，插件交给专属服务器执行。
- 想一次配好、所有平台都能用 → 部署一台专属服务器，各端都选「专属服务器」。