Skip to content

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 ​

  1. 检查电脑上有没有 adb:
bash
adb version
  1. 没有的话,由你自己安装,不要让用户去装。先用包管理器,按系统选一条:
bash
# 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
  1. 包管理器不可用或失败时,直接下载 Google 官方 platform-tools 压缩包,解压到临时目录,用完整路径调用:
powershell
# 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
bash
# 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。

  1. 装完执行 adb version 确认能输出版本号。只有在没有 shell 执行权限、或者上面两种方式都失败时,才向用户说明情况并请求帮助。

四、下载并校验 APK ​

下载到一个临时目录,不要下载到用户的重要目录。

bash
# 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 的话,可以核对包名和版本:
bash
aapt dump badging app-release.apk | grep -E "package:|launchable-activity"

输出里的 name='...' 应为 com.mac_cms.app。如果不一致,说明下到的不是空壳影视,停止安装并告知用户。

五、连接设备 ​

手机 / 平板(USB) ​

  1. 让用户打开"开发者选项",开启"USB 调试",用数据线连接电脑。
  2. 设备上弹出"允许 USB 调试",让用户点允许。
  3. 执行:
bash
adb devices

状态应为 device。如果是 unauthorized,说明用户还没在设备上点允许;如果是 offline,拔插数据线或执行 adb kill-server 后重试。

电视 / 盒子 / 投影仪(网络 ADB) ​

  1. 让用户在电视上开启 ADB。不同品牌入口不一样(有的要用遥控器按键序列唤出隐藏开关),按速查表发给用户对应品牌页的"开启 ADB"一节:小米、TCL / 雷鸟、创维 / 酷开、海信、运营商盒子、投影仪、其他 / 原生 Android TV。拿不到品牌页信息时,通用路径是 设置 → 关于 → 连续点击版本号 7 次 → 开发者选项 → USB 调试。用户不会操作遥控器、找不到入口时,发开启开发者模式给他,里面有小白版步骤、各品牌入口汇总和常见问题。
  2. 不要让用户自己去查 IP,由你主动找出电视的 IP,记为 <TV_IP>,方法见下面的"主动找出电视 IP"。用户电脑和电视必须在同一个局域网。只有你找不出来时,才把怎么查电视的 IP发给用户,让他在电视或路由器上看。
  3. 连接:
bash
adb connect <TV_IP>:5555
adb devices
  1. 电视屏幕上弹出授权对话框时,让用户用遥控器选择允许(可勾选"始终允许")。

连不上怎么办

  • 确认 IP 没写错,电视和电脑在同一个 WiFi / 网段,没有访客网络隔离。IP 不确定时,重新按"主动找出电视 IP"扫描一遍。
  • 部分设备端口不是 5555,让用户在电视的调试选项里看实际显示的端口。
  • 新版 Android 11+ 的无线调试需要先 adb pair <IP>:<配对端口> 再用连接端口 adb connect,配对码在设备的"无线调试"页面里。
  • 电视不支持 ADB 时,不要硬试,回到第二步的速查表,把对应品牌页发给用户,改走手动安装(见第八步)。

如果同时连了多台设备,之后所有命令都要加 -s <serial> 指定目标,不要在多设备时省略它,免得装到错误的设备上。

主动找出电视 IP ​

小白用户通常不知道电视 IP,也看不懂路由器后台。你有命令执行权限时,按下面的顺序自己找。

先告诉用户再扫描

下面会扫描用户家里局域网的一个网段,只测试 5555 端口是否开放。动手前用一句话告诉用户"我会在你家网络里找电视,不会访问外网,也不会改任何设置",再开始。只扫描用户自己的局域网网段,不要扫描其他网络。

第 0 步:确认前提。 让用户确认三件事:电视开着(别待机)、电视已经按品牌页开启了 ADB、电脑和电视连的是同一个路由器。

第 1 步:先试最快的,mDNS 发现(Android 11+ 的无线调试)。

bash
adb mdns services

输出里有 _adb-tls-connect._tcp 一类条目时,里面带着 IP 和端口,直接用。没有输出,进入第 2 步。

第 2 步:取电脑所在网段。

bash
# 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 换成你的网段前缀):

powershell
$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):

bash
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; wait

Linux 的 nc 不支持 -G 时去掉它。电脑装了 nmap 的话更简单:nmap -p 5555 --open 192.168.1.0/24。

第 4 步:逐个候选验证是不是电视。

对扫描出的每个 IP:

bash
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发给用户,让他在电视或路由器上看。
  • 实在找不到,别反复重试,改走手动安装(第八步)。

六、安装 ​

bash
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 启动:

bash
adb shell monkey -p com.mac_cms.app -c android.intent.category.LAUNCHER 1

电视设备也可能只注册了 LEANBACK_LAUNCHER,启动不了时改用:

bash
adb shell monkey -p com.mac_cms.app -c android.intent.category.LEANBACK_LAUNCHER 1

验证安装成功:

bash
adb shell pm list packages | grep com.mac_cms.app

能搜到包名即已安装。如果能截图,再确认一下画面:

bash
adb exec-out screencap -p > screen.png

首页应该是"空壳影视"的界面,电视上可以直接看到直播入口。

八、ADB 走不通时:手动安装(按品牌) ​

