智能体开发中，日志通常分散在本地磁盘的不同路径，难以在一个界面查看轮次耗时、Token 消耗、缓存命中率与工具调用明细。DeepSeek Harness（DSH）插件 agent-acta 提供了一个本地常驻服务，聚合多款 AI Agent 写在磁盘上的会话日志，在浏览器中展示每一「轮次/请求」的详细数据。
插件简介¶
- 名称：
agent-acta - 维护者：elegant01
- 定位：本地 AI agent 请求日志面板，支持多款 Agent 日志聚合与只读旁路监控。
核心功能¶
- 日志聚合：聚合多款 AI Agent 写在磁盘上的会话日志，支持 31 家 Agent（atomcode, codebuddy, workbuddy, claude, codex, cursor, trae, qoder, opencode, gemini, copilot, windsurf, codearts, kimi, dsh, zcode, doubao, hermes, devin, minimax, mimocode, kilo, openclaw, comate, cline, pi, qwen, crush, droid, goose, openhands）。
- 详细分析：查看每一「轮次/请求」的耗时、Token、缓存命中、上下文占用与工具调用明细。
- 纯本地运行：无外部依赖、无网络上报、纯只读旁路（不注入、不改各 Agent 的配置）。
- 桌面悬浮卡片：提供 Electron 小窗，展示今日/累计 Token 与最新卡片流。
- MCP Server 支持：可作为独立进程、直读日志，为 Claude / Cursor 等客户端提供只读工具。
- 搜索与归档：支持全文搜索（按回车搜）与历史归档（浏览
~/.agent-acta/archive/）。 - 单轮复现包：支持导出原始日志片段与完整解析结果，用于排查问题。
安装与启用¶
在安装前，请确保机器上已安装 Node.js 且版本不低于 22.5。
在 DSH 客户端中添加插件：
dsh plugin --profile desktop add "@yxzpro/agent-acta"
安装完成后，必须彻底退出 DSH 进程后再启动（只关闭窗口无效，需确保进程完全终止），插件才会生效。
典型用法¶
安装插件后，左侧栏会出现「AgentActa」图标。点击图标即可在中间栏占一整块面板查看日志。如果命令行服务 agentacta 未运行，插件会在宿主进程中自动启动一套服务；如果 agentacta 正在运行，插件将直接复用该服务。
独立使用命令行工具查看日志：
# 全局安装（使用 npm）
npm i -g @yxzpro/agent-acta
# 启动服务并打开浏览器
agentacta --open
# 自检环境配置
agentacta --doctor
# 以 MCP server 形式运行
agentacta-mcp
适用场景与注意事项¶
- 适用场景：需要本地监控多款 AI Agent 运行状态、分析 Token 消耗与工具调用效率的开发者。
- 依赖要求：机器上需要 Node.js（>=22.5）。
- 平台兼容性：Windows 是主要验证平台；macOS / Linux / 鸿蒙 PC 的代码路径已就位但未在真机端到端跑过。
- DSH 插件特性：插件不唤起悬浮卡片，不注入、不改各 Agent 的配置；仅读取本机 Agent 日志，无网络出口。
总结¶
agent-acta 是一个专注于本地日志聚合与可视化的 DSH 插件，通过纯只读旁路的方式，帮助开发者在不修改 Agent 配置的前提下，集中查看轮次耗时、Token 统计与工具调用详情。更多技术细节与日志格式说明，请参考 GitHub 仓库。
