Reach 学生效率管理软件 V1.0 · 用户操作手册 · 2026 年 10 月
以下内容为软件配套文档全文，含全部界面截图。

1引言

1.1编写目的

本手册是《Reach学生效率管理软件V1.0》配套的用户文档，面向本软件的用户，介绍软件的功能构成、运行环境、安装方法与全部操作流程，并对常见问题给出解决指引。读者按照本手册即可独立完成软件的安装、配置与日常使用。

本手册与软件源程序一一对应：手册中描述的每一项功能，均能在软件界面上找到对应的入口与操作；软件中的各功能模块（任务管理、课程表、番茄钟、提醒、AI助手、桌面小组件、成就统计、个性化设置、数据管理）在本手册中均有对应章节说明。

1.2软件概述

Reach 学生效率管理软件（简称Reach）是一款面向在校学生的本地化效率管理工具，运行于Android 平台，采用Kotlin 语言开发，基于Jetpack Compose 构建用户界面。软件将「课程表、任务、专注、提醒」四项能力整合在一个应用中，所有用户数据均存储在设备本地数据库，没有账号体系、不依赖自建服务器、不上传用户数据。

软件由以下功能模块组成：任务管理模块、课程表模块、番茄钟模块、提醒模块、AI 助手模块（可选）、桌面小组件模块、成就与统计模块、个性化设置模块与数据管理模块。各模块的界面布局与操作流程在本手册第3～11 章逐一分述。

1.3运行环境

• 硬件环境：Android 智能手机（ARM64 架构，内存4GB 及以上），测试机型OPPO PGBM10；开发与调试使用PC（Windows 10/11，16GB 内存）。
• 软件环境：Android 10 及以上（API Level 29+，含Android 11/12/13/14）；开发工具为Android Studio（JDK 17），构建系统Gradle，目标SDK 为Android 14（API 34）。
• 界面形态：软件界面固定为竖屏显示，不随系统自动旋转。
• 存储空间：软件安装包约100MB，用户数据随使用量增长占用本地存储，通常为数十兆字节以内。

2安装与首次使用

2.1安装步骤

用户可通过各安卓应用商店搜索「Reach」，进入应用详情页后点击「安装」完成下载安装；也可通过侧载方式安装：将签名后的APK 文件传输至手机，在文件管理器中点击安装（需在系统设置中允许该来源安装应用）。

安装完成后，在手机桌面或应用列表中找到Reach 图标（白色圆角底、深青色山形图案），点击图标启动软件。首次启动时软件会弹出隐私政策、用户协议与用户手册告知弹窗。

2.2隐私政策、用户协议与用户手册

首次启动软件时，屏幕弹出「隐私政策、用户协议与用户手册」告知弹窗，正文提供《用户协议》《隐私政策》与《用户手册》全文入口，列明数据本地存储、不采集不上传的隐私承诺及权限申请清单。用户点击「同意并继续」后方可进入主界面；点击「不同意」则退出应用，不收集任何数据。

该弹窗仅在首次启动出现。《用户协议》《隐私政策》与《用户手册》全文亦可在「我的→设置→关于」中随时查阅。

2.3权限说明与申请时机

软件遵循「最小必要」原则，仅在功能首次需要时向用户申请对应权限，均可在系统设置中关闭，权限逐项说明见附录B。

通知权限（POST_NOTIFICATIONS）：用于任务到期与上课提醒的消息送达，Android 13 及以上在首次使用提醒功能时弹出系统授权框。精确闹钟权限（SCHEDULE_EXACT_ALARM / USE_EXACT_ALARM）：本应用属日程提醒类工具，闹钟提醒须准点触发；Android 12 起部分机型需前往系统设置手动开启，软件内「提醒可靠性自检」页面提供逐项跳转入口。

全屏通知权限（USE_FULL_SCREEN_INTENT）：用于提醒到点时亮屏弹出全屏闹钟界面；Android 14 起该系统仅对通话与闹钟类应用默认放行，其余情况由系统降级为横幅通知（详见6.2 节）。前台服务权限（FOREGROUND_SERVICE 及其SPECIAL_USE 类型）：番茄钟运行期间在通知栏与锁屏持续显示剩余时间。开机自启动权限（RECEIVE_BOOT_COMPLETED）：手机重启或应用升级后自动重建全部提醒闹钟，防止提醒丢失。振动权限（VIBRATE）：提醒响铃时同步振动。读取存储权限（仅Android 12 及以下）：用于选择本机图片设置自定义背景，图片仅在本机处理、不上传。网络权限（INTERNET / ACCESS_NETWORK_STATE）：仅供可选的AI助手模块访问用户自行配置的第三方接口；不使用AI 功能时软件完全不联网。

2.4快速上手（五分钟跑通核心流程）

首次使用建议按下述六步操作，五分钟内即可完成从导入课表到收到第一条提醒的完整流程：

• 第一步：在「日程」页点击导入，选择文件或教务网页方式导入本学期课表，并在差异确认页核对后应用（详见4.6、4.7 节）；
• 第二步：进入「我的→课表设置」，确认每日节数与节次时间符合本校作息，如有教学楼作息差异按4.5 节绑定模板；
• 第三步：回到「今日」页点击「+」新建一条今天到期、带提醒时间的任务（详见3.2 节）；
• 第四步：按系统引导开启通知与精确闹钟权限（详见2.3 节）；
• 第五步：进入「我的→提醒自检」，逐项确认提醒链路各项权限均为绿色状态（详见6.3 节）；
• 第六步：到设定时间观察提醒送达（响铃并弹出提醒界面；部分安卓14 机型的系统会将其降级为横幅通知，点按通知同样进入），即完成提醒验证。此后可到「番茄」页开始第一个番茄钟（第5 章），并在桌面添加「今日课程」小组件（第8 章）。

