# 本地数据与目录

状态：todo  
期望阶段：P1

## 原则

数据以本地普通文件保存，保持易读、易调试、易由 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 日志与产物的具体划分。
- 备份、归档和数据清理策略。