用途：finance-cli 是本地、离线、单二进制的终端个人财务追踪工具，面向 AI 智能体使用，以债务为核心。它把用户意图翻译为对应命令并报告结果。
主要能力：支持记账（add）、余额（balance）、月度概览（status）、可负担性判断（afford）、现金流跑道（runway）、贷款列表与摊销（loans）、额外还款模拟（simulate）、月度对比（diff）、周期记账同步（recurring sync）、编辑与删除（edit/delete）、贷款还款（loan pay）、导出（export，如 hledger 格式）以及命令清单（schema）。
使用方式：会话开始先运行 finance schema --json 获取当前命令、参数、标志与是否改变状态，避免凭旧知识猜测。始终加 --json 并解析返回信封。破坏性操作（删除、还款）或金额/分类不明确时先加 --dry-run 预览，用户确认后再提交。add/edit/delete/loan add/loan pay 可传 --idempotency-key <KEY> 去重，24 小时内有效。日期用 ISO YYYY-MM-DD。货币取决于 ~/.finance/data.json 的 settings.currencySymbol，不要假定 USD 或 HKD。
结果解读：afford 看 verdict（yes/tight/no），tight 时关注 min_running_balance 与 min_running_date；runway 看 recommendation（push/coast/behind）与 push_to_break_even；simulate 报告 months_saved 与 interest_saved 绝对值；loans 含 amortization.nextPayment 与 totalInterestRemaining。错误码：ENOENT（无数据文件，建议 finance init）、ENOTFOUND、EVALIDATION、EAMBIGUOUS、EUNKNOWN。
限制：不要直接编辑 ~/.finance/data.json，应使用 CLI；不要读源码猜标志，改用 finance schema --json；未确认 dry-run 前不要对 delete 传 --yes。若 finance schema 报 ENOENT 或 command not found，说明未安装，需走安装流程并运行 finance init。安装细节与多步流程见其 references 文档，本资料未提供具体安装命令。