> 来源：https://mac-cms.com/install/ai-install
> 简介：写给 AI 代理（Claude、ChatGPT、Kiro 等）看的空壳影视安装手册：下载 APK、校验、用 ADB 连接电视盒子或手机、安装、启动、验证，以及遇到问题怎么排查。
> 更新：2026-11-02

# AI 安装空壳影视教程

> 本页写给 AI 代理（agent）阅读。如果你是被用户要求"帮我装空壳影视"的 AI，按下面的步骤执行即可。人类用户请看[安装教程总览](/install/index)。

## 一、先确认事实

| 项目 | 内容 |
|------|------|
| 应用名 | 空壳影视 |
| 包名 | `com.mac_cms.app` |
| 类型 | Android 影视壳 App，本身不含任何影视资源，靠换源获取内容 |
| 下载直链 | `https://files.mac-cms.com/app-release.apk` |
| 系统要求 | Android 5.0 及以上 |
| 适用设备 | 智能电视、电视盒子、投影仪、手机、平板 |
| 价格 / 广告 | 免费，无开屏广告、无贴片广告、无会员墙 |
| 所需权限 | 不要求隐私权限，系统提示"第三方应用 / 未知来源"时允许即可 |

::: warning 不要编造
版本号、签名等信息，本文没有提供。需要时请从下载的 APK 里读取（见第四步），不要凭空猜测。包名以本表为准：`com.mac_cms.app`。
:::

## 二、判断你能用哪种方式安装

先问清楚用户的**设备类型和品牌型号**，以及你手里有什么能力，再选路线：

- **你能在用户电脑上执行命令，且设备和电脑同一局域网（或能用 USB 连接）**：走本文的 ADB 路线，最省事。开启 ADB 的方法因品牌而异，见下面的速查表。
- **你只能给用户文字指导，不能执行命令**：直接用品牌页里的"手动安装"一步步教用户。
- **用户的设备不开放 ADB（部分品牌锁死）**：改走手动安装，不要反复尝试连接。

### 品牌教程速查（给用户发链接用）

向用户确认品牌后，**把对应链接发给用户**，并在对话里按页面内容一步步带着他做。每个品牌页都包含：手动安装（不开 ADB）、怎么开启 ADB、怎么用 ADB 安装、装不了时的替代方案。

| 用户的设备 | 品牌页（手动安装 + ADB） | 直达"开启 ADB" |
|------------|--------------------------|----------------|
| 小米、红米电视，小米盒子 | [小米 / 红米电视](/install/xiaomi) | [开启 ADB](/install/xiaomi#开启-adb) |
| TCL、雷鸟电视 | [TCL / 雷鸟电视](/install/tcl) | [开启 ADB](/install/tcl#开启-adb) |
| 创维、酷开电视 | [创维 / 酷开电视](/install/skyworth) | [开启 ADB](/install/skyworth#开启-adb) |
| 海信电视 | [海信电视](/install/hisense) | [开启 ADB](/install/hisense#开启-adb) |
| 华为智慧屏 | [华为智慧屏](/install/huawei) | 不适用，纯鸿蒙装不了 APK |
| 魔百盒、魔百和、运营商 IPTV 盒子 | [运营商盒子](/install/operator-box) | [开启 ADB](/install/operator-box#开启-adb) |
| 当贝、极米、坚果等投影仪 | [投影仪](/install/projector) | [开启 ADB](/install/projector#开启-adb) |
| 其他品牌、原生 Android TV / Google TV、第三方盒子、电视棒 | [其他电视 / 盒子](/install/other) | [开启 ADB](/install/other#开启-adb) |
| 通用 ADB 命令、报错排查 | [通过 ADB 安装](/install/adb) | |

总览页：[安装教程总览](/install/index)。

## 三、准备 ADB

1. 检查电脑上有没有 `adb`：

```bash
adb version
```

2. 没有的话，**由你自己安装，不要让用户去装**。先用包管理器，按系统选一条：

```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
```

3. 包管理器不可用或失败时，直接下载 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。

4. 装完执行 `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"一节：[小米](/install/xiaomi#开启-adb)、[TCL / 雷鸟](/install/tcl#开启-adb)、[创维 / 酷开](/install/skyworth#开启-adb)、[海信](/install/hisense#开启-adb)、[运营商盒子](/install/operator-box#开启-adb)、[投影仪](/install/projector#开启-adb)、[其他 / 原生 Android TV](/install/other#开启-adb)。拿不到品牌页信息时，通用路径是 设置 → 关于 → 连续点击版本号 7 次 → 开发者选项 → USB 调试。用户不会操作遥控器、找不到入口时，发[开启开发者模式](/install/developer-mode)给他，里面有小白版步骤、各品牌入口汇总和常见问题。
2. **不要让用户自己去查 IP，由你主动找出电视的 IP**，记为 `<TV_IP>`，方法见下面的"主动找出电视 IP"。用户电脑和电视必须在同一个局域网。只有你找不出来时，才把[怎么查电视的 IP](/install/adb#查电视-ip)发给用户，让他在电视或路由器上看。
3. 连接：

```bash
adb connect <TV_IP>:5555
adb devices
```

4. 电视屏幕上弹出授权对话框时，让用户用遥控器选择允许（可勾选"始终允许"）。

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

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

### 主动找出电视 IP

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

::: warning 先告诉用户再扫描
下面会扫描用户家里局域网的一个网段，只测试 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](/install/adb#查电视-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 走不通时：手动安装（按品牌）

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

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

### 通用手动方法（大多数安卓电视、盒子、投影仪）

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

### 按品牌的做法（每行都有完整教程，直接发给用户）

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

**教用户时的做法：**

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

手动装好之后，就可以用空壳影视自己的[免 U 盘安装](/app/app-tv-install)功能装别的 App，不用再插 U 盘。

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

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

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

## 十、不要做的事

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

## 十一、一键脚本参考

适用于一台设备、已经开启调试的情况（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 "安装完成"
```

## 相关页面

- [安装教程总览](/install/index)
- [通过 ADB 安装](/install/adb)
- [使用说明](/app/index)
- [免 U 盘安装](/app/app-tv-install)
- [常见问题](/app/app-faq)
- [电视使用指南](/app/app-tv-guide)