【Agent进阶专题】数据目录介绍

本篇记录 Agent 数据放在哪里,以及用户项目和 Agent 数据如何隔离。

唯一数据根

所有专属数据集中在 LLM_TO_AGENT_HOME。未设置时默认使用:

1
~/.llm-to-agent/

开发环境可以指定其他目录,测试则可以使用临时目录。这样不会把测试数据混入日常数据。

暂定目录

首次根据项目绝对路径生成 16 位 ID,并创建基本目录,后续进入同一项目的 Workspace 都使用同一目录。

1
2
3
4
5
6
7
<LLM_TO_AGENT_HOME>/
└── workspaces/
└── <workspace-id>/
├── workspace.json
└── conversations/
└── default/
└── messages.jsonl

workspace.json 保存 Workspace ID、项目路径和当前 Conversation。消息以 JSONL 追加写入,每行一条,包含角色、内容和创建时间。

完整目录规划

后续能力会按需扩展为:

1
2
3
4
5
6
7
8
9
10
11
12
<LLM_TO_AGENT_HOME>/
├── config/
├── workspaces/
│ └── <workspace-id>/
│ ├── files/
│ ├── conversations/
│ ├── runs/
│ └── extensions/
├── extensions/
├── releases/
├── runtime/
└── trash/

这些目录会在后续实现功能时逐步创建。未来每个 Extension 管理自己的数据,不能直接修改其他 Extension 的私有内容;缓存必须可以重建,重要数据删除前优先进入 trash/。

架构、源码目录和数据目录已经介绍完成。下一篇补充 Extension 的基本结构和生命周期。