# NexControl 熟人试用教程（1.0.712）

> 适用：你已收到「Mac 安装包 + 手机 APK」，要在**自己的电脑**上被控、用**自己的手机**去控制。  
> 版本：1.0.712 · 内测 / 熟人 · 非应用商店版  

---

## 0. 先建立正确心智

| 端 | 是什么 | 装在哪 |
|----|--------|--------|
| **被控端（Host）** | 跑在电脑上，提供画面与键鼠 | **你自己的 Mac** |
| **控制端（手机 App）** | 看画面、操作电脑 | **你自己的手机** |

- 连接关系永远是：**手机 → 你的 Mac**。  
- **不要**用别人的地址 / PIN / 密钥去连别人的电脑。  
- **PIN** 是连上本机的主钥匙；**账号**是可选（方便多设备），不是必须。

---

## 1. Mac 端安装与启动

### 1.1 安装

1. 解压收到的 `NexControl-Console-1.0.712-mac.zip`。  
2. 将 **NexControl Console.app** 拖到「应用程序」。  
3. 若提示「无法验证开发者」：  
   - 右键 App → **打开** → 仍要打开；或  
   - 打开「终端」执行（路径按实际修改）：

```bash
xattr -cr "/Applications/NexControl Console.app"
```

### 1.2 首次打开

1. 双击打开 **NexControl Console**。  
2. 按系统提示授予（缺一不可，否则手机黑屏或无法控制）：  
   - **屏幕录制**  
   - **辅助功能**  
3. 在界面中点击：

**「一键启动本机被控并生成 PIN」**

系统会自动完成：

- 生成本机随机 **PIN 码**  
- 生成本机 **访问密钥（Access Key）**  
- 启动本机 Host 服务  
- 显示 **完整连接 URL**（通常带 `key=...`，必须整段复制）

### 1.3 你要抄下来的两样东西

| 项目 | 说明 |
|------|------|
| **完整连接 URL** | 含密钥的整串地址，不要只抄 IP |
| **PIN 码** | 手机连接时输入 |

界面一般有「复制 URL」「复制 PIN」按钮，优先点复制。

> 这些凭据只属于**你这台 Mac**，不会从别人机器带来。  
> 重启后通常会沿用已保存的 PIN/密钥，除非你主动重新生成或重装清掉。

---

## 2. 手机端安装

1. 将 `NexControl-1.0.712-android-debug.apk` 传到手机（隔空投送 / 网盘 / 数据线均可）。  
2. 用文件管理打开 → **安装**。  
3. 若拦截：系统设置 → 允许此来源安装未知应用。  
4. 打开 **NexControl**。

---

## 3. 手机如何连上自己的电脑

### 方式 A（推荐）：PIN 码连接

适合第一次使用、不想折腾账号。

1. 手机与电脑尽量在 **同一 Wi‑Fi**（家里最简单）。  
2. 打开 NexControl 连接页。  
3. 在「连接目标 / 服务器」中，**粘贴 Mac 上的完整连接 URL**。  
4. 选择 **「PIN 码」** 或 **「PIN 码连接」**。  
5. 输入 Mac 上显示的 **PIN**。  
6. 点连接。  

成功后应看到 Mac 桌面画面，可用手指操作（具体手势见 App 内说明）。

### 方式 B（可选）：账号登录并连接

适合希望少记 PIN、多台手机共用。

1. 在手机上 **注册并登录你自己的账号**（用户名 + 密码，至少 8 位密码）。  
2. 确认你的 Mac 上 Host **已启动**（Console 里一键启动过）。  
3. 点 **「账号登录并连接」**。  
4. 在「我的设备 / 主机列表」中点你的 Mac → **连接**。  

说明：

- 账号登录的是**当前你连的这台服务**上的账号体系。  
- **不要**登录别人的账号，也**不要**指望登录别人的服务就能控别人电脑。  
- 若设备列表为空：回到 Mac 确认 Host 在跑、权限已开，再刷新列表。

