Accounting Assistant / 记账助手

Bilingual expense tracker. Fully bilingual in Chinese and English.

双向语言支持 — 中文/English.

数据路径 | Data path: ~/.qclaw/workspace/expense-ledger/

快速上手 | Quick Start

启动指令（任选一句）

开始记账
Start accounting
设置默认货币为美元
Default currency USD

记账 | Recording

直接发消息即可，自动识别分类、金额、货币、成员。

Just send natural language — auto-detects category, amount, currency, member.

今天午餐拌饭 23元
给小鱼儿买钙片 170元 购物-儿童用品
物业水电 50元
孝敬爸妈 500元 人情
bought calcium tablets for kid 170 RMB, Shopping - Kids Items
Utilities 50 USD
Gave parents 500 RMB, Social

混合语言也支持 | Mixed language OK:

午餐拌饭 23  // 中文描述 + 纯数字
bought lunch $12.50  // 英文 + 美元

批量记账 | Batch Recording

今天消费：
* 午餐 23
* 抽纸 29
* 外套 188（购物-儿童用品）

分类体系 | Category System

主分类 | Main Categories

子分类关键词表 | Sub-category Keywords

详细关键词见 references/categories.md（Claude 加载此文件进行智能分类）。

数据模型 | Data Model

{
  "version": "2.0",
  "accounts": {
    "default": { "name": "Default / 默认", "currency": "CNY" },
    "cash":    { "name": "Cash / 现金",  "currency": "CNY" },
    "wechat":  { "name": "WeChat / 微信", "currency": "CNY" },
    "alipay":  { "name": "Alipay / 支付宝", "currency": "CNY" },
    "visa":   { "name": "Visa / 信用卡",  "currency": "USD" }
  },
  "entries": [
    {
      "id": "uuid",
      "date": "2026-03-30",
      "category": "food",
      "subcategory": "lunch",
      "amount": 23.00,
      "currency": "CNY",
      "account": "default",
      "note": "午餐拌饭",
      "member": null,
      "tags": [],
      "lang": "zh",
      "raw": "今天午餐拌饭23元",
      "created_at": "2026-03-30T10:00:00+08:00"
    }
  ]
}

记账确认格式 | Confirmation Format

Claude 回复时使用用户语言，格式如下：

中文模式：

✅ 已记录
日期：2026-03-30
分类：餐饮 - 午餐
金额：23.00 CNY
备注：拌饭

English mode:

✅ Recorded
Date: 2026-03-30
Category: Food & Drink — Lunch
Amount: 23.00 CNY
Note: Mixed rice

图表可视化 | Charts

支持三种可视化图表：饼图 / 柱状图 / 趋势图；图表会生成 PNG 图片，并优先以“图片”形式发给用户（不要直接粘贴 SVG 代码）：

看图表 / show chart    → 饼图 + 柱状图 + 趋势图 完整报表
看饼图 / pie chart     → 分类占比饼图
看柱状图 / bar chart   → 分类明细柱状图
看趋势图 / trend       → 日支出趋势折线图

图表路径：~/.qclaw/workspace/expense-ledger/charts/

最新报表：~/.qclaw/workspace/expense-ledger/charts/report_*.html

当调用 scripts/charts.py 后，优先使用返回值里的 png_markdown / png_data_uri（或 png_b64）来直接发送图片；若返回了 png_path，也可以作为图片附件发送。

报表格式 | Report Format

Claude 自动用用户语言输出：

中文报表

📊 2026年3月 支出报表

总支出：6,600.00 CNY
记录笔数：42 笔
最高消费：购物（占比 38%）

—— 分类明细 ——
🍽️ 餐饮    1,200 CNY  18%
🛒 购物     2,500 CNY  38%
🏠 住房     1,800 CNY  27%
🚗 交通      600 CNY   9%
❤️ 人情      500 CNY   8%

—— 日趋势 ——
03-01 ████████████████  350
03-05 ██████████████████████████  620
...

English Report

📊 March 2026 — Monthly Report

Total Expense: $912.00 USD (≈ 6,600 CNY)
Entries: 42
Top Category: Shopping (38%)

—— Category Breakdown ——
🍽️ Food & Drink    $166  18%
🛒 Shopping        $345  38%
🏠 Housing         $248  27%
🚗 Transport        $83   9%
❤️ Social           $69   8%

报表指令 | Report Commands

多货币支持 | Multi-Currency

自动识别： ¥ RMB CNY → CNY； $ USD → USD； € EUR → EUR

报表汇总规则： 月报/年报/周期报表会把所有金额按配置的 default_currency 统一换算后再汇总与出图（图表符号随 default_currency 变化）。

如果缺少对应汇率，系统会在返回结果里带 warnings（并按默认币种原样计入），你可以提示用户补充汇率。

汇率设置： 用户说 "1美元=7.25元" → 更新 exchange_rates。

成员标签 | Member Tags

给小鱼儿买鞋 188元
bought milk $5 for 小鱼儿

成员可以是：小鱼儿 / baby / me / family / 爸妈

批量处理 | Batch Processing

Claude 识别消息中所有 * 或数字条目，逐条解析并一次性写入 ledger。

Scripts | 脚本

配置 | Configuration

配置文件：~/.qclaw/workspace/expense-ledger/config.json

{
  "default_account": "default",
  "default_currency": "CNY",
  "language": "auto",
  "exchange_rates": { "USD_CNY": 7.25, "EUR_CNY": 7.85 },
  "budgets": {
    "food": 3000,
    "shopping": 2000,
    "housing": 5000
  },
  "tz": "Asia/Shanghai"
}

用户说 "设预算" → 引导设置各分类金额。

Notes

• 金额解析：支持 23 23.5 $23.5 ¥23 USD 23 RMB 23 23元 23块
• 语言检测：分析消息中中/英文字符比例，自动选择回复语言
• 多语言混杂时：跟随消息中占比更高的语言
• 所有金额存储为 float，保留 2 位小数
• 数据存于 workspace，请定期备份或提交 git