CompozyOS Daemon 运维指南：SQLite 状态管理、config.toml 配置与 doctor 故障排查

CompozyOS Daemon 运维指南SQLite 状态管理、config.toml 配置与 doctor 故障排查【免费下载链接】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 操作系统把你已在用的 Agent CLIClaude Code、Codex、Gemini CLI、Cursor接进来让它们像一支团队一样分工协作、交接任务、运行自动化 Loop并共享同一份项目记忆——而这一切都由一个常驻的本地Daemon驱动你在浏览器里完成所有指挥。对于新手来说日常运维只需盯住三件事SQLite 状态文件怎么组织、config.toml 怎么改、出了问题怎么用 doctor 排查。本文用最短的路径讲透这三块让你 5 分钟建立起完整的运维心智。1️⃣ 先认识 DaemonAI Agent 团队的常驻大脑CompozyOS 的会话、任务、Loop 运行、记忆和工具都归 Daemon 所有daemon-owned这意味着关掉浏览器工作不断——会话属于 Daemon 而不是终端或窗口多客户端共享同一份状态——Web 界面、CLI、其他程序读取的都是同一个 Daemon 里的真相状态全部落盘——核心数据由 SQLite 文件持久化重启后一切照旧常用生命周期命令compozy daemon start # 启动本地 Daemon compozy status # 查看运行状态 compozy daemon stop # 停止 DaemonDaemon 启动后默认监听~/.compozy/daemon.sockUnix 域套接字和localhost:2123HTTP浏览器控制台就是挂在这个 HTTP 端口上的2️⃣ SQLite 状态管理compozy.db 与 events.db 双层设计CompozyOS 的所有持久化状态都写在本地 SQLite 文件里采用一个全局索引库 每会话一个事件库的双层结构见 internal/store/store_paths.go全局索引库~/.compozy/compozy.db这是整个系统的总账本位于 internal/store/globaldb/集中存储会话与任务会话目录、任务认领claim/lease、任务图谱Loop 与自动化Loop 节点、自动化定义、调度器、WebhookGoal 与心跳目标绑定、检查点、Agent 心跳健康工作区资源worktree、Vault 凭据、扩展环境会话级事件库会话目录/events.db每个会话拥有独立的events.db事件流加一份轻量的meta.json快速元数据查询。这种拆分带来两个运维好处删一个会话 删一个目录全局库不受影响大事件流不拖累全局索引的读写性能打开库时做了什么连接池 自动迁移 损坏自愈所有数据库统一通过 internal/store/sqlite.go 打开自动创建缺失目录、应用 PRAGMA 参数、设置连接池上限、启动时自动执行增量迁移迁移机制见 internal/store/migrate.go 与迁移步进器。如果你担心文件损坏代码库内置了专门的探测与恢复路径internal/store/sqlite_corruption.go、internal/store/sqlite_probe.go并在启动阶段做健康检查——这也是后面 doctor 探针的数据来源。运维提示备份 CompozyOS 状态 ≈ 备份~/.compozy/目录即可迁移在升级时自动完成无需手工操作 SQL。3️⃣ config.toml 配置速查三层优先级 常用配置项配置文件的三层优先级CompozyOS 的配置遵循清晰的覆盖顺序详见 README.md 的 Config Files 一节命令行显式参数最高优先级工作区配置.compozy/config.toml只覆盖当前项目全局配置~/.compozy/config.toml默认值来源内置默认值最低优先级可参考仓库根目录的 config.toml 模板常用配置项速查表配置段关键项默认值说明[daemon]socket~/.compozy/daemon.sockDaemon 套接字路径[http]host/portlocalhost:2123Web 控制台监听端口[defaults]agent/providergeneral/claude新会话的默认 Agent 与供应商[limits]max_concurrent_agents20同时运行的 Agent 数上限[session.attachments]max_file_bytes10485760单附件上限10MB[loops]reconcile_interval1mLoop 对账轮询间隔[observability]retention_days7可观测数据保留天数[log]levelinfo日志级别debug/info/warn改完配置怎么验证compozy config path # 查看生效的配置文件位置 compozy config validate # 校验配置合法性 compozy config show -o json # 查看合并后的最终配置这三条命令是配置排障的黄金组合——尤其是config show它显示的是所有层合并后的最终结果能瞬间定位我明明改了为什么没生效。4️⃣ doctor 故障排查一条命令体检整个系统当 Agent 行为怪异、子进程失联、或者 Daemon 状态不对劲时用compozy doctor做系统体检。它的实现位于 internal/doctor/doctor.go设计得非常运维友好内置探针都在查什么探针文件检查内容子进程健康subprocess_health_probe.goAgent 子进程是否存活、是否僵死运行时内存runtime_memory_probe.go运行时内存水位与阶段快照死实体探测dead_entity_probe.go数据库中指向已删除资源的死引用会话元数据session_metadata_probe.go会话元数据一致性三个让排查变快的设计细节超时兜底整轮体检默认 30 秒单个探针 5 秒超时——探针卡死也不会拖垮诊断自动脱敏每条诊断结果都会经过脱敏与格式校验后才输出可安全地贴给他人求助可过滤执行支持按探针 ID 或分类筛选--only/--exclude--quiet模式只报问题项常用诊断命令组合compozy doctor -o json # 完整体检结构化输出 compozy status # 先看 Daemon 基本状态 compozy app diagnose --bundle # 生成脱敏诊断包用于深度排障排障顺序建议status看活没活 →doctor找坏在哪 →app diagnose --bundle打包留证。诊断报告的脱敏与打包逻辑见 internal/cli/app_diagnose.go。5️⃣ 日常运维清单3 个习惯养成肌肉记忆升级前compozy config validate确认配置兼容迁移会自动处理 schema 变更异常时compozy doctor -o json先看探针报告再决定是否导出诊断包交接时备份~/.compozy/含compozy.db与会话目录即完成全部状态迁移写在最后CompozyOS 的运维模型其实很轻一个 Daemon 进程、两个 SQLite 文件、一份 config.toml、一条 doctor 命令。理解状态归 Daemon 所有、SQLite 落盘为真相源这一条主线配合上文的配置速查表和探针清单你就能从容驾驭任何 Agent 团队规模。 延伸阅读internal/store/ 存储层源码 · internal/doctor/ 诊断探针源码 · config.toml 完整默认配置【免费下载链接】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），仅供参考