三项目信息:型号、IP 与系统
任务书(PROMPT.md)解决了"怎么干",但助手还不知道"在哪儿干、给谁干"。把 CleanYourTV 的项目文件夹交给助手时,你必须补齐三项现实世界的信息:电视型号、电视 IP、电脑系统。它们分别回答三个问题:这台电视能不能修、去哪儿找它、用什么工具找它。
这三项信息填得准不准,直接决定后面所有步骤的成败。型号填错,兼容性检查就失去意义;IP 填错一位,助手连到的就不是你家电视;系统信息含糊,助手准备的工具可能装错地方。所以本篇值得你放慢速度,一项一项对着电视屏幕抄。
第一项:电视型号
在哪里找
型号一般在电视的"设置→关于"里。不同品牌的叫法略有差异,有的叫"关于本机",有的叫"设备信息",还有的把入口放在"设置→系统"下面,以你的电视实际菜单为准。在"关于"页面里,找带有"型号""Model"字样的那一行。
为什么要具体
兼容性检查依赖精确型号。项目方维护着一份经过验证的电视型号列表,"小米电视"四个字显然不够——要具体到型号级别,比如"XX 系列 55 英寸"这种写法。如果"关于"页面同时列出了多个号码(型号、序列号、设备号),优先给"型号"那一项;拿不准就全部贴上,让助手自己分辨,多给信息比少给安全。
顺手再确认两件事
在"关于"页面停留的这会儿,顺带看清两样东西:一是系统是 Android TV 还是 Google TV,二是系统版本号。助手追问时按实情回答即可,这两样不影响本篇的填写,但能让助手的准备更顺。
确认点
型号是后面一切检查的地基。填完之后,让助手把它收到的型号复述一遍,你拿遥控器在"关于"页面逐字符比对,一个字母都不能差。
第二项:电视 IP
在哪里找
IP 在电视的网络设置里,路径大致是"设置→网络→选中当前连接的网络→查看详情"。不同品牌的菜单深度不一,有的在连接成功页直接显示,以你的电视为准。本书示例统一使用 192.168.1.50,这是项目文档里的默认示例地址,你实际填自己电视的真实 IP。
为什么它很关键
ADB 走 Wi-Fi,IP 就是电视的门牌号。填错一位,结果不是"连到邻居家电视"这种浪漫剧情,而是谁都连不上——助手报连接超时,你对着电视干瞪眼。ADB 连接端口通常是 5555,这一点第 2 章已经讲过,电视端开着无线调试时,连接就落到这个端口上。
两个让 IP 省心的建议
- 让电视"留住"这个 IP。在路由器里把电视的 IP 与它的网卡地址做绑定(DHCP 静态分配),电视重启后就不会换门牌。具体操作因路由器品牌而异,以你的路由器说明书为准。不绑定也行,只是每次电视重启后可能要重新查 IP。
- 电脑与电视必须接同一个 Wi-Fi,或者说同一路由器下的同一网段。这是无线调试能通的前提:电脑要能凭 IP 直接"喊"到电视。第 2 章 ct-0201 对网络准备有完整说明,拿不准可以先翻回去看。
第三项:电脑系统
告诉助手你的电脑是什么系统:Windows、macOS 还是 Linux,顺便给出版本。这决定助手准备哪套工具。举个例子:在 macOS 上,系统的隐私策略可能挡住官方 adb 可执行文件,这时项目自带的 tools/tv.py(纯 Python ADB 客户端)就能派上用场——它不依赖官方 adb 二进制,在 macOS 也能跑,详见 ct-0401。再比如 Linux 各发行版的包管理器不同,助手装依赖时的命令也不一样。如果能顺带说明处理器架构(如 Intel 芯片或 Apple 芯片),助手准备工具时会更顺畅。
把项目交给助手:一步一步来
信息找齐了,接下来是把项目"递"到助手眼前。完整步骤如下:
- 解压源码 ZIP,得到 CleanYourTV 项目文件夹。
- 在助手里打开该文件夹,确认助手能看到 PROMPT.md。
- 把三项信息一次性说清楚。可以参考下面的模板,把尖括号换成实际内容:
电视型号:<关于页面里的完整型号>
电视 IP:192.168.1.50(替换成你电视的真实 IP)
电脑系统:Windows 11 / macOS 14 / Ubuntu 24.04(按实际填写)
- 让助手复述这三项信息,你逐项核对。
- 确认无误后,让助手按 PROMPT.md 的流程开工:先查兼容性,再备工具,再谈备份。顺序不能乱,备份没完成之前,不许碰电视上的任何应用。
确认点清单
| 项目 | 在哪里核对 | 对不上怎么办 |
|---|---|---|
| 电视型号 | 电视"设置→关于"页面 | 以电视显示为准,让助手改正 |
| 电视 IP | 电视"设置→网络"详情页 | 重新查 IP;注意大小写与点号 |
| 电脑系统 | 电脑"关于本机"或系统设置 | 如实相告,别让助手猜 |
| 助手复述 | 对话框里助手的第一条总结 | 发现错误立刻纠正,再放行 |
常见错误一览
| 现象 | 原因 | 处理 |
|---|---|---|
| 助手报连接超时 | IP 填错,或电脑电视不在同一网段 | 核对 IP,确认同一 Wi-Fi |
| 昨天还能连,今天不行 | 电视换了 IP(路由器重新分配) | 重新查 IP;长期方案是做静态绑定 |
| 兼容性检查结果含糊 | 型号填得太笼统 | 补齐完整型号再查 |
| 助手要你装一堆东西 | 系统信息没给全,助手按最坏情况准备 | 补齐系统版本与架构 |
| 连上了却提示未授权 | 电视上的授权对话框还没点 | 去电视旁确认,见 ct-0303 |
信息之外:保持对话上下文
把项目交给助手之后,接下来十几分钟里你会和它来回聊很多轮。有两条实用经验:一是别在中途清空对话,助手需要记得你的三项信息和已经走到哪个阶段;二是电视状态发生变化时(重启了、换 IP 了、升级固件了)主动告知助手,它手里的"案卷"必须和现实一致,判断才不会失真。
小结
三项信息是现实世界与任务书之间的接口:型号决定能不能做,IP 决定连哪儿,系统决定用什么工具。填写时抱着"抄错一个字符就全盘皆输"的耐心,填完让助手复述核对。信息对齐之后,下一篇 ct-0303 我们走向沙发,看看电视上那个必须由你来点的确认对话框。
