Skip to content

Cetas Home

Cetas 只解析一个 home 目录存放持久状态:配置、凭据、缓存与会话都在这里,三种入口读的都是它。

Cetas 只解析一个 home 目录来放持久状态。你所有的配置都在这里,所有入口都读它。

非空的 CETAS_HOME(环境变量)会覆盖平台用户 home;否则用平台 home(Windows 上是 USERPROFILE,然后 HOMEDRIVE + HOMEPATH;其他平台是 HOME),只有在都解析不出来时才退回当前目录。本文档用 <CETAS_HOME> 指这个解析出来的用户 home,持久状态的根是 <CETAS_HOME>/.cetas:

<CETAS_HOME>/.cetas/
├── settings.json        # 供应商、选择项、工作流、子代理
├── credentials/         # 由 /login 写入 —— 不要手改
├── model_lists.json     # 拉到的模型目录,按供应商分开
├── mcp.json             # MCP 服务器
├── sessions/            # 按客户端分开的会话记录
└── debug/               # 只在开了 CETAS_DEBUG_* 时出现

debug/ 默认不会创建:只有打开 CETAS_DEBUG_WIRE 或 CETAS_DEBUG_MCP_CATALOG 才出现。

哪些入口认这个覆盖

入口 CETAS_HOME
编辑器(cetas-acp) 认
自动化(cetas-run) 认
终端(cetas / cetas-bun) 不读 —— 直接解析平台 home

这一点在写脚本之前值得知道:在一台你为了隔离工作而设了 CETAS_HOME 环境变量的机器上,终端入口不认它,仍然解析平台 home 下的 .cetas。排查“配置不见了”之前,先确认这个会话实际用的 home。

这里放了什么,为什么共享

模型选择、凭据、MCP 配置、缓存、以及存下来的会话,共同构成了跨入口的同一个 Cetas 身份 —— 这份共享正是重点。共享状态并不承诺行为一致:每个入口有自己的交互模型、自己的续接能力。见入口(Surfaces)。

项目也可以使用文档中写明的项目级配置 —— 例如 <cwd>/.mcp.json 覆盖用户级 MCP 文件,以及 <cwd>/.cetas/agents/ 放项目作用域的子代理 kind。

备份

把目录整个复制走就行。settings.json 和 sessions/ 是最值得留的;credentials/ 也要一起搬,但要当密钥库对待;model_lists.json 只是缓存,会自己重建。

Navigation

Type to search…

↑↓ navigate↵ selectEsc close