RedPot 用户手册 · 完整版

确认适用版本

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

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

• 查看安装包与 SHA-256

安装 RedPot

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

准备第一份系统

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

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

• 按步骤导入本机镜像

完成第一次使用

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

• 新建设备的完整步骤
• 了解状态与日常操作

更新前后检查

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

开始前需要什么

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

一步一步创建

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

内置规格参考

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

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

第一次启动后

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

• 使用键盘、鼠标与剪贴板
• 调整设备配置

认识精简控制中心

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

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

新增与查找设备

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

• 完整创建流程

状态和主按钮如何对应

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

关闭窗口、暂停与关机

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

重置运行状态与删除

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

• 备份前的检查
• 排查启动与黑屏

打开设置并判断能否修改

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

名称与常规信息

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

CPU 与内存怎么分配

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

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

分辨率、DPI 与窗口

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

机身存储和 SD 卡

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

• 机身存储扩容步骤
• SD 卡连接与容量调整

应用设置与重置

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

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

鼠标和触控板

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

键盘与中文输入

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

文本输入依赖当前设备的输入通道与 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. 结束使用时关闭启用选项并应用。导出按钮不可用或持续无设备时，记录当前构建和手机型号再反馈。

先选择正确对象

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

搜索、选择、检查并导入

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

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

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

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

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

检查失败时的处理顺序

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

从官网下载镜像

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

• 浏览系统镜像栏目
• 继续排查问题

准备目标设备与安装包

先启动目标设备，等待 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 内容的地址会失败。删除来源会移除来源登记，已经下载的包会保留。

理解安装详情与取消

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

失败时如何处理

更新、卸载与数据

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

• 查看当前 ADB 连接
• 保护与管理数据

先区分哪一层不能联网

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，检查目标地址的状态；后续命令明确选择该地址，避免操作错误设备。

adb devices

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

常见 ADB 状态

文件传输的边界

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

• 应用安装流程
• 准备可复现的反馈

找到真正的数据位置

默认数据目录为 ~/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. 要修改容量时，先将卡内重要文件导出。保存新容量会要求确认重新格式化；下次启动会清空卡内数据。

进行一致性备份

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

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

删除或卸载前

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

• 重置运行状态与删除的区别
• 获取恢复操作指导

邮箱登录与订单

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

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

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

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

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

购买与付款后检查

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

• 打开账号与授权

序列号、订单凭据与证书

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

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 文件可通过“导入离线证书”校验后激活，此兼容入口无需联网。

续费、到期、移除与换机

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

先记录现象，再处理

先记录 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. 旋转或物理键失败时，记录按钮提示与错误。应用可能锁定方向；不要把界面横竖比变化直接当成客体已旋转。

• 查看输入操作和前提

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

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

• 安装错误对照表
• 网络与 ADB 排查

付款或授权未生效

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

• 完整购买与激活流程

设备或文件看起来不见了

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

提交有效反馈

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

• 可直接填写的反馈模板
• 打开支持反馈

提交前准备

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

新建一条反馈

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

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

可复制的反馈模板

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

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

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

不要提交哪些内容

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

查看回复与补充信息

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

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

• 查看我的反馈

应用快捷键

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

• 文本编辑快捷键

常见术语

当前功能边界

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

按任务快速跳转

• 第一次安装
• 创建 Android
• 让设备真正关机
• 调整 CPU 与显示
• 导入系统
• 安装应用
• 备份设备数据
• 导入授权证书
• 排查故障
• 提交反馈