QLClient 是一个面向青龙面板的移动客户端，当前包含 iOS SwiftUI 版和 Android Kotlin/Compose 版。它通过青龙 Open API 连接你的服务端，可以在手机上管理定时任务、环境变量和脚本文件。

• Open API 登录，支持保存多个青龙账号
• 账号快速切换
• 白天模式、夜间模式、跟随系统
• 定时任务列表、运行、停止、启用、禁用
• 定时任务新增、编辑、置顶、取消置顶
• 定时任务当前日志和历史日志查看
• 环境变量列表、新增、编辑、启用、禁用
• 环境变量置顶、取消置顶，并按网页版规则排序
• 脚本目录浏览、脚本内容查看、编辑保存和运行测试
• 兼容青龙 v2.20.0 的任务、变量和脚本返回格式

每次推送到 main 后，GitHub Actions 会同步构建 iOS 和 Android 安装包，并发布到同一个 Release。

• iOS 最新版：QLClient-unsigned.ipa
• Android 最新版：QLClient-android-debug.apk
• 所有版本：Releases

1. 下载 Release 中的 QLClient-unsigned.ipa。
2. 把 IPA 传到 iPhone。
3. 在 TrollStore 中点击 +。
4. 选择 Install IPA from File 并安装。

1. 下载 Release 中的 QLClient-android-debug.apk。
2. 把 APK 传到 Android 手机。
3. 允许当前文件管理器或浏览器安装未知来源应用。
4. 打开 APK 并安装。

当前 Android 自动构建产物使用 debug 证书签名，适合自用安装。后续如果需要正式发布，可以再加 release keystore 和签名密钥配置。

• iOS 源码在 QLClient/，项目由 Project.yml 通过 XcodeGen 生成。
• Android 源码在 android/，使用 Kotlin、Jetpack Compose、OkHttp 和 Kotlinx Serialization。
• .github/workflows/build-qlclient-ios.yml 会同时构建 QLClient-unsigned.ipa 和 QLClient-android-debug.apk。

在青龙 Web 面板中创建 Open API 应用，并给应用授予以下权限：

• system
• crons
• envs
• scripts

如果缺少某项权限，对应页面可能会返回 401 或权限错误。