ScholarFlow 不是另一个课表 App。 它是一个将教务系统、AI 助手和个人学习工具深度融合的本地优先工作台。
大学生的日常信息流是割裂的——教务系统查课表和成绩，再用独立的 App 记笔记、设番茄钟、写日报。数据散落在各处，账号密码交给云端，学习节奏被打断。
ScholarFlow 把这些全部收束到一个应用里：
教务系统 个人工具
(课表/考试/成绩) + (作业/笔记/番茄钟/日报/屏幕时间)
│
▼
ScholarFlow 工作台
(本地存储 · 离线可用 · 桌面原生)
ScholarFlow 不是爬虫。 它用你自己的学号密码，通过学校官方 API 登录，只获取你自己的数据。整个过程就像你用浏览器查教务一样，只不过整合到了一个更好用的界面里。数据只存在你的设备上，不经过任何第三方。
核心理念： 你的学习数据属于你自己。默认存储在本地 SQLite，凭证加密保存在设备上，不经过任何第三方服务器。
|
账号密码仅加密保存在你的设备上，学习数据默认存储在本地 SQLite。不上传、不追踪、不采集。代码完全开源，可自行审查。 |
课表 → 作业 → 番茄钟 → 日报，不是十个孤立工具的拼凑，而是围绕真实学习流程设计的完整工作台。 |
|
Electron 加持：系统级安全存储、后台自动刷新、活动窗口统计、自动更新。网页版做不到的事。 |
|
|
桌面端（主力）+ Web/PWA + Android，移动端还有专属萌系「小咪」皮肤，M3 设计系统 + 可爱吉祥物。 |
本地 SQLite + 服务端数据同步到本地。断网也能查课表、写笔记、看成绩。网络只是增强，不是依赖。 |
| 能力 | 🖥️ Electron 桌面 | 🌐 Web / PWA | 📱 Android |
|---|---|---|---|
| 课表 / 成绩 / 考试同步 | ✅ 完整 | ✅ 支持 | ⚡ 实验性 |
| 作业 / 目标 / 番茄钟 / 笔记 | ✅ 完整 | ✅ 支持 | ⚡ 实验性 |
| 本地安全加密存储 | ✅ 系统级 | ||
| AI 学习助手（聊天与周报） | ✅ 完整 | ✅ 支持 | ⚡ 实验性 |
| 活动窗口统计 | ✅ 完整 | ❌ 不支持 | ❌ 不支持 |
| 后台自动刷新 | ✅ 完整 | ❌ 不支持 | ❌ 不支持 |
| 萌系小咪皮肤 | 默认主题色 | Web 自适应 | 🐱 萌系 UI |
桌面版是主力形态，Web / PWA 是补充形态，Android 为实验性支持。
前往 Releases 下载 Windows 安装版或便携版，开箱即用。
环境要求： Node.js 20+ · npm 10+
git clone https://github.com/Health-525/scholarflow.git && cd scholarflow && npm install| 命令 | 说明 |
|---|---|
npm run dev |
启动 Web 开发服务器 |
npm run abi:node && npm run electron:dev |
启动 Electron 开发环境 |
npm run electron:hot:win |
Windows 热加载模式（Next.js + Electron 同时启动） |
npm run electron:hot:win 前可设 PORT=3002 |
开发模式下指定 Next.js dev 端口（默认 3000） |
npm run typecheck |
TypeScript 类型检查 |
npm run lint |
ESLint 代码规范检查 |
npm test |
Vitest 单元测试 |
npm run check |
一键全检（typecheck + lint + test） |
npm run electron:build |
构建 Windows 安装包与便携包 |
|
课表、作业、考试倒计时、教务通知、近期日报——一屏掌握全部学习状态 |
今日视图、本周网格、日期查询、学期周次自动计算 |
快速新增、列表管理、完成状态一键追踪 |
|
教务同步、绩点展示、按学期查看成绩趋势 |
考试安排管理与倒计时提醒 |
DeepSeek-V4 驱动：周报生成、学习伙伴聊天与智能总结 |
|
Markdown 编辑、图片上传、标签、搜索、公众号导出 |
专注 / 休息循环计时，助你进入心流 |
习惯打卡与目标追踪 |
|
学习数据沉淀，趋势回顾与复盘 |
多学校适配器配置、账号安全、主题与数据管理 |
秒级前台窗口检测，90+ 应用识别规则，未知应用保留真实名称，支持 CSV 导出 |
ScholarFlow 为移动端量身打造了专属的 「小咪」萌系皮肤：
- 核心页面适配 — 首页、课表、AI 聊天已通过
React.lazy懒加载移动专属 UI - 零开销 — 移动组件懒加载，桌面端打包体积不受影响
- M3 设计系统 — 粉色 Material-3 主题，支持粉 / 青双配色切换
- 小咪吉祥物 — 专属 Mascot 组件，带流畅动画效果
- 桌面主题 — 桌面端默认采用小咪主题色，完整萌系 UI 在移动端呈现
| 层级 | 技术选型 | 说明 |
|---|---|---|
| 🖥️ 框架 | Next.js 15 + React 19 + TypeScript |
App Router · RSC · 类型安全 |
| 🎨 样式 | Tailwind CSS + shadcn/ui + Base UI |
原子化 CSS · 无头组件 · 暗色模式 |
| 📦 状态 | Zustand + TanStack Query |
轻量状态 · 服务端缓存 · 自动刷新 |
| 🖥️ 桌面 | Electron + better-sqlite3 |
原生窗口 · 本地数据库 · 安全存储 |
| 📱 移动 | Capacitor (Android) |
跨平台 · 原生 API 桥接 |
| 🧪 测试 | Vitest + Playwright |
单元测试 · E2E · UI 自动化 |
| 适配器 | 学校 | 教务 | 状态 |
|---|---|---|---|
njtech |
南京工业大学 | ✅ | 已支持 |
hebau |
河北农业大学 | ✅ | 已支持 |
💡 想接入你的学校？ 只需实现
SchoolAdapter接口。详见 学校接入指南 →
┌──────────────────────────────────────────────────────────┐
│ 🔒 你的数据，你的设备，你的控制权 │
├──────────────────────────────────────────────────────────┤
│ • 账号密码 AES-256-GCM 加密存储，密钥经 scrypt 派生，不上传 │
│ • 学习数据默认存储在本地 SQLite（WAL 模式） │
│ • Electron: contextIsolation + nodeIntegration 严格隔离 │
│ • 内部 API 带 token 校验，敏感凭证显式边界控制 │
│ • 记住密码功能需 Electron safeStorage 才启用 │
│ • 代码完全开源，可自行审查每一行 │
│ • 零追踪 · 零广告 · 零数据采集 │
└──────────────────────────────────────────────────────────┘
详见 SECURITY.md
欢迎提 Issue 和 PR。贡献前请阅读 CONTRIBUTING.md。
| 文档 | 说明 |
|---|---|
| 学校接入指南 | 如何为新学校编写 SchoolAdapter |
| 数据模型 | 核心数据结构与关系说明 |
| 安全说明 | 安全架构设计与最佳实践 |
| 构建排错 | 常见构建问题与解决方案 |
MIT © 2026 Health-525
ScholarFlow is a local-first campus study workspace that deeply integrates academic systems, AI assistant, and personal study tools into a single desktop application.
Why ScholarFlow:
- 🔒 Data sovereignty — AES-256-GCM encrypted credentials. Study data in local SQLite. Zero tracking.
- 🧩 Complete workflow — Schedule, grades, assignments, notes, pomodoro, AI chat & reports, screen time.
- 🖥️ Desktop-native — Electron with secure storage, background refresh, activity tracking, auto-update.
- 🔌 Extensible —
SchoolAdapterpattern. NJTech and HEBau already integrated. - 📱 Multi-platform — Desktop (primary), Web/PWA, Android with a unique cute mobile skin.
Features: Dashboard · Schedule · Assignments · Exams · GPA · Notes (Markdown, WeChat export, image upload, tags, search) · Pomodoro · Goals · Daily/Weekly Reports · AI Assistant (DeepSeek-V4 powered chat & weekly report) · Screen Time (second-level activity tracking with 90+ app recognition rules & CSV export) · Settings · Mobile Ximi Skin
Platforms: Electron desktop (full), Web/PWA (complementary), Android/Capacitor (experimental).
Quick links: Downloads · Landing Page · Security · Contributing