# ledger-cli

**Repository Path**: strawhat2y/ledger-cli

## Basic Information

- **Project Name**: ledger-cli
- **Description**: ledger-cli
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ledger-cli

个人记账 CLI 工具

## 命令说明

| 命令 | 用途 | 示例 |
|------|------|------|
| `add` | 添加记录（正数=收入，负数=支出） | `npm start -- add 午餐 -a -35 -c 餐饮` |
| `list` | 查询记录（支持筛选） | `npm start -- list -c 餐饮 --from 2025-01-01` |
| `stats` | 统计收支汇总 | `npm start -- stats --from 2025-01 --to 2025-12` |

**add 选项**: `-a <金额>` (必填), `-c <类别>` (必填), `-d <YYYY-MM-DD>` (可选, 默认今天)  
**list/stats 选项**: `-c <类别>`, `--from <YYYY-MM-DD>`, `--to <YYYY-MM-DD>` (均可选)

## 数据存储

默认 `data/records.json`，可通过环境变量 `LEDGER_DATA_DIR` 自定义路径。