58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# 本地数据与配置
|
||
|
||
## 全局数据根目录与 Space 注册表
|
||
|
||
**实现阶段：P1**
|
||
|
||
- 建立 `~/.agent/` 全局目录、Runtime 数据和 Space 注册表。
|
||
- 注册表保存 Space 的 ID、类型、名称、真实路径和最近访问，用于定位 Task 与分散的 Project。
|
||
- 处理首次启动、目录缺失、重复注册和路径不可访问等情况。
|
||
|
||
## Space、Conversation 与 Run 文件仓库
|
||
|
||
**实现阶段：P1**
|
||
|
||
- 使用普通 JSON 保存当前元信息，使用 JSONL 保存消息与追加式 Run 记录。
|
||
- 支持创建、读取、更新和列出 Space、Conversation、Message、Run。
|
||
- 采用临时文件替换等简单方式保证单次写入完整，异常文件能够被识别并报告。
|
||
|
||
## 统一工作区目录
|
||
|
||
**实现阶段：P1**
|
||
|
||
- Task 根目录本身就是 Workspace，内部使用 `.agent/` 保存 Agent 数据。
|
||
- Project 使用相同目录形状，使 Task 可以整体移动并升级为 Project。
|
||
- 明确工作文件、Agent 元数据和全局注册信息各自的所有权。
|
||
|
||
## Run 日志与产物仓库
|
||
|
||
**实现阶段：P2**
|
||
|
||
- 保存模型调用、Tool 调用、Shell 输出、错误、测试结果和 Diff 等执行记录。
|
||
- 将日志中的一次性内容与需要长期保留、预览或下载的 Artifact 分开管理。
|
||
- 支持通过 Conversation、Run 和 Tool 调用定位相关记录与文件。
|
||
|
||
## 配置体系与覆盖规则
|
||
|
||
**实现阶段：P4**
|
||
|
||
- 管理全局、Space、Profile 和客户端配置，并定义清晰的覆盖顺序。
|
||
- 区分普通配置、凭据引用和运行时临时选项。
|
||
- 支持查看配置最终值、来源、修改和恢复默认值。
|
||
|
||
## 缓存、索引与临时数据
|
||
|
||
**实现阶段：P6**
|
||
|
||
- 为代码索引、知识检索、网页内容和模型缓存提供统一存放位置。
|
||
- 缓存可重建且不与原始数据混淆，支持容量统计和按类型清理。
|
||
- 保持 Project 数据、全局数据和临时数据之间的边界。
|
||
|
||
## 数据导入、导出与修复
|
||
|
||
**实现阶段：P8**
|
||
|
||
- 支持全局或按 Space 导出、导入、备份和恢复。
|
||
- 提供目录迁移、格式升级、完整性检查和损坏数据修复工具。
|
||
- 备份过程可验证，恢复前保留现有数据的回退副本。
|