3今日任务

3.1任务列表与自动分组

启动软件后默认进入「今日」页，整页按所选日期取数：页头的日期片显示当前查看的日期，点按可改选其他日期（选中非今天时，页头出现「回今天」）。任务列表自上而下分为三段——所选那一天的任务与课程同列一段（课程按上课时间排入，与任务共用色带区分）、该日期前一天仍未完成的任务归入「昨日逾期」、未设截止时间的任务归入「无期限」；完成后的任务折叠在「已完成」分组内，点按可展开查看。

点击任务条目左侧的圆形勾选框即可标记完成，任务移入「已完成」分组；点击条目右侧的铅笔图标可打开编辑面板修改名称、时间与提醒设置。

3.2新建任务与提醒设置

点击页面右下角「+」悬浮按钮，先在选择面板里二选一（新建任务/ 新建课程），进入新建任务面板后可逐项设置：任务名称、颜色标记（与课程共用同一色板，用于列表与日程页的色带区分）、截止日期与时间（支持分别指定开始时间与结束时间，只填截止亦可）、提醒开关与提前量（准点/ 提前5 / 10 / 15 / 20 / 30 / 60 分钟）、提醒方式（静默通知或响铃振动）。名称留空时「确认」按钮不可用。保存后任务立即出现在对应分组，提醒闹钟由系统AlarmManager 精确登记。

编辑任务时面板回填原有内容，修改保存后旧提醒自动取消并按新时间重建。

3.3批量编辑

点击顶栏「批量编辑」进入批量模式，顶栏实时显示「已选N 项」，可勾选多条任务后一并执行「完成」或「删除」，点击「取消」退出批量模式。

3.4任务与课程时间冲突提示

软件以课程表数据为参照进行冲突检测：当任务的起止时间与某一节课的上课时段重叠（课程真实时段依据该课程的星期、起止节次、起止周与作息规则换算）时，今日列表中该任务条目会标注红色「与课程冲突」角标；在效率模式下（见4.8 节），课表周视图不为冲突任务上图，并在页面顶部以提示条汇总「N 个任务与课程冲突，已挪到今日日程」，点按提示条即进入消息中心处理（见7.8 节）。冲突标记仅为展示层提示，不影响任务的保存与正常提醒。

4课程表

4.1周视图浏览与切换周

底部导航「日程」进入课程表页。页面以「星期× 节次」网格周视图展示本周全部课程，每节课渲染为一张色块卡片，标注课程名称、教师、上课地点与起止节次。顶部的周次指示条显示当前为第几周，支持左右滑动或点击箭头切换周次；当前日期所在周自动高亮，今日所在列带有颜色标记。当天有课时，点击课程卡片可查看课程详情。

4.2手动添加与编辑课程

长按网格中的空白时段（或点击顶栏「+」）打开添加课程表单，依次填写：课程名称、教师、上课地点、星期、开始节次与结束节次、开始周与结束周、单双周类型（每周/ 单周/ 双周）。课程颜色支持从预设色板中选取。保存后课程卡片立即出现在网格对应位置，并可自动避让同时段课程、按内容高度自适应排布。点击已添加的课程卡片进入详情，可修改或删除。

4.3学期管理

点击顶栏学期名称展开学期管理界面，可查看当前学期的开学日期与总周数。用户可新建多个学期，为每个学期分别维护一套课程；切换学期后课表页整体换为所选学期的数据。学期编辑界面提供开学日期选择器与总周数输入，修改后各周次的课程归属自动重算。

4.4课表设置

「我的→课表设置」中可配置：每日节数（支持上午/下午/晚自习分组分别设定，默认12 节）、每周起始日（周一或周日）、以及各节次的上下课时间。节次时间以「全校默认作息」表为准，支持逐节修改；修改某一节的时间时可开启「改一节后自动顺延后续节次」，其后各节整体平移。页面底部另提供「清除课表」入口，仅删除当前学期的全部课程，说明见11.3 节。

4.5作息模板与教学楼

针对同一校内不同教学楼作息不一致的情况，软件提供「作息模板」与「教学楼」两级自定义：用户可创建多套作息模板（各自的节次时间表），并将模板绑定到具体教学楼；一门课程的上课时间按「本课自定义＞所在教学楼作息＞全校默认」三级规则回退解析，课表界面上会以角标形式显示当前节次时间的解析来源，便于核对。

4.6课表导入

除手动添加外，软件在「日程→⋮→导入/ 更新课表」中提供两种导入方式：①本地文件导入——选择本机中的课表文件，软件按文件头识别格式并解析课程条目，支持Excel（.xlsx/.xls）、Word（.docx）、PDF 与CSV/纯文本（自动识别UTF-8 与GBK 编码）；②教务系统导入——在应用内打开学校教务系统网页，登录后定位课表页面，软件抓取页面表格并解析（内置正方教务系统适配与各校入口地址目录）。两种方式最终都进入同一「差异确认」环节。教务导入所用内置浏览器的登录凭据（Cookie 与本地存储）随页面关闭即清除，不在设备上保留。

