智能體開發中，日誌通常分散在本地磁盤的不同路徑，難以在一個界面查看輪次耗時、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 倉庫。
