好友协作

在对话里 @ 好友,选「请对方处理」或「仅告知」,原文直接发出;对方的 Klaus 在对方电脑上、按对方的权限处理,结果用一条回复回到你发出请求的那个对话。

好友协作让两个 Klaus 账号互相发消息。你在对话里 @ 一位好友,写下要请对方做的事,消息原文直接发给对方;如果你请对方处理,对方的 Klaus 在对方自己的电脑上处理,用的是对方的模型、对方的文件、对方给的权限。结果用一条回复回到你发出请求的那个对话。整个过程是异步的:发出后你的输入框马上空出来,手上的事照常继续。

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

加好友

侧栏固定入口里的「好友」打开好友页。右上角「+」菜单有三种方式:

  • 添加好友:输入对方的注册邮箱点「查找」,核对昵称和头像后「发送好友申请」。申请框里还可以先设好这位好友的「好友权限」,对方接受后立即生效。
  • 我的二维码:给对方扫。可以「保存我的二维码」「分享我的二维码名片」,也可以「复制链接」得到一条「添加我为好友链接」。对方在 Klaus 里打开链接时,会弹出预填好你邮箱的申请框,仍要他自己点发送,不会被一条链接直接加上。
  • 扫码添加:「使用摄像头」扫对方的码,或「选择二维码图片」识别一张截图。

对方会在「好友申请」里看到申请,可以「接受」或「拒绝」,接受时顺便选好接收任务的方式;你在对方处理前可以「取消申请」。双方确认后关系才成立。

「我的好友」里每一行显示对方是否在线、对方是否接收你的任务,以及你这边对这位好友的接收方式。行上有「发任务」(把这位好友直接放进输入框)和「好友设置」。

发消息给好友

在输入框里打 @,提及菜单的「好友」分组列出已加的好友(显示在线状态和对方是否接收任务),选中后输入框里出现带「好友」标记的好友提及。这时发送按钮前会出现一个下拉框:

  • 请对方处理(默认):请对方的 Klaus 处理这件事。
  • 仅告知:只把消息送到对方那里,不会启动对方的 Klaus。对方会收到通知,消息留在对话里,需要时对方可以自己「交给我的 Klaus」。

只有输入框里那颗完整的好友提及会让消息发给好友;正文里手打一个名字不算。消息原文直接发出,你的 Klaus 不会因此运行。发出的只有这条消息的文字:附件会被拦下并提示移除,对话历史和文件都不会随之发出去。一条消息最多同时 @ 八位好友。

你也可以让自己的 Klaus 代你给好友发消息,比如说「把结论告诉小林」。这时它会请你先确认要发出的内容;是否每次都问,跟随这个对话的权限档。代发时对话里的内容可能被带给好友,但不会带上凭据。

送达状态

发出的消息下方有一行状态,随进展变化:「已发送 · 尚未送达」→「已送达」→「等待对方授权」→「对方处理中」→「已回复」。其他情况会显示「等待补充信息」「被拒绝」「已取消」「执行失败」或「发送失败」。

  • 对方还没处理完时,可以点「取消请求」,对方那边会停止这次请求;已经完成的操作不会撤销。
  • 发送失败的消息可以「重试发送」,消息身份不变。

对方离线也能发。消息先保存在服务器上,对方的电脑一上线就会收到;请求不会因为时间过去而过期。

收到请求时

好友发来的消息出现在侧栏项目区里这位好友的分组下。同一个来源对话发来的消息会落进同一个配对的对话里,对话行上有「待回复」标记,好友分组上显示需要处理的数量;同时有系统通知。不想被打扰时,可以在好友分组的菜单里「静音此好友消息」。

请求怎么处理,取决于你在「接收任务」里给这位好友选的方式:

  • 每个新会话询问一次(默认):好友请求在你这里新建会话时,出现一张首次执行审批卡,写明执行位置。点「允许此会话」后,同一会话里的后续请求直接处理;任务结束、取消或重启应用都不会撤销这次批准。也可以「拒绝」,或先「查看授权范围」。批准前多条请求共用一张卡,批准后依次处理。
  • 按下方默认值自动执行:不再询问是否接收任务,按设置的初始目录和权限开始。执行中是否需要批准,取决于会话当前的权限档。
  • 不接收:新请求自动谢绝,对方会看到被拒绝。

