【免费下载链接】aos-ceAOS Community Edition: the open agent operating system.项目地址https://gitcode.com/gh_mirrors/ao/aos-ce点击查看免费下载AOS Tray 是 AOS Community Edition下称 AOS CE的 macOS 菜单栏原生 Shell一个 accessory 进程、无 Dock 图标、关闭面板只是隐藏窗口、退出 Tray 也绝不触碰 AOS 运行时、挂载、Agent 或 MCP 会话。本文基于 apps/aos-tray/README.md 的完整脉络展开并结合 AOSTrayCore 与入口源码覆盖默认启动的二进制绑定规则、全部命令行模式--snapshot/--demo/--socket/--aos-binary--aos-home、本地预览 bundle 组装、Overview/Capsules/卷操作的只读验证边界以及aos native-setup驱动的 Native Input 配对流程读完后你可以独立构建、测试并安全地配置这套菜单栏 Shell。产品定位与生命周期边界AOS Tray 的核心设计约束是GUI 是观测与呈现层不是运行时的一部分。这一约束在源码中被固化为一份显式的生命周期策略TrayLifecyclePolicy 的accessoryShell静态值逐条声明了该产品的行为契约public static let accessoryShell TrayLifecyclePolicy( activationPolicy: .accessory, showsDockIcon: false, closeWindowHides: true, terminateAfterLastWindowClosed: false, quitStopsRuntime: false, autoLaunchAtLogin: true, readsLiveHome: false, collectsCredentials: false, performsNetworking: false, installsApps: false, startsDaemons: false )quitStopsRuntime: false退出 Tray 不启动、不停止任何守护进程startsDaemons: false、installsApps: falseTray 自身没有自动守护进程启动或文件系统挂载行为accessory激活策略 showsDockIcon: false对应Accessory process, no Dock icon面板关闭只是隐藏closeWindowHides: true、terminateAfterLastWindowClosed: falseautoLaunchAtLogin: truemacOS 产品安装器把签名好的 App 放到$HOME/Applications首次打开后由已安装的 App 自行注册登录项。此外在 macOS 上aos start、aos restart以及面向 Oracle 的aos mcp serve入口点在该稳定 App 存在时也会重新打开它——但可选 GUI 永远不会成为运行时启动的依赖。面板的分区结构同样在源码中枚举化PanelSection 定义为overview、requests、capsules三个标签页后文的验证能力分别对应 Overview 与 Capsules。构建与运行默认绑定规则仓库给出的标准运行方式是 Swift Package Manager包描述见 Package.swift最低平台 macOS 13产品为AOSTrayCore库与aos-tray可执行文件swift build --package-path apps/aos-tray swift test --package-path apps/aos-tray swift run --package-path apps/aos-tray aos-tray --snapshot swift run --package-path apps/aos-tray aos-tray --demo --snapshot参数语义--snapshot只打印 presentation JSON 后退出不打开任何窗口适合脚本化检查呈现模型--demo加载一个带持久 DEMO 横幅的内存 fixture演示决定只会修改 fixture 本身不会触碰真实安装省略--snapshot则进入菜单栏 Shell 运行。默认无参启动的绑定规则是这套产品的关键不变量它只绑定当前用户的~/.aos/bin/aos与~/.aos或一个有效的绝对路径AOS_HOME环境变量且二进制永远取该 home 下的bin/aos。Tray 不搜索PATH、不使用 App 相邻的可执行文件、不登记设备找不到二进制时如实报告缺失而不是发明出一份清单。显式的--aos-binary/--aos-home仍然成对选择安装。这条规则在 LaunchArguments.parse 中可以直接验证--aos-binary与--aos-home各自要求绝对路径hasPrefix(/)解析完成后执行(aosBinary nil) ! (aosHome nil)的成对校验——只给一个就返回conflictingModes错误。错误消息集合 LaunchParseError 明确了三种失败未知参数、--socket缺 PATH、以及--socket与--demo/--snapshot互斥。完整的命令行面由 helpText 给出aos-tray — AOS macOS menu bar shell Usage: aos-tray aos-tray --demo aos-tray --snapshot aos-tray --demo --snapshot aos-tray --socket PATH aos-tray --aos-binary ABSOLUTE_PATH --aos-home ABSOLUTE_PATH aos-tray --overview aos-tray --native-input-config ABSOLUTE_PATH aos-tray --help入口逻辑在 AOSTrayMain解析失败打印 help 并以退出码 2 结束--snapshot在TrayPresentation.make(from: store)成功后打印 JSON 即返回其余情况经InstalledRuntimeLaunch.apply归一化出aosBinary/aosHome/expectedBinary后交给TrayApp.run。DEBUG 构建下还保留了--preview-runtime-input与--preview-input两个内部预览入口不进入发布文档面。--socket开发用 presenter 模式--socket PATH是一个开发用 presenter 监听器与--demo和--snapshot互斥。约束与行为PATH 必须是一个显式的绝对文件路径且位于已存在的、用户所有的0700目录内进程在打开 UI 之前绑定该 socket0600权限同用户 peer 检查每个连接服务一次换行符分隔的 JSON 请求/响应载荷中不存在的 principal、capsule、scope 身份一律不发明Cancel、timeout、disconnect、quit 四种结局都不构成批准这是同用户凭据边界不是人类真实发出请求的证明Inventory 在该模式下保持不可用。源码中这一互斥性由 parse 的--socket分支 与结尾的模式冲突检查共同保证。README 还强调--demo始终是内存 fixture--socket始终是无默认 home inventory 的 presenter而无参启动才会在二进制存在时检查所绑定的安装。本地预览 bundle 与动作对话框 fixture不安装、不启动仅组装一个本地 App bundlesh apps/aos-tray/scripts/build-preview.sh该脚本build-preview.sh的实际步骤是swift build→ 取--show-bin-path→ 在.build/AOS Preview.app下复制Info.plist与aos-tray二进制 →plutil -lint校验 plist →codesign --force --sign -ad-hoc 签名 →codesign --verify --strict本地验签最后打印 bundle 路径。需要明确它是 ad-hoc 签名、供本地执行的预览不是Developer ID 签名/公证后的分发包。预览构建完成后可运行隔离的动作对话框 fixturepython3 apps/aos-tray/scripts/preview-action.pypreview-action.py 只启动预览 App 和一个临时私有 socket选择一个选项会打印其响应并关闭预览它从不接触运行时、不保存任何 grant且 fixture 五分钟过期。另有 check-capsule-library.py 用于胶囊库一致性检查。验证一Overview 的显式只读检查aos-tray --aos-binary /absolute/path/to/aos --aos-home /absolute/path/to/aos-home两个参数必须一起提供且不能与 demo/snapshot 混用对应 parse 结尾的冲突检查。从菜单栏打开 AOS 或选择 Overview 会触发刷新。行为边界只执行aos status --json不启动守护进程错误显示为unavailable而非stopped已连接客户端与已加载胶囊来自类型化的 status 响应不是完整的已装胶囊/agent 会话清单status 输出在内存中限定 64 KiB并设 15 秒单调时钟截止超时或超大的 status 子进程会被 kill 并回收——这一信号永远不会发给运行时守护进程本身任何 status 输出都不落盘。验证二Capsules 标签页与 Principal 选择Capsules 页对同一显式安装调用aos status --json --include-capsules列出该已认证 principal 可见的名称、版本与描述并提供本地搜索。principal 的切换规则很严格视图从default开始Change… 通过aos principals --json和运行时的 owned-directory API 列出该已认证用户的 principals禁用的 principal 不可选发现失败时绝不回退到全局名单或自由文本身份选中的 ID 通过 CLI 的--principal选项传递返回的 inventory 必须与请求的 principal 匹配不创建 agent、不枚举全局名单、不变更权限Inventory 复用已认证的 status 连接并有自己 5 秒的请求超时Tray 层面给组合操作留 20 秒stopped、denied、unsupported、unreachable 的 inventory 不等于空库——这四种状态都被如实呈现为不可用不带--include-capsules的旧 AOS 构建仍可正常使用 OverviewCapsules 页显示 unavailable列表是包元数据不是有效 grant 或全局清单。验证三卷操作Open files / Eject / Open mounted volume卷区块读取runtime/astrid.volume元数据并可在 Finder 中揭示该容器文件文件 size 不代表分配量或容量。三个动作的精确语义动作行为约束Open files若所选 owned principal 的固定 App 属文件夹$AOS_HOME/mnt/files尚未挂载为astridfs先挂载然后校验aos status --json 原生statfs复检才打开 Finder只操作该固定路径Eject卸载上一次捕获的同一挂载路径不自动卸载其他挂载Open mounted volume…让用户选定一个已存在的 macOS 挂载根通过aos status --json --principaldefault --mountpointpath校验其 lease再复检原生文件系统后打开 Finder永不启动、挂载或卸载运行时两者mount/unmount都以设置了AOS_HOME的方式派生aos --principal id storage mount|unmountstorage是继承的产品级透传由 AOS 自己选择运行时 home 与 workspace-state 布局。Tray不传--admin、--fleet、--read-write、--workspace启动时不自动挂载也不启动守护进程mount/unmount 失败不算成功。其他平台与更旧的 AOS 版本直接拒绝该操作README 明确真实挂载的正向导航仍需实际执行验证这是开发增量而非打包集成。测试体系Swift 套件、Rust/Swift 桥接与原生 Guest 旅程Swift 测试套件覆盖 choice-index 保持、prompt 取消、socket 隔离与显示元数据测试位于 Tests/AOSTrayCoreTests例如 SocketTests、NativeInputCoordinatorTests。此外还有两层更强的验证Rust/Swift 桥接测试把AOS_TRAY_TEST_BINARY指向一个构建好的 AOS 代理二进制即可启用。这些测试使用脚本化的运行时回复不依赖已安装胶囊可选的 guest 旅程scripts/test-native-guest.sh 使用构建好的 probe 胶囊fixture 见 Tests/Fixtures/native-input-probe、一次性 home 与显式选定的候选二进制单独演练私有输入与守护进程重启与脚本化 socket 测试相互独立。注意其能力边界guest 旅程本身不证明打包 AOS 安装也不证明 Windows/Linux 的原生 UI。Native Input 设置配对、连接与私有输入通道在显式提供 AOS 二进制与 home 时从菜单栏选择Set Up Native Input…选择一个 owned principal确认设备登记与 responder 路由。aos native-setup命令会配发一枚专用的 tray key并在该 AOS home 下创建私有的native-input/connection.json配对 token 通过标准输入传递而不是命令行参数避免出现在进程列表与 shell 历史中。对应 CLI 实现位于 unicity-aos-bootstrap。设置的硬性前提与行为要求一个运行中的兼容运行时遇到已存在的 enrollment 或 responder 配置时拒绝而不是替换凭据或策略设置成功后需要重启运行时以加载 responder 配置并重启 TrayTray 从显式选定的 home 采纳该私有连接文件。后续维护入口Connect Native Input…接受一个已存在的私有连接文件对应--native-input-config ABSOLUTE_PATH解析器要求绝对路径且与--demo/--snapshot不兼容Reconnect Native Input重试该连接。私有文本与 secret 字段走已认证的原生运行时连接而不是模型侧的 MCP 结果输入、取消、断连是三种互不合并的结局。运行时决定可用的 approval 选项及其生命周期在库中选择一个 principal不授予批准权限。相关核心逻辑集中在 NativeInputCoordinator 与 NativeRuntimeInputSession 等模块。能力边界Claim LimitsREADME 的 Claim limits 一节是对该组件最诚实的能力声明值得逐条保留为工程边界默认启动不连接任何运行时显式--socket模式可以呈现来自 AOS 原生 MCP 适配器的请求但不读取 principal home--socket是本地同用户开发传输不是 grantor也不是人类发送了请求的证明存在 native socket ≠ inventory 可用AOS Tray 不是 consent 强制执行器、不是 updater、不是文件系统 UIbundle 标识是ai.unicity.aos.tray不得与org.astrid.runtime.fs混淆Host/MCP 动词只在请求列出时才显示Shell 不会为每个请求发明always请求身份是 request ID同一 principal、capsule、scope 也可能是不同的调用胶囊行身份是 principal capsule scope 三元组运行时 socket 提示按连接connection为键不按 request ID 合并GUI、打包安装与运行时检查必须在发布候选版本上重新执行VoiceOver 尚未验证。小结AOS Tray 的价值在于把可选 GUI做成了一个边界清晰、行为可枚举的组件启动模式互斥由解析器强制Identity.swift只读验证用大小/超时/复检三重护栏包裹aos status --json卷操作只碰固定路径且失败即不可用Native Input 通过 stdin 传 token、拒绝覆盖既有配置。它提供的是菜单栏上的观测、呈现与受控交互面——而不是第二套运行时控制面。对于要在 AOS CE 上扩展或审计 GUI 行为的开发者这套显式绑定 互斥模式 不可用优于虚构的设计约定本身也值得参考。赞分享【免费下载链接】aos-ceAOS Community Edition: the open agent operating system.项目地址https://gitcode.com/gh_mirrors/ao/aos-ce点击查看免费下载相关推荐如何掌握AOS滚动动画库轻松实现offset与anchorPlacement的精准控制如何掌握AOS滚动动画库轻松实现offset与anchorPlacement的精准控制 AOSAnimate on Scroll是一款轻量级的滚动动画库前端UI组件AOS的单元测试模拟Jest与Sinon实现的函数调用验证AOS的单元测试模拟Jest与Sinon实现的函数调用验证 单元测试在AOS开发中的价值 Animate on Scroll AOS 作为轻量级滚动动画库其前端UI组件终极指南macOS菜单栏VisualEffectView模糊效果深度解析与Ice应用实践终极指南macOS菜单栏VisualEffectView模糊效果深度解析与Ice应用实践 想要让你的macOS菜单栏焕然一新吗通过VisualEffectV桌面应用上一篇如何用Video2X实现专业级视频AI增强4K超分辨率与智能插帧全攻略下一篇Kitura Web应用架构MVC与Clean Architecture实践创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
