# Runline 完整使用教程



内容基于 2026-09-05 当前实现与应用界面核对。画面以原始 HTML 原型操作实录为主，设置补充模拟器界面；演示没有连接真实账号或执行真实任务。



## 00:00 先看清工作方式



1. iPhone：发任务、答问题、看结果

2. Mac：运行项目与 coding agent

3. 先用一个练习项目走通流程



欢迎使用 Runline。这份教程会带你从准备电脑和手机开始，完成配对、发起任务、处理授权，再到检查结果。先理解一件事：你在手机上告诉 agent 做什么、回答问题和验收成果；代码编辑和命令执行发生在你的 Mac 上。

你不需要在手机上输入大量代码，但仍然要决定任务范围和关键操作。新版画面直接录自 Runline 的 HTML 交互原型，保留原有界面和按钮。登录、配对和任务都是演示流程，没有连接真实账号，也不代表真实任务已经完成。

建议先准备一个练习项目，跟着步骤逐项检查。



## 00:42 准备 Mac 和 agent



1. 安装并打开 Mac 版 Runline

2. Coding Agent：检查安装与登录状态

3. 保持 Mac 唤醒、联网



先在官网下载并打开 Mac 版 Runline。第一次运行，按欢迎流程进入 agent 检测页；已经设置过，可以在设置的 Coding Agent 页面重新检查。Runline 会显示各个工具是否安装、是否可用。

选择你已经熟悉的一个 agent，例如 Claude Code 或 Codex。没有安装时，按页面提示安装；如果工具需要登录或配置模型服务，先完成它自己的设置。Runline 本身不提供模型，所以模型账号和相关费用由你选择的工具或服务决定。

不要在不知道原因时把所有权限一次打开。准备好之后，让 Mac 保持唤醒并连接网络。合上屏幕是否继续运行取决于机器条件，教程不建议依靠默认睡眠行为。



## 01:30 选择一个练习项目



1. 首次会话：选项目目录

2. 选可用的 agent

3. 没准备好可先跳过，稍后创建



接着设置项目。在 Mac 的首次会话步骤中，选择你希望 agent 操作的项目目录，再选择刚刚准备好的 agent。建议使用一个名叫 runline-demo 的练习仓库，里面放一小段能够测试的代码，不要用正在处理紧急问题的生产项目。

注意选择的是项目根目录，里面应该能看到你的源代码和项目说明。目录名称相同，并不代表是同一个工作副本，所以检查完整路径。如果暂时没有需求，也可以先跳过首次会话，继续完成手机连接。

后续仍然可以新建会话。进入下一步之前，确认自己知道任务最终会在哪台 Mac、哪个目录里运行，这样手机上选择项目时就不会混淆。



## 02:16 扫码，核对，再确认



1. Mac：连接手机页，或设置 → 我的账号

2. iPhone：会话 → 底部 Mac 栏 → 配对新的 Mac

3. 核对四位码 → 确认配对



现在连接手机。在 Mac 初次引导的连接手机页显示二维码，或者在设置的我的账号中查看配对卡。已经配对的 Mac 会显示已配对状态，不一定还有二维码，不要为录制或练习随意解除现有配对。

打开 iPhone 版，完成应用要求的引导和登录。从会话页底部的 Mac 状态栏进入，选择配对新的 Mac，再用 Runline 内的扫描器扫描电脑上的二维码。手机会显示 Mac 名称和四位码。

核对它们与电脑一致后，再点击确认配对。扫描二维码本身不等于已经授权连接。二维码的提示有效期为两分钟，过期会自动更新；失败时重新生成并扫描。

完成后，检查手机是否看到目标 Mac。



## 03:04 发起第一个任务



1. 会话页确认目标 Mac → 右上角 ＋

2. 选择项目、agent 和首条消息

3. 点「开始」，先做一次只读检查



来到手机会话页，先确认底部选中的是正确的 Mac，然后点击右上角的加号。依次选择项目、agent，填写首条消息，最后点击开始。没有选到可用 Mac 时，新建入口可能不可用。

第一次任务建议先只读检查：请检查项目的重试逻辑，告诉我实现在哪个文件，暂时不要修改。等 agent 回答后，核对它看到的项目和文件是否正确。这样做可以在真正写代码之前发现目录选错或工具不可用的问题。

新建会话的首条消息也可以留空，进入会话之后再说需求。不要同时发很多不同目标；先做成一件小事，再扩展任务范围。



## 03:49 把需求说得可验收



1. 目标：具体要改变什么

2. 限制：哪些接口或行为要保留

3. 验收：测试、文件与未解决的问题



一个好的需求，最好包含目标、限制和验收标准。例如：把重试改成指数退避，最多五次；保留现有接口，补充边界测试；修改后运行相关测试，最后说明改了哪些文件，还有什么问题没解决。这比单说修一下更容易得到可以检查的结果。

如果练习项目没有重试逻辑，就换成它实际存在的小功能。你也可以附上报错截图，说明复现步骤和预期行为。任务进行中需要补充背景，继续在同一个会话里发消息。

需要改变整体方向时，先明确告诉 agent 当前方案哪里不对。会话之间不应假定自动共享上下文；换新任务时，把必要的背景再提供一次。



