name: smart-ledger version: 1.0.0 description: > 智慧收支追蹤器 — 通過自然語言快速記賬，自動分類，生成日/周/月報告和趨勢分析。 支援中文自然語言輸入("今天午飯花了35元")，資料本地JSON儲存保護隱私。 適用於個人財務管理、預算追蹤和消費分析場景。 emoji: 💰 category: finance tags: - finance - expense-tracker - budget - chinese - natural-language requires: python: ">=3.9" os: - macos - linux - windows author: dyby99 license: MIT

Smart Expense Tracker - 智慧收支追蹤器

通過自然語言快速記賬，自動生成財務報告的智慧工具。

功能特性

• 📝 自然語言記賬: "今天午飯花了35元"、"收到工資8000"
• 🏷️ 智慧自動分類: 自動識別餐飲、交通、購物等分類
• 📊 多維度報告: 日報、週報、月報、趨勢分析
• 🔒 本地資料儲存: JSON檔案儲存，保護隱私
• 🌐 中英文支援: 支援中英文自然語言輸入
• ⚠️ 消費異常檢測: 自動識別異常消費模式

快速開始

新增收支記錄

# 記錄支出
python scripts/expense-tracker.py add "今天午飯花了35元"
python scripts/expense-tracker.py add "昨天打車去公司28塊"
python scripts/expense-tracker.py add "買衣服花了299元"

# 記錄收入
python scripts/expense-tracker.py add "今天發工資8000元"
python scripts/expense-tracker.py add "收到紅包200"

檢視記錄

# 列出最近7天記錄
python scripts/expense-tracker.py list

# 列出最近30天記錄
python scripts/expense-tracker.py list 30

# 只顯示支出
python scripts/expense-tracker.py list 7 expense

生成報告

# 日報
python scripts/report-generator.py daily
python scripts/report-generator.py daily 2024-01-15

# 週報
python scripts/report-generator.py weekly
python scripts/report-generator.py weekly 1  # 上週

# 月報
python scripts/report-generator.py monthly
python scripts/report-generator.py monthly 1  # 上月

# 趨勢分析
python scripts/report-generator.py trend 30

檢視統計

# 最近30天收支摘要
python scripts/expense-tracker.py summary

# 最近90天摘要
python scripts/expense-tracker.py summary 90

# 檢視分類列表
python scripts/expense-tracker.py categories

專案結構

smart-ledger/
├── SKILL.md                      # 本檔案
├── scripts/
│   ├── expense-tracker.py       # 核心記賬邏輯
│   └── report-generator.py      # 報告生成器
└── assets/
    └── categories.json          # 分類配置

資料儲存

• 路徑: ~/.openclaw/workspace/data/expenses/expenses.json
• 格式: JSON
• 隱私: 純本地儲存，不上傳雲端

資料結構:

{
  "expenses": [
    {
      "id": "a1b2c3d4",
      "date": "2024-01-15",
      "type": "expense",
      "amount": 35.00,
      "category": "餐飲",
      "note": "午飯",
      "raw_text": "今天午飯花了35元",
      "created_at": "2024-01-15T12:30:00"
    }
  ],
  "categories": {
    "income": ["工資", "獎金", "投資", ...],
    "expense": ["餐飲", "交通", "購物", ...]
  }
}
7w4.net小蔥技能。

自然語言支援示例

時間表達

• "今天..." - 今天
• "昨天..." - 昨天
• "前天..." - 前天
• "2024-01-15..." - 指定日期

金額表達

• "花了35元"
• "花了35塊"
• "35元"
• "收入5000"

自動分類關鍵詞

分類配置

分類配置儲存在 assets/categories.json，包含:

• 收入分類: 工資、獎金、投資、兼職、紅包、退款、其他收入
• 支出分類: 餐飲、交通、購物、娛樂、居住、醫療、教育、通訊、人情、其他支出
• 預算預警: 每個分類可設定預算閾值
• 關鍵詞對映: 自定義分類識別關鍵詞

自定義分類

編輯 assets/categories.json 新增自定義分類和關鍵詞。

報告型別

日報

• 當日收支總覽
• 分類明細
• 交易記錄列表

週報

• 本週收支總覽
• 日均支出
• 每日明細
• TOP支出分類

月報

• 月度收支總覽
• 預算執行情況
• 周度趨勢
• 分類統計
• 日均支出

趨勢分析

• 消費趨勢（上升/下降/穩定）
• 異常消費檢測（超過均值2倍）
• 環比變化分析
• 消費建議

高階用法

刪除記錄

# 刪除指定ID的記錄
python scripts/expense-tracker.py delete a1b2c3d4

JSON格式輸出

# 報告輸出JSON格式（便於程式處理）
python scripts/report-generator.py monthly 0 json

批次匯入

可通過直接編輯 expenses.json 檔案實現批次匯入。

使用建議

1. 每日記賬: 養成每天記錄的習慣，可以在每天晚上花2分鐘回顧當天支出
2. 及時分類: 如果自動分類不準確，可以在備註中新增更具體的關鍵詞
3. 定期復盤: 每週檢視週報，每月檢視月報，瞭解自己的消費模式
4. 設定預算: 在 categories.json 中為各分類設定預算預警值

故障排除

無法識別金額

• 確保金額格式正確，如 "35元"、"35塊"
• 嘗試明確表達："花了35元"

分類不準確

• 在描述中新增更多關鍵詞，如 "淘寶買衣服" 會比 "買衣服" 更準確
• 可在 categories.json 中新增自定義關鍵詞

資料檔案損壞

• 資料檔案是純JSON，可用文本編輯器修復
• 建議定期備份 ~/.openclaw/workspace/data/expenses/expenses.json

擴充套件開發

新增新的自動分類規則

編輯 scripts/expense-tracker.py 中的 KEYWORD_MAPPING 字典:

KEYWORD_MAPPING = {
    # 現有規則...
    "新關鍵詞": "目標分類",
    " another keyword": "Category Name"
}

整合其他工具

expense-tracker.py 可作為模組匯入:

from scripts.expense_tracker import ExpenseTracker

tracker = ExpenseTracker()
record = tracker.add("今天買書花了50元")
print(record)

技術規格

• Python版本: 3.9+
• 依賴: 無外部依賴，僅使用標準庫
• 編碼: UTF-8
• 資料格式: JSON

許可證

MIT License

這是一款實用的記賬工具，中文支援流暢，介面友好，能自動識別分類並生成報告，資料儲存在本地隱私有保障。不過某些消費記錄的分類可能不夠準確，預算提醒功能有時不會觸發，與文件描述的體驗存在一定差距。總體來說對於日常記賬夠用，但追求精細化預算管理的使用者可能會覺得功能還不夠完善。