文件导入支持两种常见排版：「星期×节次」矩阵表（行表头为星期、列表头为节次，单元格内填写课程名）与「条目列表」表（每行一条课程，含课程名、星期、第几节至第几节、起止周、地点、教师等列）。软件自动识别表头类型并逐格解析，无法识别的内容会归入解析失败列表并在差异确认页明示，不会静默丢弃。

4.7课表变更差异确认

导入结果不会直接覆盖现有课表。软件将解析出的课程与当前课表逐条比对，在「课表变更确认」页按新增、变更、停开（本次文件里没再列出的旧课）、无变化四类分组列出，并在顶部给出各类门数。只有勾上的条目会被应用：新增与变更默认勾上，停开默认一条都不勾（即保留那门课），页面另提供「停开：全部勾选」「停开：全部不勾」两个批量按钮。逐条可撤勾，确认后点击「更新课表」，仅勾选项写入数据库。该机制保证导入操作可预期、可回退。

4.8效率模式与日程任务上图

「我的→课表设置」中开启「效率模式」后，课程表页从节次网格切换为按真实时刻排布的日程视图，并把符合条件的任务一并画进日程。任务上图的门槛为：由AI安排创建（AI 规划师或快速指令，见第7 章；手动新建的任务不上图）、有开始与结束时间、时长不少于30 分钟、落在当前显示的这一周内，且不与课程时段冲突。不满足任一条件的任务仍保留在「今日」列表并正常提醒，只是不在日程图上绘制。

任务块与课程卡采用同款卡片样式与同一色板；时长不足以撑起一块高度的短任务画为同色细条，保证「那段时间在忙」仍然可见；同一天出现三条及以上细条时聚合为一条「· N 项· M 分钟」，点击可逐条展开。同一时段并列多门课程时只显示一张卡片，右下角以圆点标注其余数量，点击查看全部。

4.9长按拖拽调整时间

在日程视图中长按课程卡片或任务块即可抓起拖动：按住期间块放大并跟手移动，松手时自动吸附（纵向按5 分钟一挡、横向对齐到整列），落点处的目标框实时显示新的起止时间，若压到其他块会一并提示。松手后，任务块直接修改那一天的那一场，并自动重排提醒；课程块先弹出「改的是整学期」确认框，确认后才写入该课的自定义上课时间（与编辑页「自定义上课时间」同一规则，节次与节数不受影响），一门课被课间空隙拆成多段时拖动任一段即整课平移。新位置若与既有任务冲突，软件只提示不阻止。轻点仍是打开详情，不受拖拽影响。

5番茄钟

5.1开始专注与计时控制

底部导航「番茄」进入番茄钟页。页面中央以大号数字显示剩余时间，时、分、秒三列可分别上下滑动自定义时长，也可点预设按钮（15 / 25 / 45 / 60 分钟）一键选定。点击「开始」启动专注计时，计时过程中可「暂停」与「继续」，也可结束本次计时；计时期间以通知栏与锁屏通知持续显示剩余时间。

5.2锁屏倒计时与完成提醒

计时期间软件以前台服务维持运行：下拉通知栏常驻一条显示剩余时间的通知；锁屏状态下剩余时间同步显示在锁屏通知与屏上。计时结束时手机发出完成铃声并振动，进入统计页面后本次专注计入番茄钟完成次数。切换标签页或最小化应用均不影响计时精度，计时器以系统时钟为基准计算，不存在后台暂停问题。

6提醒机制

6.1任务提醒与上课提醒

软件的提醒能力分为两类：任务提醒在用户为任务设定的提醒时刻触发；上课提醒依据课程表自动计算，支持为「上课前0/5/10/15/25/30/45 分钟」等提前量配置，仅在当前周次该课程实际开课的日期触发。两类提醒均支持「静默通知」与「响铃振动」两种送达方式：任务提醒在每条任务的「新建/ 编辑任务」面板内单独设置，上课提醒在「日程→⋮→修改课表」页底部的「上课提醒」区统一设置（总开关、提前量与提醒方式）。所有提醒闹钟基于AlarmManager 精确闹钟登记，到点误差不受应用是否存活影响。

6.2全屏闹钟界面

提醒方式选为「响铃振动」后，到点时软件以系统闹钟音源播放铃声并振动，同时弹出全屏闹钟界面：上方显示提醒类型（「任务时间到」或「上课提醒」），中央显示事项名称与详情，下方提供「知道了」与「稍后X 分钟」两个按钮，后者将提醒顺延设定时长后再次响起，行为与系统闹钟一致（顺延时长可在「我的→设置→通知→稍后提醒时长」中调整，见6.5 节）。该界面在锁屏与熄屏状态下亦可点亮显示，并在显示后回读数据库做二次校验——若任务已完成或课程已删除则自动收起，不会残留误提醒。响铃通知的右侧还带有「停止」与「稍后」两颗按钮，可直接在通知上静音或顺延，无需进入应用。需说明的是：Android 14 起系统将「全屏通知」权限限定为通话与闹钟类应用，部分机型（如ColorOS 14 ）会把第三方应用的全屏闹钟降级为横幅通知，此时铃声与振动照常，点按通知即可进入同一闹钟界面；软件在「提醒可靠性自检」中提供试听入口便于区分是播放器问题还是系统拦截。

6.3提醒可靠性自检

