by 详细分析 ▾
运行时依赖
版本
更新
安装命令
点击复制技能文档
用于记录、分类和分析收据与支出的命令行财务工具包。追踪采购、监控消费趋势、预测预算、设置提醒、对比周期、标注税务相关项目——全部本地存储，支持时间戳历史、全文搜索和多格式导出。
命令
可通过 receipt [args] 使用以下命令：
财务操作
| 命令 | 描述 |
|---|---|
record | 记录收据或购买条目（例如 "Lunch at cafe $12.50"）。无参数时显示最近的记录条目。 |
categorize | 为支出项目分类（例如 "Office supplies — Q1 budget"）。无参数时显示最近的分类条目。 |
balance | 记录余额更新或对账说明（例如 "Monthly balance: $3,420"）。无参数时显示最近的余额条目。 |
trend | 记录消费趋势观察（例如 "Groceries up 15% vs last month"）。无参数时显示最近的趋势条目。 |
forecast | 记录预算预测（例如 "Projected Q2 spend: $8,000"）。无参数时显示最近的预测条目。 |
export-report | 保存导出/报告说明（例如 "Monthly PDF sent to accountant"）。无参数时显示最近的导出报告条目。 |
budget-check | 记录预算检查结果（例如 "Travel budget 78% used, $440 remaining"）。无参数时显示最近的预算检查条目。 |
summary | 记录摘要说明（例如 "Week 12 total: $327.50 across 14 transactions"）。无参数时显示最近的摘要条目。 |
alert | 记录消费提醒（例如 "Dining budget exceeded by $65"）。无参数时显示最近的提醒条目。 |
history | 记录历史说明。无参数时显示最近的历史条目。 |
compare | 记录对比说明（例如 "March vs February: +$200 on utilities"）。无参数时显示最近的对比条目。 |
tax-note | 标注税务相关项目（例如 "Home office deduction — $150/mo"）。无参数时显示最近的税务标注条目。 |
实用命令
| 命令 | 描述 |
|---|---|
stats | 显示摘要统计——每个类别的条目数、总条目数、数据大小、最早记录时间戳。 |
export | 以 json、csv 或 txt 格式导出所有数据。输出文件保存到数据目录。 |
search | 在所有日志文件中进行全文搜索（不区分大小写）。 |
recent | 显示全局历史日志中最近的 20 条活动条目。 |
status | 健康检查——版本、数据目录路径、总条目数、磁盘使用量、最后活动状态和 OK 状态。 |
help | 显示完整命令参考。 |
version | 打印当前版本（v2.0.0）。 |
数据存储
所有数据本地保存在 ~/.local/share/receipt/：
- 每命令日志 — 每个命令（record、categorize、balance 等）以
YYYY-MM-DD HH:MM|格式写入自己的.log文件。 - 全局历史 — 每个操作也以
MM-DD HH:MM :格式追加到history.log，形成统一审计跟踪。 - 导出文件 — 生成的导出以
export.json、export.csv或export.txt形式保存在同一目录。
无需外部服务、数据库或网络连接。一切通过 bash 本地运行。
要求
- Bash 4+（使用
local变量、set -euo pipefail） - 标准 Unix 工具：
date、wc、du、head、tail、grep、basename、cat - 无需 root 权限
- 无外部依赖或包安装
使用场景
- 记录日常采购 — 使用
record实时捕获收据，建立可搜索的费用日记。 - 按类别整理支出 — 使用
categorize和budget-check追踪杂货、餐饮、交通、订阅等各类别的花费。 - 月度财务审查 — 使用
summary、compare和trend分析跨周期的消费模式。 - 税务准备 — 使用
tax-note全年标记可扣除项目，便于报税时查找。 - 预算预测和提醒 — 使用
forecast预测未来支出，使用alert记录超预算情况。
示例
# 记录新收据 receipt record "Grocery store — $67.30, weekly shopping"# 为购买收据分类 receipt categorize "Amazon order $42.99 — Office Supplies"
# 检查预算状态 receipt budget-check "Food budget: $320 of $400 used, 8 days remaining"
# 记录消费趋势 receipt trend "Utility bills trending 12% higher than same quarter last year"
# 添加税务标注 receipt tax-note "Professional development course $299 — deductible education expense"
# 对比两个月 receipt compare "April total $2,180 vs March $1,950 — +$230, mostly dining"
# 查看统计摘要 receipt stats
# 导出所有数据为 CSV receipt export csv
# 搜索所有包含 'Amazon' 的条目 receipt search Amazon
# 查看最近活动 receipt recent
工作原理
每个命令遵循相同的模式：
- 带参数 — 为输入添加时间戳，将其追加到命令特定的日志文件，增加条目计数，并写入全局历史日志。
- 无参数 — 显示该命令日志文件中最近的 20 条条目。
stats 命令聚合所有日志文件的计数。export 命令遍历所有日志并以您选择的格式生成统一输出。search 命令对每个日志文件执行不区分大小写的 grep。
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com