agent-bridge-aun
v1.0.30
Published
mu-agent-bridge 的 AUN 通道插件。
Maintainers
Readme
AUN 通道插件
agent-bridge-aun 为 mu-agent-bridge 提供 AUN 消息通道,支持使用已有 AID 或通过管理 API 注册 AID,并将收到的文本交给指定 Agent 插件处理。
安装后在 ABWeb 的插件管理中启动 AUN 通道。配置 aid 和可选的 agent_plugin;默认 Agent 插件为 qwenwork。配置字段 owner_aid 是可选字符串,用作默认 Owner。AID 创建接口为 POST /api/plugins/aun/aid,请求内容为 {"aid":"新AID.agentid.cn","owner_aid":"所有者AID.agentid.cn"}。
创建使用 SDK 的兼容注册流程;Owner AID 只保存为本地归属配置,不代表 AUN 协议 Owner 关系已签名或激活。Gateway 信任根使用随插件提供并校验指纹的 AUN 根证书,不从 Gateway 下载未经验证的 CA 链。
核心支持插件命令后,可运行 mab aun status、mab aun list、mab aun agents、mab aun default-owner、mab aun default-owner set <owner-aid>、mab aun create <aid> [--owner <owner-aid>] [--agent <plugin-id>]、mab aun bind <aid> <plugin-id> 和 mab aun unbind <plugin-id>。default-owner 不带参数显示当前配置,default-owner set <owner-aid> 校验格式并持久化新的默认值。create 明确传入 --owner 时优先使用该值;省略时回退到同一配置中的 owner_aid,两者都没有时返回错误,不会创建 AID。创建新身份时,实际使用的 Owner 会保存为下次默认值。ABWeb 从同一插件配置读取 owner_aid 并预填创建表单,因此 CLI 和 ABWeb 共用默认 Owner。Agent 从当前已就绪的插件动态发现。创建后连接或关联失败时,响应会标明 AID 已创建;先用 mab aun list 检查,不要重试创建。运行日志不记录原始参数或 Owner AID;默认 Owner 查询会在终端显示当前值。
该插件依赖 @agentunion/fastaun,要求 Node.js 22.16 或更高版本。
附件回复按图片、视频和普通文件分组发送。MIME 类型为 video/* 的附件使用 EvolCore 标准 type: "video" 消息,使支持视频预览的 Peer 客户端显示播放器;保留原话题和请求引用。视频沿用 EvolCore 标准上传流程:通过 SDK 上传可公开读取的对象,发送不带分享 URL 的标准对象引用,便于接收端取得下载票据及播放器分段读取;持有对象地址者可读取视频。图片和普通文件继续使用仅原 Peer 可访问的限时分享。该流程由插件独立实现,不调用 ec 命令,也不改变各 Agent 插件的产物回传策略。
ABWeb 的 AUN 设置只展示已连接 AID,并按来源分组。成功注册并记录在插件 created_aids 中的 AID 属于本工程;共享密钥库中其余 AID 属于 EvolCore。旧版 created-aids.json 记录继续兼容。来源只用于展示,连接和关联由 AUN 插件直接管理。列表先显示已关联 Agent 的身份,各组按最近成功关联的时间倒序排列,时间相同或旧记录没有时间时按 AID 名称排序。关联时间保存在插件配置的 binding_times 中,刷新或重启后保留;旧记录不补造时间,再次关联成功后开始记录。
AUN 独立包支持核心后台每五分钟检测更新;可信提供者在自动安装策略下会下载新副本并重载通道。
