Millennium

在 Steam 商店里，多看一层游戏信息。

Android Steam 增强模块
在线人数 · 历史最低价 · SteamDB 评分 · 最近更新

下载 APK · 功能一览 · 安装使用 · 常见问题 · 问题反馈

Millennium 为 Android 版 Steam 提供一个应用内悬浮面板。浏览游戏商店页面时，点击悬浮球，即可查看这款游戏的玩家活跃情况、价格记录、评分与更新日期，关闭后继续浏览。

项目使用 现代 libxposed API 102，将 SteamDB 与 Steam 的数据整合到原生 Android 界面中。各项数据功能独立组织，共用请求与缓存逻辑，方便后续扩展。

把当前在线、近期峰值和历史峰值放在一起，了解游戏当前的活跃程度。实时在线人数优先使用 Steam 官方接口；该请求不可用时，使用 SteamDB 返回的记录。

历史最低价跟随当前商店页面识别到的币种和定价地区，同时展示折扣、出现次数和最近出现时间。已识别为免费的游戏会跳过史低查询；无法确定币种或地区时，面板会说明原因。

从当前 Steam 商店页面读取好评数和差评数，再按 SteamDB 的评分公式计算。这个分数会考虑评价样本量，因此可能与 Steam 直接展示的好评百分比不同。

更新日期与在线数据共用一次 SteamDB 游戏信息查询。这里显示的是 SteamDB 返回的游戏更新日期，不是发售日期或模块最近查询的时间。

1. 从 GitHub Releases 下载并安装模块 APK。若暂未提供发布包，可按源码构建自行生成。
2. 在 LSPosed 或兼容框架的管理器中启用 Millennium。
3. 在模块作用域中勾选 Steam，对应包名为 com.valvesoftware.android.steam.community。
4. 强制停止 Steam，再重新打开，让框架加载模块。
5. 在 Steam 内打开某款游戏的商店详情页。
6. 点击悬浮球，等待面板显示该游戏的数据。

• 查看信息：进入游戏商店详情页后，点击悬浮球打开面板。
• 调整位置：拖动悬浮球，将入口放到顺手的位置。
• 收起面板：点击“关闭”或面板外的遮罩区域。
• 切换游戏：进入另一款游戏的商店页后再查看面板，模块会按当前游戏查询，并忽略已失效页面的请求结果。

悬浮球附着在 Steam 的应用窗口中，当前实现不需要申请 Android 的“显示在其他应用上层”权限。

打开面板或已观察到的游戏页面发生变化时，模块会获取所需数据，并短期复用成功结果。当前进程内，Steam 实时人数缓存 30 秒、SteamDB 游戏信息缓存 60 秒、史低价格缓存 5 分钟。缓存有效期不是后台轮询周期，面板不会持续推送每秒变化的人数。

同一个查询正在进行时会合并等待，避免重复请求。不同数据请求分别处理结果，单项数据不可用时会显示提示；缺失字段用 — 表示。

商店数据面板是当前主要功能。源码中同时保留了 Steam Guard 本地导出实验逻辑和宿主运行诊断代码：

• 模块会挂钩 Steam 的部分安全存储读取路径；命中相关逻辑后，会尝试将读取到的数据写入系统剪贴板，并显示 SteamGuard data copied 提示。
• 这段逻辑位于 ModuleMain.kt，目前没有独立的面板开关，也不是由 SteamDB 查询按钮触发。
• 导出数据可能包含验证器密钥。请勿将这类剪贴板内容、二维码或完整导出数据提交到公开 Issue、截图或日志附件中。

SteamDB 面板的数据请求与上述导出逻辑分开。问题反馈优先截取下方列出的 steamdb 日志，避免附带无关账号信息。

git clone https://github.com/Good-Joe2049/Millennium.git
cd Millennium

在 Android Studio 中配置 Android SDK 与 Gradle JDK，完成依赖同步。具体版本以仓库里的 Gradle 配置为准。

# 生成可直接安装测试的 Debug APK
.\gradlew.bat :app:assembleDebug

# 运行单元测试和 Lint
.\gradlew.bat :app:testDebugUnitTest :app:lintDebug

# 生成开启 R8 与资源缩减的 Release APK
.\gradlew.bat :app:assembleRelease

chmod +x gradlew
./gradlew :app:assembleDebug
./gradlew :app:testDebugUnitTest :app:lintDebug
./gradlew :app:assembleRelease

Debug APK 输出到 app/build/outputs/apk/debug/，Release APK 输出到 app/build/outputs/apk/release/。未配置 release 签名时，生成的是未签名 APK，需要签名后才能安装；也可以使用 Android Studio 的 Generate Signed App Bundle or APK → APK。

Release 已开启 R8 和资源缩减，并通过 app/proguard-rules.pro 保留现代 Xposed 入口。当前只打包 arm64-v8a 原生库。后续更新应沿用同一份签名；签名密钥、密码、本机 SDK 路径和构建产物不应提交到仓库。

app/src/main/
├── java/com/millennium/app/
│   ├── ModuleMain.kt                  # 现代 Xposed 入口与宿主 Hook
│   ├── core/                         # 宿主运行诊断
│   └── features/
│       ├── ui/                       # 悬浮球、面板与界面观察
│       └── steamdb/
│           ├── SteamDbPanelController.kt
│           ├── SteamDbOnlineStatsFeature.kt
│           ├── network/              # Cronet、回退、请求头与错误日志
│           ├── data/                 # 接口解析、缓存、请求合并与页面取数
│           ├── ui/                   # 公共数据区块布局
│           ├── lowestprice/          # 历史最低价
│           ├── rating/               # SteamDB 评分
│           └── lastupdate/           # 最近更新日期
├── res/                              # 图标、字符串与界面资源
└── resources/META-INF/xposed/
    ├── java_init.list                # Java 入口类声明
    ├── module.prop                   # API 要求与模块配置
    └── scope.list                    # 推荐作用域

欢迎通过 Issues 报告问题、提出功能建议，或通过 Pull Requests 贡献改进。

提交问题时，请提供：

• 环境：设备型号、Android 版本、框架名称与核心版本。
• 版本：Millennium 版本、Steam 版本号／版本代码及安装来源。
• 页面：出现问题的游戏商店链接或 AppID。
• 现象：复现步骤、预期表现、实际表现，以及必要的截图或录屏。
• 日志：同一次操作中的相关日志，上传前去除账号信息与验证器数据。

message:steamdb

修改数据逻辑时，请验证缺失字段、接口失败和切换游戏的情况；修改悬浮界面时，请附上展开、收起与拖动的实机验证结果。涉及入口或反射调用的改动，也应验证开启 R8 的 release 构建。

本项目采用 MIT License，版权信息与完整授权条款见许可证文件。第三方代码、依赖和资源仍分别遵循其原始许可证。

Millennium 是独立开发的社区项目，与 Valve、Steam 或 SteamDB 无官方隶属或合作关系。相关名称与商标归各自权利人所有。