pscale-billing

用途

pscale-billing 用于通过 PlanetScale CLI 检查组织账单数据并管理支付方式。它面向需要查看或变更 PlanetScale 组织账单配置的操作者，覆盖支付方式与发票两类操作。

主要能力

查看当前组织的支付方式：pscale billing payment-method show --org <org> --format json
发起 Stripe Checkout 流程以更新支付方式：pscale billing payment-method update --org <org> --format json
检查由 update 启动的设置流程状态：pscale billing payment-method status <setup-id> --org <org> --format json
删除当前支付方式：pscale billing payment-method delete --org（仅在明确批准后执行）
分页查看发票：pscale billing invoice list --org --page 1 --per-page 25 --format json
查看单张发票：pscale billing invoice show --org --format json
分页查看发票明细：pscale billing invoice line-items --org --page 1 --per-page 25 --format json

使用方式

支付方式工作流

payment-method show 和 status 是只读命令，但仍会暴露敏感的账单元数据。可用它们确认组织与当前状态，再提出变更建议。

payment-method update 会启动外部 Stripe Checkout 设置流程。运行前应回读组织与预期操作者动作，然后只返回已批准操作者所需的 setup URL 或 setup ID。仅针对该 setup 轮询 payment-method status <setup-id>；如果命令返回 API 错误，应呈现真实错误，而不是将其视为中断的设置流程。

payment-method delete 是破坏性账单变更。应先显示当前支付方式、说明操作影响、获得针对确切组织的明确批准，除非特别批准非交互式删除，否则避免使用 --force，并在之后用 payment-method show 验证。

发票工作流

发票列表和明细命令每次调用只获取一页。应有意识地使用 --page 和 --per-page，并在存在更多页时告知用户，而不是把长时间账单抓取隐藏在一个命令中。

# 列出发票并查看单张发票
pscale billing invoice list --org <org> --page 1 --per-page 25 --format json
pscale billing invoice show <invoice-id> --org <org> --format json

# 分页查看明细以进行成本归因
pscale billing invoice line-items <invoice-id> --org <org> --page 1 --per-page 25 --format json
pscale billing invoice line-items <invoice-id> --org <org> --page 2 --per-page 25 --format json

明细可能包含数据库名称、资源名称、指标名称、小计以及 Cloudflare 账单指示。应按用户要求的粒度汇总成本，并在账单上下文之外共享前对细节进行脱敏或聚合。

适用场景

需要确认或变更 PlanetScale 组织支付方式时
需要分页审查发票与发票明细、进行成本归因时
需要在 CI/CD 或自动化流程之外，由操作者手动管理账单配置时

限制与安全要求

账单输出可能包含敏感的业务、支付、发票、税务、地址和使用数据。
始终显式传递 --org。
优先使用 --format json 进行结构化私密审查。
除非用户已审查并批准披露，否则不要将原始发票或支付方式输出粘贴到公开日志、issue 或聊天中。
每次账单命令前回读组织。
绝不编造或存储卡号、银行、税务、个人地址或发票数据。
绝不要求用户粘贴完整卡号或支付密钥。
将支付方式删除和更新视为需要明确批准的账单写操作。
将发票和明细输出视为敏感的只读账单数据。

参考资料

参见 references/commands.md 获取经过校验的命令帮助。

技能介绍

用途