如果请求落在你已有的对话里(比如它是对你之前发出请求的回应),直接按那个对话自己的权限处理;对话忙碌时等待它空闲,不再显示好友新会话的执行审批卡。

你本人发送的消息始终按会话当前权限执行,不受好友准入限制。 即使好友请求还在等待首次批准,你也可以在那个会话里提问。你自己发言不会自动批准尚待处理的好友请求。

处理与回复

对方 Klaus 的工作过程留在对方自己的对话里。结果要发给你时,它会用一次回复工具把结果交回去,对话里显示为「任务结果 · 这个请求标记为完成」。它的最终回答只给它的主人看,不会自动发给你。如果它需要你补充信息,会用一条提问发回来,你补充后在同一个对话里继续。

Klaus 处理完却没给出回复时,会先被提醒一次;仍然没有,对方(发出请求的人)会看到「{好友} 的 Klaus 已结束处理,没有附上结果」,主人这边会看到「Klaus 没有给出回复,已告知 {好友} 处理已结束」,并可以点「让 Klaus 回复 {好友}」补上。

回复回到你发出请求的那个对话,标着「{好友} 好友 的回复 · 回应你 HH:MM 的请求」,点后半句可以跳回原来的请求。鼠标移上去有「回复对方」和「交给我的 Klaus」两个按钮。超过 12 行或 800 字的长消息先折叠成摘要,可以「展开全文」「在阅读器中打开」或「复制全文」。原来的对话已经删除时,回复会放进一个新对话里。

回复送不出去时(最常见的是你离线),对方电脑会按 15 秒、1 分钟、5 分钟、15 分钟、1 小时的间隔自动重投,看到你上线会立即再发;被服务端明确拒绝的就停止重投。

运行中

  • 没有时长上限:好友任务一直跑到它自然结束。
  • 目录与执行权限:范围外的操作与普通会话一样进入当前权限档的批准或审核流程;完全访问解除普通目录沙箱。仍可通过「目录权限申请」把目录加入默认可写范围,并选择记入该好友的常驻设置。
  • 停止:在对话里直接停止;或者把这位好友改成「不接收」、删除好友,都会取消这位好友待处理和正在运行的任务(改成不接收前会提示要取消几个)。

设置 → 好友

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

  • 接收电脑:好友的任务投到哪台电脑。不选时是「全部在线电脑(默认)」;选了某一台,就只投到那台。
  • 默认好友权限:适用于你添加的好友和你接受的好友申请,之后可以给每位好友单独调整。包括:
    • 接收任务:每个新会话询问一次(默认)、按下方默认值自动执行、不接收。
    • 执行权限:新好友会话的初始权限,可选「请求批准」(默认)、「帮我批准」、「完全访问权限」,含义与普通会话相同。会话建立后可以单独改档,重建时保留该会话自己的选择。
    • 执行位置:「普通会话」(默认)、某个项目或某个工作区。选项目或工作区时,任务会话归入它的分组,可以读写它的目录。
    • 允许任务命令访问网络:默认开启,可以关掉;应用自身的联网能力由所选应用决定。
    • 允许 Computer Use 操作应用:默认关闭,打开后只能操作你勾选的应用。
    • 文件与目录:「添加目录」保存额外路径;「可编辑」的目录加入初始默认可写范围,「只读」目录不预先放行写入。实际读写仍按会话当前的三档权限判断,新加的默认只读。
    • 好友共享空间:每位好友自动有一个自己的子目录(~/.klaus/friends/<好友关系 id>/),好友任务从这里开始,始终可编辑。默认可写目录只包含该好友自己的子目录;选择项目或工作区时再叠加对应目录。

目录配置提供会话初始化的默认范围,不再额外限制完全访问。请求批准和帮我批准对范围外操作走普通会话的批准流程;Computer Use 所选应用授权独立生效,见权限是怎么判的。这些设置只存在本电脑。

好友页某位好友的「好友设置」里,可以写备注(只保存在本电脑,好友看不到,参与显示和搜索)、单独调整这位好友的好友权限,或者「删除好友」。删除后双方不再是好友,任务授权同时撤销,双方本地的聊天记录保留。

全局搜索(⌘/Ctrl+K)也能搜到好友对话。