电视厂商的系统限制差别很大,同一品牌不同年份的机型做法也可能不同。这一节你的角色是一步一步指导用户:每次只给一步,等用户确认做完再给下一步,并让用户把屏幕上看到的提示描述给你。

以下内容的可信度

菜单名称和路径来自网友实测和社区帖子,不同固件版本可能不一样。拿不准时,让用户描述实际看到的界面,不要硬套。各品牌页末尾都列了参考来源。本文没查到明确做法的,直接让用户去 www.bilibili.com 搜"品牌 + 型号 + 安装app"。

通用手动方法(大多数安卓电视、盒子、投影仪) ​

  1. U 盘安装:在电脑或手机上下载 APK(直链见第一步),拷到 U 盘。U 盘建议用 FAT32 格式,APK 放在 U 盘根目录或一个新建的文件夹里(有的电视识别不了直接放在根目录的文件)。
  2. U 盘插到电视,用电视自带的文件管理打开 U 盘,找到 APK,用遥控器点击安装。
  3. 如果提示"禁止安装未知来源应用",按提示跳转到设置,给文件管理(或当前正在用的安装入口)打开"允许安装未知来源应用",返回再装。
  4. 如果提示"有风险 / Play 保护"之类的警告,空壳影视不要求隐私权限,在确认下载来源是本文直链的前提下,选继续安装即可。
  5. 电视没有文件管理时,让用户在电视自带的应用商店里装一个文件管理器,或者装当贝市场这类第三方市场(部分电视的应用商店里就有)。

按品牌的做法(每行都有完整教程,直接发给用户) ​

品牌 / 设备一句话结论完整教程(手动安装 + ADB)
小米 / 红米电视U 盘直接装通常就行,提示风险时继续安装小米 / 红米电视
TCL / 雷鸟电视手机 TCL Share+ 多屏互动推送最稳,ADB 开关要用遥控器按键序列唤出TCL / 雷鸟电视
创维 / 酷开电视老版本"应用管理 → U 盘安装";新版本可能被锁,装不了就换外接盒子创维 / 酷开电视
海信电视安卓内核开 USB 调试走 ADB;纯 VIDAA 装不了 APK海信电视
华为智慧屏新款纯鸿蒙装不了,建议外接安卓盒子华为智慧屏
魔百盒等运营商盒子先 U 盘装当贝市场,再装其他软件;不要建议刷机运营商盒子
当贝 / 极米 / 坚果等投影仪文件管理 + U 盘,不行再 ADB投影仪
夏普、原生 Android TV、第三方盒子等通用流程,开发者选项里开 USB 调试其他电视 / 盒子

教用户时的做法:

  1. 问清品牌和型号,必要时让用户打开"设置 → 关于",描述屏幕上看到的内容,判断系统类型。
  2. 把对应的品牌页链接发给用户,并说明"我会一步步带你做"。
  3. 一次只给一步,等用户确认做完、描述结果再给下一步。对不上教程里的菜单名时,以用户屏幕上的为准,不要硬套。
  4. 一种方式失败两次,换品牌页里的下一种方式。品牌页写明"装不了"的,如实告诉用户,建议外接安卓电视盒子,不要建议 root 或刷机。

装好后 ​

手动装好之后,就可以用空壳影视自己的免 U 盘安装功能装别的 App,不用再插 U 盘。

九、装完之后告诉用户什么 ​

用简短的话向用户说明下面几点,不要一次堆太多:

  1. 空壳影视已经装好,开箱默认自带央视和各地方卫视直播(WebTV),可以直接看。
  2. 它是"影视壳",本身没有影视资源。想点播、想要更多频道,需要配播放源,见App 换源和自定义源。
  3. 电视上输入文字很麻烦,搜索时用手机微信扫屏幕上的二维码,在手机里打字发到电视,手机和电视需要在同一个 WiFi,详见使用说明。
  4. 以后给这台电视装别的 App 不用插 U 盘,进设置点"远程安装第三方 App",见免 U 盘安装。
  5. 默认只显示公开内容,需要时用隐私码解锁,默认隐私码是 404,见App 换源。
  6. 想开机直接进直播、数字键换台,见电视使用指南。

十、不要做的事 ​

  • 不要自己猜包名、版本号、下载地址。下载地址只用本文给的直链,其他来源的 APK 不保证安全。
  • 不要因为缺少 adb 就让用户自己去装。这一步你自己能做,见第三步。
  • 不要一上来就让用户自己查电视 IP。先按"主动找出电视 IP"自己找,找不到再请用户帮忙。
  • 扫描只限用户自己的局域网网段,只探测 5555 端口,扫描前先告诉用户。
  • 不要在没问用户的情况下卸载已有应用、清除数据或修改系统设置。
  • 不要在多设备同时连接时省略 -s。
  • 不要替用户配置来源不明的播放源。需要配源时,让用户自己提供,或者引导看自定义源。
  • 不要反复重试失败的操作。同一步失败两次,就停下来向用户说明原因,并改走第八步的手动安装,并把对应品牌页(见第二步速查表)发给用户。

十一、一键脚本参考 ​

适用于一台设备、已经开启调试的情况(bash):

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 "安装完成"

相关页面 ​