OpenRig 多智能体编排 OPENRIG_HOME 实例布局完全图解config、state、context 逐目录讲解【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个开源的多智能体编排工具它把 Claude Code、Codex 等 AI 编码智能体组织成一支持久化的智能体团队agent team统一管理角色、共享上下文和各自的任务。当你运行rig命令启动团队时OpenRig 会把所有受管状态都放进一个统一的实例目录——$OPENRIG_HOME默认~/.openrig。本文带你逐目录看懂 config、state、context 等核心目录的用途以及安全备份与迁移实例的方法。1. 实例目录在哪里如何定位 OPENRIG_HOMEOpenRig 的所有实例状态数据库、配置、日志、转录都集中在$OPENRIG_HOME下。项值环境变量OPENRIG_HOME默认路径~/.openrig状态存储位置说明ARCHITECTURE.md几个新手常问的问题改了OPENRIG_HOME能完全隔离环境吗不能。它只隔离实例状态Claude Code / Codex 的 provider 配置仍写在家目录~/.claude.json、~/.codex/等详见 README.md 中 What OpenRig changes on your machine 一节。初始化是安全的吗是。实例初始化器只创建缺失的受管条目绝不覆盖已有文件对已收敛的实例重复运行不会产生任何写入。官方对目录结构的权威定义在 docs/reference/instance-layout.md建议收藏对照。2. config 目录config.json 里都存了什么实例根目录下的config.json是类型化的实例设置文件首次启动时以空对象创建之后按需追加配置。它的完整结构定义在 packages/cli/src/config-store.ts 的RiggedConfig接口中主要分组如下配置组作用示例键daemon守护进程监听地址port默认 7433、hostdbSQLite 数据库路径db.pathtranscripts终端转录捕获enabled、path、linesworkspace项目工作区各子路径root、specsRoot、catalogPathtopology拓扑树根目录topology.rootcontext可寻址上下文库root、systemWorldskills托管技能目录skills.rootui/feed/runtimeWeb UI、订阅、运行时开关ui.enabled等配置解析优先级环境变量 config.json 内置默认值例如OPENRIG_CONTEXT_ROOT会覆盖context.root。配置文件更新时采用原子替换写入POSIX 下保留原文件的属主与权限位避免半写状态。3. state 目录运行时持久状态的家state/存放运行时拥有的持久状态其中最关键的是 SQLite 数据库openrig.sqlite见 ARCHITECTURE.md 第 89 行附近的 State 说明。数据库承载智能体团队rig、座位seat、队列queue会话注册表、消息投递记录事件与活动索引守护进程启动时会先完成实例布局对账reconcile再打开数据库并绑定监听端口因此 state 目录的存在顺序是启动链路的第一环。4. context 目录可寻址的上下文库context/是 0.5.9 版本引入的可寻址上下文库addressable context library由context.root配置默认$OPENRIG_HOME/context。核心文件context/ system/ system-world.yaml # 实例级基线上下文包引用 技能身份清单System World在角色/项目上下文之前选定的全实例基线清单可用context.system_world切换为default、显式路径或disabled。rig context add和 bundle 安装都会落到同一个受配置控制的落地根目录旧拼法context.packs_root会被直接拒绝不是兼容别名。查看当前生效状态可用rig context work-install --json加--runtime还能看到 System World 拓扑 项目世界合并后的技能装载。5. 其余目录速览一张表看懂整个布局完整官方树形图在 docs/reference/instance-layout.md这里给出通俗版速查目录归属者通俗解释config.json实例初始化器类型化实例设置首次创建为空对象state/运行时持久状态与 SQLite 数据库context/上下文工作流可寻址上下文库 System Worldskills/技能目录工作流托管技能目录skills.root初始为空workspace/Project Workspace 契约项目工作树见下节specs/spec 库工作流实例规范库rig/agent spec 源文件topology/拓扑工作流实例→rig→pod→seat 的连续性树plugins/守护进程已安装的 OpenRig 插件run/进程协调PID/锁等进程协调文件logs/守护进程守护进程与操作日志transcripts/转录捕获每个座位的持久终端转录backups/操作者手工创建的恢复产物secrets/操作者本地连接器与主机密钥6. workspace 子目录项目工作树的固定形状workspace/的形态由 docs/reference/project-workspace.md 契约固定rig config init-workspace会按需创建workspace/ SPEC.md # 项目意图说明 project.yaml # 项目上下文与技能选择 workspace.yaml # 项目位置目录catalog .gitignore missions/ # 任务mission exhaust/ # 归档输出脚手架是增量式的只补缺失的规范条目永远不覆盖已有文件。技能源字节存放在skills/目录而不在项目树内项目里只通过install.skills声明稳定的技能 ID。7. 实用技巧备份、迁移与安全操作备份复制$OPENRIG_HOME下你最关心的三样即可恢复核心状态——config.json、state/数据库、context/含 System World。backups/目录就是为操作者恢复产物准备的。迁移实例设置OPENRIG_HOME指向新路径即可但注意旧版本的 telemetry/库迁移请遵循 README 中的openrig-upgrade迁移助手流程plan → apply → verify → finalize支持--rollback。升级注意升级安装可能遗留独立的旧 spec 库specs/目录的创建不代表旧 spec 已合并请用运行中的 spec 库命令确认 spec 的实际来源。⚠️只读保护只读的 config 文件会被直接拒绝写入磁盘写满ENOSPC等错误下原子替换路径会保持原文件完整。8. 延伸阅读实例布局权威文档docs/reference/instance-layout.md项目工作区契约docs/reference/project-workspace.md配置存储源码packages/cli/src/config-store.ts架构总览ARCHITECTURE.md上手指南docs/reference/getting-started.md【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考