@yxzpro/agent-acta

数据与配置

• 配置：~/.agent-acta/config.json（老位置 ~/.agent-log/、~/.atomcode/agent-log/ 启动时自动搬迁）
• 索引：~/.agent-acta/index/.json（增量偏移持久化，重启不全量重扫）
• 归档：~/.agent-acta/archive//.jsonl + manifest.json（条目级冻结，默认永久保留）
  • 每个 agent 可单独开关：在「历史归档」弹层左下直接点（写 config.json 的 archive.skip，即改即生效，不用重启）； 手改配置也行："archive": { "skip": ["cursor"] }。只停未来的归档，已冻好的文件保留
  • 同段还能配 enabled（关自动轮）、maxDays / maxMB（限量，只删整天文件）。详见 REFERENCE「历史归档」
• 全文索引：~/.agent-acta/search/.json（每条轮次的正文，一个源一条记录）。由服务自己在后台增量维护 （启动 60 秒后首轮、之后每 10 分钟一轮），不需要手工干预；手动重建用 agentacta --search-reindex（服务在跑时先 --stop）。 本机量级参考（2026-09-22 晚，常驻服务实测 /api/search/status）：648 个源 / 5111 条可查（该机共 5431 条， 余下的要么源文件已被产品删掉、要么这一轮本来就没有正文）→ 索引约 24MB。 想关掉「每条正文最多索引 8000 字」的上限，用环境变量 AGENT_LOG_SEARCH_MAX_CHARS
  • 记录按绝对路径认源，所以把 ~/.agent-acta 搬去另一台机器/另一个平台后，载入时会把对不上本机的 记录剪掉并重扫（日志与 /api/search/status.pruned 都会报数）。POSIX 上 search/ index/ archive/ 三处都按私有新建（0700/0600，里面是明文对话）；老文件不动，要一次收干净就 chmod -R go-rwx ~/.agent-acta
• 端口：默认 14570，环境变量 AGENT_LOG_PORT 可覆盖
• pid 文件：~/.agent-acta/server-.pid