36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# 本地数据与目录
|
||
|
||
## 原则
|
||
|
||
数据以本地普通文件保存，保持易读、易调试、易由 Agent 修改。早期不承诺兼容性，不预先建设 schema migration；重要数据依靠备份，格式变更需要时再写一次性转换脚本。
|
||
|
||
Runtime 是唯一写入者，CLI/Web/Desktop 均通过 Runtime 读取或修改数据。
|
||
|
||
## 目录
|
||
|
||
```text
|
||
~/.agent/
|
||
tasks/<task-id>/
|
||
space.json
|
||
conversations/
|
||
runs/
|
||
workspace/
|
||
|
||
<project-root>/.agent/
|
||
project.json
|
||
conversations/
|
||
runs/
|
||
```
|
||
|
||
Conversation 与 Run 优先采用 JSONL；Space/Project 元信息采用小型 JSON 文件。生成并执行的脚本文本进入 Run 日志，不额外维护脚本库；真正写进 Workspace 的文件自然保留。
|
||
|
||
## Task 升级
|
||
|
||
Task Workspace 的组织尽量与 Project 工作区一致。升级为 Project 时，将该专属目录迁移至用户指定路径并写入 Project 元信息。
|
||
|
||
## 待细化
|
||
|
||
- ID 和文件命名规则。
|
||
- Run 日志与产物的具体划分。
|
||
- 备份、归档和数据清理策略。
|