Skip to content

数据存储

查询配置、Session、Goal、Team、认证、缓存和恢复数据的位置。

Updated View as Markdown

kxen 采用本地优先存储,当前没有 kxen 云同步服务。

目录

数据 macOS 位置
用户配置 file:///Users/you/.config/kxen/
应用数据 file:///Users/you/Library/Application%20Support/kxen/
缓存 file:///Users/you/Library/Caches/kxen/
项目配置 file:///path/to/workspace/.kxen/
项目知识 file:///path/to/workspace/.agents/
个人知识 file:///Users/you/.agents/

Session

每个 Session 使用一个 JSON meta 文件和一个 JSONL 消息文件。消息追加写入,meta 通过临时文件和 rename 更新。

Session 可以包含文本、隐藏上下文、工具调用、推理、图片和 Approval 结果。图片以内联数据保存,使 fork、导出、rewind 和删除保持自包含。

Goal 和 Team

Goal 保存在应用数据的 goals 子目录。Team 配置、共享任务、inbox 和 member transcript 保存在 teams 子目录。

凭证

认证数据保存在权限受限的 auth.json。配置文件只保存路由选择,不保存 API key 或 OAuth token。

认证文件不得提交到 Git。复制或删除认证数据前先退出应用,并确认目标文件权限。

Checkpoint

Checkpoint 使用独立 shadow Git repository,不写入 Workspace 自身的 .git

删除

生产环境中的文件和 Session 删除进入 macOS 废纸篓。清理整个应用数据目录会同时影响 Session、Goal、Team、认证和恢复状态,不能当作普通缓存清理。

Navigation

Type to search…

↑↓ navigate↵ selectEsc close