# 数据目录

## 唯一数据根

所有 llm-to-agent 专属数据集中在 `LLM_TO_AGENT_HOME`。未设置时默认使用：

```text
~/.llm-to-agent/
```

开发环境可以指向另一个用户目录，测试使用临时目录。

## 物理目录

```text
<LLM_TO_AGENT_HOME>/
├── config/
├── workspaces/
│   └── <workspace-id>/
│       ├── files/
│       ├── conversations/
│       ├── runs/
│       └── extensions/
├── extensions/
├── releases/
├── runtime/
└── trash/
```

目录按需要创建，不规定尚未实现的数据文件和格式。

当前对话链路只会创建 Workspace 绑定信息和
`conversations/default/messages.jsonl`，后续能力再增加自己的数据。

## Workspace

- `managed` Workspace 的工作文件位于自己的 `files/`。
- `linked` Workspace 只记录用户已有目录的绑定关系。
- 两种 Workspace 的 Conversation、Run、记忆和 Extension 数据都位于数据根目录。

## 项目目录零落地

绑定外部项目时，项目源码保留在原位置，所有 llm-to-agent 专属数据仍保存在：

```text
<LLM_TO_AGENT_HOME>/workspaces/<workspace-id>/
```

项目中不创建 `.llm-to-agent/` 或其他专属元数据。项目移动时更新绑定关系；删除 linked Workspace 绝不能删除外部项目源码。

## 数据规则

- Kernel 只提供安全路径、隔离和基础写入机制，不理解业务数据。
- 每个 Extension 管理自己的数据，不能直接修改其他 Extension 的私有内容。
- 缓存和临时数据必须可以清理重建。
- 删除重要数据默认先进入 `trash/`，迁移和修复前先保留可恢复副本。