Clean Your TV（cleanyourtv-app）是一款用手机清理 Android TV 广告和预装垃圾的社区应用。如果你的电视型号还没被收录，本文教你如何通过一份电视报告提交新电视列表（TV profile），让你的电视从"谨慎模式"升级为完整的干净首页。全程不需要电脑、不需要 ADB、不需要写代码。

电视没被收录时，应用是怎么处理的？

Clean Your TV 内置了 47 个品牌、173 份电视列表。如果你的型号不在其中，应用不会"盲操作"，而是进入谨慎模式：

• 只关闭该品牌所有已收录列表都同意的安全项，并明确告诉你"我很小心"
• 不切换首页，保留电视自带桌面
• 其余部分照常可以清理和还原

被收录之后，你的电视就会拥有专属的完整列表：该关什么、保留什么、哪些可选项由你决定，全部写清楚。

一条电视列表长什么样？

每个型号对应一份debloat.txt列表，按组列出要"关闭（不是卸载）"的应用包名。你可以在仓库里看到真实例子：

• 小米电视手工清单：debloat.txt
• 待测试的候选清单目录：core/spec/candidates/

列表头部是注释：型号、Android 版本、固件号、测试了多久、刻意保留了什么。正文按分组写包名，例如：

# 小米 + Google 遥测 com.miui.tv.analytics com.google.android.feedback # 预装应用 com.xiaomi.mimusic2 com.google.android.play.games

所有应用都用pm disable-user关闭，随时可以恢复；Wi-Fi、遥控器、HDMI 输入、系统更新等受保护组件永远不会出现在清单里。

新手路径：用应用的「Help add this TV」一键提交

这是最推荐的方式，规则详见 CONTRIBUTING.md。

第 1 步：在应用里生成隐私报告

在应用的"We found"界面或电视的 Manage 界面，点Help add this TV，再点Open GitHub。"Help add my TV"表单会自动填好型号、Android 版本和一份电视报告。

报告内容安全：应用会先完整展示给你，并自动移除 IP 地址、序列号、密钥和配对码；你自己安装的应用只报告数量。你可以直接粘贴发布，或复制后分享。

第 2 步：等待维护者起草列表

维护者会按 docs/TRIAGE.md 的流程处理：

1. 在已有列表中查找"同家族"清单（相同设备代号或相同机型平台）作为起点
2. 从报告里的系统应用挑出广告、追踪、商店演示和无用预装项，起草一份新的debloat.txt
3. 把清单发回 issue，邀请你实测

第 3 步：亲测几天

按维护者要求验证：Wi-Fi 重启后能否连上、遥控器每个按键（含语音键）、所有 HDMI 输入、Live TV、重启。一切正常后，清单就会发到上游 Clean Your TV 项目合并。

第 4 步：进入应用

上游合并后，本仓库会提一个 PR：把third_party/cleanyourtv子模块指到包含你清单的上游提交，并往 profile-meta.json 添加你电视的条目。下一次应用更新发布时，你的电视就被正式收录了，issue 会收到"已收录于 vX.Y.Z"的回复。

电视档案（profile）里记录了什么？

收录不只是加一份清单，还会登记一份结构化的"电视档案"，字段包括：

| 字段 | 含义 | | :- | :- | |match| 如何认出你的电视：型号、设备代号、品牌、SDK 范围 | |platform| 运行平台（ANDROID_TV / GOOGLE_TV / FIRE_OS） | |neverDisable| 必须保持开启的组件，如遥控器、输入源、Live TV | |stockLaunchers| 电视自带桌面，供首页切换时识别 | |groups| 清单里每一组的分类（ads、tracking、preloads 等） | |tested| 谁来测、哪个固件、是否测试过重启 |

想看看现成条目，profile-meta.json 里有 170 多个档案可以参照。还在实测阶段的清单则放在 candidate-meta.json，通过后会"转正"。

开发者进阶路径：自己写列表

如果你熟悉 adb，也可以跳过等待：

1. 按上游格式写好examples/<brand>-<model>/debloat.txt，只列出你真正关闭过、并正常生活了数天的应用
2. 先给上游 Clean Your TV 项目发 PR，合并后再回本仓库发 PR：更新third_party/cleanyourtv子模块 + 添加profile-meta.json条目
3. 构建时会自动转换清单，遇到无法理解的行会直接失败，保证清单格式正确

没有上游清单时，最简单的起步方式仍然是开一个 "Help add my TV" issue，说不定有同款电视的用户会接手。

被收录后的体验

• 完整清理计划：广告、追踪、预装、品牌附加项分组列出，每一项都能在 Customise 里逐条确认
• 干净的新首页：换成 Clean Your TV 启动器，无广告、无推荐行
• 先存还原点再动手：任何改动都能一键全部撤销；150 秒看门狗保证手机掉线时电视自动恢复原桌面

常见问题

提交后多久能收录？取决于同款电视的测试进度，通常从收到报告到进入上游需要数周；期间你的电视已有品牌级谨慎清理可用。

提交报告有隐私风险吗？没有。报告在应用本地生成并先给你过目，地址、序列号、密钥、配对码都会被移除，你自己安装的应用只统计数量。

我的电视很冷门怎么办？冷门不等于不能收录：只要报告里的包名和同平台、同芯片组的已收录电视对得上，维护者就能起草一份保守的短清单。清单越保守越安全，之后可以再慢慢补充。

想参与但不想提交？欢迎为同款电视的 issue 补充测试反馈，或在 docs/TRIAGE.md 提到的流程中帮忙验证清单——每一份真实反馈都在帮同型号的用户。