国产手机系统普遍存在后台管控，可能导致提醒失效。软件内置「提醒可靠性自检」页面（我的→提醒自检），逐项检测：通知权限是否开启、精确闹钟权限是否授权、电池优化是否已将本应用列入白名单、自启动/后台活动是否放行。每一项给出当前状态（正常/异常）并提供跳转按钮直达对应的系统设置页，用户按引导逐项放行后即可保证提醒链路可靠。页面另提供提醒铃声试听入口，响铃进行中按钮变为「停止」，可随时关闭；Android 14 及以上版本页面还会如实显示「全屏闹钟弹出」的可用状态——被系统限制时标红并跳转对应开关，便于区分「播放器问题」与「系统拦截」。

6.4错过提醒的补发与重建

当设备因被系统清理或关机导致某条提醒未能按时送达时，软件在下次启动时汇总补发错过的提醒，避免用户遗漏事项。补发窗口按提醒类型区分：任务提醒在原定时刻之后24 小时内补发；上课提醒在原定上课时刻至下课之间补发，下课即作废。此外，设备重启（BOOT_COMPLETED广播）、应用升级（MY_PACKAGE_REPLACED 广播）与系统时间变更（TIME_CHANGED 广播）三类事件触发后，软件自动扫描本地数据库中的全部提醒并重建闹钟，确保重启升级后提醒能力完整恢复。

6.5提醒铃声与稍后时长

「我的→设置→通知」提供两项提醒声音相关的设置。其一为「提醒铃声」：点「更换」后在对话框中二选一——系统铃声（闹钟音，含「默认」）或本地音频文件；选择本地文件时软件向系统申请可持久化的读取授权，重启后仍有效，若文件解析失败会自动回落系统默认闹钟音而非静音。铃声更换后软件同步重建通知渠道（渠道的声音属性创建后不可修改），默认铃声下渠道与旧版完全一致。铃声更换全局生效：全屏闹钟界面、自检试听、响铃通知与番茄钟完成提示使用同一音源出口。其二为「稍后提醒时长」：提供5/10/15/20/30 分钟五档选择（默认10 分钟），全屏闹钟界面的「稍后」按钮与响铃通知上的「稍后」按钮共用这一时长，改完即生效。

7AI 助手（可选功能）

7.1前置条件与配置

AI 助手为可选的高级功能，默认不启用。用户在「我的→设置→模型与API」中自行填写第三方大模型服务的接口地址、API 密钥与模型名称后，该功能方可使用。软件不代用户向任何第三方模型服务发起中转请求，全部请求由用户设备直连用户自配的接口；未配置时，软件的其他功能不受影响，应用亦不产生任何联网行为。

该页顶部为接入商二选一：「默认DeepSeek」由软件内置接口地址，「自定义」则自行填写地址；其下依次是快速对话模型与规划师模型两个模型名输入项，以及三档思考强度选择——快速对话、冲突重排与AI 规划师可各自在「轻度/ 中等/ 最高」中设定（前两项默认中等，规划师默认最高）。API 密钥输入框为密码框，保存后再次进入显示为「已保存（留空则不修改）」，不清空即不改动原密钥。

「模型与API」页另提供前往服务商官网获取密钥的入口卡片，点击后以软件内置浏览器的纯浏览模式打开对应网页——该模式不挂载任何页面抓取能力，仅供登录、查看与复制密钥，浏览记录与登录凭据用后即清。

7.2快速指令

AI 页提供「快速指令」与「AI 规划师」两个入口。「快速指令」为轻量问答页：在底部输入框以自然语言提问即可发起对话，可附加图片（每条消息最多9 张，发送前以缩略图确认）或文本文件（文件内容并入提问）；超长的用户消息在气泡内折叠为八行，点按底部箭头展开、再点收起。AI 回复以占满整行的气泡呈现，气泡内正文下方固定标注「AI 生成信息请谨慎甄别」。对话上下文仅保留最近5 条消息，附件保留5 天，超期自动清理。与规划师一样，点「发送」后消息先以草稿形态落在对话尾部、点【确认】才真正发出（见7.3 ①），本页的本地应答为「收到，马上为你处理…」。

7.3AI 规划师：对话式排程全流程

AI 规划师支持对话式排程：用一句自然语言描述需求（如「帮我安排本周的复习计划」），软件按「草稿确认→过程可视化→追问补全→操作确认」四个环节完成一次排程，每一步都由用户把关，自动化能力始终处于用户控制之下。

①草稿确认：点击发送后，这条消息立刻以「草稿」形态进入对话列表末尾（观感上如同已经发出，实际尚未向模型发起任何请求），列表自动滚到底；【确认】与【修改】两颗按钮右对齐贴在该条草稿气泡的正下方，随列表滚动。点【确认】才真正发送给模型；点【修改】则整条内容（含附件）回填输入区重新编辑，不产生任何发送。失败提醒条仍钉在输入栏上方。

②过程可视化与失败重试：等待响应期间，对话尾部只有一个过程气泡，其中的状态字在同一位置轮替、不并列——先是本地应答「收到，正在为您规划任务」（快速指令页为「收到，马上为你处理…」），短暂停留后让位于「正在思考」行，右侧灰色小字随工具调用逐轮更新（如「正在查课表与已排任务…」）。请求失败时同一位置换成「重新连接」行，右侧标注「网络不佳，正在重试中（n/5）」：网络异常、超时、服务不可用与空响应都会自动重试，每次间隔10 秒、最多5 次，重试复用原请求、用户消息不会重复入库。五次仍失败则在输入栏上方升起提醒条：超时档给出主句与副句，提供【重试】（重新计5 次）与关闭；密钥或模型名有误的配置档提示检查配置并提供【去设置】直达「模型与API」，这类错误不做无谓重试。模型返回后，正文与思考块在同一气泡内按真实顺序交错呈现，「思考完成」折叠行随消息一并落库——切换会话、继续发新消息乃至重启软件都不会吞掉它，点按箭头即可展开查看模型的思考过程；思考步骤若涉及工具调用（如查询课表），展开区顶部先给一行中文摘要（如「查看了你的课表」），再接该步骤的思考原文。

