One THUer should have OneTHU.
OneTHU 是面向清华学生的校园应用：统一身份、统一数据、统一界面，覆盖 macOS / Windows / Android，
并内置 AI Agent（OneTHU Harness）。v0.10.0「Complex Variable」是第一个面向所有 THUer 的大规模
公测版——作业、文件预览、桌面小组件与 Agent 四条主线在这一版全部跑通，欢迎上手试用并把问题
丢回来。
⚠️ 升级须知（Android，仅此一次）
本版更换了 Android 签名证书，从 0.9.0 或更早版本升级必须先卸载旧版再安装：
- 直接覆盖安装会失败（
INSTALL_FAILED_UPDATE_INCOMPATIBLE）。 - 卸载会清除本机数据：登录状态、外部作业源（雨课堂 / TUOJ / Tyche / DSA OJ）凭据、设置、
桌面小组件与使用统计；安装后重新登录一次即可恢复。 - 从 0.11 起可正常覆盖升级，无需再卸载。
macOS 与 Windows 不受影响。APK 签名指纹（可自行校验）：
证书主体 CN=OneTHU, OU=OneTHU, O=smartThise, L=Beijing, ST=Beijing, C=CN
SHA-256 CC:14:D7:35:66:7B:B8:B5:D3:13:4E:7D:FD:CC:F6:A4:D9:35:3E:1A:2F:CE:54:50:3F:4A:29:70:54:23:AA:97
一个对话入口：OneTHU Harness
左下角常驻的校园 Agent。用一句话查作业、课表、成绩、电费、图书馆座位与学校新闻；本版让它能直接
打开在线服务的官方页面、把结果收进收藏夹，并可接入 MCP 服务器扩展自己的工具。
原子化：收藏夹、小组件与 Agent 共用同一个引用
页面、组件与校园数据（课程、作业、通知、文件、新闻、洗衣机、教室、场馆、图书馆）统一为「原子」：
可搜索、可收藏、可通过链接直接打开，也可放置到桌面。同一个对象在收藏夹、桌面小组件与 Agent 对话
中的行为完全一致。
作业：一处看全，还能就地提交
- 网络学堂与雨课堂 / TUOJ / Tyche / DSA OJ 合并进「全部作业」与「今日」，在一个位置查看。
- 忽略：不再提醒、不再出现在日程，随时可在「已忽略」分组找回。
- 网络学堂附件支持拍照直接上传；必交附件的作业在本地预检，不再白跑一次提交。
- 雨课堂主观题可在应用内撰写与提交：图文与公式编辑、草稿、剩余次数提示、提交前确认。
只做「用户亲笔的便捷提交」，不生成、不代写、不自动提交。
文件预览：PDF 连续滚动，pptx 真正渲染
- PDF 改为连续滚动，按需渲染当前页附近内容，几十页的课件也不卡顿。
- pptx 直接渲染幻灯片页面（此前只显示文字大纲）。
- 修复手机端 PDF 乱码与渲染失败。
界面与提醒
- 首启导览：界面定制 → 账号接入（雨课堂 / OJ 平台 / 清华邮箱日历 / 清华云盘）→ 桌面小组件，
每步均可跳过。 - 今日页新增「最近使用」与「猜你喜欢」；在线服务目录可收藏，也可由 Agent 一句话打开。
- 桌面小组件按当前时间原生重算（倒计时、正在上课），在翻转点自动刷新，深色模式跟随系统。
- 三端系统通知；提醒支持静默时段，通知不再打扰休息。
稳定性
- 新增根级错误边界：渲染异常不再导致整窗白屏。
- 网络学堂登录状态失效后静默恢复；TUOJ 会话过夜自动续期。
- 修复 Windows 独立窗口白屏、Android release 包中插件命令崩溃等一批问题。
下载
| 平台 | 文件 | 说明 |
|---|---|---|
| Android | OneTHU-0.10.0-*.apk |
arm64，正式签名；升级前请先看上面的须知 |
| macOS | OneTHU_0.10.0_aarch64.dmg |
Apple Silicon；首次打开若被 Gatekeeper 阻止，在「系统设置 → 隐私与安全性」中放行 |
| Windows | OneTHU_0.10.0_x64-setup.exe |
x64 安装器 |
公测说明与已知限制
- OneTHU 是非官方的个人项目，与清华大学无关；数据来自学校公开系统的网页接口，仅供个人学习
与日常使用。 - 体育场馆模块仅提供查询（场馆 / 场次 / 余量 / 我的预约 / 退订），预约请在官方网页完成。
依据清华大学体育部场馆中心 2025 年 12 月 3 日公告第七条第 12 款，以脚本或插件等非正常途径
预定场地会被封禁预订权限 6 个月并函告院系。 - macOS 安装包为 ad-hoc 签名（尚无 Apple 开发者证书），首次打开需手动放行。
- 各平台接口均为逆向自其公开网页端的非官方用法，可能随对方改版失效。
- 插件生态处于早期：插件市场名单仍在扩充，欢迎提交自己的插件。
反馈
- 问题与建议：GitHub Issues——附上应用版本与
设置页「自检」的结果，定位会快很多。 - 用户交流群见仓库 README。
许可
自有代码以 MIT 许可开源，并附两条限制：严禁商业用途；严禁用于对清华大学信息服务的
攻击性访问（抢课、体育场馆或图书馆座位等自动预约提交）。第三方组件按其自带许可，详见
LICENSE 与
第三方组件许可。