Aside Agent 技能允许电脑上的 AI 代理与同一局域网内运行 Aside 应用的手机进行交互。用户通过自然语言指令(如“连接我的 Aside”或“在手机上写一条笔记”)触发该技能。技能使用 Bonjour 服务发现(_aside-agent._tcp)定位手机,并通过 HTTP 接口完成配对和授权。配对成功后,手机当前打开的资料库会被挂载到本地路径 /aside,之后可以使用 arc afs 命令进行搜索、读取和写入操作。
主要能力包括:配对连接、挂载资料库、搜索条目(支持关键字、标签、集合、类型、链接、日期等过滤条件)、读取条目详情及附件、创建和更新笔记(支持文本、链接、图片、音频、文件、视频等嵌入块)、管理标签和集合、批量操作以及请求永久删除(需手机确认)。所有库操作通过 arc afs exec 调用 /aside/.actions/aside 执行,部分操作需要提供 operationId 和 resourceVersion 以保证幂等性和冲突检测。
使用方式:首先确保手机和电脑在同一局域网,并在手机上打开 Aside 的内容终端页。电脑需安装 arc 工具(安装命令:curl -fsSL https://arc.afsd.io/install.sh | bash)。技能自动完成服务发现、协议版本检查、凭证探测或配对流程。配对时需用户在手机上允许,配对码约 60 秒有效。配对成功后,凭证保存在 ~/.aside-agent/credential(权限 0600),设备标识保存在 ~/.aside-agent/device-id。挂载命令需在 ~/.aside-agent 目录下执行,并带 --standalone 参数,同时设置 allowPrivateNetwork=true。
适用场景:需要在电脑上快速记录笔记到手机、检索手机资料库内容、管理标签和集合、上传附件到手机笔记等。限制:仅支持 macOS(依赖 dns-sd),需要 arc 工具;明文 TCP 通信,无 TLS,同一局域网观察者可能看到配对码和凭证;部分操作(如永久删除)需手机确认;附件大小有限制(图片最多9张每张20MB,音频/文件每条20MB,视频最多1条200MB且时长≤15秒);不支持 Muse 等未经验证的工具集成。