③追问补全：当需求信息不全（如未说明希望的时间段），屏幕中央浮出「追问卡」，以选择题方式逐题补全：每个选项前置圆圈字母徽章，末项固定为「其他（自己填）」，点开即可输入。点选的选项即刻变蓝，稍作停留后自动进入下一题，全部答完自动发送。已答内容随卡片现场保存，切换会话甚至关闭软件后再打开，卡片与已答选项都在，不会丢失。

④操作确认：模型返回的结构化操作（新建任务、修改任务、删除任务等）不再重复写进回复正文——回复气泡只讲排期依据，气泡下方另起一条独立的小卡片：一行操作摘要（如「➕添加「复习大学英语」」「✏修改任务」），右侧【取消】【确认】两颗按钮。所有操作必须经用户点击「确认」后才真正写入数据库，「取消」则完全不影响既有数据。任务若落在上课时段内会被排期校验直接打回，模型会另择空档或先向用户追问，不会静默覆盖既有安排；因课表更新而产生的冲突则汇总到消息中心处理（见7.8 节）。

确认执行后，新任务即写入数据库并登记提醒；带起止时间的AI 任务还会出现在效率模式的日程页上（见4.8 节）。

7.4健康管理

「健康管理」是AI 页的第三张功能卡。进入后顶部玻璃卡显示当前体重与较上一条记录的增减（↑/ ↓/ 持平，差值小于0.05 视为持平），卡上的「记一笔」展开手动录入行：填数值与日期后保存，体重取值超出20~300 会被拦下并提示取值范围。页面另提供「导入截图」与「拍体重秤」两个识别入口——对体重记录截图或秤面照片做文字识别，识别结果先进确认页，核对或修改后再入库。点按顶部卡可展开「最近记录· 体重」，列出近30 条记录，点按某条可改数值与日期，长按该条经确认后删除。连续记录满两天后，页面底部出现近30 天的体重趋势曲线卡，标出记录次数与区间。

7.5个人履历

「个人履历」是AI 页的第四张功能卡。首次进入以八题问答建档案（学历层次、年级、专业、学校等，多为选择题卡片，学校与专业手填），答完生成一张A4 简历纸：头部为姓名、求职意向与头像，姓名实时取个人中心昵称，改昵称简历随之变；其下按教育背景、实习经历、项目经历、科研竞赛、荣誉奖项、技能证书、校园经历、个人能力八节排布，其中教育背景与个人能力读问答档案，其余各节的条目为左侧年月（支持起止区间）加右侧多行要点，暂无条目的节显示「＋添加一条」。页面可把档案与已录条目摘要交给AI 规划师出改进建议：只给建议、不创建任务，也不替用户编造未提供的经历。

7.6花哪去了

「花哪去了」是AI 页的第五张功能卡。首页顶部大卡显示本月支出合计与笔数，并标出最近一笔的日期；「记一笔」展开录入行，填金额、选分类（餐饮/ 交通/ 购物/ 学习/ 娱乐/ 其他六选一）、选日期，备注可选。「导入截图」与健康同构：对微信、支付宝的账单截图做文字识别，一行一笔、每行各带日期，余额与优惠等杂项自动排除，识别结果先进确认页核对后入库。下方「流水」按新到旧列出近50 条记录，长按某条经确认后可删除。页面底部提供「AI 看账」：把近90 天的支出摘要（合计、分类与最近几笔）交给AI 规划师，结合近7 天的空闲日程给出分析与建议——只出分析，不创建任务。

7.7会话管理（历史对话抽屉）

规划师页顶栏右侧的入口可展开「历史对话」抽屉（自屏幕右侧滑出），以卡片列表列出各次会话，点击切换、亦可新建对话。快速指令与规划师的会话相互独立，全部会话内容仅保存在设备本地。

7.8消息中心：冲突处理与AI 建议

「我的→消息中心」（或点按日程页顶部的冲突提示条「去处理」）汇总待处理的冲突消息，未结案的消息以红点计数。每条消息可让AI 重新规划：模型给出的改期建议以「任务名改到开始～结束」的形式逐行展示，用户从四个出口中任选其一——「按建议改」（新时间逐条写入并重排提醒，消息标记已处理）、「再想一个」（带同一冲突详情请模型另给一版）、「自己说怎么改」（展开输入框补充要求后再规划）与「稍后处理」（不做任何改动，红点不消）。用户未确认前，AI 建议绝不会直接改动任务数据。

列表底部提供「全部清除」与「批量清除」入口：前者经二次确认后清空全部消息，后者进入多选模式勾选删除。AI 建议依赖已配置的模型接口（见7.1 节），接口不可用时页面给出提示，可稍后重试或手动调整任务。

7.9信件

