什么是 PROMPT.md
打开 CleanYourTV 的源码压缩包并解压,你会看到一堆目录与脚本:tools/ 里躺着工具链,themes/ 里收着二十一套主题,addons/ 放着附加模块,此外还有几份说明文件。其中最值得你停下来细读十分钟的,是根目录下的 PROMPT.md。
它不长,却可能是整个项目里"含金量"最高的一个文件。原因很简单:CleanYourTV 的完整流程——查兼容性、备工具、改前备份、连接电视、选择保留、执行修改、收尾验证——被原原本本写成了一份递给 AI 编程助手的任务书。你不需要背命令,不需要懂 ADB 协议,也不需要知道 pm disable-user 究竟是什么。你要做的,是把这份任务书连同三项目信息交给助手,然后在几个关键节点上到电视旁边点几下"确认"。
打个比方:PROMPT.md 就像一张写给智能管家的施工单。管家(AI 助手)识字、会看仓库、能执行命令,但它不知道你家电视是什么型号、IP 是多少、你的电脑是什么系统。施工单负责告诉它"活儿怎么干",你负责告诉它"活儿在哪儿干、给谁干"。两者一拼,才是一次完整的精简。
为什么要把流程写成一份任务书
精简一台电视,步骤其实并不短。从下载源码到最终重启,中间隔着十多个环节,任何一环出错——连错了设备、禁错了应用、忘了备份——都可能让你在沙发前陷入尴尬。把流程固化成一份提示词文件,至少带来四个好处:
- 不遗漏。任务书按顺序列清了每一步,助手照着走,比人凭记忆操作更稳。
- 可复用。提示词写在文件里,下次换一台电视,改三项信息就能再来一遍。
- 边界清。哪些事能做、哪些事不能碰(不 Root、不刷机、不绕 DRM),白纸黑字写在任务书里,助手不容易"自由发挥"。
- 可审查。你是这份任务书的主人,助手执行的每一步你都看得见;改什么、禁什么,最终由你把关。
项目方宣称,在助手主导下全程约 15 分钟即可完成。这个数字能成立,前提正是流程被压缩成了一份高质量的任务书:助手通读一遍仓库就能上手,而不必每次从零讨论"咱们下一步干嘛"。你的角色也从"操作工"变成了"监工"——盯住几个确认点,其余交给它。
任务书里的六个阶段
PROMPT.md 的核心,是把一次完整的精简拆成六个阶段。理解这六个阶段,你手里就握住了本章的骨架。
| 阶段 | 助手做什么 | 你需要做什么 | 本书对应 |
|---|---|---|---|
| 1. 兼容性检查 | 根据电视型号核对验证列表 | 提供准确型号 | 第 1 章 ct-0104 |
| 2. 工具准备 | 确认电脑侧环境,必要时准备工具链 | 允许助手安装或使用工具 | 第 2 章、本章 ct-0302 |
| 3. 改前备份 | 记录当前应用包状态,生成恢复记录 | 确认备份完成再放行 | 第 4 章 ct-0403 |
| 4. 建立连接 | 通过无线调试连接电视 | 在电视上确认配对与授权 | 本章 ct-0303 |
| 5. 选择与修改 | 生成禁用清单并执行禁用 | 逐项把关保留内容 | 本章 ct-0304 |
| 6. 测试收尾 | 引导你完成测试,关闭调试 | 测试首页、应用、遥控、HDMI | 本章 ct-0305 |
用一张流程图看更直观:
flowchart TD
A[打开项目文件夹] --> B[助手读取 PROMPT.md]
B --> C[补充型号 IP 系统三项信息]
C --> D[阶段1 兼容性检查]
D --> E[阶段2 工具准备]
E --> F[阶段3 改前备份]
F --> G[阶段4 建立连接]
G --> H[电视上确认授权]
H --> I[阶段5 生成禁用清单]
I --> J[人工把关]
J --> K[执行禁用]
K --> L[阶段6 测试与收尾]
请注意图中两个特殊节点:"补充三项信息"和"人工把关"。它们提醒你:任务书再完善,也有两件事必须由人完成——一是把现实世界的信息喂给助手,二是在动手改电视之前逐项确认。前者是本章 ct-0302 的主题,后者是 ct-0304 的主题。
15 分钟是怎么分配的
项目宣称助手全程约 15 分钟。这个时间不是玄学,拆开大致是这样(仅供参考,实际时长取决于你的电视型号、网络状况和你的确认速度):
| 时段 | 发生什么 |
|---|---|
| 第 0~2 分钟 | 你在助手里打开项目,填写型号、IP、系统信息 |
| 第 2~5 分钟 | 助手读仓库、查兼容性、准备工具 |
| 第 5~8 分钟 | 改前备份,发起无线调试连接 |
| 第 8~10 分钟 | 你在电视上确认配对与授权 |
| 第 10~13 分钟 | 生成禁用清单,你人工把关 |
| 第 13~15 分钟 | 执行禁用,进入测试收尾 |
你会发现,真正"耗时"的往往不是命令执行,而是你在沙发与电脑之间的往返、在电视上点确认的那几下。这也解释了一个常见现象:助手这边秒回,你那边却"卡住"——卡住的原因通常是对话框正在电视上等着你点。所以开工前,请把遥控器放在手边。
在助手里打开项目
使用 PROMPT.md 的第一步,是让助手"看得见"这个项目文件夹。常见做法如下:
- 下载源码 ZIP 并解压,记住解压后文件夹的位置。
- 打开你常用的 AI 编程助手,选择"打开文件夹"或"打开项目"之类的入口(不同助手叫法不同,以你使用的助手为准)。
- 选中 CleanYourTV 的项目根目录,确认助手能看到 PROMPT.md、tools/、themes/ 等文件。
- 如果助手不支持打开文件夹,也可以把 PROMPT.md 的全文直接粘贴到对话框,再补充三项目信息。
确认点:随便问一句"这个项目是做什么的"。助手如果能答出"通过 Wi-Fi 精简 Android TV / Google TV 预装软件、更换 Apple TV 风格首页、无需 Root、可恢复",说明它确实读到了项目文件,任务书生效了。
读懂任务书,再签字
任务书交给助手之后,建议你做一件事:让助手把"接下来打算执行的每一步"复述一遍,尤其是涉及修改电视的部分。这不是不信任助手,而是本书反复强调的原则——每一次对电视的修改,都要先有记录、再有人点头。
一次合格的复述应该包含四要素:连哪台设备(IP 是多少)、改哪些应用(清单是什么)、用什么方式改(pm disable-user,即设置里的"停用")、搞砸了怎么退(恢复记录在哪里)。如果助手对其中任何一项含混其辞,请让它回到 PROMPT.md 重读,或等你补充信息后再来。宁可慢两分钟,不要错一步。
安全边界写在任务书里
PROMPT.md 之所以敢让 AI 主导操作,是因为整个项目站在一条清晰的安全线上,这条线也写进了任务书:
- 只使用电视提供给机主的开关(pm disable-user,等同于设置→应用→停用),不卸载、不 Root、不刷机。
- 不绕过任何 DRM 或版权保护机制。
- 仓库里不含任何厂商软件、固件或 APK,所有改动都基于你电视上已有的东西。
- 一切操作可恢复——前提是备份与恢复文件被妥善保留。
- 风险自担:这是项目明文写下的态度,也应该是你的预期。
只要你守住这条线,"15 分钟精简"就是一次客厅里的普通折腾,而不是一场冒险。
常见问题
问:助手说找不到 PROMPT.md,怎么办?
答:多半是打开的不是项目根目录。确认文件夹里能直接看到 PROMPT.md、tools/、themes/,再让助手重新扫描;或者干脆把文件内容粘贴给它。
问:助手跳过兼容性检查直接要连接,要紧吗?
答:要紧。兼容性是第一道闸门,电视型号不在验证列表里时,项目方并不保证效果。让助手按任务书的顺序来,一步都不要跳。
问:可以让助手"看着办"吗?
答:连接、备份、收尾这些步骤可以;唯独"修改清单"这一步不行。禁用哪些应用直接影响你的使用体验,必须人工过目,这就是 ct-0304 的主题。
小结
PROMPT.md 是 CleanYourTV 交给 AI 时代的钥匙:它把十六步流程压缩成一张施工单,让不懂命令行的用户也能安全地精简电视。你的任务是三项——填对信息、把好清单、做完测试。下一篇 ct-0302,我们先从最基础的"把项目交给助手"说起。
