1.0 KiB
1.0 KiB
本地数据与目录
原则
数据以本地普通文件保存,保持易读、易调试、易由 Agent 修改。早期不承诺兼容性,不预先建设 schema migration;重要数据依靠备份,格式变更需要时再写一次性转换脚本。
Runtime 是唯一写入者,CLI/Web/Desktop 均通过 Runtime 读取或修改数据。
目录
~/.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 日志与产物的具体划分。
- 备份、归档和数据清理策略。