久未使用的AI 对话在闲置满「连续N 天」（默认30 天，可在「模型与API」页的「AI 对话的保留与来信」中调整，下限7 天）后，软件请模型为那段对话写一封回顾信，汇总在「我的→信件」页以时间线列表展示，每条显示会话标题、正文首行与生成日期，点开可读全文并自动标记已读；尚无来信时页面给出空态提示与闲置天数说明。是否生成来信、闲置天数与是否清理历史对话是三件独立的事，可各开各的；某段对话的原始记录仅在其来信成功生成后才按设置清理，未配置密钥或生成失败时不会静默删掉对话。来信正文带有「AI 生成」标识。

7.10AI 生成内容标识

凡经AI 助手产出的回复文本与月度来信，界面均带有「AI 生成」标签提示，避免用户将生成内容误认为软件自身的确定性结论。

8桌面小组件

8.1今日课程与下节课组件

软件提供两个原生桌面小组件：「今日课程」组件按时间顺序列出当天全部课程（课程名、地点、上课时间），并高亮当前正在进行的一节；「下节课」组件显示下一节课的名称、地点与上课时间倒计时。组件支持「透明玻璃」与「实底」两种外观样式，长按组件可进入样式切换。

8.2添加与刷新机制

在手机桌面空白处长按→「小组件」→找到Reach，将「今日课程」或「下节课」拖到桌面即完成添加（各品牌手机入口略有差异，组件帮助页提供OPPO/vivo/小米/华为四家入口图示）。组件内容由午夜换日闹钟与每节课的边界闹钟驱动刷新，保证桌面信息与课表实时一致；点击组件可直接打开软件对应页面。

9成就与统计

9.1成就值与等级

软件以「成就值」量化用户的执行成果：完成一项任务、完成一次番茄钟均可累计成就值；成就值达到阈值后等级自动提升，并写入一条升级历史。用户可在成就页查看当前等级、累计成就值、进度条与逐条升级历史。

9.2任务统计

在「我的」页点开任务统计卡片，汇总多个维度：本周完成任务数、本月完成任务数、连续完成天数（连续每天至少完成一项任务的记录），以及完成趋势柱状图与任务状态环——两图进入页面时各播放一次生长动画，图表窗口可在7 天/ 30 天/ 1 年之间切换（默认30 天，1 年的柱状图按月汇总）；环形图按完成状态分三段弧（已完成/ 进行中/ 逾期），中心以大字显示完成率。统计基于本地任务记录实时计算，数据随用户行为每日更新，不依赖任何网络服务。

10个性化设置

10.1主题模式与字体大小

「我的→外观设置」提供浅色/深色/跟随系统三种主题模式；软件主色采用Material 3 动态取色，亦支持手动指定主题色。字体大小提供「标准/ 中/ 大/ 特大」四档调节，调大后全局界面文字同步缩放，兼顾无障碍阅读需求。

10.2材质风格与雨天效果

「我的→设置→主题」的风格区提供三选一：「简洁」——页面用自身底色、卡片为白底细边；「玻璃」——卡片呈半透明磨砂质感并随背景产生流动折射，该效果按设备能力自动判档、不设独立开关；「卡片」——照片作底、面板与课程块均为不透明卡片。玻璃风格下另有「雨天」段：一个水效果总开关加「雨滴/ 水帘」二选一，水效果需要背景有画面，选「不用照片」时不生效；卡片风格不接视频背景、也没有雨天。

10.3自定义背景

用户可为应用设置背景：从相册选择照片（Android 12 及以下申请存储权限，Android 13+ 使用系统图片选择器，不申请额外权限），或选择本地短视频作为动态背景（仅玻璃风格支持）；软件内置20 张场景照片可直接选用，也可随时改回「不用照片」，此时页面使用所选风格自身的底色面板。

11数据管理

11.1本地存储说明

软件所有业务数据（任务、课程、学期、专注记录、成就、设置）均存储于设备本地的Room 关系型数据库中，数据库文件位于应用私有目录，其他应用无法读写。软件不提供云同步、不上传用户数据，卸载应用即随系统清理删除全部数据；恢复出厂设置前如有重要数据，请自行截图导出。

11.2清除用户数据（恢复出厂）

「我的→数据管理→清除全部数据」等同恢复出厂：点击后弹出二次确认对话框，明确列出将被清除的数据范围（任务、课程、专注与成就记录、设置项，以及隐私政策同意记录、提醒闹钟登记、AI 对话与附件等）；确认后软件在本地事务中逐表清空数据库并退出应用，下次启动如同全新安装（重新出现隐私政策弹窗）。该操作不可撤销，清除过程无需联网。

11.3清除课表

「我的→课表设置」页底部提供范围更小的「清除课表」：仅删除当前学期的全部课程并同步取消其上课提醒，学期、开学日期、作息模板、教学楼、任务与各项设置一概保留。操作经二次确认，适用于换学期重新导入课表等场景。

12常见问题（FAQ）

12.1提醒不响怎么办

提醒依赖系统精确闹钟与通知通道。请按「提醒可靠性自检」页逐项检查：①系统通知权限已开启；②精确闹钟权限已授权（部分机型默认关闭）；③本应用已加入电池优化白名单；④自启动/后台活动已放行。四项全部正常后，到点仍不响的少数情况为系统限制（如ROM 强杀前台服务），可尝试锁屏后保留应用后台。

12.2课表导入失败

