CompozyOS多Profile工作分区：一个daemon同时管理多个项目与多人的最佳实践-二趣网

CompozyOS多Profile工作分区：一个daemon同时管理多个项目与多人的最佳实践

【免费下载链接】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 操作系统：把它已在用的 Agent CLI（Claude Code、Codex、Gemini CLI、Cursor）接入同一个 daemon，它们就能分工协作、共享项目记忆。而多 Profile 工作分区正是 CompozyOS 让"一台机器、一个 daemon、多个项目、多个人"互不干扰的核心机制：每个 Profile 都是一个独立的工作上下文，会话、任务、Loop 运行、自动化任务在创建的那一刻就被归档到唯一 Profile 之下，切换 Profile 后列表、计数、徽章只展示当前上下文的工作。

为什么一个 daemon 需要多个工作分区

没有 Profile 之前，上午做产品开发、下午写发布文案、周五处理账单，所有列表全部混在一起。Profile 把"谁在工作"这个维度显式化了：

Profile 隔离的内容：会话、任务、Loop 运行、自动化及其运行记录、用量与花费归属、profiles/<name>/下的配置 / MCP / Agent / 技能层、Vault 中的密钥覆盖、桌面与窗口布局、工具审批授权、Profile 作用域记忆。
跨 Profile 共享的内容：工作区（项目文件夹）、已安装扩展（各 Profile 自行决定开/关）、用户级凭据、原生 Provider CLI 登录、仓库提交的记忆、daemon 身份（端口、数据库、日志、网关）。

换句话说：daemon 只有一个，工作却可以按项目、按角色、按人分开记账。

⚠️ 官方明确：Profile 是"隔离，不是安全"。它组织工作，不做访问控制——任何 Profile 都可以随时被选中。真正的多人权限隔离是另一个独立的程序，不在 Profile 功能范围内。

5分钟上手：创建你的第一个 Profile

以官方引导流程为例（约十分钟，全程无破坏性操作）。

第一步，创建 Profile——名字用小写字母、数字和连字符，以字母开头，最长 32 字符：

compozy profile create marketing --color '#FF7F3A' --icon megaphone

第二步，确认当前所在 Profile（括号里是解析来源，不是装饰）：

compozy profile current # marketing (remembered choice of workspace my-saas)

第三步，在里面干活。新建的会话会立刻被打上marketing印记，且永不改变：

compozy session new --workspace my-saas --name launch-tweet-thread compozy profile use default # 切回去后，marketing 的会话就从列表中"消失"了

切换后再次compozy session list，marketing 的会话不会出现在结果里——不是被删除，而是"归档到了别处"。选择是按工作区记忆的，下次回到该工作区仍停留在你上次的选择。

一键切换：Profile 解析顺序与命令面板

CompozyOS 按固定顺序解析 Profile，并在结果中说明是哪一环生效的：

根级--profile <name>标志（只影响单条命令）
COMPOZY_PROFILE环境变量
该工作区记忆的选择（compozy profile use <name>持久化到这里）
永久存在的default

偏好图形界面？打开命令面板执行Profiles（命令palette.view.profiles），按回车即可切换；创建、重命名、归档、删除等生命周期命令也走同一套本地 API，不存在第二套实现。脚本和 Agent 则可以直接读取compozy profile current -o json的source字段（flag/env/remembered/session/default）做自动化。

多项目并行：daemon 替你过滤，且"失败即关闭"

这是 Profile 机制最关键的设计：过滤发生在 daemon 端，而不是客户端。无论 HTTP 还是本地连接，读取会话、任务、Loop 运行、自动化、用量时，都只返回当前 Profile 拥有的记录，且解析失败时宁可报错也不返回未过滤的数据（fail closed）。

需要全局视角时，用--all-profiles拿到跨 Profile 的聚合视图，每一行都带上profile_name归属标签：

compozy session list --all-profiles -o json

注意--profile与--all-profiles不能同时使用，daemon 会明确拒绝而不是猜。唯一的例外是 worktree：它们在所有 Profile 中都可见（带归属标签），因为描述的是工作区的文件系统状态。

多人协作：把 Profile 提交到仓库共享

Profile 的"团队共享"姿势是：把.compozy/profiles/<name>/目录提交进项目仓库。这个目录里的config.toml、mcp.json、Agent 定义（agents/<agent>/AGENT.md）、技能（skills/<group>/<skill>/SKILL.md）都是只读的仓库层配置，当目录名与激活的 Profile 名匹配时自动生效。

这样团队里的每个人克隆仓库后，eng、review这样的 Profile 各自带着专属的默认 Agent、MCP 服务器和技能，开箱即用；个人级的密钥、记忆仍留在各自机器的~/.compozy/profiles/<name>/下，互不污染。

每个 Profile 还可以独立持有：

独立默认值：compozy config set defaults.agent copywriter会写入profiles/marketing/config.toml，只影响该 Profile；
独立密钥：compozy secret set providers/openai/api_key --value-stdin存入 Vault 的profiles/marketing/命名空间，不进 shell 历史，用量照常归属到该 Profile；
独立扩展开关：扩展每台机器只装一次，compozy extension disable <name>只改变当前 Profile 的开/关状态。

生命周期管理：归档、恢复与安全删除

重命名、归档、删除都是"计划式"变更：先读取影响预览（plan），再提交plan_revision，daemon 会拒绝过期的计划，防止应用没预览过的副作用。

compozy profile archive finance # 暂停自动化、冻结排队任务，运行中的会话会阻止归档 compozy profile unarchive finance # 恢复可选状态 compozy profile delete scratch --yes # 仅在 Profile 名下无工作时允许

defaultProfile 永远不能被重命名、归档或删除；失败的多步操作保留在compozy profile ops中，可按操作 ID 重试。

最佳实践清单 📋

按项目建 Profile：一个产品一个名字，会话、Loop、花费自动分开记账；
按角色建 Profile：给不同开发者不同默认 Agent 与技能集，通过仓库层下发；
记住解析顺序：CI 脚本里显式用--profile，交互开发用compozy profile use持久化；
跨项目汇报用--all-profiles：一次拉全量带归属标签的聚合视图；
归档代替删除：不再活跃的项目用archive保留历史工作，需要时随时恢复；
别把 Profile 当权限墙：需要真正保密隔离的场景请配合独立实例或独立账号。

参考路径

Profile 核心概念：docs/profiles/index.mdx
首次创建引导：docs/profiles/quickstart.mdx
解析与切换规则：docs/profiles/selection.mdx
聚合读取规则：docs/profiles/reads.mdx
生命周期管理：docs/profiles/lifecycle.mdx
文件位置（含仓库共享层）：docs/configuration/file-locations.mdx
源码入口：internal/profile/（身份、选择、解析与生命周期实现见 types.go、manager.go）

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

企业官网建设流程全解析