WYU-Monet

「数智邑大」增强模块 —— 数智邑大（五邑大学套壳 WPS 协同版，com.wps.koa）的 LSPosed / Xposed 增强模块，基于 Miuix (HyperOS) Compose 构建原生质感界面。

✨ 功能

功能	说明
🎨 莫奈取色	Hook `Resources.getColor` / `TypedArray.getColor`，让 WPS 全局跟随系统动态取色（Material You / Monet）
🌈 莫奈染色底栏	WPS 底部导航栏图标、文字、背景跟随系统 accent 色动态染色
🛡️ 去除 Root 检测	屏蔽 WPS 对 Root 环境的检测提示
🧹 去除水印	移除文档上的牛皮癣水印
⏰ 自动打卡	Root 常驻轮询定时器 + 独立 CheckinWorker，定时自动提交 WPS 表单，无需打开任何 App
🤖 Claude Code 集成	WebSocket 连接远程 AI 助手，宠物气泡 UI

效果预览

---

⏰ 自动打卡架构

模块采用 "零后台依赖" 设计：打卡进程独立于 WPS 与模块 App，即使两者都被杀掉，root 定时器仍能到点执行。

┌─────────────┐  开关   ┌──────────────────┐
│  模块 App    │───────▶│ /data/local/tmp/ │  wyu-checkin-enabled
└─────────────┘         │   wyu-*.txt      │  wps-miuix-checkin.txt
                        └──────────────────┘
                                │ 读取
┌────────────────────────────────▼─────────────────────┐
│  root 常驻轮询循环（sh 脚本 + PID 自锁）                 │
│  每 30s 读配置 → 到点调 CheckinWorker.dex              │
└────────────────────────────────┬─────────────────────┘
                                 │ app_process 独立进程
                        ┌────────▼─────────┐
                        │  CheckinWorker   │──▶ kdocs API 静默提交
                        └──────────────────┘

关键机制

配置轮询：定时器脚本每轮重新读取配置文件，改配置后下一轮即生效，无需重启定时器
PID 自锁：脚本写 PID 文件 + kill -0 探测，防止重复派发
开机自启：BootReceiver 等待 Magisk su 就绪（最多 5 分钟重试）后重新派发
凭证运行时捕获：Cookie / CSRF / 学号 / 姓名 / 院系均为运行时从 WPS 会话与表单历史自动解析，不写死

🚀 使用

1. 安装激活

在 LSPosed 中激活模块，勾选作用域 com.wps.koa
Force-stop 后重启 WPS Office（Xposed 模块必须重启目标进程才生效）

2. 开启功能

打开模块 App，通过开关启用所需功能（自动打卡、莫奈取色、去 Root 检测、去水印等）。

3. 配置自动打卡

⚠️ 打卡配置入口在 WPS 的 KIM 机器人菜单里，不在模块 App 中。

🔋 重要：使用自动打卡必须打开模块 App 的开机自启动。模块靠 BootReceiver 在开机后自动派发 root 定时器（重启后无需打开任何 App 也能到点打卡）。国产 ROM（MIUI/HyperOS/EMUI 等）默认禁止第三方应用自启动，需在系统设置中手动允许：

小米/红米（HyperOS）：设置 → 应用设置 → 应用管理 → WYU-Monet → 自启动 → 允许

其他机型：设置 → 应用 → 自启动管理，找到 WYU-Monet 打开开关未开启自启动时，手机重启后自动打卡会失效，需手动打开一次模块 App 恢复。

① 模块 App 打开「自动打卡」开关
   → 使 KIM 机器人菜单出现「打卡设置」按钮

② 打开 WPS 里的「学生打卡入口」机器人会话
   → 菜单末尾出现「打卡设置」

③ 点「打卡设置」→ 配置打卡时间 / 地点 / 表单 URL

④ 打开一次打卡表单完成 Cookie 捕获
   → WebView 自动抓取表单 URL、Cookie、CSRF

🛠️ 构建

需要 Android SDK（compileSdk 37）、JDK 17+。

# debug 包（调试用）
./gradlew :app:assembleDebug

# release 包（正式发布，v2+v3 签名）
./gradlew :app:assembleRelease

release 签名使用本地 wyu-monet-release.jks（配置见 key.properties），两者均已 git 忽略，不会随仓库分发。构建环境若没有该 keystore，release 产出未签名包。

重新编译 CheckinWorker.dex

自动打卡依赖 app/src/main/assets/CheckinWorker.dex。修改 checkin/CheckinWorker.java 后需重新编译：

# 编译（需 classpath 含 android.jar 或 org.json 依赖）
javac -encoding UTF-8 -cp <android.jar> checkin/CheckinWorker.java

# 转 dex（d8 位于 Android SDK build-tools）
d8 checkin/CheckinWorker.class --lib <android.jar> --output app/src/main/assets/

⚠️ 免责声明

本模块仅供学习 Android Hook 技术与 Compose UI 开发研究使用。请勿用于违反任何平台服务条款、校规或法律法规的场景。使用本模块产生的一切后果由使用者自行承担。

📄 License

MIT

模块内置的 Miuix 组件库版权归其原作者所有，遵循其开源许可。