什么是 PROMPT.md

打开 CleanYourTV 的源码压缩包并解压,你会看到一堆目录与脚本:tools/ 里躺着工具链,themes/ 里收着二十一套主题,addons/ 放着附加模块,此外还有几份说明文件。其中最值得你停下来细读十分钟的,是根目录下的 PROMPT.md。

它不长,却可能是整个项目里"含金量"最高的一个文件。原因很简单:CleanYourTV 的完整流程——查兼容性、备工具、改前备份、连接电视、选择保留、执行修改、收尾验证——被原原本本写成了一份递给 AI 编程助手的任务书。你不需要背命令,不需要懂 ADB 协议,也不需要知道 pm disable-user 究竟是什么。你要做的,是把这份任务书连同三项目信息交给助手,然后在几个关键节点上到电视旁边点几下"确认"。

打个比方:PROMPT.md 就像一张写给智能管家的施工单。管家(AI 助手)识字、会看仓库、能执行命令,但它不知道你家电视是什么型号、IP 是多少、你的电脑是什么系统。施工单负责告诉它"活儿怎么干",你负责告诉它"活儿在哪儿干、给谁干"。两者一拼,才是一次完整的精简。

为什么要把流程写成一份任务书

精简一台电视,步骤其实并不短。从下载源码到最终重启,中间隔着十多个环节,任何一环出错——连错了设备、禁错了应用、忘了备份——都可能让你在沙发前陷入尴尬。把流程固化成一份提示词文件,至少带来四个好处:

  1. 不遗漏。任务书按顺序列清了每一步,助手照着走,比人凭记忆操作更稳。
  2. 可复用。提示词写在文件里,下次换一台电视,改三项信息就能再来一遍。
  3. 边界清。哪些事能做、哪些事不能碰(不 Root、不刷机、不绕 DRM),白纸黑字写在任务书里,助手不容易"自由发挥"。
  4. 可审查。你是这份任务书的主人,助手执行的每一步你都看得见;改什么、禁什么,最终由你把关。

项目方宣称,在助手主导下全程约 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 的第一步,是让助手"看得见"这个项目文件夹。常见做法如下:

  1. 下载源码 ZIP 并解压,记住解压后文件夹的位置。
  2. 打开你常用的 AI 编程助手,选择"打开文件夹"或"打开项目"之类的入口(不同助手叫法不同,以你使用的助手为准)。
  3. 选中 CleanYourTV 的项目根目录,确认助手能看到 PROMPT.md、tools/、themes/ 等文件。
  4. 如果助手不支持打开文件夹,也可以把 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,我们先从最基础的"把项目交给助手"说起。