1
00:00:00,550 --> 00:00:05,866
欢迎使用 Runline。这份教程会带你从准备电脑和手机开始，

2
00:00:05,866 --> 00:00:10,840
完成配对、发起任务、处理授权，再到检查结果。先理解一件事：

3
00:00:10,840 --> 00:00:15,642
你在手机上告诉 agent 做什么、回答问题和验收成果；

4
00:00:15,642 --> 00:00:21,816
代码编辑和命令执行发生在你的 Mac 上。你不需要在手机上输入大量代码，

5
00:00:21,816 --> 00:00:24,560
但仍然要决定任务范围和关键操作。

6
00:00:24,560 --> 00:00:31,248
新版画面直接录自 Runline 的 HTML 交互原型，保留原有界面和按钮。

7
00:00:31,248 --> 00:00:37,594
登录、配对和任务都是演示流程，没有连接真实账号，也不代表真实任务已经完成。

8
00:00:37,594 --> 00:00:41,196
建议先准备一个练习项目，跟着步骤逐项检查。

9
00:00:43,195 --> 00:00:47,784
先在官网下载并打开 Mac 版 Runline。第一次运行，

10
00:00:47,784 --> 00:00:51,456
按欢迎流程进入 agent 检测页；已经设置过，

11
00:00:51,456 --> 00:00:55,586
可以在设置的 Coding Agent 页面重新检查。

12
00:00:55,586 --> 00:00:59,411
Runline 会显示各个工具是否安装、是否可用。

13
00:00:59,411 --> 00:01:02,012
选择你已经熟悉的一个 agent，

14
00:01:02,012 --> 00:01:07,672
例如 Claude Code 或 Codex。没有安装时，按页面提示安装；

15
00:01:07,672 --> 00:01:11,649
如果工具需要登录或配置模型服务，先完成它自己的设置。

16
00:01:11,649 --> 00:01:14,097
Runline 本身不提供模型，

17
00:01:14,097 --> 00:01:17,769
所以模型账号和相关费用由你选择的工具或服务决定。

18
00:01:17,769 --> 00:01:21,593
不要在不知道原因时把所有权限一次打开。准备好之后，

19
00:01:21,593 --> 00:01:26,795
让 Mac 保持唤醒并连接网络。合上屏幕是否继续运行取决于机器条件，

20
00:01:26,795 --> 00:01:28,936
教程不建议依靠默认睡眠行为。

21
00:01:30,936 --> 00:01:34,609
接着设置项目。在 Mac 的首次会话步骤中，

22
00:01:34,609 --> 00:01:40,618
选择你希望 agent 操作的项目目录，再选择刚刚准备好的 agent。

23
00:01:40,618 --> 00:01:45,293
建议使用一个名叫 runline-demo 的练习仓库，

24
00:01:45,293 --> 00:01:50,468
里面放一小段能够测试的代码，不要用正在处理紧急问题的生产项目。

25
00:01:50,468 --> 00:01:56,645
注意选择的是项目根目录，里面应该能看到你的源代码和项目说明。目录名称相同，

26
00:01:56,645 --> 00:02:01,820
并不代表是同一个工作副本，所以检查完整路径。如果暂时没有需求，

27
00:02:01,820 --> 00:02:08,330
也可以先跳过首次会话，继续完成手机连接。后续仍然可以新建会话。进入下一步之前，

28
00:02:08,330 --> 00:02:12,838
确认自己知道任务最终会在哪台 Mac、哪个目录里运行，

29
00:02:12,838 --> 00:02:15,509
这样手机上选择项目时就不会混淆。

30
00:02:17,509 --> 00:02:22,288
现在连接手机。在 Mac 初次引导的连接手机页显示二维码，

31
00:02:22,288 --> 00:02:28,221
或者在设置的我的账号中查看配对卡。已经配对的 Mac 会显示已配对状态，

32
00:02:28,221 --> 00:02:34,483
不一定还有二维码，不要为录制或练习随意解除现有配对。打开 iPhone 版，

33
00:02:34,483 --> 00:02:39,592
完成应用要求的引导和登录。从会话页底部的 Mac 状态栏进入，

34
00:02:39,592 --> 00:02:45,690
选择配对新的 Mac，再用 Runline 内的扫描器扫描电脑上的二维码。

35
00:02:45,690 --> 00:02:51,623
手机会显示 Mac 名称和四位码。核对它们与电脑一致后，再点击确认配对。

36
00:02:51,623 --> 00:02:58,050
扫描二维码本身不等于已经授权连接。二维码的提示有效期为两分钟，过期会自动更新；

