归藏电视 · GuiZang TV

main 分支提供默认关闭的 Codex 对话实验：在「设置 → 实验性功能 → Codex 对话 → 开启」后显示入口，通过同一局域网电脑连接 Codex。以首页底部输入浮层呈现，带渐变模糊、彩色光效和胶囊消息；支持文字与系统输入法语音（需设备支持），尚未接入米家或个人日程。正式 v0.3.0 APK 不含此功能。

一个给国内小米电视做的简洁桌面：大字、壁纸、常用应用，以及直接进入游戏机和 Apple TV 的入口。

下载 v0.3.0 APK · 兼容性与验证 · 代码 MIT 许可

v0.3.0：统一设置与全新 Dock。 壁纸、布局、字体、焦点和首页编辑都在「设置」中；操作见 设置指南。横向 Dock 使用宽幅圆角毛玻璃底板和大图标，入口较多时随遥控器焦点平滑滚动。

项目背景见 v0.2.0 项目介绍与使用指南：与 cleanYourTV、CleanFrame 的区别，实际改造与优势，安装、遥控器操作、壁纸设置和源码定制。

这是从个人电视上的定制版本整理出的公开版。目前重点适配小米电视 MiTV-MTSU0，不是面向所有 Android TV 的通用桌面替换工具。上图为布局示意；实际内置照片见 壁纸预览与署名。

main 天气试用功能（尚未发布 APK）： 时间右侧可显示天气，支持自动城市与手动选城。默认关闭，开启后联网；试用说明与数据来源。正式下载仍为 v0.3.0。

• 左侧大字列表：PlayStation 5、Apple TV、哔哩哔哩、小米投屏、相册、小米原桌面。
• 在已适配机型上，PlayStation 5 直达 HDMI 2，Apple TV 直达 HDMI 1。
• 操作区保留全部应用、其他信号源、设置（列表右下角，Dock 右上角）；壁纸统一进入「设置 → 背景」。
• 设置使用圆角选项与嵌入式首页预览；浏览壁纸时，预览和整页高斯模糊背景同步变化。
• 首页支持列表 / Dock、统一单色 SVG 图标 / 文字、字体风格与字号；毛玻璃焦点按内容宽度包裹，无长条描边。
• 首页 1–9 项，可添加、隐藏、排序和撤销编辑；默认六项不变。
• 壁纸支持固定选择、自动轮播，默认每 5 分钟切换；可选 1 / 5 / 15 / 30 分钟。
• 淡入淡出切换壁纸，离开桌面后暂停计时，返回后重新计时。
• 遥控器方向键操作，记住上次选中的入口和壁纸偏好。
• 基础桌面不需要账号或无障碍服务，不下载或预装视频 App。main 的可选天气和 Codex 实验默认关闭；后者需要电脑上的 Codex 登录及相应额度。v0.3.0 正式版仍不联网。
• 支持实验性开机自动进入：默认关闭，适配机型需先完成一次 ADB 配置，详见 启用与恢复说明。

公开版自带五张经过来源核对的 Unsplash 照片：雾中雪岭、雨林山路、热带绿叶、山间彩虹、流光花影。图片适用 Unsplash License，代码适用 MIT；完整来源与署名随源码和 APK 保存。其余版权未确认的照片未纳入。也可以用自己的图片构建。

从 Releases 下载 APK，通过电视支持的本地安装方式安装。也可以在开启电视 ADB 调试、电脑连接同一网络后执行：

adb connect <电视IP>:5555
adb install -r guizang-tv-v0.3.0.apk

端口和调试方式取决于电视固件。首次连接请在电视上确认调试授权；使用结束后可以关闭调试。

安装后，在小米原桌面的应用列表中打开 归藏电视。

建议先作为普通应用试用。 已测试的 HyperOS 固件会忽略第三方默认桌面选择，因此本项目不接管 Home 键。可在已适配机型上配置开机自动进入，需开启应用内开关并设置系统目标；这与默认桌面选择是两回事。无需禁用原桌面，小爱同学、手机投屏、直播及 HDMI 系统组件均保留。真实语音、投屏、直播播放仍需自行验证。

未配置开机自动进入时，卸载「归藏电视」即可结束试用。已经配置的用户先按 关闭与恢复步骤 停用并核对系统目标，避免缓存调用或降级旧版后行为变化。公开版包名为 io.github.op7418.guizangtv，不会覆盖上游 cleanYourTV，也不会覆盖原有私人试用版，设置不会自动迁移。

