旅行记账助手

SKILL.md

---
name: travel-expense-tracker
display_name: 旅行记账助手
description: 多币种记录旅行消费、汇率自动换算、分类统计与预算管理，旅行花钱心里有数。暑期旅行开销记录，AA记账轻松分摊
tags: [旅行记账, 多币种, 汇率换算, 预算管理, 消费统计]
tools:
  - name: track_expense
    description: 记录旅行支出

---

# 旅行记账助手 — 多币种记账，汇率换算，预算管理

> 旅行花钱心里有数——多币种记账、汇率换算、分类统计、预算管理。

🔥 **核心亮点：**
- **多币种支持** — 人民币/日元/美元/欧元等，自动换算，出境旅行必备
- **分类统计** — 餐饮/交通/住宿/购物/门票/其他，一目了然钱花在哪了
- **预算管理** — 设定总预算或日均预算，超支自动提醒
- **按天/按币种查看** — 每天花了多少、各币种花了多少，清晰明了
- **零配置** — 数据本地存储，无需申请任何API Key

---

## 快速入门

**3个开场白示例，复制即用：**
1. "今天在日本吃了拉面花了1500日元，帮我记一下"
2. "这趟旅行花了多少钱了"
3. "帮我看看这趟旅行的消费分类统计"

---

## 核心能力

1. **多币种记账**：支持CNY/JPY/USD/EUR等，自动换算人民币
2. **分类统计**：按餐饮/交通/住宿/购物/门票/其他分类汇总
3. **预算管理**：设定总预算或日均预算，超支提醒
4. **消费汇总**：按分类/日期/币种多维度查看统计
5. **本地存储**：数据存在本地，不上传云端，隐私安全

## 能力概览

| 序号 | 工具 | 说明 |
|------|------|------|
| 1 | add_expense | 记录一笔消费 |
| 2 | expense_summary | 查看消费汇总统计 |
| 3 | budget_check | 预算管理与超支提醒 |

## 工作流程

1. 根据用户需求判断调用哪个工具
2. 执行 `python3 scripts/expense_tracker.py <tool> '<json_params>'`
3. 解析JSON输出，以自然语言回复用户

## 工具参数说明

### add_expense
记录一笔消费。参数：trip(必填，旅行名称), amount(必填，金额), currency(必填，货币代码如CNY/JPY/USD/EUR), category(必填，分类如餐饮/交通/住宿/购物/门票/其他), description(选填，消费描述), date(选填，日期YYYY-MM-DD)

### expense_summary
查看消费汇总。参数：trip(必填，旅行名称), group_by(选填，分组方式category/date/currency，默认category)

### budget_check
预算管理与超支检查。参数：trip(必填), total_budget(选填，总预算CNY), daily_budget(选填，日均预算CNY), days(选填，旅行天数)

## 数据说明

- 记账数据存储在本地文件 travel_expenses/
- 汇率使用内置参考汇率，仅供参考
- 零配置，无需申请任何API Key

## 数据流向

所有数据为本地内置，不发送任何外部请求，不收集用户数据。

## 能做什么

- 多币种记录旅行消费，自动换算人民币
- 按分类/日期/币种多维度查看消费统计
- 设定总预算或日均预算，超支提醒
- 本地存储记账数据，隐私安全

## 不能做什么

- 不支持自动同步银行卡/支付宝消费记录
- 汇率为内置参考汇率，非实时汇率
- 不支持多人共同记账

## 使用提示

- 每笔消费需指定旅行名称、金额、币种、分类
- 支持按分类/日期/币种分组查看汇总
- 设定预算后，超支会自动提醒

## 🔗 搭配使用

- **旅行预算规划师** — 出发前做好费用预算
- **旅行购物退税计算器** — 出境购物退税计算
- **全能旅行助手** — 行程规划+机票酒店景点一站式服务