37
00:02:58,050 --> 00:03:02,994
失败时重新生成并扫描。完成后，检查手机是否看到目标 Mac。

38
00:03:04,994 --> 00:03:11,508
来到手机会话页，先确认底部选中的是正确的 Mac，然后点击右上角的加号。

39
00:03:11,508 --> 00:03:16,394
依次选择项目、agent，填写首条消息，最后点击开始。

40
00:03:16,394 --> 00:03:22,909
没有选到可用 Mac 时，新建入口可能不可用。第一次任务建议先只读检查：

41
00:03:22,909 --> 00:03:28,156
请检查项目的重试逻辑，告诉我实现在哪个文件，暂时不要修改。

42
00:03:28,156 --> 00:03:33,223
等 agent 回答后，核对它看到的项目和文件是否正确。

43
00:03:33,223 --> 00:03:38,471
这样做可以在真正写代码之前发现目录选错或工具不可用的问题。

44
00:03:38,471 --> 00:03:45,347
新建会话的首条消息也可以留空，进入会话之后再说需求。不要同时发很多不同目标；

45
00:03:45,347 --> 00:03:48,243
先做成一件小事，再扩展任务范围。

46
00:03:50,243 --> 00:03:56,773
一个好的需求，最好包含目标、限制和验收标准。例如：把重试改成指数退避，

47
00:03:56,773 --> 00:04:02,184
最多五次；保留现有接口，补充边界测试；修改后运行相关测试，

48
00:04:02,184 --> 00:04:06,102
最后说明改了哪些文件，还有什么问题没解决。

49
00:04:06,102 --> 00:04:12,260
这比单说修一下更容易得到可以检查的结果。如果练习项目没有重试逻辑，

50
00:04:12,260 --> 00:04:18,977
就换成它实际存在的小功能。你也可以附上报错截图，说明复现步骤和预期行为。

51
00:04:18,977 --> 00:04:25,507
任务进行中需要补充背景，继续在同一个会话里发消息。需要改变整体方向时，

52
00:04:25,507 --> 00:04:32,410
先明确告诉 agent 当前方案哪里不对。会话之间不应假定自动共享上下文；

53
00:04:32,410 --> 00:04:35,769
换新任务时，把必要的背景再提供一次。

54
00:04:37,769 --> 00:04:43,322
Agent 工作时会出现两类需要你回应的卡片。琥珀色是执行授权，

55
00:04:43,322 --> 00:04:49,744
蓝色是方向选择。画面里，agent 要搜索 SyncEngine 的代码。

56
00:04:49,744 --> 00:04:56,512
先看命令原文，确认它是本次任务需要的只读搜索，再点允许这一次。授权卡收起之后，

57
00:04:56,512 --> 00:05:02,586
历史里会留下一条允许记录。随后，蓝色卡片问你三处都改，还是只改主路径。

58
00:05:02,586 --> 00:05:08,660
读完每个选项的说明，选择符合需求的一项；选项不够时，也可以自己写一句。

59
00:05:08,660 --> 00:05:15,428
授权是在决定能不能执行，追问是在决定怎么做。不同 agent 的选项可能不同，

60
00:05:15,428 --> 00:05:20,982
以当前界面为准。需要停止时，点击停止并等待 Mac 的状态反馈，

61
00:05:20,982 --> 00:05:24,106
不能把手机上的点击当作已经停止执行。

62
00:05:26,106 --> 00:05:32,041
想离开应用也能知道任务进展，打开底部设置，再进入灵动岛与小组件。

63
00:05:32,041 --> 00:05:39,090
这里有三个实际开关：运行时显示灵动岛、展开后可直接批准，以及显示正在做什么。

64
00:05:39,090 --> 00:05:45,210
它们分别控制活动是否出现、是否展示批准操作，以及是否显示任务细节。

65
00:05:45,210 --> 00:05:50,775
页面上方的胶囊是设置示意，不代表当前有一个真实任务正在运行。

66
00:05:50,775 --> 00:05:56,339
在支持的 iPhone 上，任务活动可以出现在灵动岛或锁屏；

67
00:05:56,339 --> 00:06:00,605
系统权限、设备型号和当前任务状态都会影响显示。

68
00:06:00,605 --> 00:06:04,871
桌面组件通过系统添加流程选择 Runline，

69
00:06:04,871 --> 00:06:09,508
可以看到运行中、等待决定和空闲等状态。没有出现时，

70
00:06:09,508 --> 00:06:15,258
先检查应用开关和系统实时活动权限，再确认任务是否确实还在运行。

71
00:06:17,258 --> 00:06:23,237
接下来是记忆。你在其他应用看到网页、截图或仓库链接，可以用系统分享，

