本帖最后由 758639304 于 2026-10-1 22:40 编辑
🎉【掌上运营商 Shaobo Pocket Carrier】v3.5.0 重磅发布！
联通通话/短信/上网三大详单全套接入（免二次认证）· 内置专属 Lovelace 独立卡片 · 月初出账期防抖保护
大家好！掌上运营商集成迎来重大升级 v3.5.0！
本次版本重点攻克了中国联通全套详单获取难题，并自带专属通讯卡片，开箱即用体验再上新台阶！
🌟 v3.5.0 核心更新亮点
1. 🌐 中国联通：通话 / 短信 / 上网三大详单全套接入（免二次认证）
• 三单齐发：联通号码现已完美对齐电信能力，新增 通话记录、短信记录 与 上网流量记录（包含上网会话清单与每日汇总）；
• 免二次认证：联通官方接口原生无需短信二次认证，配置完成后全自动静默获取，更加丝滑无感；
• 一键刷新详单：新增专属控制实体 button.<手机号>_button（刷新详单流水），按下即可立即拉取当月最新流水；
• 本地缓存安全兜底：即便未开启定时拉取或遇到运营商接口波动，同月历史流水自动以本地缓存展示，数据永不凭空丢失。
2. 🎴 内置独立通讯卡片 pocket-carrier-card（开箱即用）
• 集成内部直接内置了 Lovelace 独立通讯卡片，启动时自动注册静态资源路径与前端引用；
• 再也不用手动下载 JS、不用修改 resources 资源列表，仪表盘直接添加 type: custom:pocket-carrier-card 即可瞬间拥有高颜值通讯面板！
3. 🛡️ 月初月结出账期防抖保护
• 针对联通每月 1 日 00:00 ~ 08:00 计费锁账期接口返回余额为 0 或 "--" 的问题，加入智能出账期拦截；
• 锁账期自动平滑继承并显示出账前最后一次有效余额，附带出账期通知属性，彻底告别月初余额闪断归零误报警。
4. ⚙️ 控制实体多平台通用化与设备自动纠偏
• 查询起始日期（date）、自动获取通话记录（switch）、每日重置起始日期（switch）、号码归属地自动更新（switch）全面支持联通；
• 自动识别并纠正历史版本中联通控制实体误挂在电信设备下的问题，启动时自动平滑迁移设备归属并清理残留空设备；
• 优化配置项快照比对机制，杜绝因为保存 token 触发配置重载导致的无限刷新死循环。
🎴 内置专属卡片使用教程（手把手教学）
从 v3.5.0 起，无需手动下载 js 文件，无需在「信息 - 仪表盘 - 资源」里配置路径，集成在 Home Assistant 启动时已全自动完成注册！
一、单手机号配置（最简写法）
进入仪表盘编辑模式，添加「手动卡片 (Manual Card)」，输入以下 YAML 即可：
type: custom:pocket-carrier-card
name: 我的通讯
tel: 13800138000
💡 说明：只需写手机号，卡片会自动推导并关联该号码下的余额、流量、语音、详单及全部控制实体，无需逐个配置实体 ID！
二、多号码 / 双卡切换配置（推荐）
如果您有电信、联通多个手机号，卡片支持在顶部自动生成切换标签页，一键无缝滑动切换：
type: custom:pocket-carrier-card
name: 家庭通讯总览
tel_1: 13800138000
tel_1_name: 我的联通
tel_2: 18900189000
tel_2_name: 家里电信
三、传统实体 ID 配置方式（兼容老写法）
也可以直接指定数据总览实体（sensor.<手机号>_overview）：
type: custom:pocket-carrier-card
name: 掌上运营商
entity: sensor.13800138000_overview
四、卡片核心交互特性
• 资产三环进度：直观展示通用流量使用进度、剩余语音分钟以及账户实时余额；
• 三大详单自由切换：面板底部无缝切换「通话记录」、「短信详单」与「上网流量」，支持按通话类型/收发方向筛选与时间排序；
• 电信 vs 联通智能适配：
- 电信号码：卡片右上角显示「详单二次认证」状态标签，点击可弹窗填写姓名、身份证与短信验证码完成认证；
- 联通号码：右上角显示「详单设置」，支持一键触发「刷新详单流水」，免密立即拉取最新记录；
• ECharts 图表可视化：上网流量详单提供每日用量趋势柱状图与统计明细，视觉体验拉满。
📊 实体支持矩阵更新（联通 / 电信全面对齐）
| 功能模块 | 中国联通 | 中国电信 | 说明 | | 基础资产指标 | 话费、通用流量、语音、短信、定向流量、积分、星级 | 话费、通用流量、语音、短信、定向流量、积分、星级 | 标准传感器实体，带各副卡明细 | | 通话记录流水 | 支持（按月拉取，免二次认证） | 支持（三要素二次认证，30分有效期） | 通话时长、类型、对端号码与归属地 | | 短信详单记录 | 支持（收发清单、按天汇总） | 支持（收发清单、按天汇总） | 对端号码精准还原、短信费用统计 | | 上网流量详单 | 支持（会话明细、按天汇总） | 支持（会话明细、按天汇总） | 上网时长、流量消耗(MB)、费用统计 | | 专属前端卡片 | 内置 pocket-carrier-card | 内置 pocket-carrier-card | 无需手动配置资源，直接卡片引用 |
⬆️ 升级方式
• HACS 升级：HACS → 集成 → 掌上运营商 → 右上角「重新下载」→ 选择 v3.5.0 → 重启 Home Assistant；
• 手动升级：从 GitHub Release 下载源码覆盖 custom_components/shaobo_pocket_carrier 目录后重启。
🔗 开源仓库
• GitHub: https://github.com/Shaobor/Shaobo-Pocket-Carrier
• Release: https://github.com/Shaobor/Shaobo-Pocket-Carrier/releases/tag/v3.5.0
• 企业交流群: 690711798 欢迎反馈与交流！
| 
发表于 2026-9-26 21:21:49
