AI 安装空壳影视教程
本页写给 AI 代理(agent)阅读。如果你是被用户要求"帮我装空壳影视"的 AI,按下面的步骤执行即可。人类用户请看安装教程总览。
一、先确认事实
| 项目 | 内容 |
|---|---|
| 应用名 | 空壳影视 |
| 包名 | com.mac_cms.app |
| 类型 | Android 影视壳 App,本身不含任何影视资源,靠换源获取内容 |
| 下载直链 | https://files.mac-cms.com/app-release.apk |
| 系统要求 | Android 5.0 及以上 |
| 适用设备 | 智能电视、电视盒子、投影仪、手机、平板 |
| 价格 / 广告 | 免费,无开屏广告、无贴片广告、无会员墙 |
| 所需权限 | 不要求隐私权限,系统提示"第三方应用 / 未知来源"时允许即可 |
不要编造
版本号、签名等信息,本文没有提供。需要时请从下载的 APK 里读取(见第四步),不要凭空猜测。包名以本表为准:com.mac_cms.app。
二、判断你能用哪种方式安装
先问清楚用户的设备类型和品牌型号,以及你手里有什么能力,再选路线:
- 你能在用户电脑上执行命令,且设备和电脑同一局域网(或能用 USB 连接):走本文的 ADB 路线,最省事。开启 ADB 的方法因品牌而异,见下面的速查表。
- 你只能给用户文字指导,不能执行命令:直接用品牌页里的"手动安装"一步步教用户。
- 用户的设备不开放 ADB(部分品牌锁死):改走手动安装,不要反复尝试连接。
品牌教程速查(给用户发链接用)
向用户确认品牌后,把对应链接发给用户,并在对话里按页面内容一步步带着他做。每个品牌页都包含:手动安装(不开 ADB)、怎么开启 ADB、怎么用 ADB 安装、装不了时的替代方案。
| 用户的设备 | 品牌页(手动安装 + ADB) | 直达"开启 ADB" |
|---|---|---|
| 小米、红米电视,小米盒子 | 小米 / 红米电视 | 开启 ADB |
| TCL、雷鸟电视 | TCL / 雷鸟电视 | 开启 ADB |
| 创维、酷开电视 | 创维 / 酷开电视 | 开启 ADB |
| 海信电视 | 海信电视 | 开启 ADB |
| 华为智慧屏 | 华为智慧屏 | 不适用,纯鸿蒙装不了 APK |
| 魔百盒、魔百和、运营商 IPTV 盒子 | 运营商盒子 | 开启 ADB |
| 当贝、极米、坚果等投影仪 | 投影仪 | 开启 ADB |
| 其他品牌、原生 Android TV / Google TV、第三方盒子、电视棒 | 其他电视 / 盒子 | 开启 ADB |
| 通用 ADB 命令、报错排查 | 通过 ADB 安装 |
总览页:安装教程总览。
三、准备 ADB
- 检查电脑上有没有
adb:
adb version- 没有的话,由你自己安装,不要让用户去装。先用包管理器,按系统选一条:
# Windows (winget)
winget install --id Google.PlatformTools -e --accept-source-agreements --accept-package-agreements
# macOS (Homebrew)
brew install --cask android-platform-tools
# Debian / Ubuntu
sudo apt install -y adb- 包管理器不可用或失败时,直接下载 Google 官方 platform-tools 压缩包,解压到临时目录,用完整路径调用:
# Windows PowerShell
Invoke-WebRequest -Uri https://dl.google.com/android/repository/platform-tools-latest-windows.zip -OutFile platform-tools.zip
Expand-Archive platform-tools.zip -DestinationPath .\adb-tools -Force
.\adb-tools\platform-tools\adb.exe version# macOS:把 windows 换成 darwin;Linux:换成 linux
curl -L -o platform-tools.zip https://dl.google.com/android/repository/platform-tools-latest-linux.zip
unzip -o platform-tools.zip -d ./adb-tools
./adb-tools/platform-tools/adb version之后文中所有 adb 命令,都替换成这个解压出来的完整路径即可,不必改系统 PATH。
- 装完执行
adb version确认能输出版本号。只有在没有 shell 执行权限、或者上面两种方式都失败时,才向用户说明情况并请求帮助。
四、下载并校验 APK
下载到一个临时目录,不要下载到用户的重要目录。
# Linux / macOS
curl -L -o app-release.apk https://files.mac-cms.com/app-release.apk
# Windows PowerShell
Invoke-WebRequest -Uri https://files.mac-cms.com/app-release.apk -OutFile app-release.apk校验:
- 文件大小应该明显大于 0(几 MB 到几十 MB 量级)。如果只有几 KB,说明下到的是错误页,重新下载。
- 文件头应该是 ZIP 格式(APK 本质是 ZIP),前两个字节是
PK。 - 有 Android SDK
build-tools的话,可以核对包名和版本:
aapt dump badging app-release.apk | grep -E "package:|launchable-activity"输出里的 name='...' 应为 com.mac_cms.app。如果不一致,说明下到的不是空壳影视,停止安装并告知用户。
五、连接设备
手机 / 平板(USB)
- 让用户打开"开发者选项",开启"USB 调试",用数据线连接电脑。
- 设备上弹出"允许 USB 调试",让用户点允许。
- 执行:
adb devices状态应为 device。如果是 unauthorized,说明用户还没在设备上点允许;如果是 offline,拔插数据线或执行 adb kill-server 后重试。
电视 / 盒子 / 投影仪(网络 ADB)
- 让用户在电视上开启 ADB。不同品牌入口不一样(有的要用遥控器按键序列唤出隐藏开关),按速查表发给用户对应品牌页的"开启 ADB"一节:小米、TCL / 雷鸟、创维 / 酷开、海信、运营商盒子、投影仪、其他 / 原生 Android TV。拿不到品牌页信息时,通用路径是 设置 → 关于 → 连续点击版本号 7 次 → 开发者选项 → USB 调试。用户不会操作遥控器、找不到入口时,发开启开发者模式给他,里面有小白版步骤、各品牌入口汇总和常见问题。
- 不要让用户自己去查 IP,由你主动找出电视的 IP,记为
<TV_IP>,方法见下面的"主动找出电视 IP"。用户电脑和电视必须在同一个局域网。只有你找不出来时,才把怎么查电视的 IP发给用户,让他在电视或路由器上看。 - 连接:
adb connect <TV_IP>:5555
adb devices- 电视屏幕上弹出授权对话框时,让用户用遥控器选择允许(可勾选"始终允许")。
连不上怎么办
- 确认 IP 没写错,电视和电脑在同一个 WiFi / 网段,没有访客网络隔离。IP 不确定时,重新按"主动找出电视 IP"扫描一遍。
- 部分设备端口不是 5555,让用户在电视的调试选项里看实际显示的端口。
- 新版 Android 11+ 的无线调试需要先
adb pair <IP>:<配对端口>再用连接端口adb connect,配对码在设备的"无线调试"页面里。 - 电视不支持 ADB 时,不要硬试,回到第二步的速查表,把对应品牌页发给用户,改走手动安装(见第八步)。
如果同时连了多台设备,之后所有命令都要加 -s <serial> 指定目标,不要在多设备时省略它,免得装到错误的设备上。
主动找出电视 IP
小白用户通常不知道电视 IP,也看不懂路由器后台。你有命令执行权限时,按下面的顺序自己找。
先告诉用户再扫描
下面会扫描用户家里局域网的一个网段,只测试 5555 端口是否开放。动手前用一句话告诉用户"我会在你家网络里找电视,不会访问外网,也不会改任何设置",再开始。只扫描用户自己的局域网网段,不要扫描其他网络。
第 0 步:确认前提。 让用户确认三件事:电视开着(别待机)、电视已经按品牌页开启了 ADB、电脑和电视连的是同一个路由器。
第 1 步:先试最快的,mDNS 发现(Android 11+ 的无线调试)。
adb mdns services输出里有 _adb-tls-connect._tcp 一类条目时,里面带着 IP 和端口,直接用。没有输出,进入第 2 步。
第 2 步:取电脑所在网段。
# Windows
ipconfig
# macOS
ipconfig getifaddr en0
# Linux
ip -4 addr show找到电脑当前的 IPv4 地址,比如 192.168.1.8,网段前缀就是 192.168.1。有多个网卡(有线、WiFi、虚拟机、VPN)时,选和路由器同网段的那个,一般是默认网关所在的网卡。
第 3 步:扫描网段内开放 5555 端口的设备。
Windows PowerShell(5.1 和 7 都能用,把 $p 换成你的网段前缀):
$p = "192.168.1"
$jobs = 1..254 | ForEach-Object {
$c = New-Object Net.Sockets.TcpClient
[pscustomobject]@{ Ip = "$p.$_"; Client = $c; Task = $c.ConnectAsync("$p.$_", 5555) }
}
Start-Sleep -Seconds 3
$jobs | Where-Object { $_.Task.Status -eq "RanToCompletion" -and $_.Client.Connected } | ForEach-Object { $_.Ip }
$jobs | ForEach-Object { $_.Client.Close() }macOS / Linux(需要 nc):
P=192.168.1
for i in $(seq 1 254); do (nc -z -G 1 -w 1 $P.$i 5555 >/dev/null 2>&1 && echo $P.$i) & done; waitLinux 的 nc 不支持 -G 时去掉它。电脑装了 nmap 的话更简单:nmap -p 5555 --open 192.168.1.0/24。
第 4 步:逐个候选验证是不是电视。
对扫描出的每个 IP:
adb connect <候选IP>:5555
adb -s <候选IP>:5555 shell getprop ro.product.brand
adb -s <候选IP>:5555 shell getprop ro.product.model- 电视上这时会弹出授权框,请用户用遥控器选"允许"。授权前
adb devices显示unauthorized,授权后变成device,再执行getprop。 - 品牌和型号对得上用户说的电视,就是它,记下
<TV_IP>。 - 候选有多个、分不清时,告诉用户"电视上现在有没有弹出授权框",哪个 IP 对应的连接触发了弹框,哪个就是电视。
- 验证完不是电视的候选,
adb disconnect <候选IP>:5555断开。
第 5 步:扫不到时的备选。
- 没有任何设备开放 5555:多半是 ADB 没开、电视休眠了,或者用的是 Android 11+ 的无线调试(端口不是 5555)。让用户确认电视开着、ADB 已开,无线调试的话让用户读出电视"无线调试"页面上的 IP 和端口。
- 用
arp -a列出同网段所有设备,结合ping -a <IP>(Windows)或nslookup <IP>看主机名,主机名里带品牌或型号的多半是电视。 - 路由器的"已连接设备"列表里能看到电视,但你读不到路由器:把怎么查电视的 IP发给用户,让他在电视或路由器上看。
- 实在找不到,别反复重试,改走手动安装(第八步)。
六、安装
adb install -r app-release.apk-r:已安装则覆盖升级,保留数据。- 输出
Success即安装成功。
常见失败信息:
| 报错 | 原因与处理 |
|---|---|
INSTALL_FAILED_OLDER_SDK | 系统低于 Android 5.0,该设备不支持,告知用户 |
INSTALL_FAILED_UPDATE_INCOMPATIBLE | 设备上已有签名不同的同包名应用。需要先卸载旧版,但卸载会丢失数据,先征得用户同意 |
INSTALL_FAILED_INSUFFICIENT_STORAGE | 存储空间不足,请用户清理 |
INSTALL_FAILED_USER_RESTRICTED / 弹窗被拦截 | 系统限制第三方安装,让用户在设备上手动允许,TCL、雷鸟等需要在"电视卫士"里放行 |
INSTALL_PARSE_FAILED_NOT_APK / NO_CERTIFICATES | 文件下载不完整或损坏,回到第四步重新下载 |
device offline / no devices | 回到第五步重新连接 |
七、启动并验证
有包名时,用 monkey 启动:
adb shell monkey -p com.mac_cms.app -c android.intent.category.LAUNCHER 1电视设备也可能只注册了 LEANBACK_LAUNCHER,启动不了时改用:
adb shell monkey -p com.mac_cms.app -c android.intent.category.LEANBACK_LAUNCHER 1验证安装成功:
adb shell pm list packages | grep com.mac_cms.app能搜到包名即已安装。如果能截图,再确认一下画面:
adb exec-out screencap -p > screen.png首页应该是"空壳影视"的界面,电视上可以直接看到直播入口。
八、ADB 走不通时:手动安装(按品牌)
电视厂商的系统限制差别很大,同一品牌不同年份的机型做法也可能不同。这一节你的角色是一步一步指导用户:每次只给一步,等用户确认做完再给下一步,并让用户把屏幕上看到的提示描述给你。
以下内容的可信度
菜单名称和路径来自网友实测和社区帖子,不同固件版本可能不一样。拿不准时,让用户描述实际看到的界面,不要硬套。各品牌页末尾都列了参考来源。本文没查到明确做法的,直接让用户去 www.bilibili.com 搜"品牌 + 型号 + 安装app"。
通用手动方法(大多数安卓电视、盒子、投影仪)
- U 盘安装:在电脑或手机上下载 APK(直链见第一步),拷到 U 盘。U 盘建议用 FAT32 格式,APK 放在 U 盘根目录或一个新建的文件夹里(有的电视识别不了直接放在根目录的文件)。
- U 盘插到电视,用电视自带的文件管理打开 U 盘,找到 APK,用遥控器点击安装。
- 如果提示"禁止安装未知来源应用",按提示跳转到设置,给文件管理(或当前正在用的安装入口)打开"允许安装未知来源应用",返回再装。
- 如果提示"有风险 / Play 保护"之类的警告,空壳影视不要求隐私权限,在确认下载来源是本文直链的前提下,选继续安装即可。
- 电视没有文件管理时,让用户在电视自带的应用商店里装一个文件管理器,或者装当贝市场这类第三方市场(部分电视的应用商店里就有)。
按品牌的做法(每行都有完整教程,直接发给用户)
| 品牌 / 设备 | 一句话结论 | 完整教程(手动安装 + ADB) |
|---|---|---|
| 小米 / 红米电视 | U 盘直接装通常就行,提示风险时继续安装 | 小米 / 红米电视 |
| TCL / 雷鸟电视 | 手机 TCL Share+ 多屏互动推送最稳,ADB 开关要用遥控器按键序列唤出 | TCL / 雷鸟电视 |
| 创维 / 酷开电视 | 老版本"应用管理 → U 盘安装";新版本可能被锁,装不了就换外接盒子 | 创维 / 酷开电视 |
| 海信电视 | 安卓内核开 USB 调试走 ADB;纯 VIDAA 装不了 APK | 海信电视 |
| 华为智慧屏 | 新款纯鸿蒙装不了,建议外接安卓盒子 | 华为智慧屏 |
| 魔百盒等运营商盒子 | 先 U 盘装当贝市场,再装其他软件;不要建议刷机 | 运营商盒子 |
| 当贝 / 极米 / 坚果等投影仪 | 文件管理 + U 盘,不行再 ADB | 投影仪 |
| 夏普、原生 Android TV、第三方盒子等 | 通用流程,开发者选项里开 USB 调试 | 其他电视 / 盒子 |
教用户时的做法:
- 问清品牌和型号,必要时让用户打开"设置 → 关于",描述屏幕上看到的内容,判断系统类型。
- 把对应的品牌页链接发给用户,并说明"我会一步步带你做"。
- 一次只给一步,等用户确认做完、描述结果再给下一步。对不上教程里的菜单名时,以用户屏幕上的为准,不要硬套。
- 一种方式失败两次,换品牌页里的下一种方式。品牌页写明"装不了"的,如实告诉用户,建议外接安卓电视盒子,不要建议 root 或刷机。
装好后
手动装好之后,就可以用空壳影视自己的免 U 盘安装功能装别的 App,不用再插 U 盘。
九、装完之后告诉用户什么
用简短的话向用户说明下面几点,不要一次堆太多:
- 空壳影视已经装好,开箱默认自带央视和各地方卫视直播(WebTV),可以直接看。
- 它是"影视壳",本身没有影视资源。想点播、想要更多频道,需要配播放源,见App 换源和自定义源。
- 电视上输入文字很麻烦,搜索时用手机微信扫屏幕上的二维码,在手机里打字发到电视,手机和电视需要在同一个 WiFi,详见使用说明。
- 以后给这台电视装别的 App 不用插 U 盘,进设置点"远程安装第三方 App",见免 U 盘安装。
- 默认只显示公开内容,需要时用隐私码解锁,默认隐私码是
404,见App 换源。 - 想开机直接进直播、数字键换台,见电视使用指南。
十、不要做的事
- 不要自己猜包名、版本号、下载地址。下载地址只用本文给的直链,其他来源的 APK 不保证安全。
- 不要因为缺少
adb就让用户自己去装。这一步你自己能做,见第三步。 - 不要一上来就让用户自己查电视 IP。先按"主动找出电视 IP"自己找,找不到再请用户帮忙。
- 扫描只限用户自己的局域网网段,只探测 5555 端口,扫描前先告诉用户。
- 不要在没问用户的情况下卸载已有应用、清除数据或修改系统设置。
- 不要在多设备同时连接时省略
-s。 - 不要替用户配置来源不明的播放源。需要配源时,让用户自己提供,或者引导看自定义源。
- 不要反复重试失败的操作。同一步失败两次,就停下来向用户说明原因,并改走第八步的手动安装,并把对应品牌页(见第二步速查表)发给用户。
十一、一键脚本参考
适用于一台设备、已经开启调试的情况(bash):
#!/usr/bin/env bash
set -euo pipefail
APK_URL="https://files.mac-cms.com/app-release.apk"
APK_FILE="app-release.apk"
TARGET="${1:-}" # 可选:adb 设备序列号或 <IP>:5555
# 需要网络 ADB 时先连接
if [[ "$TARGET" == *:* ]]; then
adb connect "$TARGET"
fi
# 下载
curl -fL -o "$APK_FILE" "$APK_URL"
# 校验:APK 是 ZIP,文件头为 PK
head -c 2 "$APK_FILE" | grep -q "PK" || { echo "下载的文件不是有效 APK"; exit 1; }
# 安装
if [[ -n "$TARGET" ]]; then
adb -s "$TARGET" install -r "$APK_FILE"
else
adb install -r "$APK_FILE"
fi
echo "安装完成"