72
00:06:23,237 --> 00:06:29,393
选择 Runline，补上一句备注并保存。回到记忆页，列表不仅有标题，

73
00:06:29,393 --> 00:06:35,196
还有摘要、标签和时间。画面中先打开一条资料，查看摘要和自己的备注，

74
00:06:35,196 --> 00:06:40,120
再点拿去干活。这会把资料带回会话，成为输入区的一枚引用。

75
00:06:40,120 --> 00:06:44,869
另一条路是在会话里输入 at 符号，从面板中选择记忆，

76
00:06:44,869 --> 00:06:50,848
再告诉 agent 应该怎么用它。例如，参考这份欢迎页资料优化排版，

77
00:06:50,848 --> 00:06:57,531
但保留自己的内容。收藏和引用是两个动作；保存过不等于 agent 自动知道。

78
00:06:57,531 --> 00:07:00,872
网页读不到全文时，补充关键文本或截图。

79
00:07:02,872 --> 00:07:09,090
任务结束后，先读改动范围、测试命令和实际结果。完成两个字不是验收证据。

80
00:07:09,090 --> 00:07:15,485
Agent 发来的文件会留在会话里。画面用两张 Mac 界面参考图演示：

81
00:07:15,485 --> 00:07:21,170
点开图片，可以分享、存到相册，或者存进记忆；保存后会有状态反馈。

82
00:07:21,170 --> 00:07:27,032
想查看正在运行的项目，回到会话，点右上角的窗口图标，打开预览中心。

83
00:07:27,032 --> 00:07:32,184
这里分成端口、文件和屏幕三个入口，当前都有 Pro 条件。

84
00:07:32,184 --> 00:07:37,336
网页要求 Mac 上的开发服务已经启动，文件要求主机就绪，

85
00:07:37,336 --> 00:07:44,087
屏幕还需要 Mac 应用运行和相应权限。预览是临时查看；需要长期保留的成果，

86
00:07:44,087 --> 00:07:47,640
要保存或分享。消息的导出成图是 PNG，

87
00:07:47,640 --> 00:07:51,193
不是完整会话的 Markdown 文件。

88
00:07:53,193 --> 00:07:57,663
熟悉基本流程后，就可以处理多个项目和会话。每次切换，

89
00:07:57,663 --> 00:08:04,023
先核对目标 Mac 与项目，避免把需求发到另一个仓库。不同工作分别建会话，

90
00:08:04,023 --> 00:08:08,836
会更容易判断每个 agent 正在做什么。需要换模型时，

91
00:08:08,836 --> 00:08:11,415
打开会话输入区下方的模型入口。

92
00:08:11,415 --> 00:08:17,604
当前模型卡可以请求 agent 返回可用模型列表，也可以填写模型名切换，

93
00:08:17,604 --> 00:08:23,620
并不是所有 agent 都共享同一个固定下拉菜单。切换后等待主机反馈，

94
00:08:23,620 --> 00:08:27,918
确认实际生效。长期复用的资料放进记忆，再按需引用。

95
00:08:27,918 --> 00:08:31,700
设置中的项目权限入口提示在 Mac 上修改；

96
00:08:31,700 --> 00:08:36,513
不要把手机端可见列表理解成已经获得对任意目录的访问权限。

97
00:08:36,513 --> 00:08:39,436
只给本次工作提供必要的项目和背景。

98
00:08:41,436 --> 00:08:47,568
最后看几个常见问题。扫码不成功，检查二维码有效期、是否完成手机确认，

99
00:08:47,568 --> 00:08:54,421
以及两端网络。项目列表为空，检查 Mac 有没有配置项目、是否选中正确设备。

100
00:08:54,421 --> 00:08:58,929
发消息后没有变化，先看消息状态、Mac 是否唤醒，

101
00:08:58,929 --> 00:09:04,159
再看有没有待处理审批或 agent 错误。网页预览打不开，

102
00:09:04,159 --> 00:09:10,110
确认开发服务正在运行、端口正确，以及账号具备相应功能。没有灵动岛，

103
00:09:10,110 --> 00:09:17,144
检查设备支持、系统权限、应用开关和活动任务。Mac 离线时不能马上执行新工作；

104
00:09:17,144 --> 00:09:20,390
不要因为没反应就重复提交。最后记住，

105
00:09:20,390 --> 00:09:27,243
修改完成、运行测试、Git 提交、推送和部署是不同步骤。如果你需要后面几步，

106
00:09:27,243 --> 00:09:31,932
要明确提出并分别检查结果。完成一次小而可验证的任务，

107
00:09:31,932 --> 00:09:35,899
就掌握了 Runline 最重要的工作方式。