Han1meViewer
本软件不接受任何形式的公开宣传。若出现公开宣传、搬运或引流,仓库维护者可能随时归档或隐藏仓库,并删除已编译的发行版。
🌸 Han1meViewer
🔞 R18 警告:未满 18 岁禁止下载和使用。
使用 Kotlin 开发的 Android 客户端,用于浏览、搜索、播放和管理 hanime 相关公开视频页面内容。
Jetpack Compose · Navigation Compose · ViewModel + StateFlow · Retrofit · Jsoup · Room · WorkManager · Media3 / MPV
⚠️ 本应用没有任何官方网站。GitHub Release 与 CI 构建产物是唯一下载及更新渠道。
📜 项目来源与许可
此项目最初 Fork 自 YenalyLiew/Han1meViewer,感谢原作者的贡献。
根据 Apache License 2.0 许可证要求:
- 保留原版权声明;
- 包含许可证文件副本(见 LICENSE);
- 说明修改内容。
⚠️ 免责声明
本应用程序与 https://hanime1.me/ 及其关联方无任何隶属、合作或授权关系。
🔍 数据来源
- 本应用仅通过常规网络请求和 HTML DOM 解析获取目标网站公开显示的信息;
- 不访问网站后端数据库;
- 不进行注入攻击、绕过授权或获取非公开用户隐私数据。
⚖️ 使用限制
- 本应用仅用于技术研究、学习交流和移动端体验优化;
- 不提供商业化服务;
- 使用者应自行遵守所在地区法律法规和目标网站规则。
©️ 版权归属
- 原始视频、图文和相关内容版权归
https://hanime1.me/或原始制作、发行方所有; - 本应用不存储版权内容,不修改原始内容,不声称拥有内容所有权。
🛡️ 责任豁免
- 本应用不保证数据完整性、准确性和实时性;
- 使用本应用产生的一切后果由用户自行承担;
- 不得将本应用用于任何非法用途。
若 https://hanime1.me/ 认为本应用行为不当,可通过 GitHub 仓库内置功能联系维护者。
ℹ️ 建议通过官方渠道支持原站内容,并点击广告以支持网站运营者。
🔄 最后更新日期:
2026-11-17
✨ 功能概览
| 模块 | 功能 |
|---|---|
| 🏠 首页浏览 | 首页推荐、最新上传、分类入口、预览页和搜索入口 |
| 🎬 视频详情 | 简介、作者、标签、系列视频、相关推荐、评论和子评论 |
| ▶️ 视频播放 | 在线播放、本地下载文件播放、画中画、播放内核切换、倍速和画质选择 |
| 🔍 搜索系统 | 关键词搜索、高级搜索、历史记录、筛选条件展示和分页加载 |
| 👤 用户内容 | 收藏、稍后观看、播放列表、在线历史、订阅作者和创作中心 |
| 💬 评论系统 | 评论排序、回复查看、举报和复制分享文本 |
| 📥 下载管理 | 后台下载、下载分组(下载时可按系列名自动创建分组)、导入本地文件、自定义下载目录和下载后播放 |
| 🔐 账号能力 | 登录、手动录入 cookies、账号资料、头像裁剪、登录状态检测和退出登录 |
| 🎨 主题与设置 | Material 3 主题、动态颜色、首页布局、播放设置、MPV 设置、下载设置和网络设置 |
| 🕵️ 隐私保护 | 应用锁、启动器图标伪装和手动 Cookie 管理 |
| 🌐 网络辅助 | Cloudflare 处理、备用域名、代理相关设置、CDN / 网络检测和更新检查 |
| 📅 健康打卡 | 内置冲了么打卡页面和桌面小组件 |
| 🎯 共享关键 H 帧 | 内置关键帧数据读取、设置和共享数据展示 |
| 🗞️ 公告系统 | 首页公告展示、公告详情弹窗,配套 HanimeAnnouncementManagerWebUI 维护 Firebase Realtime Database 中的 announcements 节点 |
📷 截图预览
🧱 当前架构
📦 项目采用单应用模块 + buildSrc 的 Gradle 结构:
| 模块 | 职责 |
|---|---|
:app |
主应用模块,包含界面、导航、业务 ViewModel、网络解析、数据库、下载 Worker、播放器和资源文件 |
buildSrc |
构建配置辅助代码,用于版本号、构建类型和提交信息等 Gradle 逻辑 |
🗂️ 主应用采用分层组织:
| 分层 | 职责 |
|---|---|
ui.activity |
入口 Activity、登录、Cloudflare 处理和手动 Cookie 输入页面 |
ui.navigation |
Navigation Compose 路由定义、主导航、设置导航和安全跳转封装 |
ui.screen |
Compose 页面实现,按首页、搜索、视频、设置、账号、下载等业务域划分 |
ui.component |
可复用 Compose 组件,如视频卡片、弹窗、空 / 错 / 加载状态、AppBar、评论卡片等 |
ui.viewmodel |
页面状态和业务动作入口,主要通过 StateFlow / SharedFlow 对 UI 暴露状态 |
logic.network |
Retrofit Service、OkHttp 拦截器、DNS、CookieJar、更新服务和网络入口 |
logic.model |
页面和网络解析后的领域模型,如 HanimeVideo、HanimeInfo、HomePage、Playlists 等 |
logic.dao / logic.entity |
Room 数据库、DAO 和实体,用于历史、下载、搜索历史、关键帧、打卡等本地数据 |
announcement 链路 |
公告数据从 Firebase Realtime Database 的 announcements 节点读取,首页通过 MainViewModel.loadAnnouncements() 拉取并展示,管理端使用 HanimeAnnouncementManagerWebUI 维护公告内容 |
worker |
WorkManager 下载任务和更新任务 |
util |
主题、网络、文件、权限、Cookie、Toast、视频和通用工具方法 |
🔁 整体数据流:
Compose Screen -> ViewModel -> NetworkRepo / DatabaseRepo -> Retrofit + Jsoup / Room -> StateFlow -> Compose Screen
🎞️ 视频页数据流:
VideoRoute -> VideoViewModel -> NetworkRepo.getHanimeVideo -> Parser -> HanimeVideo -> VideoScreen / Player / CommentScreen
📥 下载数据流:
DownloadScreen -> DownloadViewModel -> HanimeDownloadManagerV2 -> WorkManager Worker -> Room -> Flow -> UI
🛠️ 技术栈
| 类别 | 技术 |
|---|---|
| 语言与工具链 | Kotlin 2.3.x · Java 21 toolchain · Android Gradle Plugin 9.2.x |
| UI | Jetpack Compose · Material 3 · Navigation Compose + Kotlin Serialization typed routes |
| 架构 | ViewModel · StateFlow · SharedFlow |
| 网络 | Retrofit 3 + kotlinx.serialization converter · Jsoup HTML 解析 |
| 数据 | Room + KSP |
| 图片 | Coil 3 Compose |
| 播放 | Media3 ExoPlayer · MPV Android(Compose 播放器) |
| 后台任务 | WorkManager |
| 平台服务 | Firebase Analytics · Crashlytics · Performance · Remote Config · Realtime Database |
| AndroidX | Window · Biometric · SplashScreen · Preference |
| 其他 | AboutLibraries 开源许可展示 |
🧰 构建环境
✅ 推荐环境:
- Android Studio Panda 或更新版本;
- JDK 21;
- Gradle Wrapper 使用仓库内置版本。
| 配置项 | 值 |
|---|---|
| 编译 SDK | 37 |
| 最低支持 | Android 8.1(API 27) |
| 目标 SDK | 37 |
📌 关键版本以仓库文件为准:gradle.properties、gradle/libs.versions.toml、app/build.gradle.kts、buildSrc/src/main/java/Config.kt。
🚀 本地运行
克隆项目:
git clone https://github.com/misaka10032w/Han1meViewer.git使用 Android Studio 打开项目根目录;
等待 Gradle Sync 完成;
选择
debug变体运行到设备或模拟器。
💻 常用命令
# Linux / macOS
./gradlew :app:compileDebugKotlin
./gradlew :app:assembleDebug
# Windows PowerShell
.\gradlew.bat :app:compileDebugKotlin
.\gradlew.bat :app:assembleDebug
🔏 Release 构建
Release 构建需要本地或 CI 提供签名相关环境变量:
KEYSTORE_PASSWORDKEY_ALIAS
🔑 GitHub API Token
GitHub API Token 可通过环境变量或本地文件提供:
- 环境变量:
HA_GITHUB_TOKEN - 本地文件:
app/ha1_github_token.txt
✅ 代码约定
- UI 优先使用 Jetpack Compose,少量历史页面和组件仍保留 XML / ViewBinding / DataBinding;
- 页面状态通过
StateFlow暴露,事件通过SharedFlow或回调传递; - 网络页面列表追加时应按稳定业务键去重,避免 Compose
Lazy*列表 key 冲突; LazyColumn、LazyVerticalGrid、LazyRow使用稳定 key 时应确保数据源唯一。
🗺️ 目录速查
Han1meViewer/
├── app/ 主 Android 应用
│ ├── src/main/java/.../logic 网络、解析、模型、数据库、状态
│ ├── src/main/java/.../ui Activity、Compose 页面、导航、组件、ViewModel
│ ├── src/main/java/.../util 通用工具
│ ├── src/main/java/.../worker WorkManager 任务
│ └── src/main/res 资源文件、主题、布局、图标、小组件
├── buildSrc/ Gradle 构建辅助代码
├── docs/ 文档、README 截图与工具(images/、mpv-trim/、HanimeAnnouncementManagerWebUI/)
├── gradle/libs.versions.toml 依赖版本目录
├── README.md 项目说明
└── README_TECH.md 历史技术说明与部分实现笔记
🤝 贡献说明
- 提交代码前请先确认可以通过
:app:compileDebugKotlin; - 修改网络列表、分页或 Compose
Lazy*列表时,请检查重复 key 风险; - 修改播放、下载、账号、Cookie、Cloudflare、更新逻辑时,请尽量说明验证方式;
- 提交共享关键 H 帧可参考
.github/PULL_REQUEST_TEMPLATE/submit_h_keyframe.md。
🧩 TODO
- 随时有想法随时写。
💬 参与讨论
Telegram 群组:https://t.me/Han1meViewer
📄 许可证
本项目继承原始项目的 Apache License 2.0,主要条款包括:
- ✅ 允许商用、修改和分发;
- 📋 要求保留版权声明和许可证文件;
- ✏️ 要求提供修改说明;
- ❌ 不提供质量担保,不承担用户使用风险。
完整条款请参阅项目根目录下的 LICENSE 文件。
🗞️ 公告系统使用须知(维护者向)
公告系统分为两部分:
- 用户侧:应用启动后由
MainViewModel.loadAnnouncements()从 Firebase Realtime Database 读取announcements节点,首页会展示有效公告,并可点开公告详情弹窗。 - 维护侧:
HanimeAnnouncementManagerWebUI用于维护公告数据,负责向同一个announcements节点写入、更新或下线公告。
HanimeAnnouncementManagerWebUI 目录包含两个文件:
HanimeAnnouncementManager.html:公告管理网页,用于增删改查公告、切换启用状态;PermitAdmin.py:给 Firebase Auth 用户写入isAdmin自定义声明,用于控制谁能访问管理端。
前置条件
- 应用必须能够正常访问网络;
- 项目中配置的 Firebase Realtime Database 地址必须可用;
announcements节点下的公告数据结构需要和Announcement模型一致,至少包含title、content、isActive等字段;- 公告内容会按
priority排序,只有isActive = true的公告才会显示; - 管理端需要启用 Firebase Authentication 和 Realtime Database;
- 管理端需要准备 Firebase Web 配置参数和可登录的管理员邮箱、密码;
- 若使用
PermitAdmin.py,还需要 Firebase Admin SDK 的serviceAccountKey.json。
使用规则
- 首页公告默认会展示为有效公告列表;
- 用户关闭公告后,会记录
last_dismiss_time,24 小时内不会再次自动弹出; - 公告详情支持标题、内容、发布时间、图片和按钮文案;
- 若公告配置了链接,内容中可直接展示可点击的 URL。
管理端使用步骤
- 在
HanimeAnnouncementManager.html中填写firebaseConfig; - 在
ADMIN_EMAIL和ADMIN_PASSWORD中填入可登录 Firebase Auth 的管理员账号; - 确保 Realtime Database 规则允许该管理员账号读写
announcements节点; - 如需批量授权管理员,先安装
firebase-admin,准备serviceAccountKey.json,再运行PermitAdmin.py并填写目标用户 UID; - 打开管理页后即可新增、编辑、启用、停用或删除公告。
公告字段说明
| 字段 | 说明 |
|---|---|
title |
公告标题 |
content |
公告正文 |
imageUrl |
公告图片地址(可选) |
positiveText |
确认按钮文案(可选) |
negativeText |
取消按钮文案(可选) |
priority |
排序优先级 |
timestamp |
公告时间戳(秒) |
isActive |
是否启用 |
维护建议
- 新公告建议先在 WebUI 中预览,再切换为
isActive = true; - 过期或不再需要显示的公告应直接下线,而不是删除,以便回溯;
- 重要公告优先级数值应更高或更低需与 WebUI 约定保持一致,避免排序混乱。
