核心用法
AgentBooks 是专为 AI 代理设计的财务管理基础设施，将传统会计概念映射到自主代理的经济活动中。核心工作流分为三层：
1. 会话前健康检查
通过 agentbooks guard 获取财务健康报告（FHS），系统根据 tier 字段（uninitialized/normal/optimizing/critical/suspended）动态路由代理行为。例如在 critical 层级时，代理需立即告知用户剩余资金天数并请求连接资金提供方。
2. 经济活动记录
- 成本端：支持 6 大渠道（inference/runtime/faculty/skill/agent/custom），其中推理成本可由 runner 自动捕获，其他需手动记录
- 收入端：必须附带
--confirmed外部验证标志，按 low/medium/high 质量分级，提供 $0.10-$200 的价值参考区间
3. 会话后结算
提供完整的会计报表（balance/pl/ledger/financial-health）及可视化 HTML 报告，数据持久化于本地 JSON 文件，支持路径覆盖。
显著优点
- 行为耦合设计：财务状态直接驱动代理决策（如
optimizing时自动启用成本优化策略），非被动记账工具 - 生产就绪架构：支持 Coinbase CDP、ACN、Onchain 三大 provider，EVM 钱包确定性生成，零框架依赖
- 会计完整性：实现资产负债表 + 损益表 + 现金流量表三表联动，burn rate 历史追踪
潜在局限
- 收入确认门槛：依赖外部验证机制，在封闭环境中可能形成收入记录瓶颈
- 估值主观性：提供的价值参考区间为粗略估计，缺乏动态市场定价
- 中心化依赖：实际资金托管于第三方 provider，非完全自托管方案
适合人群
AI 代理宿主（host）开发者、自主代理研究团队、需要经济计量能力的 Agent-as-a-Service 平台，尤其适合探索代理经济可持续性的早期项目。
常规风险
- 财务数据泄露：本地存储的
economic-state.json包含完整交易历史，需确保~/.agentbooks/目录权限控制 - provider 单点故障：未连接 provider 时处于
uninitialized开发模式，生产级部署需持续监控连接状态 - 误报收入：强制
--confirmed标志虽防自刷，但验证源可信度仍取决于外部系统实现