JSONL_SCHEMAS.md

Coco 创世纪

JSONL Schema Registry · Coco记忆体系

版本:V1.0 | 日期:2026-02-24 作用:记录系统所有关键JSONL文件的字段结构,让AI在读取前就了解数据格式 规则:新建手动维护JSONL文件必须在第1行写入_schema条目;系统生成文件在此注册


规范说明

类型A:手动维护JSONL(新建时必须加_schema首行)

格式:

{"_schema": "文件类型名", "_version": "1.0", "_description": "字段说明。包含:字段1/字段2/..."}

已实施文件: - 创世纪/decisions.jsonl ✅ - 创世纪/experiences.jsonl ✅ - 创世纪/failures.jsonl

类型B:系统自动生成JSONL(不加首行,在此注册schema)


系统生成文件 Schema 注册

1. 任务历史 _task_history/tasks.jsonl

字段:task_id / agent_name / prompt / session_id / status /
      model / work_dir / files_created / started_at / completed_at /
      error / cost / duration_ms
状态值:running | completed | failed
说明:记录每次Agent执行的完整任务记录,status会从running更新为completed

2. 活动日志 03-Coco首席助理/活动日志/YYYY-MM-DD.jsonl

字段:timestamp / type / agent / status / prompt /
      duration_ms / cost / files / verification_passed / task_id
type值:task_complete | task_start | task_error
说明:每次Agent完成任务后写入,按日期分文件

3. 会议记录 chat_data/_meetings/meetings.jsonl

字段:meeting_id / topic / creator / participants / description /
      status / comments / created_at / started_at / ended_at / minutes /
      current_speaker_index / william_has_spoken / william_summary
comments字段:[{comment_id, speaker, content, timestamp}]
status值:planning | in_progress | completed
说明:每次会议存一个JSON对象(单行),含完整会议记录和生成的会议纪要

4. 审计日志 audit_logs/audit-YYYY-MM-DD.jsonl

字段:timestamp / event_type / agent / action / detail /
      decision / decided_by / prev_hash / hash
event_type值:kill_switch | approval | permission_change | security_event
说明:链式哈希,prev_hash指向上一条记录的hash,形成不可篡改审计链

5. 活动事件 event_logs/activity-YYYY-MM-DD.jsonl

字段:icon / title / detail / category / source / timestamp / entry_id / time_str
category值:model | task | system | memory | content
说明:虚拟办公区实时活动流,由dispatcher和各模块写入

6. 防火墙日志 03-Coco首席助理/审计日志/firewall_YYYY-MM-DD.jsonl

字段:timestamp / event_type / agent / action / detail /
      decision / decided_by / prev_hash / hash
说明:安全事件专用日志,格式与audit_logs相同,链式哈希

7. 模型路由指标 _metrics/routing_metrics.jsonl

字段(推测):timestamp / model / request_type / tokens / latency / cost
说明:记录LiteLLM路由决策和模型使用统计

8. Agent对话历史 chat_data/{AgentName}/history.jsonl

字段:role / content / timestamp / session_id
role值:user | assistant | system
说明:每个Agent的对话历史,按session_id分组

9. 绩效评审 review_data/reviews_YYYY-MM-DD.jsonl

字段(推测):agent_name / review_date / scores / level / comments
说明:由agent_review.py生成,记录Agent绩效评审结果

10. 意象视频生成历史 _jimeng_history/generations.jsonl

字段(推测):generation_id / prompt / status / video_url / created_at
说明:即梦AI视频生成记录

新文件创建规范(铁律)

Coco创建新JSONL文件时,必须遵守:

  1. 如果是手动维护的记忆/决策/经验文件 → 第1行必须是_schema条目
  2. 如果是系统代码生成的文件 → 在本注册表添加schema描述
  3. 新注册表条目必须说明:字段列表 + 状态值枚举 + 一句话用途说明

Schema Registry V1.0 | 2026-02-24