好友协作

按邮箱、二维码或链接加好友,把任务派给好友在他自己的电脑上执行;对方先审批目录与权限,结果回到你发出请求的那个会话。

好友协作让两个不同的 Klaus 账号互相派活。你把一句任务发给好友,它在好友自己的电脑上由好友的 Klaus 执行,用的是对方的模型、对方的文件;好友先看到任务全文并决定给它多大的范围,跑完后回复送回你发出请求的那个会话。

这个功能需要登录 Klaus 账号,双方都要。没登录时好友入口不可用,其余功能不受影响,见账号与登录。

加好友

侧栏固定入口里的「好友」打开好友页。点「添加好友」,有三种方式:

  • 按邮箱:输入对方的注册邮箱点「查找」,确认是这个人后「发送好友申请」。
  • 我的二维码:给对方扫。二维码可以保存、分享,也可以「复制链接」,得到一条「添加我为好友」链接。对方打开链接时,Klaus 会弹出预填好你邮箱的申请框,仍要他自己点发送,不会被一条链接直接加上。
  • 扫码添加:「使用摄像头」扫对方的码,或「选择二维码图片」识别一张截图。

申请发出后对方会看到一条待处理申请,可以「接受」或「拒绝」;发出的一方在对方处理前可以撤回。双方确认后关系才成立,之后才能互相派任务。

给好友派任务

两种发法,效果一样:

  • 在输入框里打 @,提及菜单里会列出已加好友的人,选中后写任务、发送。
  • 好友页某个好友行上的「发任务」,会把这个好友的提及直接放进输入框。

只有输入框里那颗完整的好友提及会触发转发;正文里手打一个名字不算。转发的只有这一条消息的文字:你的对话历史、附件和文件都不会随之发出去。

发出后,好友页的「已发出」列表跟踪这条任务的状态:已送达、已回复、已拒绝、已取消、失败、已过期。好友在线才能投递,没有离线排队;对方离线时请稍后再发。

收到任务时:授权

好友的任务不会自己跑起来。它先出现在你这边的待授权列表里(同时有通知),你打开授权框看到的是:谁发的、任务全文、它会落在哪台电脑上,以及一段资源风险摘要。在这里决定给它多大范围:

  • 执行位置:「普通会话」、某个「项目」或某个「工作区」。不选就是普通会话。
  • 目录:「添加目录」把额外的路径给它,每个目录分「只读」或「可编辑」,新加的默认只读。
  • 网络:是否允许联网,默认关。
  • 电脑操控:「允许 Computer Use 操作应用」,并且只限你勾选的那几个应用,默认关。

然后「允许本次任务」或「拒绝任务」。默认只授权这一次;勾上「以后 {好友} 的任务按此范围自动执行」,这份范围就会记下来,这个好友后来的任务直接在同一范围里启动,不再逐条问你。

授权框不选执行模式。任务开跑后它就是一条普通的好友会话,权限档(每次询问 / 自动编辑 / 跳过所有权限)在那条会话的输入框里调,改档从下一个回合开始生效。无论哪一档,授权范围都照样生效:范围外的路径一律拒绝,只读目录始终只读,见权限是怎么判的。

运行中与结束后

  • 没有时长上限:好友任务一直跑到它自然结束,不会被单轮时长截断。
  • 越界要单独申请:任务需要访问授权范围之外的目录时,会单独向你发起一次申请,而不是静默失败。申请最多等十分钟;你批准后范围更新,从下一个回合起可以访问。
  • 回复会自动补发:跑完后回复送不出去(最常见的是对方离线),Klaus 按 15 秒、1 分钟、5 分钟、15 分钟、1 小时的间隔自动重投;被服务端明确拒绝的就停止自动重试,界面上还可以手动重试。
  • 停止:在好友设置里改成「不接收」或者删除好友,会撤掉已记住的授权,并取消这个好友正在跑的任务。

回复回到发起方原来那条会话里,以好友卡片的样子出现:好友的头像和名字、「好友」身份标识,并能对上是回哪一次请求的。超过 12 行或 800 字的长回复先折叠成摘要,可以「展开全文」、「在阅读器中打开」或「复制全文」。

好友任务页

好友页本身只管关系:申请和好友列表。某个好友发来的任务,从这个好友行的「任务」入口进入单独的页面集中处理:

  • 待授权的:授权、拒绝或忽略。
  • 启动中、运行中的:「取消任务」。
  • 已经有会话的:「打开会话」。
  • 已结束的可以重新授权再跑一次。

待授权的任务一时不想处理,可以「忽略」。忽略分三级:单条、这个好友的全部、「忽略全部待授权」。忽略只是本机暂时收起、不再提醒,不会通知好友;24 小时后仍未处理才会提示一次已过期。

共享目录、备注与侧栏

  • 每个好友在本机有一个自己的共享子目录(~/.klaus/friends/<好友关系 id>/),这个好友的任务以它为基础目录;你在授权时选了项目或工作区,进程就在那个位置运行。注意所有好友的共享子目录都在同一个上级目录下,不要把它当成好友之间的严格隔离。
  • 「好友设置」里可以给好友写备注。备注只保存在本电脑,好友看不到,会参与显示和搜索。
  • 侧栏的项目区里每个好友一组,好友派来的任务会话归在下面;这一组也能和项目一起拖动排序。

设置 → 好友

账号分组下的「好友」页管两件事:

  • 接收电脑:好友任务投到哪台电脑。不选时是「全部在线电脑(默认)」,投给所有在线、且支持好友协作的电脑;选了就固定投那一台。不支持的设备在选择器里不可选。
  • 默认好友权限:新好友任务的起始范围。默认是每次询问、不开网络、不开电脑操控、不给额外目录与应用、不记住授权。这份默认值只存在本机。

好友是否「在线」看的是对方还有没有有效的桌面登录;接收电脑的在线状态看的是它的好友接收通道是否连着。