BIT101-iOS 是 BIT101 的 iOS 客户端，当前已经上架 App Store。
这个仓库的定位不是“从零重新设计一套 iOS 校园应用”，而是：
- 以 Android 端现有能力为基线
- 尽量保留用户最常用的功能
- 在 iOS 端重写成可维护的原生实现
- 对小组件、锁屏组件、Live Activity、账号隔离、缓存等部分做平台适配
项目迁移与生成过程中主要参考了以下仓库：
- Android 端：https://github.com/BIT101-dev/BIT101-Android
- 后端：https://github.com/BIT101-dev/BIT101-GO
- 网页端：https://github.com/BIT101-dev/BIT101
本项目的代码生成与移植过程高度依赖 AI。仓库目前的工程价值主要在于：
- 展示一个复杂 iOS 应用如何在 AI 辅助下逐步成形
- 积累 Android -> iOS 迁移时的架构和踩坑经验
- 作为后续继续维护、修补和本地化打磨的基础
当前 iOS 端已经覆盖的主要能力包括：
- 登录与会话恢复
- 日程
- 课表
- 考试
- DDL
- 自定义日程
- 空教室
- 成绩查询、筛选和统计
- 校园地图
- 话廊
- feed 浏览
- 搜索
- 发帖
- 评论
- 举报
- 本地屏蔽
- 消息中心
- 我的主页与他人主页
- 设置中心
- 桌面小组件
- 锁屏组件
- Live Activity / 灵动岛提醒
项目仍处于实验性阶段。
这意味着：
- 部分实现已经可用，但未必优雅
- 有些链路更偏“能跑通”，而不是“最漂亮的工程实现”
- 某些 UI 与交互细节仍在持续收口
- 代码库已经具备维护基础，但还没到可以完全放手不管的程度
如果你把它当成一个“正在运转、但仍需继续打磨”的原生 iOS 客户端，会更符合它当前的状态。
主要目录如下：
BIT101-iOS/BIT101-iOS主 App 源码BIT101-iOS/BIT101ScheduleWidget小组件、锁屏组件、Live Activity / 灵动岛扩展BIT101-iOS/docs仓库级文档
主 App 内的核心模块：
Login/登录、凭据恢复、学校 SSO 与 BIT101 登录桥接Schedule/课表、考试、DDL、空教室、自定义日程，以及小组件快照导出Score/成绩查询、筛选与统计Map/地图页与MapKit桥接Gallery/话廊 feed、搜索、发帖、详情、消息、本地屏蔽Mine/我的主页、他人主页、粉丝、关注、帖子Settings/设置中心、账号相关设置、界面偏好Shell/登录后的 tab 壳层与全局路由
建议按下面顺序阅读：
docs/CODEBASE_GUIDE.md说明模块边界、数据流、状态流和关键设计约束。docs/MAINTENANCE_GUIDE.md说明构建、签名、真机、账号隔离、小组件、Live Activity 和常见维护注意事项。docs/FILE_INDEX.md列出全部 Swift 源码文件及其职责，适合快速定位代码入口。
本项目使用 Xcode 工程构建，包含两个 target：
- 主 App：
BIT101-iOS - 扩展：
BIT101ScheduleWidget
因此在修改以下能力时，需要同时关注主 App 与扩展：
- 课表
- 小组件
- 锁屏组件
- Live Activity / 灵动岛
- App Group 共享快照
基本要求：
- 最新稳定版 Xcode
- 有效的 Apple 签名与描述文件
- 真机调试能力
当前仓库的推荐维护原则如下：
- 优先保证行为稳定，再考虑结构重写
- 多账号相关数据必须继续保持隔离
- 小组件与 Live Activity 只依赖共享快照，不直接耦合主 App 内部复杂状态
- 服务层和状态机变更时，优先同步注释和
docs/ - 用户可见文案调整后，要同步 README、代码注释和设置页说明
这个仓库的文档目标不是“简单介绍功能”，而是帮助后续维护者回答下面这些问题：
- 这个模块到底归谁管
- 状态是保存在本地、内存、Keychain，还是共享容器
- 哪些行为是平台约束，哪些只是当前实现选择
- 改一个功能时，需要同时留意哪些文件和 target
因此文档会比普通项目更强调：
- 模块职责
- 数据流
- 约束条件
- 踩坑记录
- 维护边界
如果你发现 bug、异常行为或明显不合理的实现，欢迎提交 Issue。
本项目主要用于探索 AI 生成代码与 Android -> iOS 迁移的可行性与边界，不保证代码质量、可维护性或生产可用性。