# RedPot 用户手册

2026-10-30

先在“关于 RedPot”核对版本。公开 v0.1.0 与新版预览有不同的系统要求和功能入口。

https://redpot.top/handbook

## 01. 安装与首次使用

先确认版本与 Mac，再完成安装、系统准备和第一次启动。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 确认适用版本

本手册适用于 RedPot 0.3.3.11 的精简控制中心。先在“RedPot → 关于 RedPot”核对版本。

| 项目 | 当前公开下载 |
| --- | --- |
| 版本 | 0.3.3.11 · build 2026110118 |
| 处理器 | Apple Silicon（ARM64） |
| 最低系统 | macOS 26 |
| 系统镜像 | 不含内置镜像，需另行导入 |

免费版可长期使用，Pro 可在官网购买并通过序列号激活。磁盘需容纳系统镜像、设备数据和增长余量。

- [查看安装包与 SHA-256](https://redpot.top/news/public-download)

### 安装 RedPot

1. 从官网“下载 Mac 版”获取 DMG，核对文件名称和所选版本。不要用来源不明的重新打包文件。
2. 打开 DMG，将 RedPot.app 拷贝到“应用程序”。已有版本正在运行时，先将设备正常关机，再退出 RedPot 后替换应用。
3. 从“应用程序”打开 RedPot，阅读并接受用户协议。未接受协议时，不会进入设备控制中心。
4. 核对“关于 RedPot”中的版本。确认应用已复制完成后，可以推出 DMG。

> 提示：如果 macOS 阻止打开，请先记录完整提示并核对官网来源、版本和校验值。不要用关闭系统安全检查或删除设备数据的方式尝试修复。

### 准备第一份系统

带内置系统的安装包会在首次使用时准备本机镜像；这是解包、检查和复制，不是在下载 Android。无内置镜像的安装包需要先导入可用的本机系统。

1. 等待准备结束，查看成功提示或具体错误。准备时不要移动来源文件或耗尽磁盘空间。
2. 准备失败时，可按提示重试；也可进入控制中心，在新建窗口使用“重新准备内置系统”或“导入其他镜像…”。这些入口取决于安装包是否提供内置系统。
3. 检查系统是否显示可用。只有通过检查的系统才能用来创建新设备。

- [按步骤导入本机镜像](https://redpot.top/handbook/images#import)

### 完成第一次使用

1. 点击“新建设备”或使用 ⌘N，选择可用系统和适合 Mac 的配置。首次建议从“轻量”或“标准”开始。
2. 点击“创建并启动”，等待 Android 进入可交互界面。进程出现、画面出现与 Android 完成启动不是同一个阶段。
3. 按 Android 自己的首次设置提示完成初始化，然后尝试打开设置、输入文本和安装一个已知可用的 APK。
4. 用完后，在设备行“更多操作”中选择“关机…”，等状态变为已关机。关闭画面窗口只会收起窗口。

- [新建设备的完整步骤](https://redpot.top/handbook/first-device)
- [了解状态与日常操作](https://redpot.top/handbook/devices)

### 更新前后检查

- 更新前关机并备份重要数据；应用文件和设备数据分别保存。
- 更新后检查版本、设备列表、镜像和授权状态，再启动常用设备。
- 若设备列表突然为空，先检查当前数据位置与使用的产品版本。不要立即删除旧目录或重新创建同名数据。
- RedPot Park 是上游验证产品，与面向用户的 RedPot 有不同的数据和偏好域；不要把两个应用视为同一安装。

## 02. 创建你的第一台 Android

选择系统、资源与屏幕规格，并确认创建后的实际状态。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 开始前需要什么

- 已有一份通过检查的本机系统镜像，并且 Mac 满足该镜像与客户端的要求。
- 有足够宿主磁盘与内存余量。免费版最多同时运行 1 台；已有设备正在后台运行时，先正常关机。
- 为每个用途取易辨认的名字，例如“学习用 Android”“应用测试”。名称 1–64 个字符，不以点开头，不包含路径分隔符或控制字符。

### 一步一步创建

1. 在控制中心点击“新建设备”，或选择“文件 → 新建 Android…”（⌘N）。
2. 填写名称，从“系统镜像”选择可用系统。若选项不可用，阅读原因；没有可用系统时，先点“导入其他镜像…”。
3. 选择“轻量”“标准”或“自定义”配置。自定义时填写 CPU、内存 MB 和机身存储；1024 MB = 1 GB。
4. 独立选择屏幕预设；“自定义屏幕”需填写宽、高和 DPI。配置档与屏幕档可以分别选择。
5. 首次使用时，将“更多设置”中的额外内核参数留空。检查下方提示后点击“创建并启动”。
6. 创建成功后会打开设备窗口并尝试启动。回到设备列表核对状态；“创建成功”并不保证系统已经完成启动。

### 内置规格参考

| 选项 | CPU | 内存 | 机身存储 |
| --- | --- | --- | --- |
| 轻量配置 | 2 核 | 2048 MB | 32 GB |
| 标准配置 | 4 核 | 4096 MB | 64 GB |
| 自定义配置 | 受授权和宿主限制 | 以 MB 填写 | 16 / 32 / 64 / 128 / 256 GB |

| 屏幕预设 | 分辨率（像素） |
| --- | --- |
| 轻量手机 | 720 × 1600 |
| 手机 | 1080 × 2400 |
| 平板 | 1600 × 2560 |

这些是当前预览的预设值。以安装版本显示的规格为准；分辨率提高会增加渲染负担。给虚拟机更多资源不一定更快，先用真实任务验证。

### 创建按钮不可用或创建失败

| 现象 | 处理方式 |
| --- | --- |
| 系统不可选 | 查看缺失文件、图形环境或系统版本提示，先修复镜像条件。 |
| 名称或数字错误 | 修正名称；CPU 与内存使用正整数，内存单位为 MB。 |
| 超过免费额度 | 关闭其他运行设备，或降低 CPU / 内存到授权上限以内。 |
| 创建失败 | 保留表单中的信息，记录具体错误并检查磁盘与路径。不要连续重复点击。 |
| 设备已经出现，但启动失败 | 回到设备行检查错误并重试启动；不要为了再次启动重复创建设备。 |

### 第一次启动后

分别检查触控、键盘、网络和一个简单应用。为需要长期保存的账号或文件建立备份习惯。后续改名不会改变设备数据路径；更换系统请创建另一台设备，不要直接覆盖原设备的磁盘。

- [使用键盘、鼠标与剪贴板](https://redpot.top/handbook/input)
- [调整设备配置](https://redpot.top/handbook/configuration)

## 03. 控制中心与设备管理

看懂设备状态，正确启动、暂停、关机和处理异常。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 认识精简控制中心

控制中心使用单一精简布局，顶部栏目为“设备 / 镜像 / APK / 帮助 / 设置”。设备页可以按名称或设备 ID 搜索，并按全部、运行中、启动中、已暂停、已关机、需处理筛选。

- 双击设备行打开画面。齿轮打开设备设置，“更多操作”包含暂停、截屏、关机、强制停止和删除等操作。
- 操作不可用时，查看禁用提示或当前状态。正在处理的操作不能重复提交。
- 最近活动和安装详情用于查看本次会话的结果，不能作为长期保存的审计记录。需要留存时，退出前记录相关内容。

### 新增与查找设备

通过“新建设备”或 ⌘N 创建。保存设备的数量与允许同时运行的数量不同。免费版可以保留不同用途的设备，但需要依次运行。找不到设备时，先清除名称和状态筛选，再检查设置中的存储位置。

- [完整创建流程](https://redpot.top/handbook/first-device#create)

### 状态和主按钮如何对应

| 状态 | 含义 | 下一步 |
| --- | --- | --- |
| 已关机 / 启动失败 | 没有正常运行的设备会话 | 启动并打开；失败先查看原因 |
| 启动中 / 恢复中 | 仍在准备或启动系统 | 等待状态变化，勿反复启动 |
| 运行中 | 设备会话运行，可打开窗口 | 打开窗口或执行可用操作 |
| 已暂停 | 暂停执行，仍占用运行资源 | 恢复并打开 |
| 需处理 / 状态不一致 | 记录与实际进程状态不一致，或出现失败 | 按具体提示处理，不把它当作健康运行 |

设备进程存在不代表 Android 已经响应。画面、ADB、应用安装等能力可能比进程启动更晚就绪；启动时间取决于镜像、首次初始化和宿主资源。

### 关闭窗口、暂停与关机

| 动作 | 效果 |
| --- | --- |
| 关闭 Android 窗口 | 只关闭画面，设备继续在后台运行；不会释放并发名额。 |
| 关闭控制中心或最后一个窗口 | RedPot 仍可继续运行。用“窗口 → 控制中心”（⌘0）重新打开。 |
| 暂停 / 恢复 | 暂停计算后可恢复，仍占用内存和并发名额；不等同于关机。 |
| 锁屏 / 短按电源 | 作用于 Android 锁屏或唤醒，不是关闭虚拟机。 |
| 关机… | 请求 Android 保存数据并关闭；等待设备变为已关机。 |
| 强制停止… | 立即终止失去响应的设备，未保存数据可能丢失。 |

1. 在 Android 内保存正在编辑的内容，回到控制中心找到对应设备。
2. 打开“更多操作 → 关机…”，核对设备名称并确认。若保留默认设置，会先出现关机确认。
3. 等到已关机再启动另一台、改硬件或备份。只有普通关机无响应时，才考虑“强制停止…”。

### 重置运行状态与删除

“重置运行状态…”只会在已确认进程退出但记录残留的情况下提供。它清理过期运行记录并保留设备磁盘，不是 Android 恢复出厂设置，也不会修复已损坏的客体文件。

> 注意：“删除…”会删除该设备及其磁盘数据，无法撤销。先正常关机，并将重要数据导出或备份；仅为了释放并发名额时，关机即可。

- [备份前的检查](https://redpot.top/handbook/storage#backup)
- [排查启动与黑屏](https://redpot.top/handbook/troubleshooting#black-screen)

## 04. CPU、显示与设备设置

按任务调整规格，理解每个设置何时生效。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 打开设置并判断能否修改

1. 在设备行点击齿轮，或在 Android 窗口右侧点击“设备设置”。用搜索定位具体设置项。
2. 修改硬件前正常关机。运行、暂停、休眠或状态不一致时，硬件设置会锁定。
3. 若设备处于休眠，先恢复，再正常关机。不要删除恢复文件来绕过限制。
4. 保存后，下次启动使用新配置。打开窗口不会自动应用尚未保存的改动。

### 名称与常规信息

常规信息显示名称和设备数据位置。名称须为 1–64 个字符，不能以点开头或包含路径分隔符、控制字符。重命名只改变显示名称，不移动数据目录；用“在 Finder 中显示”查看实际位置。

### CPU 与内存怎么分配

| 新版额度 | Free | Pro |
| --- | --- | --- |
| 同时运行 | 1 台 | 5 台 |
| 单台 CPU 上限 | 4 核 | 32 核 |
| 单台内存上限 | 8 GB | 128 GB |

上限不是推荐配置，也不是宿主可提供资源的保证。内存输入单位是 MB，必须为正整数，并受 Mac 物理内存与授权约束。为 macOS 和其他应用留出余量。

1. 先运行默认配置下的真实任务，观察是否只是首次启动或安装阶段较慢。
2. 在 macOS 活动监视器中观察内存压力与交换使用；压力持续偏高时，减少并发或降低单台内存。
3. 每次只改变一个参数，并对比同一任务。应用兼容性和图形错误不能简单靠加内存解决。

### 分辨率、DPI 与窗口

- 宽和高决定 Android 的像素分辨率；DPI 影响界面元素的显示比例；对角线英寸用于屏幕规格配置。使用预设作为起点更容易排查。
- 拖动 Mac 窗口边缘只缩放显示区域，不会改变 Android 的分辨率。要改客体分辨率，关机后修改“显示”。
- 机身旋转使用窗口右侧旋转按钮；它与修改分辨率是两种操作。应用仍可能锁定自己的方向。

### 机身存储和 SD 卡

机身存储支持扩容，不支持缩容；扩容在下次启动时完成并保留应用和文件。SD 卡可连接或断开，断开会保留原内容；修改 SD 容量则会在下次启动时重新格式化。

> 注意：不要把 SD 容量调整当作无损扩容。保存前请阅读清空数据确认，并先备份卡内文件。

- [机身存储扩容步骤](https://redpot.top/handbook/storage#expand)
- [SD 卡连接与容量调整](https://redpot.top/handbook/storage#sd-card)

### 应用设置与重置

控制中心“设置”或“RedPot → 设置…”（⌘,）包含授权、关机前确认、实际存储位置、内置运行时、版本与协议。引擎路径只读，发布应用优先使用随包运行时。当前设置界面没有数据目录迁移向导。

“重置界面与用户协议”会恢复界面与确认偏好，并重新显示协议；保留设备、镜像、数据、存储位置和运行中的设备。它不会清空 Android。客户端语言跟随 macOS，官网右上角的语言开关只影响网站。

## 05. 画面、键盘与交互

使用触控模拟、中文输入、复制粘贴、截图和物理按键。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 鼠标和触控板

| 操作 | Android 中的作用 |
| --- | --- |
| 单击画面 | 点击当前位置，同时让画面获得输入焦点。 |
| 按住并拖动 | 拖动或滑动；长按效果取决于应用对按住的处理。 |
| 滚轮 / 触控板滚动 | 在指针位置模拟滑动；先将指针放在可滚动内容内。 |
| 按住 ⌘ 并拖动 | 模拟双指缩放；需要目标应用支持该手势。 |

如果按钮或手势无响应，先确认不是暂停或锁屏状态，再在 Android 画面内点击一次。物理按键不可用时查看按钮提示，不能把没有输入通道的状态视为应用卡死。

### 键盘与中文输入

1. 打开 Android 中的可编辑输入框，点击输入位置，使光标出现。
2. 使用 Mac 键盘输入；中文等输入法先完成候选词选择，再将已提交文本送入 Android。
3. 方向键、回车、删除和 Tab 可用于相应输入操作。若单个应用的自定义输入框不响应，先在 Android 设置中的普通文本框验证。

文本输入依赖当前设备的输入通道与 Android 侧支持。不要把模拟键盘当作完整游戏键位映射功能；本手册不承诺每个应用的快捷键或安全输入框都兼容。

### 文本复制和粘贴

| 快捷键 / 按钮 | 作用 |
| --- | --- |
| ⌘V / 粘贴到 Android | 将 Mac 剪贴板中的文本粘贴到当前 Android 输入框。 |
| ⌘C | 复制 Android 当前选中的文本到 Mac 剪贴板。 |
| ⌘X | 剪切可编辑区域中选中的文本。 |
| ⌘A | 在支持的当前输入区域中全选。 |
| ⌘⇧C | 读取 Android 剪贴板文本到 Mac；适用于已经在 Android 内完成复制的内容。 |

这些是文本操作，不是图片或任意文件同步。先确认画面有焦点、设备已启动且未暂停。粘贴没有内容时，先在 Mac 复制一小段纯文本再试；失败提示应保留用于排查。

### 导航与机身按键

- 画面下方的返回、主页、最近任务分别用于返回上一层、回到 Android 桌面和切换应用。
- 右侧提供锁屏、音量加减、截屏、旋转、安装 APK、粘贴、USB 投屏和设备设置；实际可用状态取决于设备。
- “Android → 按键”还提供长按电源等操作。电源键作用于 Android；要停止虚拟机请使用“关机…”。

### 截图并保存

1. 确认目标 Android 窗口，点击右侧“截屏”，或从该设备的“更多操作”选择“截屏”。
2. 成功后，生成的 PNG 会用 Mac 默认图片应用打开。截图最初位于临时目录。
3. 需要长期留存或提交反馈时，在图片应用中另存或导出到自己的文件夹。分享前遮挡账号、二维码和其他私人信息。

> 提示：截屏失败时不要把旧画面当成新结果；记录提示，并确认当前设备确实提供截屏能力。

### USB 投屏到实体 Android 手机

提供此入口的开发预览，可将 RedPot 设备画面串流到实体 Android 接收端并回传触控。它不是将手机整个系统导入 RedPot，也不是通用 USB 设备透传。硬件、接收端和当前构建必须支持。

1. 启动 RedPot 设备，打开右栏“USB 投屏”。若“导出 Android 接收端 APK…”可用，导出并在自己的实体手机上安装接收端。
2. 使用支持数据传输的 USB 线连接手机，按手机实际提示处理接收端授权。在对话框中刷新并选择目标手机。
3. 启用投屏，选择码率与帧率后点击“应用”，观察链路状态和错误。设定的帧率不是实际达到帧率的保证。
4. 结束使用时关闭启用选项并应用。导出按钮不可用或持续无设备时，记录当前构建和手机型号再反馈。

## 06. 系统镜像的准备与导入

分清系统与应用，检查镜像完整性，导入到独立本机资料库。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 先选择正确对象

系统镜像用于创建 Android 设备；APK 是安装到已运行 Android 中的应用。不要把 APK 放进系统导入窗口，也不要把固件 ZIP 当成可直接安装的 Android 应用。

| 来源形式 | 当前预览如何处理 |
| --- | --- |
| RedPot / Redroid 目录 | 检查 kernel 和 img.raw 等需要的文件以及运行条件。 |
| 已准备好的 Google 镜像 | 检查 Image、initrd.cpio、system.img、vendor.img、userdata.img、metadata.img、cache.img 及兼容条件。 |
| Android Studio 系统镜像目录 | 识别受支持的镜像，导入时在独立副本中准备内核、ramdisk、可写盘与兼容补丁。 |
| 独立 .img / img.raw | 只有检查识别且能配对兼容 ARM64 内核时才能继续；扩展名本身不是兼容保证。 |

> 提示：请从有权使用的来源取得镜像，并遵守其许可。导入器识别某个文件不表示所有厂商 ROM、Google 服务或应用都经过兼容验证。

### 搜索、选择、检查并导入

1. 在控制中心点击“导入镜像”，或在新建窗口点击“导入其他镜像…”。
2. 在“本机搜索”查看镜像库、Android SDK、下载目录等已发现的候选项。搜索不完整时使用“指定文件夹…”。
3. 选择镜像目录进行子目录扫描；当前预览的选择器也接受独立 .img 文件。也可把目录或 .img 拖到导入窗口指定区域。
4. 选中候选项，阅读识别结果、缺失文件与兼容提示，点击“检查并导入”。
5. 等待完成。系统会检查并写入独立本机镜像库；支持的 Google 镜像会在副本上处理兼容补丁，不修改原文件。
6. 返回镜像页或新建窗口，确认该系统可用后再创建设备。

这是本机导入流程，不是镜像下载器。界面以“检查并导入”等真实阶段提示工作；没有百分比时，不代表卡住，也不要根据文件名猜测成功。

### 镜像、原始文件与设备数据

成功导入后，镜像库不依赖原始来源文件夹；创建的设备又拥有自己的可写数据。移走最初下载的文件不等于删除设备，但不要在 Finder 中手动删除当前镜像库或设备引用的文件。

同一个系统可用于创建用途不同的设备。要尝试另一份系统，请新建独立设备；镜像导入不会把已有设备自动升级成新系统。

### 检查失败时的处理顺序

1. 读出完整错误：是来源缺文件、无法读取、缺内核，还是宿主系统或图形环境不满足。
2. 返回原始来源核对是否解压完整、选对目录，以及镜像架构是否适合当前 Mac。压缩包下载完成不等于系统文件已经齐全。
3. 检查目标存储空间与目录访问权限，然后重新检查。不要通过随意改名或伪造文件绕过校验。
4. 仍失败时，提交镜像来源、系统版本、文件清单和错误文本；无需上传整份大镜像或包含私人数据的磁盘。

### 从官网下载镜像

在官网资源页打开百度网盘，输入提取码 hmkz，在「系统镜像」文件夹下载 Google - Android 17.zip。解压后，在 RedPot 的「系统镜像 → 导入镜像」中选择完整文件夹。网盘中的使用说明与校验文件可用于核对下载内容。

- [浏览系统镜像栏目](https://redpot.top/resources#system-images)
- [继续排查问题](https://redpot.top/handbook/troubleshooting)

## 07. APK 安装与应用管理

从本地文件、直链或公开来源安装，并核对每个应用的结果。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 准备目标设备与安装包

先启动目标设备，等待 Android 与安装通道就绪。处于暂停、停止中或状态异常的设备不能作为正常安装目标；如果已在安装，等待当前批次完成。

- 本地支持 .apk，以及包含同一应用所需 APK 分包的 .zip；本地校验上限为 1000 MiB，分包解压后的 APK 总量也受此限制。
- 不要把任意 ZIP、系统固件或多个不相关应用打包成一次分包安装；.xapk / .apks 并不是此入口承诺的直接支持格式。
- 应用是否可运行仍取决于 Android 版本、CPU 架构、图形、Google 服务及应用自身限制。安装成功只证明安装结果。

### 安装本地文件

1. 确认要安装到哪台设备。将一个或多个 APK 拖到该设备的 Android 画面，可直接进入这台设备的安装队列。
2. 也可点击 Android 右栏“安装 APK”选择文件；拖到控制中心时，则按选择窗口指定目标设备。
3. 在“APK → 本地”导入文件是登记到本地列表；随后选择条目与目标设备安装。登记完成不等于已经装进 Android。
4. 查看设备行的结果，打开“安装详情…”核对每个文件。最后在 Android 内找到应用并打开验证。

### 下载直链与公开来源

1. 打开“APK → 远端”。单个文件使用“APK 链接”入口，填写名称和公开的 http(s) .apk 地址。
2. 添加一组应用时，使用“添加来源”，填写来源名称与公开 index.json 仓库地址，再点“验证并添加”。
3. 验证通过后可搜索应用名或包名，并按来源筛选。使用“检查更新”刷新来源索引；它不会自动更新 Android 内已安装的应用。
4. 先从远端条目下载到本地，再选设备安装。下载中、下载完成和安装完成是不同阶段。

当前来源入口面向可匿名访问的公开仓库，不代存登录 Cookie 或令牌。返回登录网页、HTML 错误页或无效 APK 内容的地址会失败。删除来源会移除来源登记，已经下载的包会保留。

### 理解安装详情与取消

| 状态 / 操作 | 说明 |
| --- | --- |
| 排队中 | 尚未开始当前包。 |
| 正在下载 | 正在取得远端文件，不编造百分比。 |
| 正在安装 | 已进入当前应用的安装步骤。 |
| 已完成 / 失败 / 未装 | 逐项查看回执或原因，不用一条总提示代替所有结果。 |
| 取消后续安装 | 请求跳过尚未开始的应用，当前安装会继续收尾。 |
| 清空已结束记录 | 只清除已经结束的记录，不取消未完成任务。 |

关闭安装详情窗口不会中断安装。记录保留至退出应用；需要反馈时，请在退出前保存错误文本。

### 失败时如何处理

| 提示或现象 | 建议操作 |
| --- | --- |
| 目标未就绪 / ADB 不可用 | 恢复或启动设备，等 Android 完成启动，再查看“ADB 连接”中的当前端口。 |
| 架构或 SDK 不兼容 | 核对 APK 支持的架构和 Android 最低版本，更换适配的包或系统。 |
| 签名冲突 / 不允许降级 | 优先使用同一开发者签名的新版本。若必须卸载旧版，先导出应用数据；卸载可能清除数据。 |
| 空间不足 | 检查 Android 内部存储与 Mac 实际磁盘。必要时先备份，再扩容机身存储。 |
| 安装成功但无法启动 | 记录应用版本、系统镜像、复现步骤与画面；不要重复安装来代替兼容性排查。 |

### 更新、卸载与数据

更新时优先使用同一来源与签名的包，并检查安装详情。卸载应用在 Android 内的应用设置中完成；从 Mac 的 APK 列表删除或移走安装包，不等于卸载设备内的应用。卸载、清除应用存储和删除整个设备是三种不同的数据操作。

- [查看当前 ADB 连接](https://redpot.top/handbook/network#adb)
- [保护与管理数据](https://redpot.top/handbook/storage)

## 08. 网络与 ADB 连接

判断联网问题，找到正确的本机 ADB 端口并连接。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 先区分哪一层不能联网

Mac 能联网，不代表 Android 内的每个应用都能访问同一服务。先分别检查 Mac 浏览器、Android 浏览器和出问题的应用，记录失败发生在哪一层。

1. 确认 Mac 网络工作正常，再用 Android 中一个已知可访问的地址测试。
2. 若只有某个应用失败，检查应用自身账号、服务状态、权限与版本，不要先重建整台设备。
3. 若所有 Android 网络访问失败，记录设备状态、镜像、网络提示与 Mac 当前 VPN / 代理环境，正常关机后重试。

> 提示：设备设置中的“网络”页展示保存的配置，只读信息不等于实时网络连通检查。不要据此判断“已经联网”。

### 连接这台设备的 ADB

普通启动和图形界面安装 APK 不要求你手工输入 ADB 命令。以下流程适合需要调试或按支持人员指引收集信息的用户；终端中需已经可用 adb。

1. 启动目标设备并等待 Android 就绪。打开该设备“设备设置 → 连接 → ADB 连接”。
2. 读取当前显示的 127.0.0.1 地址与端口，点击复制命令。端口被占用时，下一次启动可能改用其他端口。
3. 在 Mac 终端粘贴并执行该页给出的完整 adb connect 命令。不要照抄其他设备或旧截图中的端口。
4. 执行 adb devices，检查目标地址的状态；后续命令明确选择该地址，避免操作错误设备。

```text
adb devices
```

本手册不提供固定端口范例，正确端口以当前设备界面为准。这里的回环地址用于这台 Mac 本机，不是供另一台电脑或手机直接连接的公网地址。

### 常见 ADB 状态

| 状态 | 检查 |
| --- | --- |
| connection refused / 无法连接 | 确认设备没有关机或暂停，重新读取当前端口，等待 Android 启动。 |
| offline | 等待就绪，核对是否连到旧端口；必要时断开该目标后用当前命令重连。 |
| unauthorized | 查看 Android 画面是否有调试授权提示，确认目标和操作后再处理。 |
| more than one device / 多设备 | 在命令中显式指定当前设备地址，避免使用未指定目标的调试命令。 |
| 终端找不到 adb | 这只是终端工具未安装或不在搜索路径；不代表 RedPot 设备本身损坏。 |

### 文件传输的边界

将文件拖到 Android 画面时，当前公开说明的入口是 APK 安装。不要期待任意文档、照片或目录自动变成共享文件夹。普通文件可使用 Android 应用自己的导入导出方式；高级用户可使用已连接的 ADB，但要先核对目标和目标路径。

- [应用安装流程](https://redpot.top/handbook/apps)
- [准备可复现的反馈](https://redpot.top/handbook/support)

## 09. 存储、SD 卡与数据保护

分清容量与占用，在扩容、备份和删除前保护重要数据。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 找到真正的数据位置

默认数据目录为 ~/Library/Application Support/RedPot。实际位置可能受已有配置影响，所以以控制中心“设置”显示的路径为准，使用“在 Finder 中显示”打开；单台设备设置也能显示自己的数据位置。

应用、镜像库、每台设备的磁盘和临时安装文件是不同对象。仅替换 RedPot.app 不等于删除 Android 数据；反过来，只复制应用也不是设备备份。当前界面未提供一键迁移整个资料库。

### 虚拟容量与 Mac 实际占用

“64 GB 机身存储”描述 Android 可使用的逻辑容量，不是保证 Mac 立刻或永远只占用某个固定值。系统镜像、可写数据、SD 卡和备份会分别占空间；后续安装应用和写入文件会增加宿主占用。

- 同时查看 Android 内部存储和 Finder 中 Mac 磁盘剩余空间。任一侧不足都可能导致安装或写入失败。
- 虚拟磁盘扩容不会增加 Mac 的真实剩余容量；不要在宿主磁盘已满时靠扩大虚拟容量解决。
- 清理前先辨认下载副本、安装包与正在使用的设备数据，避免手工删除活动目录里的磁盘文件。

### 扩大机身存储

1. 备份重要内容，然后正常关机。确认该设备不处于暂停、休眠或异常状态。
2. 打开“设备设置 → 硬件 → 机身存储”，选择比当前更大的可用容量。
3. 保存设置并重新启动。扩容会在下次启动时执行，原有应用和文件应保留。
4. 在 Android 存储设置中核对容量与文件；若出现错误，记录提示，不要反复修改磁盘文件。

> 提示：当前支持增大，不支持缩小机身存储。备份可以防范磁盘故障或中断，不能省略关键数据的保护。

### 连接、断开与调整 SD 卡

1. 先关机，打开“设备设置 → 硬件 → SD 卡”，勾选“连接 SD 卡”并选择容量。
2. 保存并启动，在 Android 内检查卡是否可用；客体系统可能显示自己的存储初始化提示。
3. 只想暂时不使用时，关机后取消连接并保存。此操作保留卡内内容；以后按同容量重新连接可复用。
4. 要修改容量时，先将卡内重要文件导出。保存新容量会要求确认重新格式化；下次启动会清空卡内数据。

> 注意：SD 卡改容量会清空数据；机身存储扩容保留数据。两者的行为不同，请在点击确认前核对设置页面与设备名称。

### 进行一致性备份

1. 先在 Android 内导出最重要的文件，完成正在进行的应用操作。
2. 逐台正常关机，确认没有运行或暂停的设备。休眠设备应恢复后再正常关机。
3. 记录 RedPot 版本、实际数据目录和使用的系统镜像，再退出客户端。
4. 使用自己的备份工具复制完整数据目录及实际引用的外部文件，保留相对结构、权限和时间信息。确保备份目标有足够空间。
5. 确认备份可读取，保留原件。恢复到不同位置或另一台 Mac 可能涉及路径与运行环境差异，应先保留副本并获取具体指导。

这是一份关机状态的数据备份建议，不是产品提供的导出/导入向导，也不是内存快照。当前硬件加速设备不支持内存快照或休眠；Pro 也不会把未提供的模板分叉功能自动打开。授权证书绑定机器，复制数据不会转移授权。

### 删除或卸载前

删除单台设备会删除它的磁盘且不能撤销。卸载 RedPot 应用本身与清理独立数据目录是两步；不确定某个目录用途时先保留。重装应用不能代替备份，也不应把清空全部数据作为一般故障处理的第一步。

- [重置运行状态与删除的区别](https://redpot.top/handbook/devices#recovery)
- [获取恢复操作指导](https://redpot.top/handbook/support)

## 10. 账号、购买与客户端激活

从邮箱登录、订单核对到本机绑定，分清序列号与授权文件。

> 适用于当前官网服务；证书导入需使用支持该功能的新版客户端。公开购买状态以授权页为准。

### 邮箱登录与订单

1. 打开官网“账号与授权”，填写购买邮箱，完成安全验证后点击发送验证码。验证未通过时不会发送邮件。
2. 输入收到的 6 位验证码并“登录 / 注册”。验证码有效期为 10 分钟；重发需等待 60 秒。优先使用最近收到的有效验证码。
3. 登录后查看自己的订单和授权。更换邮箱登录不会自动合并另一个账号的历史订单。

免费使用客户端不要求购买 Pro。官网登录用于订单、授权和反馈；离线证书激活不等同于在客户端输入邮箱密码。

### 免费与 Pro、月订阅与年订阅

| 项目 | Free | Pro |
| --- | --- | --- |
| 使用期限 | 长期免费 | 按月订阅或年订阅有效期 |
| 并发 / 单台上限 | 1 台 / 4 核 / 8 GB | 5 台 / 32 核 / 128 GB |
| 绑定方式 | 不需要付费证书 | 均支持 3 台 Mac，每台分别签发证书 |

当前定价：月订阅折扣价 ¥9.9、正价 ¥19.9；年订阅折扣价 ¥99、正价 ¥199。两种订阅均支持 3 台 Mac。是否开售、当前售价和支付方式以授权页及订单确认为准。

月订阅和年订阅的有效期分别从确认支付起计算 1 个和 12 个日历月；月底日期按目标月份最后一天截断。两种订阅的 Pro 资源额度相同，各台 Mac 共用订单到期时间。已有订单保留原购买价格、期限和授权台数。

### 购买与付款后检查

1. 先登录账号，选择实际开放的方案，核对价格、有效期和收款方，再创建订单。
2. 按订单页面提供的支付宝或微信流程自行完成付款。过期二维码需重新生成有效订单，不要给陌生收款方付款。
3. 返回官网查看订单状态，以服务器确认“已支付”为准。付款页关闭、扫码成功或看到二维码都不等于到账。
4. 若支付应用显示成功而官网仍待支付，先保留订单号与交易时间并刷新查询；不要立即重复购买。需要时通过支持反馈核对。

- [打开账号与授权](https://redpot.top/license)

### 序列号、订单凭据与证书

| 内容 | 用途 |
| --- | --- |
| RP-… 序列号 | 在新版客户端输入即可激活，也可通过官网按钮唤起客户端自动绑定。 |
| .redpot-order | 购买订单凭据，不是设备授权证书。 |
| 机器码 | 客户端自动读取并用于本机绑定，无需在网站填写或复制。 |
| .redpot-license | 客户端自动获取并验证的签名授权文件；已有文件也可离线导入。 |

> 提示：保存好序列号与证书，不要发布到公共截图、帖子或反馈正文。证书内容不能通过改扩展名、修改到期时间或替换机器码来合法转移。

### 从官网回到客户端，一键绑定

1. 在准备使用 Pro 的 Mac 上安装官网当前版本 RedPot 0.3.3.11。
2. 在官网订单中点击“回到 RedPot 激活”；已有序列号也可在“已有序列号”页签中输入后点击该按钮。
3. 允许浏览器打开 RedPot。客户端自动识别本机、申请授权并校验证书；完成后弹出“绑定成功，Pro 已激活”。
4. 新订阅支持 3 台 Mac，同一台重复激活不额外占名额。链接 5 分钟有效，过期后回网站重新点击；未能唤起客户端时可复制序列号手动激活。

### 在客户端输入序列号

1. 打开 RedPot → 授权，粘贴完整的 RP-… 序列号。
2. 点击“激活授权”，保持网络连接。无需填写本机机器码。
3. 客户端完成绑定、签名和有效期校验并保存后，会弹出绑定成功提示。失败时请按提示重试，已有授权会保留。
4. 已有 .redpot-license 文件可通过“导入离线证书”校验后激活，此兼容入口无需联网。

| 校验失败 | 处理 |
| --- | --- |
| 文件类型 / 内容错误 | 核对完整序列号；导入离线证书时请使用原始 .redpot-license，不使用订单凭据。 |
| 机器不匹配 | 在当前 Mac 输入序列号重新激活；不要导入其他 Mac 的证书。 |
| 签名失败 | 使用官网原始文件重新下载；仍失败时记录错误并联系支持。 |
| 过期 / 时间异常 | 检查证书有效期与 Mac 正确日期；不要用回拨时钟延长授权。 |

### 续费、到期、移除与换机

- 到期后可按当时官网价格购买新的月订阅或年订阅，不自动扣费。新订单有效期从付款起算，不自动叠加旧证书时长；按新订单签发并核对有效期。
- 到期或移除授权不会删除设备与数据，也不会自动结束当前运行进程；后续启动按免费额度检查。
- “移除本机授权…”只移除本地激活，不会解绑官网机器，也不是把席位转给另一台 Mac。
- 当前离线证书流程没有自助换机解绑、在线席位释放或即时远程吊销。需要换机或机器码变化时，通过支持反馈核对处理。
- 证书可离线验证，但首次购买、网站签发与重新下载需要联网。请保持 Mac 系统时间准确。

## 11. 常见问题与故障排查

先确认失败发生在哪一步，再按最小影响顺序处理。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 先记录现象，再处理

先记录 RedPot 与 macOS 版本、Mac 芯片和内存、使用的系统镜像、设备规格、完整错误和发生时间。把问题区分为应用打不开、镜像导入、设备启动、输入、网络、安装或授权。每次只改一个条件，保留前后结果。

### 安装后打不开

1. 当前公开版本要求 Apple Silicon 和 macOS 26 或更新版本。
2. 确认应用已复制到“应用程序”，没有仍在旧 DMG 中打开另一份同名应用。
3. 记录 macOS 的完整提示；核对官网安装包与校验值，必要时重新下载同一版本。
4. 仍无法启动时提交版本和提示。此阶段不要先删除 Android 数据目录。

### 启动失败、一直启动中或黑屏

1. 查看设备行是否运行、暂停、需处理或已失败。暂停先恢复；锁屏先短按电源唤醒。
2. 确认镜像已通过检查、CPU / 内存符合额度、Mac 有磁盘与内存余量。
3. 进程启动后 Android 可能仍在初始化。记录持续时间与状态变化，不依据固定秒数判断成功。
4. 若画面不刷新但设备仍有响应，可关闭并重新打开该画面窗口。若整台设备无响应，先尝试普通关机。
5. 只有普通关机无效才考虑强制停止，并接受未保存数据可能丢失。进程已退出但记录残留时，使用提供的“重置运行状态…”。
6. 保留错误、镜像来源及复现步骤。不要直接覆盖 disk.raw 或把另一份系统写进原设备。

### 关闭窗口后仍然超过额度

关闭窗口、隐藏应用或暂停设备都不会释放并发名额。返回控制中心，用“运行中 / 已暂停”筛选找到后台设备，执行普通关机并确认已关机。若仍超过额度，查看本机授权是否已激活、到期或移除，以及单台资源是否高于当前额度。

### 无法输入、粘贴或旋转

1. 确认目标窗口和输入框有焦点，设备未暂停，Android 不是停留在锁屏。
2. 先在普通 Android 文本框测试短文本，再测试出问题的应用，以区分系统输入和应用自身限制。
3. 粘贴只处理文本；Mac 剪贴板为空、只有图片或文件时不会得到预期文本。
4. 旋转或物理键失败时，记录按钮提示与错误。应用可能锁定方向；不要把界面横竖比变化直接当成客体已旋转。

- [查看输入操作和前提](https://redpot.top/handbook/input)

### 应用无法下载、安装或运行

下载失败先检查链接是否为公开安装文件；安装失败查看“安装详情…”逐项原因；安装成功但无法运行则核对架构、Android 版本、图形与应用服务依赖。不要把三种失败统一当成“APK 坏了”。

- [安装错误对照表](https://redpot.top/handbook/apps#result)
- [网络与 ADB 排查](https://redpot.top/handbook/network)

### 付款或授权未生效

1. 官网确认已登录购买时的邮箱，订单状态确实为已支付。只有扫码或打开收银台不算成功付款。
2. 在目标 Mac 的 RedPot → 授权输入序列号，或从官网点击“回到 RedPot 激活”，客户端会自动识别本机。
3. 在客户端选择文件、等校验通过后点击“激活授权”，最后核对档位。
4. 若显示机器不匹配、过期或签名错误，按错误处理，不修改证书正文。

- [完整购买与激活流程](https://redpot.top/handbook/activation)

### 设备或文件看起来不见了

- 先清空搜索与状态筛选，并检查控制中心设置里的实际数据位置。
- 确认打开的是 RedPot 而不是 RedPot Park 或另一份安装。改名不会移动数据路径。
- 断开的 SD 卡内容会保留，但需要按原容量重新连接；修改容量导致的格式化不能用重新连接撤销。
- 保留现存目录和备份，先请求具体恢复指导。不要在可能包含原数据的位置创建替代文件。

### 提交有效反馈

经过上述检查仍无法解决时，把最少可复现步骤、预期结果、实际结果和完整错误提交到官网支持。注明尝试过哪些操作，尤其是强制停止、SD 容量修改或版本更新。

- [可直接填写的反馈模板](https://redpot.top/handbook/support#template)
- [打开支持反馈](https://redpot.top/support)

## 12. 获取支持与提交反馈

说明问题、补充进展，并在账号中查看回复。

> 适用于当前官网服务；证书导入需使用支持该功能的新版客户端。公开购买状态以授权页为准。

### 提交前准备

- 查看与问题对应的手册章节，保留完整错误文本和最少复现步骤。
- 记录 Mac 芯片、内存、macOS 与 RedPot 版本、镜像、设备配置和 APK 版本。只提供与问题有关的信息。
- 截图可先保存在本机作为证据。当前网页反馈不支持附件，可将已脱敏的错误文本写入正文。

### 新建一条反馈

1. 打开“支持反馈”，用官网邮箱验证码账号登录。已登录时核对页面显示的账号。
2. 选择最贴近问题的分类：安装与启动、设备与性能、应用与镜像、购买与授权、功能建议或其他问题。
3. 写一个明确标题；在环境字段记录版本和设备。在正文填写复现步骤、预期与实际结果。
4. 提交后检查成功提示，并到“我的反馈”核对新条目。超时或网络异常时先刷新列表确认是否已创建，避免重复提交。

标题 3–100 字；环境最多 300 字；正文 10–1800 字。每个账号每天最多新建 5 条。一个问题尽量保留在同一条反馈内，补充信息使用回复。

### 可复制的反馈模板

```text
问题标题：
Mac 芯片 / 内存：
macOS / RedPot 版本：
系统镜像 / Android 版本：
设备 CPU / 内存 / 存储：
应用名称与版本（如相关）：

复现步骤：
1.
2.
3.
预期结果：
实际结果与完整错误：
发生时间与频率：
已经尝试的处理：
```

错误很长时保留最相关的一段，并说明发生在创建、启动、安装还是激活阶段。不要为了凑长度重复粘贴日志。

### 不要提交哪些内容

- 不提交密码、邮箱验证码、支付二维码、完整序列号、授权证书或机器私钥。
- 付款问题提供订单号、时间、金额和实际提示即可；不要发送银行卡信息或支付口令。
- 日志和截图中的账号、手机号、聊天内容、私人文件路径应先脱敏。反馈与账号关联，用于处理该问题。

### 查看回复与补充信息

1. 使用同一邮箱登录，打开“我的反馈”，展开相应问题查看状态和消息。
2. 用“刷新”获取新结果，需要时加载更多历史记录。切换到其他邮箱不会显示本账号的问题。
3. 在原反馈中补充测试结果与变化。补充消息会让问题重新进入待处理状态。

回复目前在网页内查看，不发送回复邮件提醒，也没有固定响应时间承诺。不要把未收到邮件理解为没有回复。

- [查看我的反馈](https://redpot.top/support#my-feedback)

## 13. 快捷键与术语速查

快速找到常用操作，区分容易混淆的几个概念。

> 适用于 RedPot 0.3.3.11 · Apple Silicon · macOS 26 或更新版本。

### 应用快捷键

| 快捷键 | 操作 |
| --- | --- |
| ⌘N | 新建 Android |
| ⌘0 | 显示控制中心 |
| ⌘, | 打开应用设置 |
| ⌘R | 启动当前 Android 窗口对应设备 |
| ⌘⇧P | 暂停 / 恢复当前设备 |
| ⌘⇧H | 请求当前设备关机 |
| ⌘H | 隐藏 RedPot 应用 |
| ⌘⌥H | 隐藏其他应用 |
| ⌘Q | 退出 RedPot；重要工作先保存并正常关机 |

Android 菜单的设备动作针对当前活动的 Android 窗口；窗口不明确或没有可用目标时，先点击目标窗口。可用性仍受设备状态约束。⌘ 表示 Command，⇧ 表示 Shift，⌥ 表示 Option。

- [文本编辑快捷键](https://redpot.top/handbook/input#clipboard)

### 常见术语

| 术语 | 含义 |
| --- | --- |
| 宿主 / 客体 | 宿主是 Mac；客体是 RedPot 内运行的 Android。 |
| 系统镜像 | 创建 Android 环境使用的基础系统文件，不是应用安装包。 |
| 设备 / 实例 | 由某份系统创建的独立 Android 环境，拥有自己的可写数据。 |
| APK / 分包 | Android 应用包；同一应用可能由基础包和配置分包组成。 |
| 并发 | 同一时间运行的设备数，不是保存的设备总数。 |
| 暂停 / 关机 | 暂停保留运行资源；关机结束运行并释放运行名额。 |
| DPI | Android 显示密度设置，影响界面元素缩放。 |
| ADB | Android 调试连接，用于安装与诊断等操作；端口以当前设备为准。 |
| 序列号 / 证书 | 序列号用于网站绑定；签名证书文件用于目标 Mac 的离线验证与激活。 |
| 快照 / 关机备份 | 内存状态快照与停止运行后复制数据不同，不能互相等同。 |

### 当前功能边界

- 本手册覆盖 RedPot 0.3.3.11 的 macOS 精简控制中心。
- 系统导入使用本机文件；网站唤起客户端不表示自动下载系统。
- 硬件加速设备不提供内存快照或休眠；Pro 不承诺模板分叉、无限并发或任意应用兼容。
- 备份与恢复不是一键迁移；机器绑定授权不能通过复制数据目录转移。
- 官网支持目前是账号内文字反馈与回复，不支持附件和回复邮件通知。

### 按任务快速跳转

- [第一次安装](https://redpot.top/handbook/getting-started)
- [创建 Android](https://redpot.top/handbook/first-device)
- [让设备真正关机](https://redpot.top/handbook/devices#windows)
- [调整 CPU 与显示](https://redpot.top/handbook/configuration)
- [导入系统](https://redpot.top/handbook/images#import)
- [安装应用](https://redpot.top/handbook/apps#local)
- [备份设备数据](https://redpot.top/handbook/storage#backup)
- [导入授权证书](https://redpot.top/handbook/activation#activate)
- [排查故障](https://redpot.top/handbook/troubleshooting)
- [提交反馈](https://redpot.top/support)