最后更新:2026-11-18 01:30
OneTHU 是一款面向清华师生的非官方校园应用,支持 macOS、Windows 与 Android。0.11 版本采用 OneGUI 统一视觉与交互,支持自由定制主题、壁纸与布局,并提供极简、实用、完整三种使用模式:全局搜索与 OH 胶囊贯穿三种模式;完整模式进一步开放自由白板、暂存分享、名片与组织、插件、OneTHU Harness 与清小搭。
| 项目 | 适用场景 | 获取方式 |
|---|---|---|
| OneTHU | macOS、Windows、Android 校园客户端,整合课程学习、日程提醒、生活预约与常用外部平台。 | 下载应用 |
| NextTHUxk | 在教务选课网页直接提供课程检索、课表预览、暂存方案与 AI 辅助排课。 | 安装选课扩展 |
| NextTHULearn | 打开网络学堂网页即可启用 OneTHU 风格的清爽学习工作台。 | 安装学堂扩展 |
三个项目均可独立使用;两款浏览器扩展直接复用对应学校网页的登录会话,装上就能用。
| 版本 | 主要改进 |
|---|---|
| 0.11.4-fix-3 · 当前版本 | 修复保留数据升级后的登录衔接与云盘更新请求参数,保障本机认证与二次验证顺畅。 |
| 0.11.4-fix-1 | 优化 Windows 登录与后台启动体验,修复首页课程展示、平板设置页滚动与手机卡片高度。 |
| 0.11.4 | 推出独立 CLI、SDK 与桌面常驻后台;OH 接入雨课堂、好友、组织、清小搭与暂存箱,完善附件命名与多账号隔离。 |
以下截图全部截取自真实运行的应用界面,填充了离线模拟数据,涵盖手机竖屏、横屏与桌面大屏视图(示例语言为中文)。素材生成方式与校验记录见 截图来源说明。
| 极简 | 实用 | 完整 |
|---|---|---|
![]() | ![]() | ![]() |
| 功能模块 | 体验说明 |
|---|---|
| 三种模式 | 极简聚焦今日待办与课程;实用收纳高频校园服务;完整展开可自由编排的工作台。随时切换模式,原有配置与数据都会完好保留。 |
| 统一搜索 | 通过顶部或底部的 OH 胶囊快速检索功能、校园服务与已同步内容,本地直达目标页面,响应迅速。 |
| OneShot / OneGO / 白板 | 默认底栏提供学习、预约、生活、信息、课表五大直达入口;完整模式支持多标签页、OneGO 收藏栏、多工作区与自由白板组件。 |
| 学习与日程 | 汇总网络学堂课程、作业、公告与课件,支持按需接入雨课堂与 OJ 作业;课表、作业截止与个人日程同屏呈现,三种模式均可查看待交截止提醒。 |
| 生活与预约 | 集成校园卡(含余额预警线与恢复后自动撤回提醒)、电费、校园网、清华新闻、空教室、图书馆座位与研讨间查询等常用服务。 |
| 暂存箱与口令 | 长按已接入的卡片或条目,提起即可拖入高亮的暂存箱按钮,并通过在线短口令快捷分享(近期推荐使用短口令,体验比 NFC 更稳定)。 |
| 名片与组织 | 完整模式提供个人名片、好友联络、组织成员权限、共享文件、项目协作与公告管理;数据同步机制详见文档。 |
| OH / OneTHU Harness | 完整模式可调用已授权的应用工具与插件;精简模式支持自填模型 API 及连接微信、飞书通道,模型配置与校园账号相互独立。 |
| 清小搭与技能 | 浏览模型、智能体与技能广场:纯同步 JavaScript 技能可在内置轻量 QuickJS 沙箱中即点即用;需要 Python、Node 或本地命令行环境的技能可一键导出给电脑端 Agent 运行。 |
| 插件生态 | 支持 JS 扩展、桌面 Rust sidecar 与 Android 内嵌插件三种形态;当前开放 41 个命名空间、297 个 API 入口,按声明权限与所在平台运行。 |
下方动图录制自真实交互过程(仅叠加触控指针以便观看)。支持长按拖入的来源涵盖已接入的作业、课件、白板组件、标签页、工作区、搜索结果、日程、名片、邮件与云盘文件。
前往 GitHub Releases 或 清华云盘镜像 下载对应系统的安装包(版本发版后云盘镜像会陆续同步)。
- 选择语言与模式:首次打开可跟随交互导览熟悉布局,点击导览中的体验入口可直达真实页面并随时返回。
- 登录校园账号:使用清华统一认证登录并按提示完成二次验证;邮箱、日历、云盘与大模型等功能可在需要时单独连接授权。
- 开启提醒与排障:按需打开作业、日程或余额通知;若遇到网络或登录异常,可先查看应用内的脱敏诊断信息定位原因,稍候再试。
git clone --recurse-submodules https://github.com/smartThise/OneTHU.git
cd OneTHU
git switch dev3
pnpm install
pnpm devpnpm dev 可在浏览器中快速预览和调试前端界面;若需体验校园网请求、本地文件、通知等完整系统能力,请配置 Rust 与 Tauri 环境运行原生宿主(Android 构建另需 JDK / SDK / NDK)。日常主力开发分支为 dev3。
- 开发者中心与构建指南
- OneTHU CLI、SDK 与常驻助理:支持终端独立登录、课程资料归档、定时巡检、IM 提醒及面向外部智能体的 MCP 接入。
- 贡献者名录
- 插件开发指南 · API 清单 · OneTHU Harness
- 系统架构 · OneGUI 设计系统 · 文档目录索引
衷心感谢 THU Info、learnX、thu-learn-lib、NextTHUxk、NextTHULearn、thu-tok-auto、yuketang-helper-auto 以及每一位参与设计、开发、测试和反馈的朋友。
OneTHU 自有代码采用自定义非商业开源许可,并附带保护清华大学信息服务正常秩序的使用约定。若在公开项目中复用或改编相关代码,烦请在 README、NOTICE 等显著位置注明 OneTHU 及实际引用的上游项目。THU Info 授权代码、LearnX 移植部分及其他第三方依赖分别遵循各自许可条款。









