CompozyOS桌面应用部署指南macOS与Linux安装、自动更新与深度链接配置【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozyCompozyOS是一个面向 AI 智能体的操作系统把你已经在用的智能体 CLIClaude Code、Codex、Gemini CLI、Cursor 等接入同一个守护进程让它们组队分工、互相交接任务、跑定时作业与循环Loops并共享一份项目记忆全部操作都可以通过浏览器或桌面端完成。本指南带你完成CompozyOS 桌面应用部署覆盖 macOS 与 Linux 的安装、自动更新机制和深度链接配置。 桌面端与安装方式总览CompozyOS 的桌面壳基于 Electron 构建见 desktop/package.json它内嵌了 Go 编写的守护进程二进制首次启动时会自动完成运行时引导连接本机的compozy守护进程因此你只需要一次安装即可获得完整的桌面应用 守护进程 Web 控制台体验。当前 v0.3 处于 beta 阶段推荐两种安装方式方式命令适用场景官方安装脚本curl -fsSL https://compozy.com/install.sh \| shmacOS / Linux自动校验 Sigstore 来源NPM 全局安装npm install -g compozy/clibeta已有 Node 环境的用户⚠️ 注意Homebrew 配方在 v0.3 beta 期间仍停留在已弃用的 v0.2 线详见 docs/release/homebrew-beta-notice.md。compozy官方配方将在 v0.3.0 正式版回归。也支持从源码构建桌面端仓库克隆地址https://gitcode.com/gh_mirrors/co/compozygit clone https://gitcode.com/gh_mirrors/co/compozy cd compozy make dev macOS 一键安装步骤macOS 发布产物为dmg与zip两种格式定义在 desktop/electron-builder.yml 中DMG标准双击安装适合普通用户ZIP供自动更新流程使用更新时会校验包内 zip 完整性校验逻辑见 desktop/src/release/mac-zip.ts 与 desktop/scripts/verify-mac-update-zip.ts。安装后首次启动会触发以下引导流程解析用户主目录下的~/.compozy作为运行目录路径解析逻辑见 desktop/src/home.ts启动内嵌的compozy运行时二进制写入app.json、app.sock、app.token等应用记录打开产品窗口通过控制通道与守护进程通信。macOS 构建启用了加固运行时hardenedRuntime并使用 asar 完整性校验安全性开箱即得。 Linux 最快安装方法Linux 发布产物为AppImage与deb见 desktop/electron-builder.yml 的linux段。一个值得注意的细节构建配置启用了静态 AppImage 运行时这意味着你的机器无需再安装 libfuse2这类系统依赖下载即可运行。AppImage下载后赋予可执行权限直接双击运行适合不想污染系统的用户debsudo dpkg -i CompozyOS-*.deb适合希望纳入包管理器管理的用户。Linux 下桌面应用的可执行名为compozyos桌面快捷方式名会自动与桌面文件同步syncDesktopName: true。 CompozyOS桌面应用自动更新机制桌面端内置了完整的自动更新消费者核心实现在 desktop/src/update/app-update-consumer.ts。对普通用户来说你只需要知道它稳看门狗超时安装应用阶段有 10 分钟看门狗、安装器交接阶段有 5 分钟看门狗超时会自动接管处理避免更新卡死租约续期更新过程中每 30 秒续租一次防止多个更新操作互相踩踏失败自愈如果安装中断下次启动会进入恢复安装或静默失败分支自动修复到一致状态版本校验下载完成后会比对版本号不匹配的包会被直接拒绝。更新包通过通用发布源publish.provider: generic见 desktop/electron-builder.yml分发频道清单由 desktop/scripts/prepare-channel-manifests.ts 生成。发布流水线必须按desktop-build → desktop-smoke → desktop-publish的顺序执行并全部通过流程说明见 docs/release/v0.3-single-cut.md。 深度链接配置一键直达任意页面CompozyOS 桌面端注册了自定义协议让你可以从浏览器、终端或其他工具一键唤起桌面应用并直达指定页面环境协议方案示例正式版compozyoscompozyos://open/sessions/abc?tablogs开发版compozyos-devcompozyos-dev://open/tasks协议解析与安全校验实现在 desktop/src/deep-links/deep-link.ts要点只接受compozyos://open路径形式的链接并保留查询参数恶意路径全部拒绝http://、//evil.com、../遍历、空字符等都会安全回退到默认视图测试覆盖见 desktop/src/deep-links/tests/deep-link.test.ts最新链接获胜应用就绪前连续收到的多个深度链接只消费最后一条避免窗口连环跳转启动参数中的深度链接只取最后一个方便compozyos://open/tasks 应用路径这类命令行用法。实际使用场景把compozyos://open/sessions/会话ID放进书签或脚本即可从任意地方召唤出对应的会话页面。✅ 部署验证与常见问题排查安装完成后用以下三条命令验证运行状态结构化 JSON 输出便于脚本消费compozy status # 查看守护进程状态 compozy version # 确认版本号 compozy doctor -o json # 全面体检常见问题速查问题排查方向桌面端启动后无法连接守护进程确认~/.compozy/app.json与app.sock是否存在见 desktop/src/home.ts查看启动日志~/.compozy/logs/desktop-bootstrap.jsonl与desktop.log更新失败检查~/.compozy/update-operation.json中的操作状态端口冲突用COMPOZY_HOME环境变量指定隔离目录再启动深度链接无反应确认使用的是正式版compozyos而非开发版compozyos-dev协议小结一次安装macOS 用 DMGLinux 用 AppImage/deb桌面壳自带运行时与守护进程放心更新看门狗 租约 自愈机制让自动更新不会把应用留在中间状态随时直达compozyos://open/...深度链接让任何入口都能一键打开对应页面。装好 CompozyOS 桌面端之后下一步可以尝试官方演示场景make demo-seed-desktop见 README.md快速体验多个智能体协作的完整流程。【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CompozyOS桌面应用部署指南：macOS与Linux安装、自动更新与深度链接配置
CompozyOS桌面应用部署指南macOS与Linux安装、自动更新与深度链接配置【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozyCompozyOS是一个面向 AI 智能体的操作系统把你已经在用的智能体 CLIClaude Code、Codex、Gemini CLI、Cursor 等接入同一个守护进程让它们组队分工、互相交接任务、跑定时作业与循环Loops并共享一份项目记忆全部操作都可以通过浏览器或桌面端完成。本指南带你完成CompozyOS 桌面应用部署覆盖 macOS 与 Linux 的安装、自动更新机制和深度链接配置。 桌面端与安装方式总览CompozyOS 的桌面壳基于 Electron 构建见 desktop/package.json它内嵌了 Go 编写的守护进程二进制首次启动时会自动完成运行时引导连接本机的compozy守护进程因此你只需要一次安装即可获得完整的桌面应用 守护进程 Web 控制台体验。当前 v0.3 处于 beta 阶段推荐两种安装方式方式命令适用场景官方安装脚本curl -fsSL https://compozy.com/install.sh \| shmacOS / Linux自动校验 Sigstore 来源NPM 全局安装npm install -g compozy/clibeta已有 Node 环境的用户⚠️ 注意Homebrew 配方在 v0.3 beta 期间仍停留在已弃用的 v0.2 线详见 docs/release/homebrew-beta-notice.md。compozy官方配方将在 v0.3.0 正式版回归。也支持从源码构建桌面端仓库克隆地址https://gitcode.com/gh_mirrors/co/compozygit clone https://gitcode.com/gh_mirrors/co/compozy cd compozy make dev macOS 一键安装步骤macOS 发布产物为dmg与zip两种格式定义在 desktop/electron-builder.yml 中DMG标准双击安装适合普通用户ZIP供自动更新流程使用更新时会校验包内 zip 完整性校验逻辑见 desktop/src/release/mac-zip.ts 与 desktop/scripts/verify-mac-update-zip.ts。安装后首次启动会触发以下引导流程解析用户主目录下的~/.compozy作为运行目录路径解析逻辑见 desktop/src/home.ts启动内嵌的compozy运行时二进制写入app.json、app.sock、app.token等应用记录打开产品窗口通过控制通道与守护进程通信。macOS 构建启用了加固运行时hardenedRuntime并使用 asar 完整性校验安全性开箱即得。 Linux 最快安装方法Linux 发布产物为AppImage与deb见 desktop/electron-builder.yml 的linux段。一个值得注意的细节构建配置启用了静态 AppImage 运行时这意味着你的机器无需再安装 libfuse2这类系统依赖下载即可运行。AppImage下载后赋予可执行权限直接双击运行适合不想污染系统的用户debsudo dpkg -i CompozyOS-*.deb适合希望纳入包管理器管理的用户。Linux 下桌面应用的可执行名为compozyos桌面快捷方式名会自动与桌面文件同步syncDesktopName: true。 CompozyOS桌面应用自动更新机制桌面端内置了完整的自动更新消费者核心实现在 desktop/src/update/app-update-consumer.ts。对普通用户来说你只需要知道它稳看门狗超时安装应用阶段有 10 分钟看门狗、安装器交接阶段有 5 分钟看门狗超时会自动接管处理避免更新卡死租约续期更新过程中每 30 秒续租一次防止多个更新操作互相踩踏失败自愈如果安装中断下次启动会进入恢复安装或静默失败分支自动修复到一致状态版本校验下载完成后会比对版本号不匹配的包会被直接拒绝。更新包通过通用发布源publish.provider: generic见 desktop/electron-builder.yml分发频道清单由 desktop/scripts/prepare-channel-manifests.ts 生成。发布流水线必须按desktop-build → desktop-smoke → desktop-publish的顺序执行并全部通过流程说明见 docs/release/v0.3-single-cut.md。 深度链接配置一键直达任意页面CompozyOS 桌面端注册了自定义协议让你可以从浏览器、终端或其他工具一键唤起桌面应用并直达指定页面环境协议方案示例正式版compozyoscompozyos://open/sessions/abc?tablogs开发版compozyos-devcompozyos-dev://open/tasks协议解析与安全校验实现在 desktop/src/deep-links/deep-link.ts要点只接受compozyos://open路径形式的链接并保留查询参数恶意路径全部拒绝http://、//evil.com、../遍历、空字符等都会安全回退到默认视图测试覆盖见 desktop/src/deep-links/tests/deep-link.test.ts最新链接获胜应用就绪前连续收到的多个深度链接只消费最后一条避免窗口连环跳转启动参数中的深度链接只取最后一个方便compozyos://open/tasks 应用路径这类命令行用法。实际使用场景把compozyos://open/sessions/会话ID放进书签或脚本即可从任意地方召唤出对应的会话页面。✅ 部署验证与常见问题排查安装完成后用以下三条命令验证运行状态结构化 JSON 输出便于脚本消费compozy status # 查看守护进程状态 compozy version # 确认版本号 compozy doctor -o json # 全面体检常见问题速查问题排查方向桌面端启动后无法连接守护进程确认~/.compozy/app.json与app.sock是否存在见 desktop/src/home.ts查看启动日志~/.compozy/logs/desktop-bootstrap.jsonl与desktop.log更新失败检查~/.compozy/update-operation.json中的操作状态端口冲突用COMPOZY_HOME环境变量指定隔离目录再启动深度链接无反应确认使用的是正式版compozyos而非开发版compozyos-dev协议小结一次安装macOS 用 DMGLinux 用 AppImage/deb桌面壳自带运行时与守护进程放心更新看门狗 租约 自愈机制让自动更新不会把应用留在中间状态随时直达compozyos://open/...深度链接让任何入口都能一键打开对应页面。装好 CompozyOS 桌面端之后下一步可以尝试官方演示场景make demo-seed-desktop见 README.md快速体验多个智能体协作的完整流程。【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考