介绍
# PhoenixClaw Ledger: Zero-Effort Financial Tracking
PhoenixClaw 账本自动从您的日常对话和支付截图中提取财务交易，无需任何手动输入。
## 核心功能
| 功能 | 描述 | |---------|-------------| | **语义支出检测** | AI 识别自然对话中的支出提及 | | **截图识别** | 从支付应用截图中提取交易数据 | | **智能分类** | 根据商家和语境自动分类 | | **预算追踪** | 每月预算警报和进度可视化 | | **财务洞察** | 整合到日记成长笔记中的模式分析 | | **目标管理** | 储蓄、预算控制、习惯和愿望清单目标 | | **每周报告** | 每周日晚 9 点自动生成支出回顾 | | **查询支持** | 实时自然语言财务咨询 | | **支出趋势** | 多月分析支出可视化 | | **交易浏览** | 交互式完整交易历史记录视图 |
## 工作流程
作为 PhoenixClaw 的插件，账本挂接到 `post-moment-analysis` 阶段：
1. **接收时刻**：从 PhoenixClaw 核心获取识别到的时刻 2. **检测财务**：扫描文本和媒体中的支出/收入信号 - 文本：语义模式（参见 `references/expense-detection.md`） - 媒体：支付截图（参见 `references/payment-screenshot.md`） 3. **提取数据**：解析金额、商家、类别、时间戳 4. **分类**：应用来自 `references/merchant-category-map.md` 的规则 5. **去重**：防止重复计算同一笔交易 6. **存储**：写入 `~/PhoenixClaw/Finance/ledger.yaml` 7. **导出**：使用 `assets/daily-finance-section.md` 生成日记部分
## 显式触发
虽然默认是被动的，但用户可以直接交互：
- *"我今天/本周/本月花了多少钱？"* - *"显示我的支出明细"* - *"将我的月预算设置为 [金额]"* - *"我主要的开销类别有哪些？"* - *"生成 [时间段] 的财务报告"* - *"在 [日期] 前设定一个 [金额] 的储蓄目标"* - *"显示我的支出趋势"* - *"浏览我的所有交易"* - *"我的目标进展如何？"*
## 输出结构
``` ~/PhoenixClaw/ ├── Journal/ │ ├── daily/2026-02-02.md # Contains 💰 Finance section │ └── weekly/2026-W05.md # Weekly financial recaps │ └── Finance/ # Ledger-specific directory ├── ledger.yaml # Structured transaction data ├── budget.yaml # Budget configuration ├── goals.yaml # Financial goals tracking ├── transactions.md # Transaction browser view ├── monthly/ │ └── 2026-02.md # Monthly financial reports └── yearly/ └── 2026.md # Annual summaries ```
## 配置
`~/.phoenixclaw/config.yaml` 中的账本特定设置：
```yaml plugins: phoenixclaw-ledger: enabled: true default_currency: CNY # or USD, EUR, etc. budget_monthly: 5000 # Monthly budget amount categories_custom: [] # User-defined categories screenshot_confidence: 0.7 # Min confidence for auto-record ```
## Cron 与定时报告
账本使用 PhoenixClaw 核心的 cron 基础设施以及额外的定时任务：
| 任务 | 计划 | 描述 | |------|----------|-------------| | **每日处理** | 晚上 10 点（通过核心） | 提取交易，生成每日部分 | | **每月报告** | 每月 1 日，上午 8 点 | 综合每月财务摘要 | | **每周摘要** | 每周日晚 9 点（可选） | 每周支出回顾 |
### 每日处理（自动）
无需单独设置。账本挂接到核心的夜间 cron： - 核心在晚上 10 点运行 → 触发 `post-moment-analysis` - 账本激活，提取财务数据，导出到日记
### 每月报告设置
```bash openclaw cron add \ --name "PhoenixClaw Ledger monthly report" \ --cron "0 8 1 * *" \ --tz "auto" \ --session isolated \ --message "Generate monthly financial report for the previous month." ```
有关完整的配置详细信息，请参阅 `references/cron-setup.md`。
## 文档参考
### 参考 (`references/`) - `expense-detection.md`：对话解析的语义模式 - `payment-screenshot.md`：截图识别和 OCR 提取 - `merchant-category-map.md`：商家到类别的映射规则 - `category-rules.md`：类别定义和层级结构 - `budget-tracking.md`：预算警报和进度计算 - `financial-insights.md`：成长笔记的模式分析 - `cron-setup.md`：定时任务和报告自动化 - `goal-management.md`：财务目标和进度追踪 - `query-patterns.md`：自然语言查询模板和逻辑
### 资源 (`assets/`) - `expense-callout.md`：对话检测支出的模板 - `receipt-callout.md`：截图检测支出的模板 - `daily-finance-section.md`：日记集成模板 - `monthly-report.md`：每月摘要模板 - `yearly-report.md`：年度摘要模板
---