elegant01/agent-acta ↗★ 0

@yxzpro/agent-acta

本地 AI agent 请求日志面板:聚合 atomcode / codebuddy / workbuddy / claude / codex / codearts / gemini / cursor / kimi / dsh 等本地日志,看每轮耗时、token、缓存、上下文与工具调用 适合需要监控和分析多款本地AI工具耗时、Token及上下文调用的开发者。

パッケージ
@yxzpro/agent-acta
互換性
未検証
バージョン
2.14.8
ライセンス
MIT
最終更新
2026/10/08

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:elegant01/agent-acta

ドキュメント

README 全文を読む ↗

数据与配置

  • 配置:~/.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