xyzAI Meter

项目定位与引用说明

本项目是一个面向 800×480 横屏设备的 Android WebView 项目，负责将指定的 Web 页面封装成可安装的 Android 应用。

如果需要监控 Codex 使用情况，可以先部署配套项目 codexMeter，再将部署后的 Web 地址填写到本项目的设置页面中。两个项目的职责如下：

• xyzAiMeter：Android WebView 壳应用，负责展示和操作监控页面。
• codexMeter：Codex 监控页面及相关服务项目。

也可以参考 codexMeter 的项目结构、页面和接口信息，结合自身设备、后端和业务需求，使用 AI 对本项目进行二次开发改造。

两个项目的关系

简单使用流程：先部署 codexMeter，获得可访问的监控页面地址；再安装 xyzAiMeter，在首次设置页面填写 URL 和认证信息，最后由 Android 设备通过 WebView 展示监控页面。

项目架构图

设备刷机教程

如果设备还没有合适的 Android 系统，可以参考以下 B 站博主提供的刷机教程：

推荐刷机教程：Bilibili BV1fu4y1U7xz

刷机前请先备份设备数据，并确认设备型号、系统版本和固件文件完全匹配。刷机存在数据丢失或设备无法启动的风险，请根据教程作者的说明操作。

主要功能

• 全屏横屏显示
• JavaScript、DOM Storage、网页缓存
• HTTPS 页面内导航
• 网络错误点击重试
• 防止设备自动休眠
• 右上角设置页，可修改并持久化 WebView URL
• Basic Auth 用户名和密码配置
• 没有配置文件时进入首次设置引导

使用说明

方式一：直接使用 GitHub Release

正式 APK 会由 GitHub Actions 构建并发布到 Releases，文件名为 xyzAIMeter.apk。

安装应用后：

1. 首次启动时，如果没有配置文件，会自动进入设置引导页。
2. 填写已经部署好的 codexMeter 页面 URL。
3. 如果页面启用了 Basic Auth，再填写用户名和密码；未启用时可以留空。
4. 保存配置后，应用会加载监控页面。
5. 后续可通过页面右上角的设置入口修改 URL 和认证信息。

方式二：本地构建安装

本地调试构建可以使用 ADB 安装：

gradlew.bat assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

配置字段模板见 config.example.json：

{
  "url": "https://your-codex-meter.example.com/",
  "username": "",
  "password": ""
}

真实配置保存在 Android 应用私有目录，不会写入仓库。没有配置文件时不会使用硬编码的默认 URL 或认证密码，而是进入首次设置引导。

当前 release 构建使用 debug signing，适合个人设备使用。若要公开发布，请在 GitHub Actions 中替换为自己的 release signing key。

构建

gradlew.bat assembleDebug
gradlew.bat assembleRelease

输出目录：app/build/outputs/apk/

二次开发建议

可以根据目标设备分辨率、横竖屏方向、Web 页面地址、认证方式和交互需求进行改造，例如：

• 替换或扩展 WebView 页面加载逻辑。
• 增加定时刷新、网络状态提示和离线重试。
• 按设备分辨率调整布局、字体和操作按钮。
• 对接自有监控后端或调整 Basic Auth、Token 等认证方式。
• 使用 AI 辅助分析 codexMeter 和本项目代码，再按实际业务进行定制。

GitHub Actions 自动发布

推送版本标签即可自动构建并创建 GitHub Release：

git tag v1.0.0
git push origin v1.0.0

工作流会上传 xyzAIMeter.apk，APK 不会提交到代码仓库。