数据都存在哪
~/.klaus 下每个目录和文件装的是什么,以及设置的两个来源。
全部在 ~/.klaus/ 下:
settings.db:设置与本地状态(SQLite,WAL 模式)。sessions/:这一个目录装了两样东西——会话记录是<创建时间戳>-<会话 id>.jsonl(所以按文件名排序就是按时间排序,找某个会话搜它的 id);同名的目录则是那个会话的工作区,只有你没给它指定项目目录时才会用到,另外__klaus__是没有项目时共用的那个锚点目录。projects/<工作目录路径,斜杠换成横线>/:按项目分的会话元信息(<会话 id>.session-meta.json)和项目级记忆。从别的客户端导进来的会话记录也落在这里。所以「同一个项目下的历史会话」是靠工作目录路径归拢的,换了目录名就换了一堆。agent-memory/:记忆文件。skills/、agents/、commands/、plugins/:全局技能、子代理、斜杠命令、插件。- 日志分文件放:
cron.log(定时任务的调度与投递)、memory-maintenance.log(做梦与记忆维护)、browser-surface.log(浏览器操控)、logs/下的分项日志(MCP 诊断、频道活动等)。桌面应用的输出到不了启动它的终端,所以这些机制一律自己写文件——排查时直接看对应那一份,比翻控制台有用。
设置本身有两个来源:大多数开关与面板状态是 settings.db 里的键值行,没写过的键不存行——所以「查不到这个设置」通常意思是它还是默认值,而不是被清空了;引擎侧的配置则落在 ~/.klaus/config.toml(引擎自己读这份文件),界面上没摆出来的引擎开关都在那里改。API Key、配对令牌这类凭据也存在这里,但不会交给模型:Klaus 自己读设置时凭据字段一律是遮蔽后的值。
删掉 ~/.klaus 等于把 Klaus 恢复到初装状态,登录、设置、会话、记忆一并消失。