使用帮助

开始使用理枝

四步开始，再按需了解账号同步、校园网络与数据存放方式。没找到答案时，欢迎到 GitHub Issues 提问。

初次使用

理枝使用学校统一身份认证账号登录。登录过程由本地客户端直接完成： 账号密码和登录会话保存在操作系统的安全存储中，不会写入普通文件。

访问教学中心时，应用会同时探测校内直连与 WebVPN 两条线路，自动使用先连通的一条；某条线路中断时会自动尝试另一条，无需手动切换。乐学与新延河课堂使用可校外访问的直连入口。

启动时只恢复登录状态，不同步业务数据；课表、日程（DDL、考试）、成绩与学分均按你的操作手动同步。同步 DDL 时会保留本地的编辑、完成与删除状态。

登录途中遇到短信或图形验证属于学校认证流程的正常环节。取消验证后账号会保留「需要验证」状态，可在设置的账号项中点击「验证」重新完成。

课表

同步后按周查看，横滑切换周次，浏览其他周时用「回到本周」返回。支持手动添加课程、导出 ICS 到系统日历。点击课程可查看详情与下一门课的换楼关系。

日程

提供列表与瀑布时间轴两种视图。右上角导入菜单可分别更新乐学、新延河课堂与大物实验的 DDL。列表中可滑动完成或删除，已删除的 DDL 可单独恢复。

成绩

同步全部学期成绩后自动计算绩点与加权平均分，同一课程取最高成绩。试算页可添加拟修或重修课程预测绩点变化，不影响已保存成绩。

空教室

选择校区、教学楼与日期后查看各节次占用，也可筛选指定时段全程空闲的教室。需要先完成校园账号登录。

在校内网时通常走直连更快；在校外时 WebVPN 线路一般先连通。理枝每次操作都会并行探测两条线路并选择先响应的一条，你不需要判断自己身处哪种网络环境，也不需要在应用里手动切换。

如果同步持续失败，可先在浏览器中确认统一身份认证能否正常登录，再于应用内重试；仍然失败时请提交 Issue 并附上导出的日志。

课表与日程保存在本机；账号凭据使用系统安全存储；对校园服务的请求由本地直接发起， 不经理枝自建中转服务器，必要时使用学校自己的 WebVPN。已保存的课表和日程随时可以离线查看。

日志在本地保留七天，可在 设置 → 导出日志 中预览最近 100 行或导出日志文件，文件包含构建版本与运行环境信息，便于排查问题。应用不自动上传日志，分享前请再次检查内容。

理枝不要求注册自己的账号，也不做行为遥测；可选的中国大学 MOOC 使用独立官方登录。应用还会访问 GitHub 检查更新。数据存储、认证及加密范围详见安全性与隐私。

登录时提示需要短信或图形验证，怎么办？

这是学校统一身份认证的正常环节，在应用内按提示完成验证即可继续。取消验证后账号会保留「需要验证」状态，前往设置的账号项点击「验证」可重新进入验证流程。

在校外（不连校园网）可以使用吗？

可以。教学中心的数据会通过 WebVPN 线路获取；乐学与新延河课堂本身支持校外直连。已保存的课表和日程不联网也能查看。

我的数据保存在哪里？换手机会丢失吗？

课表、日程与学业数据都以文件形式保存在当前设备的本机存储中，不上传云端。更换设备后重新登录同一账号并同步，即可取回学校侧的数据；本地手动添加的内容需要重新录入。

卸载应用会清除数据吗？

不要把卸载等同于彻底清除所有数据。应用目录、系统安全存储和备份的保留行为因平台而异，导出的文件也不会随卸载自动删除。需要清理时，请先退出学校和 MOOC 账号，并删除不再需要的本地数据、日志及导出文件。

绩点是怎么计算的？

采用学校公布的本科生绩点计算规则，同一课程取最高成绩计入。规则原文见学校教务页面。理枝还会同时给出加权平均分与学期表现。

macOS 打开时提示「无法验证开发者」或「已损坏」？

当前版本未签名，被 macOS Gatekeeper 拦截。前往「系统设置 → 隐私与安全性」，在底部点击「仍要打开」后再启动即可。提示「已损坏」时，可先确认压缩包是否完整解压。

iOS 版怎么安装？

iOS 的 IPA 安装包未签名，需要使用自签工具或开发者证书完成签名后，通过侧载方式安装到设备。相关工具与步骤请以 GitHub Releases 页面说明为准。

忘记密码或登录一直失败？

理枝使用学校统一身份认证的账号密码，与你在其他校园系统使用的一致。忘记密码请通过学校统一身份认证平台重置；重置后仍无法登录，可带日志到 Issues 反馈。

如何反馈问题或建议？

先在「设置 → 导出日志」中导出日志文件（含构建版本与运行环境），然后到 GitHub Issues 提交新问题并附上日志。功能建议同样欢迎。

以上说明基于仓库当前文档整理；如与应用实际行为不一致，以应用内提示与 GitHub 仓库为准。