CompozyOS v0.2 迁移 v0.3 完整指南命令变更映射与破坏性变化全清单【免费下载链接】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 智能体的操作系统接入你已在用的 Agent CLIClaude Code、Codex、Gemini CLI、Cursor让它们分工协作、自动执行定时任务与循环工作并共享同一份项目记忆全程在浏览器中掌控。v0.3 是一次**硬切割hard cut**而非平滑兼容升级它保留了compozy二进制名和.compozy/tasks/任务格式但彻底替换了工作流运行器。官方迁移文档见 MIGRATION_GUIDE.md本文帮你快速掌握命令变更映射与全部破坏性变化。为什么说 v0.3 是一次硬切割在动手之前先理解三个关键事实迁移策略就清晰了不携带状态运行时数据库、命令名、扩展契约、审查行为都不会自动迁移。旧的global.db、守护进程 socket、运行目录都不要拷贝进新运行时。不提供别名被移除的命令没有兼容别名、没有隐藏回退。脚本里调用的旧命令必须逐个改写。任务文件可以保留.compozy/tasks/下的 Markdown 任务文件Task Schema v2继续有效v0.3 会通过内置 Loop 导入并执行它们。一句话原则保留可提交的任务产物抛弃全部运行时状态配置手动翻译。一键安装 v0.3 beta 的正确姿势 ⚠️先记住Homebrew 不是升级路径。beta 窗口期内 formula 仍停在已弃用的 v0.2.15详见 docs/release/homebrew-beta-notice.mdcompozyformula 要到 v0.3.0 稳定版才回归。推荐三条安装路径详见 README.md 的 Installation 章节方式命令注意官方验证安装器curl -fsSL https://compozy.com/install.sh \| sh固定最新版 beta安装前校验 Sigstore 来源NPMnpm install -g compozy/clibeta必须带beta标签Gogo install github.com/compozy/compozyrelease-taglatest在 beta 期仍解析到 v0.2必须用 release 页面标注的确切 tag另外注意升级命令改名compozy upgrade现在是compozy update且 beta 构建只会跟随更新的 v0.3 beta 版本永远不会跳回 v0.2 稳定线。命令变更映射表旧命令去哪了以下是最高频命令的 v0.2.15 → v0.3 对照完整映射见迁移指南 Command map 章节v0.2 命令v0.3 命令说明compozy tasks run democompozy loop run --name implement-tasks --input slugdemo在项目树中执行使用内置任务实现 Loop--task-runtime typefrontend,idecodex,model...--runtime typefrontend:codex/gpt-5.5-codexxhigh--runtime可重复还支持worker、judge等选择器--auto-commit--input auto_committrue两个内置 dev-cycle Loop 均支持均不推送compozy reviews fix taskcompozy loop run --name review-and-fix --input task_nametask由 CompozyOS 审查 Agent 生成新一轮审查compozy exec promptcompozy session new --agent name然后compozy session prompt id promptv0.3 显式化持久会话compozy agents list/agents inspectcompozy agent list/compozy agent info nameAgent 定义现在是守护进程管理的资源compozy mcp-servecompozy mcp serverelay 绑定推断出的工作区compozy workspaces list/show/registercompozy workspace list/info/add/remove旧的resolve动词无直接替代compozy daemon start先执行一次compozy install再compozy daemon startinstall只引导配置和默认 Agent不启动守护进程compozy daemon statuscompozy status支持-o json结构化输出compozy ext list/install/...compozy extension list/install/...扩展 manifest 与 SDK 契约不兼容需重装或移植compozy runs watch idcompozy loop status --run-id id旧 run ID 不存在于新数据库compozy runs attach id无 TUI 替代使用结构化 status/events 与 Web 运行页compozy sync/compozy archive无需替代 / 无替代Loop 任务导入走各自运行时入口归档需手动compozy tasks validate已移除不要与loop validate混淆后者校验的是 Loop 定义几个高频参数家族的命运需要特别注意--dry-run保留v0.3 的 dry-run 会报告生效输入值和来源且不创建运行--attach、--ui、--stream、--detachTUI 附加模式移除改用 Web 运行页 URL、loop status、HTTP/UDS/SSE 事件流--recovery系列遗留恢复 Agent 已整体移除改用 Loop 的重试/无进展/终态机制加人工重跑--multiple、--parallel、--parallel-tasks推迟deferred当前可先串行执行或在显式隔离的工作区/worktree 中分别启动运行破坏性变化清单 完整台账见 Deferred and removed surfaces 章节以下是必须知道的类别️ 命令与功能移除reviews fetch/list/show/fix/watch整个命令族移除不再有 PR 轮询、外部审查抓取、线程解决、自动推送review-and-fix是唯一的内置审查旅程恢复 Agent、成本感知任务预算推迟、TUI 驾驶舱与runs attachcompozy ext旧命令与旧 manifest API 被不兼容地替换面向库使用的 Go facadecompozy.go、pkg/compozy/{events,runs}移除如需库能力请固定在 v0.2.xv0.3 是产品不是库 配置翻译无自动迁移器compozy migrate config不在当前 beta 中提供不要围绕它做自动化。需要手工对照翻译几个核心项v0.2 配置v0.3 去向defaults.ide/defaults.model展开到loops.defaults.{delivery,watch}.runtime_defaults.{worker,judge}.provider / modeldefaults.timeoutsession.limits.timeoutdefaults.auto_commitloops.inputs.implement-tasks.auto_commit等输入默认值tasks.run.parallel.*、recovery.*、sound.*直接丢弃无运行时配置落点提供商映射是精确的codex → codex、claude → claude、cursor-agent → cursor、opencode → opencode、pi → pi、gemini → gemini、copilot → copilot、kiro → kirodroid、devin与旧版ultra推理档位被丢弃切勿悄悄别名或降级。 市场与技能体系硬切割已安装 Marketplace 技能中内嵌的 MCP 服务器被禁用技能文件本身仍可读发现入口改为compozy marketplace search [query]/info entry_id/refresh--kind参数移除旧的compozy mcp install、远程skill search/install命令移除skills.allowed_marketplace_mcp、skills.marketplace.registry等设置项退役配置文件加载时会自动归档为注释 扩展需要重建扩展 manifest 和 SDK 契约 API 不兼容旧目录不能直接复用需按当前 SDK 重装或移植。扩展作者使用版本匹配的compozy/extension-sdknpm或sdk/go模块见 sdk/go/用compozy extension init脚手架新工程。网络可达性现在通过[gateway]权限声明旧network_participationmanifest 不会被转换。 技能Skills的新家v0.3 的dev-cycle扩展内置 8 个保留的流程技能cy-create-spec、cy-execute-task、cy-review-round、cy-fix-reviews等。v0.2 的compozy setup复制/软链技能到外部 CLI 目录的安装器已移除——改用守护进程管理的compozy skill、compozy agent和扩展资源面。官方技能指南位于 skills/compozy/。浏览器页面路径也变了Web 端不做任何旧路由重定向语义映射如下摘自迁移指南台账v0.2 页面v0.3 页面/工作流仪表板v0.3 根即操作系统主页/memory、/memory/:slug/knowledge与/settings/memory/reviews/.../loops/review-and-fix、/loop-runs/:runId/runs、/runs/:runId/loop-runs、/session/:id/workflows/loops/workflows/:slug/tasks/tasks、/tasks/:id迁移前检查清单 ✅照着做五分钟完成准备工作备份全局~/.compozy/与各工作区.compozy/目录、config.toml跑旧转换器仅限 XML 时代产物如果任务树里还有task_context标签先在 v0.2.15 中运行compozy migrateXML → frontmatter 转换器再换 CLI清理冲突目录把旧版独占的agents/、extensions/移出.compozy/命名空间不要让 v0.3 收录旧格式干净启动不要拷贝global.db、daemon socket、锁、日志、运行目录等任何 v0.2 状态配置手动翻译按上表改写为全新 v0.3 配置先 dry-run--dry-run -o json检查输入来源与运行时信息确认无误再真跑跟随末行/loop-runs/idURL 观察保留备份直到 beta 旅程与必要的任务证据都验证通过迁移之后全新工作流长什么样安装完成后v0.3 的首次运行只有三步见 README.md Quick Startcompozy install compozy daemon start compozy session new --agent general --name first-run会话、Loop 运行都属于守护进程——关闭任何客户端都不会丢失工作这正是从终端脚本走向智能体操作系统的核心体验。升级完成后若遇到问题用compozy doctor -o json做结构化诊断或查阅 MIGRATION_GUIDE.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），仅供参考