Relay

BoxJS iOS 客户端
一个美观、原生的 BoxJS 管理工具

功能特性

• 收藏应用管理 — iOS 主屏幕风格的图标网格，支持长按拖拽排序、编辑模式和收藏标记
• 应用订阅 — 添加、刷新、删除订阅源，卡片式 UI 展示订阅状态和更新时间，支持拖拽排序
• 多代理工具切换 — 支持 Loon / Surge / Shadowrocket / Quantumult X，每个工具独立配置 API 地址
• 应用详情与配置 — 原生 Form 布局，查看应用描述、编辑配置项（单选、复选、文本输入等）
• 会话管理 — 创建、切换、关联多组会话，保存和恢复应用数据状态，支持会话数据导入
• 全局备份 — 一键备份/恢复全部数据，支持 JSON 文件导入导出，备份重命名与详情查看
• 全局搜索 — 实时搜索应用，按名称和 ID 模糊匹配，快速导航到应用详情
• 脚本执行与编辑 — 内置 JavaScript 控制台，支持远程脚本和自定义脚本运行，查看执行结果与异常
• 数据查看器 — 查询、浏览和编辑 BoxJS 存储的键值数据，快捷标签访问最近查询
• 偏好设置 — 通知静默、查询提醒、Surge HTTP-API 配置等个性化选项
• 深色模式 — 完整的深色模式支持，20+ 组语义化颜色资源，自适应图标和配色
• 下拉刷新 — 首页和订阅页支持下拉刷新数据
• 版本更新提示 — 自动检测新版本，语义化版本对比，展示完整更新日志
• 性能优化 — 图片降采样解码、派生数据缓存、批量更新去重、内存占用精细控制
• Liquid Glass — iOS 26+ 自适应 Liquid Glass 视觉效果，低版本自动回退

支持的代理工具

工具	状态
Loon	✅
Surge	✅
Shadowrocket	✅
Quantumult X	✅

每个代理工具可独立配置 BoxJS API 地址，支持一键切换。

技术栈

• UI 框架: SwiftUI + UIKit（UICollectionView 等高性能组件）
• 架构模式: MVVM + Combine
• 网络层: Moya / Alamofire
• 图片加载: SDWebImage / SDWebImageSwiftUI
• 依赖管理: Swift Package Manager

主要依赖

依赖	用途
Moya	网络抽象层
Alamofire	HTTP 客户端
SDWebImage	图片缓存与加载
AnyCodable	动态 JSON 类型支持
swift-markdown-ui	Markdown / HTML 渲染
SwipeCellKit	列表滑动操作

项目结构

Relay/
├── Models/            # 数据模型 (BoxDataResp, AppModel, AppSubCache, AppSubSummary, Session 等)
├── Views/             # SwiftUI 视图
│   ├── Home/          # 收藏应用主页、搜索
│   ├── Subscribe/     # 应用订阅管理
│   ├── Profile/       # 个人中心与备份
│   ├── AppDetail/     # 应用详情与配置
│   └── Components/    # 共享组件 (AppIconView 等)
├── ViewModels/        # MVVM ViewModel (BoxJsViewModel，含派生数据缓存)
├── Services/          # 网络服务层
│   ├── BoxJSAPI       # Moya TargetType 定义
│   ├── ApiRequest     # API 请求门面
│   └── NetworkProvider# Moya Provider 封装
├── Managers/          # 全局管理器 (ApiManager, ToastManager)
├── Helpers/           # 工具类 (震动反馈等)
└── Extension/         # 扩展 (Color hex, Toast 视图等)

构建与运行

环境要求

• Xcode 15.4+
• iOS 15.0+
• Swift 5.0

步骤

1. 克隆仓库

   git clone https://github.com/gideonsenku/Relay.git
   cd Relay

2. 用 Xcode 打开项目

   open Relay.xcodeproj

3. 等待 SPM 自动拉取依赖，选择目标设备后运行

配置 BoxJS 地址

首次启动后，点击首页左上角的工具切换按钮，选择你使用的代理工具并输入对应的 BoxJS API 地址（例如 http://127.0.0.1:9090）。

Roadmap

✅ Phase 1 — 基础功能 应用管理 / 订阅管理 / 脚本执行 / 全局备份

✅ Phase 2 — 完整体验 会话管理 / 全局搜索 / 数据查看器 / 脚本编辑器 / 偏好设置

✅ Phase 3 — 体验优化 深色模式适配 / 下拉刷新 / 版本更新提示

📋 Phase 4 — iCloud 同步 多设备配置同步 / 备份云端存储 / 无缝切换

🤖 Phase 5 — AI Agent 自然语言生成脚本 / 智能优化 / 一键部署

API 兼容性

Relay 通过 REST API 与 BoxJS 后端通信：

• 查询: /query/boxdata, /query/data/*, /query/versions
• 更新: /api/update, /api/save
• 订阅: /api/addAppSub, /api/deleteAppSub, /api/reloadAppSub
• 备份: /api/saveGlobalBak, /api/delGlobalBak, /api/revertGlobalBak
• 脚本: /api/runScript

响应格式：{ "code": 0, "message": "...", ...payload }

License

MIT