用途：splitwise-pp-cli 是驱动 Splitwise API 的命令行工具，适合共享开支、旅行分账、室友账单与结算场景，可记录费用、查看谁欠谁、按类别或月份汇总消费、查找历史费用并计算最少转账结算方案，也用于离线分析与验证本地账本副本，而非一次性实时查询。
安装与验证：npx -y @mvanhorn/printing-press-library install splitwise --cli-only，随后用 splitwise-pp-cli --version 验证，并确保安装目录在 PATH 中。
鉴权：使用个人 API key 作为 HTTP Bearer token，在 https://secure.splitwise.com/apps 注册应用后设置 SPLITWISE_API_KEY；API 也提供 OAuth 2.0，但本工具以单用户密钥鉴权，不用于多用户 OAuth 应用。
主要能力：balances 查看净余额（支持 --by-currency、--by-group）；debts --aged 按未结清时长排列债务；net 将某人跨群组余额压缩为最少转账；ledger 输出群组逐笔费用与累计余额；settle-up 计算并可选 --record 记录最少转账；audit 检查重复结算与异常金额；split 预览等额、定额、百分比或份额拆分；fairness 查看谁承担超份额成本，并可 nudge 在费用线程预览或发送提醒；reconcile 用实时 API 校验本地账本；spend、report、recurring、forecast、normalize（用户自供汇率）提供分析与汇总。resolve 可用名称解析 ID，which 用自然语言找命令，brief 提供一次调用状态摘要。
输出与数据源：--agent 将结果包为 {"meta": {...}, "results": ...}，--json 返回原始载荷。--data-source auto 可做有界刷新，local 不刷新，live 直读 API 且不改本地库；可设 SPLITWISE_NO_AUTO_REFRESH=1 跳过刷新钩子。
限制：不用于实时汇率换算、不用于实际付款（仅记录结算）、不用于多用户 OAuth、不支持实时推送通知（同步与对账均为拉取式）。部分命令返回 200 不代表成功，需检查响应中的 success 值。暂未提供更多信息。