跳转至

脱敏演示版（OneTHU Demo）构建说明

最后更新：2026-09-22 22:59

本分支（demo）用于构建自动化演示用的脱敏版应用。它与正式版是同一份代码， 只在少数文件上有差异（见下），镜像纪律见「双线纪律」。

与正式版的差异（全部差异就这三处）

位置 正式分支 demo 分支
packages/core/src/privacy/config.ts DESENSITIZE_ENABLED = false DESENSITIZE_ENABLED = true
apps/desktop/src-tauri/tauri.conf.json identifier = app.onethu.desktop，productName = OneTHU identifier = app.onethu.demo，productName = OneTHU Demo
窗口标题 OneTHU OneTHU Demo（脱敏演示版）

因为应用 id 不同（app.onethu.demo），脱敏版与正式版可以装在同一台机器 / 同一台手机上共存， 互不覆盖数据。

双线纪律

demo 与发布线 dev3（本地检出的分支名为 dev2）只允许在上面列出的文件上不同。镜像改动只按文件摘取：

git checkout <sha> -- <files>    # 在发布线单独提交；本分支独有的文件不得带过去

不得 git merge 或快进把 demo 合入发布线。2026-09-21 的实际事故即由此产生：demo 的两个 专属提交（脱敏开关、独立应用身份）进入 dev3，发布线于是带着 DESENSITIZE_ENABLED = true （正式版会脱敏）与 identifier = app.onethu.demo（装成另一个应用、覆盖不了线上版本）。

门禁：node tools/release-line-check.mjs 检查 git 引用（发布线必须脱敏关闭、身份为 app.onethu.desktop、无 demo 专属产物；demo 线反之），--worktree 在镜像提交前自查工作区。

脱敏口径

登录流程与正式版完全一致：使用真实清华统一身份认证与 2FA，不包含模拟登录，也不使用假数据接口。

登录之后，数据在离开客户端的那一刻被替换（apps/desktop/src/lib/privacy.ts 用 Proxy 包住 learn / info / thu-info-lib helper / 外部作业源，方法名无需登记，新增接口自动生效）：

类别 处理
姓名（自己 / 老师 / 助教 / 讨论区发帖与回复 / 分组同学 / 通知发布人 / 校园卡 / 发票 / 网络账号 / 体育预约 / 体测） 换成化名池里的化名（张三、李四…），同一个人始终同一个化名
学号 / 一卡通号 / 账号 换成编造学号（保留年级前缀，如 2025xxxxxx）；登录凭据本身仍是真实值
联系方式（邮箱 / 手机 / 座机） 换成示例邮箱与编造号码
成绩（成绩单、作业与考试得分、体测总分、雨课堂） 按 GRADE_SCALE 编造，只生成高分段：A+ / A / A- = 4.0（约 2/3）、B+ = 3.6（约 1/3）；等级与绩点取自同一行。不生成 C / D / F：真实成绩单中极少出现 1.3 这类绩点，一旦出现即明显异常
富文本正文（讨论区帖子、通知正文、作业评语、评教建议） 已登记的真实姓名与 10 位学号一并替换
非敏感数据（课程名、课表、教室、洗衣机、图书馆座位、新闻、场馆、发票金额…） 原样不动，全部是真实数据

界面标识：侧栏底部角标显示「脱敏演示版」，登录页有一行说明；正式构建里这两处是死代码。

构建

pnpm install
pnpm --filter @onethu/desktop tauri:dev      # 桌面壳开发态（脱敏已生效）
pnpm --filter @onethu/desktop tauri:build    # macOS DMG / Windows EXE（productName = OneTHU Demo）

bash apps/desktop/scripts/build-demo-apk.sh  # Android APK：脱敏 + app.onethu.demo，工程落在 ~/onethu-android-demo

发布线的对应脚本是 build-release-apk.sh：两者都把 Android 工程放在内盘 APFS（exFAT 卷上 Gradle 会误读 AppleDouble 副档），差别是发布线脚本在构建前先自检发布线不变量，demo 线脚本 使用独立的应用身份与工程目录。

两条防错配护栏（2026-09-21 加）：

  • 符号链接无条件重指：gen/android 每次都重指到 demo 工程。此前写成「与当前指向不同 才改」，于是上一次构建留下的正式工程指向被沿用，产物名是 demo、内容却是正式版。
  • 构建后校验产物包名：用 aapt2 dump badging 读取产物，包名不是 app.onethu.demo 即报错退出——把「打错工程」这类静默错配挡在安装之前。

Android 注意事项：apps/desktop/src-tauri/gen/android 为本地生成物（不入库）。若此前已按 正式版生成过 Android 工程，应用 id 仍为 app.onethu.desktop，需重新生成才能得到 app.onethu.demo（否则会覆盖正式版安装）：

rm -rf apps/desktop/src-tauri/gen/android
pnpm --filter @onethu/desktop exec tauri android init
pnpm --filter @onethu/desktop exec tauri android build --apk --target aarch64

签名（自用调试签名，与正式版一致）：

zipalign -p 4 app-universal-release-unsigned.apk app-demo.apk
apksigner sign --ks ~/.android/debug.keystore --ks-key-alias androiddebugkey \
  --ks-pass pass:android --key-pass pass:android app-demo.apk
adb install -r app-demo.apk

已知残留（演示前须知）

  1. 登录页输入框显示的是用户输入的真实学号与密码；登录必须使用真实凭据，无法脱敏。 演示前建议清除「记住密码」，并避免在输入过程中被拍摄。
  2. 未登记的第三方自由文本（例如某条通知正文里出现了某个姓名，但该姓名此前从未在任何 结构化字段里出现过）无法被替换：替换依赖该姓名此前已在结构化字段中出现。
  3. 讨论区 / 通知里由服务端渲染进 HTML 的姓名若与结构化 author 字段写法不同（如「王老师」 vs 「王某某」），以结构化字段为准替换，正文里的变体可能残留。
  4. 成绩被编造后，成绩单页的学分总数 / 平均绩点由界面按编造值重算，因此与真实数值无关。
  5. 宿舍卫生为服务端渲染的图片（曲线图 base64），文本层无法脱敏；该页不显示姓名， 若演示需绝对保守，可跳过该页。
  6. 体测只替换姓名、学号与总分，身高 / 体重 / 肺活量等原始测量值保留（不属于姓名 / 学号 / 成绩）。
  7. 服务端返回的图片型数据（宿舍卫生图、雨课堂题干里的加密字体、附件缩略图）一律按原样展示， 脱敏层只能处理文本与结构化字段。

验证

node --import ./tools/ts-resolve-register.mjs tools/desensitize-test.mjs   # 69 条断言
cd apps/desktop && npx tsc --noEmit

tools/desensitize-test.mjs 在两种配置下均成立：正式分支断言「零行为（原样返回同一引用）」， demo 分支断言「必须替换姓名 / 学号 / 嵌套教师名，且原对象不被就地修改」， 并覆盖「非敏感数据零改动」与「成绩等级与绩点同表」。