## 04:37 你来做关键决定



1. 先读动作、原因和影响范围

2. 需要执行时允许；不合适时拒绝

3. 停止后，等待主机反馈



Agent 工作时会出现两类需要你回应的卡片。琥珀色是执行授权，蓝色是方向选择。画面里，agent 要搜索 SyncEngine 的代码。

先看命令原文，确认它是本次任务需要的只读搜索，再点允许这一次。授权卡收起之后，历史里会留下一条允许记录。随后，蓝色卡片问你三处都改，还是只改主路径。

读完每个选项的说明，选择符合需求的一项；选项不够时，也可以自己写一句。授权是在决定能不能执行，追问是在决定怎么做。不同 agent 的选项可能不同，以当前界面为准。

需要停止时，点击停止并等待 Mac 的状态反馈，不能把手机上的点击当作已经停止执行。



## 05:25 灵动岛与小组件



1. 设置 → 灵动岛与小组件

2. 运行时显示、展开批准、任务详情

3. 系统添加 Runline 桌面或锁屏组件



想离开应用也能知道任务进展，打开底部设置，再进入灵动岛与小组件。这里有三个实际开关：运行时显示灵动岛、展开后可直接批准，以及显示正在做什么。它们分别控制活动是否出现、是否展示批准操作，以及是否显示任务细节。

页面上方的胶囊是设置示意，不代表当前有一个真实任务正在运行。在支持的 iPhone 上，任务活动可以出现在灵动岛或锁屏；系统权限、设备型号和当前任务状态都会影响显示。桌面组件通过系统添加流程选择 Runline，可以看到运行中、等待决定和空闲等状态。

没有出现时，先检查应用开关和系统实时活动权限，再确认任务是否确实还在运行。



## 06:16 把资料存进记忆



1. 其他 App → 分享 → Runline

2. 补上备注，保存到「记忆」

3. 在会话中输入 @，引用后再派活



接下来是记忆。你在其他应用看到网页、截图或仓库链接，可以用系统分享，选择 Runline，补上一句备注并保存。回到记忆页，列表不仅有标题，还有摘要、标签和时间。

画面中先打开一条资料，查看摘要和自己的备注，再点拿去干活。这会把资料带回会话，成为输入区的一枚引用。另一条路是在会话里输入 at 符号，从面板中选择记忆，再告诉 agent 应该怎么用它。

例如，参考这份欢迎页资料优化排版，但保留自己的内容。收藏和引用是两个动作；保存过不等于 agent 自动知道。网页读不到全文时，补充关键文本或截图。



## 07:02 在手机检查成果



1. 先读回复、文件范围和测试结果

2. 会话右上角 Mac 图标 → 预览中心

3. Pro：网页服务、文件、Mac 屏幕



任务结束后，先读改动范围、测试命令和实际结果。完成两个字不是验收证据。Agent 发来的文件会留在会话里。

画面用两张 Mac 界面参考图演示：点开图片，可以分享、存到相册，或者存进记忆；保存后会有状态反馈。想查看正在运行的项目，回到会话，点右上角的窗口图标，打开预览中心。这里分成端口、文件和屏幕三个入口，当前都有 Pro 条件。

网页要求 Mac 上的开发服务已经启动，文件要求主机就绪，屏幕还需要 Mac 应用运行和相应权限。预览是临时查看；需要长期保留的成果，要保存或分享。消息的导出成图是 PNG，不是完整会话的 Markdown 文件。



## 07:52 模型与多会话



1. 换任务前核对 Mac 与项目

2. 模型卡：请求列表或输入模型名

3. 独立工作分别建会话



熟悉基本流程后，就可以处理多个项目和会话。每次切换，先核对目标 Mac 与项目，避免把需求发到另一个仓库。不同工作分别建会话，会更容易判断每个 agent 正在做什么。

需要换模型时，打开会话输入区下方的模型入口。当前模型卡可以请求 agent 返回可用模型列表，也可以填写模型名切换，并不是所有 agent 都共享同一个固定下拉菜单。切换后等待主机反馈，确认实际生效。

长期复用的资料放进记忆，再按需引用。设置中的项目权限入口提示在 Mac 上修改；不要把手机端可见列表理解成已经获得对任意目录的访问权限。只给本次工作提供必要的项目和背景。



## 08:40 排障与最终验收



1. 先查网络、唤醒、发送状态和待审批

2. 再查 agent、项目和预览服务

3. 修改、提交、推送、部署分别确认



最后看几个常见问题。扫码不成功，检查二维码有效期、是否完成手机确认，以及两端网络。项目列表为空，检查 Mac 有没有配置项目、是否选中正确设备。

发消息后没有变化，先看消息状态、Mac 是否唤醒，再看有没有待处理审批或 agent 错误。网页预览打不开，确认开发服务正在运行、端口正确，以及账号具备相应功能。没有灵动岛，检查设备支持、系统权限、应用开关和活动任务。

Mac 离线时不能马上执行新工作；不要因为没反应就重复提交。最后记住，修改完成、运行测试、Git 提交、推送和部署是不同步骤。如果你需要后面几步，要明确提出并分别检查结果。

完成一次小而可验证的任务，就掌握了 Runline 最重要的工作方式。