


# 为了让 AI 跑在自己的手机上，我给 nl2sh-helper 加了一个通知配对入口
![nl2sh-helper-1.png](https://developer.qcloudimg.com/http-save/yehe-2988206/a8e75642bb58ff8a09de1a0a4001283d.png)

让手机连接自己，听起来应该比连接另一台手机更简单。

但在给 nl2sh-helper 增加本机部署功能时，真正卡住流程的，是 Android 的两个界面问题：**系统设置不能分屏，切换应用后配对窗口消失；加了配对浮窗，进入无线调试页面后，浮窗又消失了。**

最后，让这条流程跑通的，是一个大家每天都在使用的入口：通知栏。

这篇文章，就聊聊为什么要增加这个功能，以及从分屏、浮窗到通知配对的适配过程。

## 为什么要让 nl2sh-helper 在本机部署 nl2sh？

先简单介绍一下这两个项目。

**nl2sh** 是一个运行在 Android Shell 环境中的 AI Agent。你可以通过自然语言提出任务，由它调用工具、检查设备信息、处理文件，并通过 TUI 或 Web 界面与它交互。

**nl2sh-helper** 则是 Android 端的安装和启动助手：连接设备，下载并校验 nl2sh，部署程序，启动服务，再打开 Web 界面。

之前，助手已经可以连接另一台 Android 设备。比如用手机 A 给手机 B 安装并启动 nl2sh。

但对大多数想体验项目的用户来说，一个更自然的需求是：


> 我只有这一台手机，能不能直接在这台手机上安装和运行 nl2sh？

如果还要找电脑、准备 ADB、下载对应架构的程序，再逐条输入部署命令，尝试一个项目的门槛就有点高了。

所以，这次增加的“本机”模式，希望把流程变成：

```text
安装 nl2sh-helper
    ↓
开启本机无线调试，完成配对
    ↓
助手部署并启动 nl2sh
    ↓
在这台手机的浏览器中打开 Web 界面
```

这里的关键，是助手通过**本机无线 ADB**连接这台手机自己的调试服务，再以 shell 身份部署和启动 nl2sh。

这样，nl2sh 可以继续使用原有的 Android Shell 运行环境。本机与远程部署也能共享签名验证、文件校验、更新回滚和服务管理流程。

浏览器访问的地址则使用 `127.0.0.1` 和服务实际返回的端口。用户不需要为了打开本机 Web 界面，再去记一遍手机的 Wi-Fi 地址。
![nl2sh-helper-2.png](https://developer.qcloudimg.com/http-save/yehe-2988206/9e952a42ea4e08f4a4628463f595c3e8.png)

安装流程可以复用，真正需要打磨的，是第一次配对时的操作体验。

## 第一个坑：设置不能分屏，一切换应用，配对窗口就没了

Android 无线调试的配对，需要临时配对端口和六位配对码。

它们出现在系统设置的“使用配对码配对设备”窗口里。助手需要拿到这两项信息，才能完成配对。

最初想到的操作方式很直接：把系统设置和助手分屏，一边看端口与配对码，一边输入。

但实际使用时，遇到了一个问题：**部分手机的系统设置不支持分屏。**

于是，用户只能在两个画面之间来回切换：

```text
打开系统配对码窗口
    ↓
记下端口和六位码
    ↓
切换到 nl2sh-helper 输入
```

问题就发生在“切换”这一步。

在部分设备上，离开系统设置后，配对窗口会消失，当前这次临时配对入口也随之失效。等用户回到助手，刚刚记下来的信息已经不能用于完成配对了。

重新打开窗口，又会得到新一轮配对信息；再次切换，又可能让窗口消失。

这时，即使输入没有出错，用户也很难把流程走完。

**要解决这个问题，必须让用户在输入配对信息时，仍然停留在系统的配对码窗口。**

![nl2sh-helper-3.png](https://developer.qcloudimg.com/http-save/yehe-2988206/26e9c6fa0c6826c88fb4a5ff241b3569.png)

## 第二个坑：加了浮窗，系统又把浮窗“关掉”了

顺着这个思路，第二个方案就是配对浮窗。

助手显示一个小窗口，用户打开系统无线调试页面后，可以直接在浮窗里输入端口和配对码，不必切回助手，也不需要分屏。

这次实现的浮窗支持：

- 拖动标题移动位置，避免遮住系统配对信息。
- 收起、展开和关闭，让出系统页面的操作空间。
- 输入临时配对端口和六位码，在浮窗中发起配对。
- 显示处理中、失败和配对完成的结果。
- 配对完成后返回助手，继续安装或启动 nl2sh。

浮窗的配对任务由前台服务管理，切换到设置页面时不依赖助手主界面一直留在前台。用户关闭浮窗时，则取消进行中的配对并清理窗口。

看起来，这应该能解决不能分屏的问题了。

但继续适配后，又遇到了第二个坑：**部分手机进入无线调试或无线配对界面时，会让普通应用浮窗消失。**

从用户的感受来看，就是“浮窗被系统自动关掉了”。

这里需要区分一下：浮窗消失，不一定表示助手进程或配对服务已经退出。在已测试的 API 35 系统设置中，可以观察到系统强制隐藏普通浮窗，窗口仍由助手管理，但用户已经看不到、也无法在里面输入。

因此，单纯检查“有没有浮窗权限”还不够。

在助手自己的界面上，浮窗能正常显示，也能拖动；但一进入最需要它出现的系统设置页面，它就可能被隐藏。

把浮窗做得更小、换一个位置，都不能解除系统对这个页面的限制。

我们还需要一个能在配对窗口保持打开时使用的输入入口。

![nl2sh-helper-4.png](https://developer.qcloudimg.com/http-save/yehe-2988206/1c2e31862430958adff1d7f111d29a63.png)

## 最后的方案：在配对通知中输入“端口 六位码”

最终，助手增加了**通知配对入口**，作为浮窗被系统隐藏时的兼容方案。

它利用系统通知的直接回复能力，让用户在通知栏输入配对信息。助手收到输入后，仍然调用同一套本机无线 ADB 配对逻辑。

用户不必切回助手主界面，也不需要系统设置支持分屏。

输入格式很简单：

```text
<临时配对端口> <六位配对码>
```

两项之间用空格分隔。

实际操作可以按下面的顺序进行。

### 1. 在助手中打开本机配对入口

打开 nl2sh-helper，选择“本机”，点击“打开配对浮窗”。

首次使用时，根据提示允许“显示在其他应用上层”，返回助手后再次打开浮窗。为了使用通知配对入口，还需要允许助手发送通知。

### 2. 打开系统无线调试的配对码窗口

进入开发者选项，开启无线调试，选择“使用配对码配对设备”。

此时，系统窗口会显示临时配对地址、端口和六位码。

**保持这个窗口打开，不要切回助手。**

### 3. 下拉通知栏，输入配对信息

找到助手的配对通知，点击“输入配对信息”。

按照“临时端口、空格、六位配对码”的格式输入，然后发送。

本机配对只需要这里的端口，不需要把整段 IP 地址一起输入。

这里尤其容易混淆的一点是：**配对端口和连接端口是两回事。**

通知里填写的是当前配对码窗口中的临时配对端口；无线调试主页显示的连接端口，用于配对完成后的 ADB 连接。

### 4. 配对成功后，返回助手继续部署

通知会显示配对结果。成功后点击“返回助手”，再点击“启动 / 首次安装 nl2sh”。

助手会尝试发现本机的无线 ADB 连接端口。如果发现失败，可以填写无线调试主页显示的连接端口后重试。

**配对成功表示 ADB 授权已经完成，安装和启动是后续步骤。**

把这两个状态分开，用户就能判断问题究竟发生在配对、连接，还是部署阶段。

![nl2sh-helper-5.png](https://developer.qcloudimg.com/http-save/yehe-2988206/8b25f754db41eb057be39e2410e40d47.png)

## 一加 Ace 3 实机验证：本机配对通过

目前，已经在**一加 Ace 3**上进行了实机验证：**用于本机部署 nl2sh 的无线 ADB 配对通过。**

这次验证确认了实际手机上的配对流程可以走通，也让“只用这一台手机完成首次配对”有了实机依据。

不同厂商的设置界面和后台限制仍可能存在差异，因此保留多个入口很有必要：允许显示浮窗的设备，可以直接使用浮窗；会隐藏浮窗的设备，可以使用通知配对入口；主页面表单也继续保留。

配对码是临时信息，助手不会把它保存到磁盘、历史记录或日志中，也不会在配对结果通知中回显输入。通知回复框由系统渲染，不提供助手浮窗里的密码掩码，这一点在使用时也要区分。

## 从“能连接”到“用户能完成连接”

这次适配中，ADB 配对本身只是一部分工作。

剩下的工作，是让用户能够在手机上拿到有效的配对信息，并在它仍然有效时完成输入。

不能分屏，就增加浮窗；系统隐藏浮窗，就增加通知输入。每一步都来自实际操作中遇到的问题，也让本机部署的流程更完整。

希望这个功能能让更多人用手边的一台 Android 手机，体验 nl2sh。


![nl2sh-helper-6.png](https://developer.qcloudimg.com/http-save/yehe-2988206/e8e0c2dc5df75605157537a72c5d3a8c.png)

## 欢迎 Star

如果你对“让 AI 在 Android 手机上完成问题分析，排查，自动测试等”感兴趣，欢迎到 GitHub 给项目点一个 **Star**：

- **nl2sh：**[github.com/nl2sh/nl2sh](https://github.com/nl2sh/nl2sh)
- **nl2sh-helper：**[github.com/nl2sh/nl2sh-helper](https://github.com/nl2sh/nl2sh-helper)

后续会继续分享 nl2sh 的功能进展、手机端 AI Agent 的使用方法，以及 Android 实机适配中遇到的问题和解决过程。

如果这篇文章对你有帮助，也欢迎转发给想在手机上体验 AI Agent 的朋友。


但在给 nl2sh-helper 增加本机部署功能时，真正卡住流程的，是 Android 的两个界面问题：系统设置不能分屏，切换应用后配对窗口消失；加了配对浮窗，进入无线调试页面后，浮窗又消失了。

为了让 AI 跑在自己的手机上，我给 nl2sh-helper 加了一个通知配对入口

给 nl2sh-helper 增加本机部署功能时，真正卡住流程的，是 Android 的两个界面问题：**系统设置不能分屏，切换应用后配对窗口消失；加了配对浮窗，进入无线调试页面后，浮窗又消失了。**

最后，让这条流程跑通的，是一个大家每天都在使用的入口：通知栏。

这篇文章，就聊聊为什么要增加这个功能，以及从分屏、浮窗到通知配对的适配过程。

人工智能

客户端

开发工具

nl2sh-helper新增本机部署功能，解决Android无线调试配对中的界面切换难题。通过通知栏输入配对信息，绕开分屏限制和浮窗消失问题，让用户仅用一台手机即可完成nl2sh的安装与启动，降低AIAgent体验门槛。

代码解释

Android

GitHub

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

为了让 AI 跑在自己的手机上，我给 nl2sh-helper 加了一个通知配对入口-腾讯云开发者社区-腾讯云

为了让 AI 跑在自己的手机上，我给 nl2sh-helper 加了一个通知配对入口

为了让 AI 跑在自己的手机上，我给 nl2sh-helper 加了一个通知配对入口

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