核心用法
Aoineco Ledger 是专为极端预算场景设计的AI智能体财务追踪引擎，核心解决"AI花钱但不算账"的痛点。采用纯Python 3.10+实现，零外部依赖，单文件即可运行。
关键操作流：
1. 初始化引擎：AoinecoLedger() 自动创建JSONL追加式账本
2. 记录支出：log_api_cost() / log_gas() 记录API调用与链上Gas，支持智能体标签归因
3. 记录收入：log_revenue() 追踪MoltLaunch等收入来源
4. 设置预算：set_budget() 按类别/周期设定限额，80%预警/100%拦截
5. 获取指标：get_bootstrap_metrics() 输出$7种子资金全维度健康度
核心指标 IPD（Intelligence per Dollar）：每美元可执行的操作次数，直接量化智能体运营效率。
显著优点
- 极端轻量：单文件、零依赖，契合$7 Bootstrap Protocol的"每字节计数"哲学
- 多智能体归因：解决 squad 场景"谁花了什么"的追踪难题
- 实时财务感知：内置跑道（runway）、日燃速（burn rate）、ROI%计算
- 防损存储：JSONL追加式日志，崩溃后可逐行恢复，避免数据库损坏风险
- 即开即用：预配置AI运营专用分类（API/LLM、Gas/Blockchain、Revenue/Gig等）
潜在缺点与局限性
- 无云端同步：本地JSONL存储，多机部署需自行解决数据聚合
- 无UI界面：纯代码/CLI交互，非技术用户上手门槛高
- 简单统计：缺乏高级财务分析（现金流预测、敏感性分析）
- 手动集成：需在每个API调用点埋点，无法自动拦截无SDK的服务
- 币种单一：假设全美元计价，未内置多币种/加密资产波动处理
适合人群
- 运行多智能体小队的独立开发者/AI研究员
- 践行$7 Bootstrap Protocol的极简启动者
- 需精确追踪API/Gas支出的DeFi/区块链自动化运营者
- 为智能体 squad 构建共享财务感知的基础设施开发者
常规风险
| 风险类型 | 说明 |
|---------|------|
| **数据丢失** | 本地文件损坏未备份时，历史账目不可恢复 |
| **预算漂移** | 80%预警依赖定期查询，长时间不检查可能错过拦截窗口 |
| **归因误差** | agent参数传递错误导致成本归属混乱 |
| **精度累积** | 大量微交易（$0.0001级）浮点运算可能产生分位偏差 |
| **合规盲区** | 未内置税务申报格式，需自行导出CSV后处理 |