文件导入失败多为表格排版无法解析：Excel/CSV 建议采用标准「星期×节次」矩阵格式或「课程名/星期/第几节」条目格式；PDF/Word 仅支持文本型课表（扫描件图片无法识别）。教务导入失败通常因学校教务系统改版，可改用「网页导入」手动选择课表区域。所有导入均经差异确认后才写入，解析错误不会产生脏数据。

12.3AI 功能无法使用

AI 功能不可用按序排查：①是否已在「模型与API」中填写有效的接口地址、密钥与模型名称；②设备网络是否连通、所选服务商是否可达；③密钥余额/额度是否充足；④返回超时属服务商侧波动，可稍后重试。以上任一未满足时，软件其余功能均不受影响。

12.4断网环境能否正常使用

可以。除可选的AI 助手外，任务、课表、番茄钟、提醒、小组件、成就统计与个性化设置等全部功能均在本地完成，飞行模式下可正常使用全部核心能力；重新联网后无需任何同步操作。

12.5重启手机后提醒是否仍然有效

有效。软件通过开机广播监听在设备启动后自动扫描本地数据库中的全部未来提醒并重建闹钟，用户无需手动恢复；前提是已在系统设置中允许Reach 自启动（可通过「提醒可靠性自检」页跳转开启）。

12.6桌面小组件内容不更新

小组件由「午夜换日闹钟」与「课程边界闹钟」驱动刷新。若长时间停留在旧内容：①先打开一次Reach 主界面，触发数据重新装配；②检查系统是否限制了Reach 的后台活动（见12.1 的自检项）；③确认当前学期与开学日期设置正确（周次判断依赖该设置）。以上均正常仍不刷新时，可移除小组件后重新添加。

12.7自定义背景上文字看不清

照片或视频背景上文字偏灰时，在「主题→风格」中改用「卡片」风格（照片作底、面板为不透明卡片）或「简洁」风格（页面用自身底色），或在「背景」里选「不用照片」；日程页另有「课表标签垫卡片」开关（课表设置内，默认关闭），开启后给年份、周次、日期与节次时间各垫一张小卡，压在照片上更好认。软件已默认为带文字的卡片区域垫入底板。

12.8AI 排的任务为什么没有出现在日程页

日程页上图的任务须同时满足五个条件：已在「我的→课表设置」开启效率模式；任务由AI 创建（规划师或快速指令），手动新建的任务不上图；任务有开始与结束时间、时长不少于30 分钟；落在当前查看的这一周内；不与课程时段冲突。任一条件不满足即不在日程图上绘制，但任务本身与提醒均不受影响，可到「今日」页查看。

13版本信息与联系方式

本手册对应软件版本V1.0。本版本为软件首次公开发布版本，包含第1～12 章所述全部功能；后续版本的功能变更将在更新日志中列明，并视变化幅度修订本手册。「我的→设置→关于」提供《用户协议》《隐私政策》《用户手册》与开源许可清单（列明软件所用开源组件及许可证原文），可随时查阅。

• 软件全称：Reach 学生效率管理软件
• 软件简称：Reach
• 版本号：V1.0
• 著作权人：Dehors
• 联系方式：dehorsboyer@163.com

附录A功能与源程序模块对照

为便于核对文档所述功能与源程序实现的对应关系，本附录将本手册各章功能逐条映射至源代码目录（com/dehors/reach/ 下）。手册描述的每一项用户可见功能，均可在下列源文件所实现的界面与业务逻辑中找到对应入口。

A.1模块与源码目录对照

①应用入口与主框架（第2 章）：ReachApplication.kt（全局初始化、通知渠道注册）、MainActivity.kt（主界面、导航宿主、首次启动隐私协议弹窗与权限引导）、ui/TabNav.kt 与ui/FullScreenMode.kt（底部导航与全屏显示、系统栏处理）。

②今日任务（第3 章）：界面位于ui/screens/home/HomeScreen.kt 、HomeViewModel.kt ；任务数据读写位于data/repository/TaskRepository.kt 与data/local/dao/ 下的任务数据访问对象，持久化实体位于data/local/entity/；任务与课程的时间冲突检测位于utils/ConflictDetector.kt，冲突消息生成与全写入点重扫钩子收口于data/repository/ConflictScanRepository.kt。

③课程表（第4 章）：界面位于ui/screens/schedule/（ScheduleScreen.kt 周视图、CourseEditScreen.kt课程编辑、SemesterManageScreen.kt学期管理、BuildingManageScreen.kt 与TemplateManageScreen.kt 教学楼及作息模板、CourseSettingsScreen.kt 课表设置、ScheduleImportFlow.kt 与WebImportActivity.kt 导入与差异确认）；解析与业务逻辑位于data/repository/ScheduleRepository.kt 及utils/ 下的ClassTableParser.kt 、TimetableHtmlParser.kt 、ZfJsonParser.kt 、CourseWeekFilter.kt 、WeekCalculator.kt 、TimeBlockLayout.kt 、ScheduleTaskFilter.kt （4.8 节任务上图判据）、CourseColors.kt（课程与任务共用色板）等源文件。

④番茄钟（第5 章）：界面位于ui/screens/pomodoro/PomodoroScreen.kt 、PomodoroViewModel.kt；通知栏与锁屏倒计时由同目录PomodoroTimerService.kt（前台服务）实现；完成提醒经utils/ 闹钟调度封装注册。

