技能介绍

解决的问题

运营商的账单、余量、详单分散在不同入口：APP 首页看不全，网页端要登录，发票和返费藏得更深。开发者想做一个自动化的用量查询，要么找不到稳定接口，要么得在脚本里硬塞手机号、验证码，既难维护也不安全。

工作方式

这个技能把查询拆成最小业务命令，默认走 --format json 获取稳定结构，再由上层转成中文摘要。命令按意图映射：

balance：剩余话费、本月消费
allowances：套餐余量、流量语音短信剩余
bills：按月拉取月账单
payments：指定时间范围的交费记录
invoices：已有电子发票列表，不申请也不下载
rebates：返费与赠款
contract-bills：金融合约账单、金融代收
usage-details：详单查询，支持 data/voice/sms 三类

综合查询用 query --scope，范围从 overview、data、voice、sms、members、resources 到 all。成员和副卡默认可查，但只有明确询问才展开。

账户定位优先靠用户给的中文别名；没有指定运营商时用全局默认，指定了就用运营商默认。真正歧义时才展示脱敏候选，不猜。

登录采用中国联通 APP 扫码。网页登录会话保存在权限为 0600 的本机文件里，技能不截图、不解析二维码，也不在命令行参数里接收 token、Cookie 或完整手机号。

适用边界

当前只支持 china_unicom，移动、电信、广电会明确返回未实现。所有命令只读：不充值、不缴费、不改套餐、不退订、不绕过验证。详单必须由用户在联通官方页面完成短信二次认证。出错时按退出码处理：配置问题查环境变量或 0600 权限的 TOML，认证失效重跑 login，上游限流按提示等待，接口结构变化就停止猜字段并提交脱敏 issue。不要把真实响应当测试样例，也不要批量查询或查未授权账户。