### 配对码（进阶，可选）

部分界面支持「配对码」：在 Mac 已登录账号的情况下生成短时码，手机输入配对码连接。熟人日常用 **PIN 即可**，可忽略。

---

## 4. 三种东西分别是什么？（必读）

| 名称 | 谁生成 | 干什么 | 能给别人吗 |
|------|--------|--------|------------|
| **完整连接 URL（含 key）** | 本机 Host 自动生成 | 告诉手机「连哪台服务」 | 只给你自己的手机；给别人 = 开门 |
| **PIN** | 本机 Host 自动生成 | 证明你有权控制这台 Mac | 只给你自己；**绝不要发群** |
| **账号（用户名密码）** | 你在 App 里注册 | 登录态、设备列表、少输 PIN | 只属于你自己 |

**结论：能自己生成 PIN —— 而且默认就是自动生成，不需要手写一套。**

---

## 5. 常见问题

### Q1：手机连不上？

- Mac 上 Host 是否仍在运行（Console 未退出）。  
- URL 是否**完整**（含 `key=` 时不要漏）。  
- PIN 是否抄错、是否区分大小写/空格。  
- 手机与电脑是否同一局域网；公司访客 Wi‑Fi 常隔离设备互访。  
- 防火墙是否拦截本机端口（默认常见为 9000 一带）。

### Q2：能连上但是黑屏？

- Mac「系统设置 → 隐私与安全性 → **屏幕录制**」勾选 NexControl / 终端并重启 App。  
- 再试连接。

### Q3：能看到画面但点不动？

- 打开「辅助功能」权限，允许控制电脑。  
- 重开 Console / Host 后再连。

### Q4：出门在外怎么连？

- 需要公网可达的地址（自建隧道 / 域名等），把 Host 暴露出去后再用**新的完整 URL**。  
- 内测阶段建议先在家里局域网跑通，再折腾公网。

### Q5：会不会登我的号就进别人电脑？

- 每个 Mac 的 Host 有自己的 PIN/密钥。  
- 服务端还有 **Host 授权账号名单**：别人的账号不能控制未授权的电脑。  
- 只要**不泄露自己的 PIN 和完整 URL**，别人不能控你的机。

### Q6：这是正式商店版吗？

- 否。手机为 **debug 内测包**，Mac 为 **ad-hoc 签名**。  
- 可能出现系统安全提示，按上文处理即可。  
- 公网远控仍可能偶发断线；客户端会尽量自动恢复，仍失败时重开 App 即可。

---

## 6. 推荐日常流程（一句话版）

1. **Mac**：打开 Console → 一键启动本机被控 → 复制 URL + PIN。  
2. **手机**：粘贴完整 URL → 输入 PIN → 连接。  
3. **安全**：PIN 和完整 URL 只给自己的设备，不转发、不截图发群。

---

## 7. 安装包文件名对照

| 文件 | 用途 |
|------|------|
| `NexControl-1.0.712-android-debug.apk` | 安卓控制端 |
| `NexControl-Console-1.0.712-mac.zip` | Mac 控制台（含本机被控能力） |
| `SHA256SUMS.txt` | 可选校验完整性 |

本地打包目录（开发者侧）：  
`remote-control/dist_packages/friend_handoff_1.0.712/`

---

## 8. 实操教学视频

| 文件 | 说明 |
|------|------|
| `dist_packages/friend_handoff_1.0.712/NexControl-使用教程-1.0.712.mp4` | 约 28 秒分镜教学（6 页：心智 → Mac 启动 → URL/PIN → 装 APK → PIN 连接 → 三句话） |
| `tutorial_video/` | 单页高清分镜 JPG，可单独发图 |

可与 APK / Mac zip 一并发给熟人。

---

*文档版本与客户端 1.0.712 对齐 · 2026-07-30*