https://www.gentv.me/downloads/PROMPT.md

# GenTV 操作提示词 / Operating prompt ## 先读：GenTV 的当前入口（优先于下方继承流程） 你正在操作 GenTV 本地项目。品牌为 GenTV，官网为 https://www.gentv.me，提供中英文服务。国内与海外均使用 GenTV 桌面；仍需确认电视地区与固件，不按 IP 或语言假定兼容性。 - 清理、备份、恢复沿用本仓库 `tools/` 和 `examples/`，不要重写保护逻辑或修改原清单格式。`python3 -m neatv devices <关键词>` 只是资料搜索，`python3 -m neatv plan <清单>` 只是离线预览；都不是自动机型认证。 - 必须核对型号、固件、清单头部、设备说明及用户保留的功能。保留所有适用的下方安全规则，不卸载系统包，不打开工厂菜单。 - 国内与海外均采用 GenTV 桌面（源码开发中），包名 com.gentv.me，HOME 为 com.gentv.me/com.gentv.me.ui.main.MainActivity。先运行 `python3 -m neatv launchers --json` 查看固定安装包及 SHA256。已核验签名与身份，但尚未通过目标电视的安装、主页键、待机与重启验证。不自动安装或接管 Home，不禁用原厂 Home 和其依赖。 - 下方上游流程中关于现场编译、安装 `com.gathin.tvhome`、启用其按键服务、推送主题、修改 `config.xml` 的步骤属于原参考 Launcher，不适用于 GenTV 当前选定的 GenTV 桌面。不得据此自动安装原 Launcher 或假设新桌面有相同接口。保留原厂桌面完成可确认的清理，其余说明待办即可。 - 清理前保存完整备份；继续使用 `~/.neatv/` 的恢复记录和同一份清单绝对路径。手机端源项目的备份不是该格式，不能直接传给 `tools/restore.*`。 - `python3 -m neatv disable <清单>` 默认展示原脚本命令；仅在用户选择、备份和设备检查完成后加 `--execute`。`check` 指定该电视实际 Home 包名，不默认使用原参考 Launcher。 - 代码仓库的自有发布地址与 release tag 尚未确定，不从 upstream main 或随机 latest 拼装 GenTV 发行资产，不编造下载链接。 - 完成后验证保留功能，提供恢复路径，并按下方规则关闭调试。无法验证的结果如实说明。 ## Read first: GenTV overrides Use this checkout's original tools and device notes. Both markets now use GenTV Launcher (source development), package com.gentv.me. Its source has been forked; build, device and Home takeover checks remain pending. Check `python3 -m neatv launchers --json` first. Until installation and Home behaviour are verified for the exact device, keep stock Home and its dependencies; do not build or install the reference launcher, enable its key services, or apply its themes. Offline search and previews are not device certification. Back up first, preserve upstream guards and recovery paths, and disable rather than uninstall system packages. Source-phone-app backups are not interchangeable with Python recovery records. Do not invent a release repository or claim that a device has been tested. ## Inherited upstream procedure The following connection, backup and safety guidance is retained from the fixed upstream baseline. Reference-launcher-specific steps are overridden above; they are not the current GenTV installation procedure. # The prompt Paste this into Claude Code (or another coding assistant with shell access) on a computer that is on the same Wi-Fi as the TV. Works on Android TV / Google TV sets (Xiaomi, TCL, Hisense, Sony, OnePlus, Realme, Nvidia Shield and most others). It will not work on Samsung Tizen, LG webOS or Fire TV. For Samsung, LG, Roku and other non-Android TVs, use https://www.gentv.me/non-android/ instead: it turns off the tracking with the remote. If you cloned this repo, mention that: the assistant can reuse `tools/` and `launcher/` instead of writing them from scratch, and only needs to edit `launcher/.../values/config.xml`. Before you start, on the TV: Settings → Device Preferences → About → press OK on "Build" 7 times, then go back → Developer options → turn on USB debugging (and Network/ADB debugging if your TV shows it). Keep the TV on. Some boxes cut power to their USB port while USB debugging is on, so a USB speaker or drive plugged into it goes dead until you switch debugging off again. A USB Ethernet adapter on that port can drop the same way, so plan to do the whole session in one sitting. --- I want to debloat my Android TV and replace its launcher with a clean Apple TV style home screen. My TV model is: . Work on the real device, step by step, and verify everything you do with screenshots pulled from the TV. Ask me before anything that depends on my preferences. Use this project's local checkout. If tools/, docs/ or examples/ are missing, ask for the confirmed GenTV source location before proceeding. Do not invent a repository URL or write replacement safety tools. Connect - Find the TV on my network (hostname, ARP table, or ask me for the IP) and connect over ADB on port 5555. If the TV is in another home, I'll give you its Tailscale address instead (docs/REMOTE.md): use that, don't scan my local network. - If the stock adb binary fails with "No route to host" on macOS even though the port is open, that is macOS Local Network privacy blocking adb. Don't debug it: use the Python `adb-shell` package in a venv as the ADB client instead. If its file push hangs on larger files, transfer files as base64 chunks through the shell and verify the md5. - If your own commands can't reach the TV at all while it answers from an ordinary terminal (a sandbox that blocks the local network), ask me to run `tools/relay.py ` in a terminal and leave it running, then use `TV_HOST=127.0.0.1 TV_PORT=15555` (`tools/relay.md`). - If port 5555 stays closed, the TV may only offer Wireless debugging (Google TV sets often do): look for `_adb-tls-connect._tcp` with `dns-sd -B` or `adb mdns services`, ask me for the code and port under Developer options > Wireless debugging > Pair device with pairing code, then `adb pair`, `adb connect` and `adb tcpip 5555`. Android switches Wireless debugging off whenever Wi-Fi drops. Some firmware runs network ADB on another fixed port instead (a projector used 5877): if 5555 refuses and nothing advertises Wireless debugging, scan the TV's own TCP ports and try each open one with `TV_PORT`. - If the TV turns out not to be Android TV / Google TV (no ADB port at all, or it identifies as Tizen, webOS, Roku OS, VIDAA or SmartCast), stop and tell me to use https://www.gentv.me/non-android/ which turns off the tracking with the remote. Nothing in this repo applies to it. - Tell me when the "Allow USB debugging?" prompt will appear on the TV so I can accept it. - If `adb install` hangs on Android 14 it is waiting for an on-screen confirmation; push the APK and run `pm install -r` over the shell instead. Back up first - Save the full package list, disabled-package list, getprop output and all settings to a backup folder before changing anything, and write a restore script that re-enables everything you disable. - Ask me what is plugged into the TV's USB ports, and ask