by 运行时依赖
安装命令
点击复制技能文档
Accounting 助手 / 记账助手
Bilingual expense 追踪er. Fully bilingual in Chinese and English. 双向语言支持 — 中文/English.
数据路径 | Data path: ~/.qclaw/workspace/expense-ledger/
快速上手 | Quick 启动 启动指令（任选一句） 开始记账 启动 accounting 设置默认货币为美元 Default currency USD
记账 | Recording
直接发消息即可，自动识别分类、金额、货币、成员。 Just 发送 natural language — auto-检测s 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 系统 主分类 | MAIn Categories ID 中文 English food 餐饮 Food & Drink shopping 购物 Shopping housing 住房 Housing transport 交通/汽车 Transport / Car comm 通讯 Communication medical 医疗 Medical social 人情 Social entertAIn 娱乐 EntertAInment education 学习 Education childcare 育儿 Baby & Child travel 旅行 Travel investment 投资 Investment other 其他 Others 子分类关键词表 | Sub-category Keywords
详细关键词见 references/categories.md（Claude 加载此文件进行智能分类）。
数据模型 | Data 模型 { "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元", "创建d_at": "2026-03-30T10:00:00+08:00" } ] }
记账确认格式 | Confirmation 格式化
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
图表可视化 | 图表s
支持三种可视化图表：饼图 / 柱状图 / 趋势图；图表会生成 PNG 图片，并优先以“图片”形式发给用户（不要直接粘贴 SVG 代码）：
看图表 / show 图表 → 饼图 + 柱状图 + 趋势图 完整报表 看饼图 / pie 图表 → 分类占比饼图 看柱状图 / bar 图表 → 分类明细柱状图 看趋势图 / trend → 日支出趋势折线图
图表路径：~/.qclaw/workspace/expense-ledger/图表s/ 最新报表：~/.qclaw/workspace/expense-ledger/图表s/报告_.html
当调用 scripts/图表s.py 后，优先使用返回值里的 png_markdown / png_data_uri（或 png_b64）来直接发送图片；若返回了 png_path，也可以作为图片附件发送。
报表格式 | 报告 格式化
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 报告 📊 March 2026 — Monthly 报告
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%
报表指令 | 报告 Commands Command Description 今天报表 / DAIly 报告 日报 本周报表 / Weekly 报告 周报 3月报表 / March 报告 / Monthly 报告 月报 2026年报 / 2026 报告 / Annual 报告 年报 餐饮明细 / Food detAIls 分类明细 预算对比 / Bud获取 vs actual 预算执行 导出CSV / 导出 CSV 导出数据 导出Excel / 导出 Excel Excel 格式 多货币支持 | Multi-Currency
自动识别： ¥ RMB CNY → CNY； $ USD → USD； € EUR → EUR
报表汇总规则： 月报/年报/周期报表会把所有金额按配置的 default_currency 统一换算后再汇总与出图（图表符号随 default_currency 变化）。
如果缺少对应汇率，系统会在返回结果里带 警告s（并按默认币种原样计入），你可以提示用户补充汇率。
汇率设置： 用户说 "1美元=7.25元" → 更新 exchange_rates。
成员标签 | Member Tags 给小鱼儿买鞋 188元 bought milk $5 for 小鱼儿
成员可以是：小鱼儿 / baby / me / family / 爸妈
批量处理 | Batch Processing
Claude 识别消息中所有 * 或数字条目，逐条解析并一次性写入 ledger。
Scripts | 脚本 Script Purpose scripts/ledger.py 核心：添加 / 列出 / 报告 / balance / config scripts/导出.py 导出：CSV / JSON / Excel scripts/图表s.py 可视化：pie / bar / line / 报告-html 配置 | 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 }, "bud获取s": { "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