Splitwise CLI — 管理共享开支

通过 splitwise CLI 管理共享开支、余额和结算。

设置

此技能需要已安装 splitwise CLI 并在 PATH 上可用。它使用存储在 ~/.config/splitwise-cli/auth.json 中的 OAuth 2.0 凭据。如果认证过期，CLI 会提示你 — 运行 splitwise auth 重新认证（需要浏览器进行 OAuth 流程）。如果本地已配置默认群组，可以省略 --group。否则，请显式传递 --group。

快速参考

查看余额

# 默认群组余额
splitwise balances
# 特定群组
splitwise balances --group "Trip"

列出支出

# 默认群组中的最近支出
splitwise expenses list --limit 10
# 按日期筛选
splitwise expenses list --after 2026-03-01 --before 2026-03-31
# 不同群组
splitwise expenses list --group "Trip" --limit 5

创建支出

# 均分，你已支付
splitwise expenses create "Internet - March" 51.30
# 自定义精确分摊（60/40、70/30、任意比例）
splitwise expenses create "Utilities - March 2026" 254.80 --split "exact:MemberA:152.88,MemberB:101.92"
splitwise expenses create "Rent - April" 9300 --split "exact:MemberA:7300,MemberB:2000"
# 其他成员已支付
splitwise expenses create "Groceries" 87.50 --paid-by "MemberB"
# 其他成员已支付并自定义分摊
splitwise expenses create "Dinner" 120.00 --paid-by "MemberB" --split "exact:MemberA:80,MemberB:40"
# 不同群组
splitwise expenses create "Dinner" 120.00 --group "Trip"
# 不同货币
splitwise expenses create "Dinner on Trip" 45.00 --group "Trip" --currency EUR

其他命令

splitwise me                    # 当前用户信息
splitwise groups                # 列出所有群组
splitwise group "Household"    # 群组详情 + 成员余额
splitwise friends               # 列出好友
splitwise settle "MemberB"     # 记录结算
splitwise expenses delete 12345 # 按 ID 删除支出

输出模式

每个命令都支持：

• --json — 原始 JSON（用于脚本或管道）
• --quiet — 最小输出，仅显示 ID/金额
• --no-color — 禁用颜色（也尊重 NO_COLOR 环境变量）

常见任务模式

记录定期共享账单

在描述中包含月份以避免混淆：

splitwise expenses create "Internet - March 2026" 51.30

记录前检查（避免重复）

splitwise expenses list --after 2026-03-01 --limit 50 --json

在创建前搜索输出中匹配的相关描述。

批量记录多笔支出

按顺序运行多个 splitwise expenses create 命令。没有特殊语法。

错误处理

• 「未登录」 → 运行 splitwise auth（需要浏览器进行 OAuth）
• 「未找到群组」 → 用 splitwise groups 验证名称
• 「未找到好友」 → 用 splitwise friends 验证名称
• 网络错误 → 重试一次，然后报告给用户

关键细节

• 群组/好友名称使用不区分大小写的部分匹配
• 配置的默认群组意味着 --group 是可选的
• 金额默认使用美元（可通过 splitwise config set default_currency 配置）
• --split even 是默认选项 — 支出在所有群组成员之间平均分摊
• --split "exact:Name:Amount,Name:Amount" — 自定义每人分摊金额（金额必须总和等于总额）
• --paid-by 标志默认指向已认证用户