可将本仓库交给 Codex、Claude Code 或其他 AI 编程助手。AI 入口是 AGENTS.md / CLAUDE.md，完整流程见 AI 适配与引导指南，涵盖其他安卓设备、Mac、Windows、Linux 电脑、配对、语音测试和故障定位。

可以直接说：

请阅读 AGENTS.md 和 docs/AI-SETUP.md，检查我的安卓设备与电脑环境，保留已有设置，指导我手动开启 Codex 实验并完成配对。先验证文字和重复进入，再测试语音；说明已通过和未验证的能力，不公开凭证。

目前完整实测组合是指定小米电视与 Mac。Windows/Linux 和其他安卓设备提供适配路径，尚不代表全面兼容；电脑运行连接服务，Android APK 不会因此变成电脑原生桌面。

要求：JDK 17、Gradle 8.9、Android SDK Platform 34、Build Tools 34.0.0。

仓库只包含源码；Gradle 请通过 官方发行版 安装。也可以用 Android Studio 打开项目，并选择本地 Gradle 8.9。

git clone https://github.com/op7418/guizang-tv.git
cd guizang-tv
export ANDROID_HOME=/path/to/Android/sdk
export JAVA_HOME=/path/to/jdk-17
gradle :app:assembleDebug :app:testDebugUnitTest :app:lintDebug

生成文件：app/build/outputs/apk/debug/app-debug.apk。首次构建需要联网下载 Android Gradle Plugin 和测试依赖，基础桌面离线可用；开启天气或 Codex 实验后，相应功能需要网络。

CI 会构建 Debug APK 并执行测试、lint；下载 Actions 产物需要登录 GitHub。Debug 包用于自行测试，不保证与 Releases 的正式签名兼容。

Release 构建：

gradle :app:assembleRelease :app:testReleaseUnitTest :app:lintRelease

未设置签名时输出未签名 APK。维护者可在本地配置 GUIZANG_KEYSTORE、GUIZANG_STORE_PASSWORD、GUIZANG_KEY_ALIAS（默认 guizang-tv）和 GUIZANG_KEY_PASSWORD（默认同 store password），再构建签名版本。密钥和密码不应提交到 Git。

目前支持构建时打包，电视端可以从已打包的图片中选择；尚未提供电视端文件导入功能。

准备 1–15 张 JPEG / PNG / WebP 图片，然后：

python3 -m venv .venv
.venv/bin/pip install Pillow
.venv/bin/python scripts/prepare_wallpapers.py /path/to/your/wallpapers
gradle :app:assembleDebug

脚本保留原图，为电视生成最长边 1920 像素的副本与缩略图，并去除 EXIF。生成内容放在 Git 忽略的 app/src/main/assets/wallpapers/local/ 中。重新构建后，桌面会优先使用这组图片，内置照片仍随 APK 保留；文件名作为壁纸名称。请只分发有权公开使用的图片。

重复运行时，上一份生成结果会移到本地 .wallpaper-backups/ 保留，避免旧照片混进新的安装包；备份目录也不进入 Git。

如需恢复默认的五张照片，将 local/ 移到项目目录外备份，再重新构建。没有照片目录时会回退到五种渐变背景。

• 首页可在「设置 → 首页内容」编辑。默认名称、包名和顺序位于 HomeItems.java，应用启动由 FrameHomeActivity 处理。
• 小米接口集中在 XiaomiControls.java。HDMI 参数只在已验证机型上启用，不能仅添加机型名就视为完成适配。
• 分组设置位于 HomeSettings，首页及预览共用 HomeSurface；壁纸加载与轮播逻辑在 FrameWallpapers.java。
• 当前 PS5 / Apple TV 是入口名称，不代表自动识别到设备。请按实际接线修改端口。
• 应用未安装时会显示提示；项目没有代装应用、账号登录或内容破解功能。

欢迎通过 Issue 提交电视型号、Android / 固件版本和复现步骤。请隐去局域网地址、序列号、账号及调试密钥。

本项目起步于 Gathin23/cleanyourtv 的本地定制，整理时提取了本次实现的原生列表桌面及小米适配。公开版不包含上游的一键清理脚本、旧 Dock 桌面、无障碍按键服务或系统应用禁用流程。

界面方向参考 nthnclrk/CleanFrame：照片背景、大字纵向列表、克制的焦点高亮，以及分组设置、预览和确认应用的交互。Android 界面使用原生 Java 实现，没有移植 Tizen 运行代码或附带其照片。

代码采用 MIT 许可，保留上游署名。详细来源见 NOTICE.md。