CompozyOS v0.2 迁移 v0.3 完整指南：命令变更映射与破坏性变化全清单-二趣网

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/compozy

CompozyOS 是 AI 智能体的"操作系统"：接入你已在用的 Agent CLI（Claude 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.md），compozyformula 要到 v0.3.0 稳定版才回归。

推荐三条安装路径（详见 README.md 的 Installation 章节）：

方式	命令	注意
官方验证安装器	`curl -fsSL https://compozy.com/install.sh \\| sh`	固定最新版 beta，安装前校验 Sigstore 来源
NPM	`npm install -g @compozy/cli@beta`	必须带`@beta`标签
Go	`go install github.com/compozy/compozy@<release-tag>`	`@latest`在 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 demo`	`compozy loop run --name implement-tasks --input slug=demo`	在项目树中执行，使用内置任务实现 Loop
`--task-runtime type=frontend,ide=codex,model=...`	`--runtime type=frontend:codex/gpt-5.5-codex@xhigh`	`--runtime`可重复，还支持`worker=`、`judge=`等选择器
`--auto-commit`	`--input auto_commit=true`	两个内置 dev-cycle Loop 均支持，均不推送
`compozy reviews fix <task>`	`compozy loop run --name review-and-fix --input task_name=<task>`	由 CompozyOS 审查 Agent 生成新一轮审查
`compozy exec "prompt"`	`compozy session new --agent <name>`然后`compozy session prompt <id> "prompt"`	v0.3 显式化持久会话
`compozy agents list`/`agents inspect`	`compozy agent list`/`compozy agent info <name>`	Agent 定义现在是守护进程管理的资源
`compozy mcp-serve`	`compozy mcp serve`	relay 绑定推断出的工作区
`compozy workspaces list/show/register`	`compozy workspace list/info/add/remove`	旧的`resolve`动词无直接替代
`compozy daemon start`	先执行一次`compozy install`，再`compozy daemon start`	`install`只引导配置和默认 Agent，不启动守护进程
`compozy daemon status`	`compozy status`	支持`-o json`结构化输出
`compozy ext list/install/...`	`compozy extension list/install/...`	扩展 manifest 与 SDK 契约不兼容，需重装或移植
`compozy runs watch <id>`	`compozy 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、--detach：TUI 附加模式移除，改用 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 attach
compozy ext旧命令与旧 manifest API 被不兼容地替换
面向库使用的 Go facade（compozy.go、pkg/compozy/{events,runs}）移除：如需库能力请固定在 v0.2.x，v0.3 是产品不是库

📄 配置翻译（无自动迁移器）

compozy migrate config不在当前 beta 中提供，不要围绕它做自动化。需要手工对照翻译，几个核心项：

v0.2 配置	v0.3 去向
`defaults.ide`/`defaults.model`	展开到`loops.defaults.{delivery,watch}.runtime_defaults.{worker,judge}.provider / model`
`defaults.timeout`	`session.limits.timeout`
`defaults.auto_commit`	`loops.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 → kiro；droid、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-sdk（npm）或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 migrate（XML → frontmatter 转换器），再换 CLI
清理冲突目录：把旧版独占的agents/、extensions/移出.compozy/命名空间，不要让 v0.3 收录旧格式
干净启动：不要拷贝global.db、daemon socket、锁、日志、运行目录等任何 v0.2 状态
配置手动翻译：按上表改写为全新 v0.3 配置
先 dry-run：--dry-run -o json检查输入来源与运行时信息，确认无误再真跑，跟随末行/loop-runs/<id>URL 观察
保留备份，直到 beta 旅程与必要的任务证据都验证通过

迁移之后：全新工作流长什么样

安装完成后，v0.3 的首次运行只有三步（见 README.md Quick Start）：

compozy install compozy daemon start compozy session new --agent general --name first-run

会话、Loop 运行都属于守护进程——关闭任何客户端都不会丢失工作，这正是从"终端脚本"走向"智能体操作系统"的核心体验。升级完成后若遇到问题，用compozy doctor -o json做结构化诊断，或查阅 MIGRATION_GUIDE.md 中对应的锚点章节逐条核对。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析