
HLedger Cal 发布:以日历视图展示多币种账目和汇率影响
来源标题:Show HN: HLedger Cal – your money habits over time
HLedger Cal 是一款 hledger 插件,用日历视图展示多币种账本,可按基准货币显示每日资金流向和汇率变动成本。它支持键盘切换周期与视图,数字与 hledger bal、hledger reg 一致,并提供 Homebrew、Scoop 及预编译二进制安装方式。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
hledger cal 是一个以日历形式呈现 hledger 账本的视图,专为资金分布在多种货币中的人设计。它回答的问题是:“今年/本季度/本月/本周的钱都去哪了——用我习惯用来思考的那种货币计价——汇率变动又让我损失了多少?”原生 hledger 无法一眼看出这些:hledger bal -M -X NGN 能给出数字,但没有日历布局、没有按天下钻、没有汇率影响,也看不出哪些汇率已经过期。打开 hledger cal,你会看到当前月份以日历形式铺开,并按你的基准货币计价。你可以用键盘在期间和视图之间切换,屏幕上的每个数字都与同一查询和计价下 hledger bal / hledger reg 报告的结果一致。
它是一个 hledger 插件(PATH 中名为 hledger-cal 的可执行文件),基于 hledger-lib 1.52 和 brick 构建。
brew install igbanam/servings/hledger-cal
Scoop(Windows):
scoop bucket add igbanam https://github.com/igbanam/scoop-bucket
scoop install igbanam/hledger-cal
每个 GitHub release 都附带了 macOS、Linux 和 Windows 的二进制文件。把 hledger-cal 放到 PATH 中的任意位置即可。
cabal install --installdir ~/.local/bin --install-method=copy
然后确认 hledger 能找到这个插件:
hledger cal --help
用法
hledger cal # 当前月份,按基准货币计价
hledger cal -Y # 今年
hledger cal -Q -p 2025 # 2025 年的各季度
hledger cal -M -p 2026-10 -X USD # 2026 年 10 月,按 USD 计价
hledger cal --commodities # 商品视图
hledger cal --print | less -R # 输出静态结果而非 TUI
选项使用 hledger 自身的机制解析,因此 -f、LEDGER_FILE、-p 期间表达式和 QUERY 参数(acct:expenses、cur:USD、not:desc:transfer)的行为与 hledger 中一致。
hledger cal [-Y|-Q|-M|-W] [--commodities]
[-p PERIODEXPR | -b DATE -e DATE]
[-f FILE]... [-X COMM | -V | --value=TYPE[,COMM] | --native]
[--infer-market-prices | --no-infer-market-prices]
[--forecast] [--stale-days N]
[--print] [--width N] [--color=auto|always|never] [--ascii]
[QUERY...]
当 stdout 不是终端时(或使用 --print 时),当前视图会以静态文本打印。至少需要 80 列。NO_COLOR 和 --color=never 会禁用颜色;--ascii 强制使用 ASCII 字符集。
| 按键 | 操作 |
|---|---|
| Y Q M W C | 年、季度、月、周、商品视图(分别对应 -Y -Q -M -W --commodities) |
| Tab / Shift-Tab | 向前 / 向后循环切换视图 |
| [ ] | 上一个 / 下一个期间 |
| c | 循环切换计价货币(基准货币、……、原生货币) |
| v | 循环切换汇率取值时点:期末、交易日期、今天 |
| / | 编辑账户/查询过滤器(Esc 取消,留空则清除) |
| Enter | 年/季度:下钻。月/周:为光标所在日期打开明细面板。商品:按所选商品计价 |
| Esc | 关闭已打开的面板(明细、过滤输入、帮助);否则从下钻层级返回 |
| 方向键(及 hjkl) | 移动光标(月/周中的日期、年中的月份、季度中的季度、商品行) |
| g | 从磁盘重新加载账本,保留视图、焦点、货币和过滤器 |
| ? | 帮助浮层,列出当前视图的所有按键 |
| q | 退出 |
明细面板:用 Up/Down/PgUp/PgDn/Home/End 滚动;Esc 或 Enter 关闭。
hledger-cal 将每个数字都以基准商品计价,与原生 hledger 有两处不同:
没有可用价格的金额会保留其原生商品,并显示在基准数字之后;它们绝不会被丢弃,也不会被当作零处理。
只有类型为 Revenue(收入)或 Expense(支出)的账户上的分录才会进入总计、单元格和明细;资产账户之间的转账永远不会被列出。账户类型来自 hledger 本身:账户指令上的 type: 标签,否则从账户名推断。
account income ; type: R
account expenses ; type: X
account assets:bank ; type: C
收入显示为正数,净额 = 收入 - 支出。
cabal bench startup --benchmark-options='+RTS -N -RTS'
该基准会生成一个含 10,000 笔交易的账本,并测量加载 + 设置 + 以 140 列渲染一个月份视图的耗时;如果耗时达到或超过 1.0 秒,则以非零状态退出。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。