这个项目能做什么

agentacct 是一款本地优先的“Agent Work Intelligence”工具,回答一个实际问题:我的编码代理到底在做什么,花了多少钱?它读取编码代理的本地会话日志,并跨项目与客户端呈现近期活动、工具调用、已记录步骤、检查、token 与预估成本。 提到的受支持客户端包括 Claude Code、Codex、Kimi Code、OpenCode、Hermes 等,并附有覆盖矩阵,对每条能力通道单独评级。README 指出,Claude Code 和 Codex 目前拥有最完整的凭据记录。 安装通过 pipx 完成(macOS 或 Linux 上需 Python >= 3.11;Windows 仅支持通过 WSL),同时提供已签名的 macOS 应用。设置时每台机器运行一次 `agentacct onboard` 以检测代理、创建本地存储并启动记录器;`agentacct tui` 打开终端应用。项目范围的安装会将所有内容保留在仓库内。 界面以 Sessions 视图和每个任务的“Work Receipt”为核心,结合参与的会话、记录的结果、预估成本、声明与检查结果,以及活动时间线。一个关键区别是 Reported 与 Verified:代理自己说的“完成”只是 Reported,而 Verified 需要在上次记录变更之后有当前通过的检查。失败的尝试仍保留在历史中可见。 Work groups 让你指向一个项目文件夹,查看哪些代理在那里工作过,并附有会话详情和跨代理的共享时间线。Dashboard 显示最新记录的工作,包括客户端、时间、结果、证据与成本,并将历史上失败的检查和阻塞项保留在单独的“Recorded issues”区域,而不是让它们成为默认排序。 Usage 视图可按日期、代理、模型和提供商独立筛选,提供按代理和模型的区间总计、带 Fresh/All token 切换的每日图表,以及区分缓存读取与写入的细分。Token 来自客户端记录;成本是按价格表估算的,标有 ≈,并明确说明不是账单。提供商报告的配额窗口和重置时间显示在同一页面。 终端 UI 提供 receipts、usage、capacity 和 review 概览,包括一个以文件夹为锚点的 Work 标签页,带有可用键盘导航的跨代理时间线。 该项目强调诚实与隐私:估算值有标注,缺失数据以缺口而非零显示,usage 与已记录工作之间的每次关联都带有置信度标签(exact、high、medium、low),支持情况按能力而非按 logo 描述。它记录工作元数据,如工具名称与类别、触及的文件、已清除凭据的命令、退出码、token 与已记录步骤,但不记录提示词、模型响应或转录内容。它只读取本地会话文件,只监听 127.0.0.1,从不存储或请求提供商 API 密钥。 在架构上,它将两条证据流分开:使用了什么(来自客户端会话文件)和做了什么(来自通过 MCP 记录的步骤与检查,以及测试运行等机器检查),基于真实客户端 id 以带标签的置信度进行关联。Claude Code 通过已安装的 hook bridge 绑定 id;Codex 和 OpenCode 在导入时从各自的日志中匹配;Hermes 仅通过显式传递的 id 关联。 卸载步骤会停止受管进程、移除已安装的自启动项、卸载软件包,并可选删除本地存储和客户端配置条目。文档涵盖参考资料、覆盖矩阵、架构、安全边界、隐私威胁模型、示例演练和完整演示。