⑤提醒机制（第6 章）：闹钟登记与重建逻辑位于utils/ReminderScheduler.kt、ReminderAlarms.kt、CourseReminderScheduler.kt、ReminderGuard.kt；到点送达与响铃位于utils/ReminderNotifier.kt、NotificationHelper.kt（含提醒铃声音源出口与稍后时长快照）、AlarmRingtonePlayer.kt ；响铃通知的「停止/ 稍后」按钮位于receiver/NotificationActionReceiver.kt，稍后时长取值域位于utils/ReminderSnooze.kt；补发逻辑位于utils/MissedReminderNotifier.kt；广播接收器位于receiver/BootReceiver.kt、ReminderReceiver.kt、ReminderFollowUpReceiver.kt、SelfCheckReceiver.kt；保活服务位于service/ReminderKeepAliveService.kt；全屏闹钟界面位于ui/screens/reminder/ReminderAlarmActivity.kt；可靠性自检页位于ui/screens/profile/ReminderReliabilityScreen.kt ；提醒点击聚焦动效位于ui/components/ReminderFocus.kt。

⑥AI 助手（第7 章）：界面位于ui/screens/ai/ （AiEntryScreen.kt 、QuickChatScreen.kt、PlannerChatScreen.kt）与ui/screens/letters/（月度来信），消息中心位于ui/screens/profile/MessageCenterScreen.kt、MessageCenterViewModel.kt；对话组件（草稿确认、追问卡、过程气泡与思考块）位于ui/components/ChatComponents.kt；对话与会话管理位于data/repository/ChatRepository.kt、SessionRepository.kt（追问卡现场表pending_question_cards 与消息思考轨迹trace 列位于data/local/，数据库版本21）；接口配置界面位于ui/screens/profile/ModelSettingsScreen.kt；密钥与配置存储位于utils/ApiKeyManager.kt 、SettingsManager.kt 。AI 页三张功能卡分别位于ui/screens/health/ （HealthScreen.kt 、HealthViewModel.kt 、HealthOcrReview.kt 、WeightTrendCard.kt 及ocr/ 识别引擎）、ui/screens/resume/ （ResumeScreen.kt 、ResumeQuiz.kt 、ResumeViewModel.kt ）与ui/screens/finance/ （FinanceScreen.kt 、FinanceViewModel.kt、FinanceOcrReview.kt）；账单与体重截图的文字识别按行切分与解析位于utils/OcrLines.kt、utils/HealthOcrParser.kt、utils/ExpenseOcrParser.kt，指标取值域位于utils/HealthMetrics.kt。

⑦桌面小组件（第8章）：widget/TodayCoursesWidget.kt 、widget/NextCourseWidget.kt（组件渲染），widget/WidgetDataLoader.kt（数据装配），widget/WidgetRefresh.kt（刷新闹钟与广播），widget/WidgetState.kt、WidgetTheme.kt（玻璃/实底样式），widget/WidgetPinHelper.kt（添加引导）。

⑧成就与统计（第9 章）：界面位于ui/screens/profile/AchievementScreen.kt、TaskStatsScreen.kt ；成就值与等级计算位于utils/LevelUtils.kt ，统计聚合位于utils/StatsUtils.kt。

⑨个性化设置（第10 章）：主题、配色、字体、动效档位与材质效果位于ui/theme/ （Theme.kt 、Color.kt 、Typography.kt 、Motion.kt 、GlassModule.kt 、LiquidGlass.kt、WaterCurtain.kt）；外观设置界面位于ui/screens/profile/ThemeScreen.kt、SettingsScreen.kt；设置项读写位于utils/SettingsManager.kt、UserPreferencesManager.kt。

⑩数据管理（第11 章）：Room 数据库定义与历次版本迁移位于data/local/TaskDatabase.kt 及dao/ 、entity/ 、di/ 子目录；清除全部数据流程位于utils/UserDataCleaner.kt 与对应数据访问层。

A.2术语表

精确闹钟：Android 系统提供的按时分秒精确触发的定时器能力（AlarmManager.setAlarmClock / setExactAndAllowWhileIdle），是本软件提醒可靠性的基础。

前台服务：应用退至后台后仍可继续运行并向用户展示常驻通知的系统组件，本软件用于番茄钟倒计时。

单双周：课程仅在单数周或双数周开课的属性，课表解析时与起止周共同决定某课程在某周是否生效。

作息模板：一组「节次→上下课时间」的映射表，可绑定到具体教学楼，实现跨教学楼的差异化作息。

差异确认：课表导入时，软件将解析结果与现有数据逐条比对、由用户勾选采纳的安全导入机制。

效率模式：课表设置中的一项开关，开启后课程表页按真实时刻排布课程，并把符合条件的AI 安排任务一并画入日程，是4.8 节所述日程视图的总开关。

追问卡：AI 判断需求信息不全时，在屏幕中央弹出的选择题卡片，逐题补全后自动继续；已答内容随卡片现场保存，杀进程不丢。

液态玻璃：玻璃风格下的一种界面视觉效果，使半透明卡片随背景产生流动折射，按设备能力自动判档、不设独立开关，属纯展示层实现，不影响业务数据。

附录B权限清单与系统设置引导

本附录汇总软件申请的全部系统权限、用途与对应设置入口，供用户核对与排查提醒问题时查阅。所有权限均可在系统「设置→应用→Reach →权限」中关闭；关闭后仅对应功能降级，不影响其余功能使用。

注：上表权限与AndroidManifest.xml 中的声明一一对应，软件未申请定位、相机、麦克风、通讯录、短信等其他任何权限。