llm-to-agent/docs/data-layout.md

数据目录

唯一数据根

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

~/.llm-to-agent/

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

物理目录

<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 专属数据仍保存在：

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

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

数据规则

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