如何监控账号登录健康度？颜小二的做法与告警字段
简短答案：颜小二把每个账号的登录态做成结构化的"健康度字段"，既会在每次发布失败时通过 login_expired 回调实时上报，也支持你定期拉取整个矩阵的账号健康快照，告警可对接你侧的工单或 IM 系统。
发布矩阵跑久了会发现：真正让人睡不着的不是"今天发了多少篇"，而是"哪个账号悄悄掉线我没发现"。下面把颜小二在登录健康度这块做的事讲清楚。
背景与机制
登录态在自媒体发布场景里有三种典型失效模式：
1. 被动过期：cookie 到期被平台清掉 2. 风控触发：平台基于行为/指纹要求重新验证（短信、滑块、扫码） 3. 主动踢出：账号在别处登录，原会话被挤掉
无论是哪种，结果都一样——任务发出去就报"登录态失效"。如果没有主动监控，运营端常常是"今天发文了发现挂了 8 个账号"。
颜小二的做法是把登录态变成一个一直被观察的状态字段，而不是只在发布失败时才发现。具体分三层：
- 任务级实时上报：每次任务执行时，本地 Agent 把"是否需要重新登录"作为前置探针的一部分回传；状态命中过期立刻触发
login_expired回调 - 周期巡检：本地 Agent 在静默时段（不发文时）做轻量心跳，判断登录态是否仍然可用，结果写入账号状态
- 可观测拉取：你的系统可以按租户拉取整个矩阵每个账号的最新健康度，做看板或告警
整体目标是：让"重登"这件事从"任务挂了再去救火"前移到"健康度变红就提前处理"。
相关字段
健康度回调与查询接口里你会看到这些关键字段：
| 字段 | 含义 | 典型值 | |---|---|---| | account_id | 账号在颜小二里的唯一 ID | 字符串 | | platform | 所属平台 | toutiao / wechat_mp / ... | | group_code | 所属账号分组 | brand_a_default | | login_status | 登录健康度 | healthy / warning / expired | | last_active_at | 上次成功使用时间 | 时间戳 | | next_check_at | 下次巡检时间 | 时间戳 | | error_msg | 失效具体原因 | 字符串（如"风控滑块"） |
发布失败时单独的回调里会有：
``json { "external_id": "your_article_2026_001", "platform": "toutiao", "status": "login_expired", "account_id": "acc_xxx", "error_msg": "session expired, need re-login", "retryable": false } ``
retryable: false 提示这条任务不会被颜小二自动重试，需要重登后由你侧重发。
注意事项
第一，登录态全程保存在客户侧本地 Agent，颜小二云端不存 cookie。健康度字段是抽象出来的状态，不会暴露任何登录凭证。
第二，巡检频率建议结合你侧的发布频率配置。完全不发文的账号也建议每天至少巡检一次，否则等真要发了才发现失效会拖慢节奏。
第三，告警接入推荐做"账号健康度变化"事件触发，而不是定时全量扫描——前者更及时，后者容易漏掉短时窗的异常。
第四，多平台多账号下的告警一定要按 group_code + platform 聚合。一个分组里两个号同时挂掉，和分散在不同分组里的两个号挂掉，应对优先级是不一样的。
相关问题
- 能不能让颜小二自动重登？ 不能。颜小二不持有账号凭证，重登流程只能由客户侧的本地 Agent 通过自有方式（人工扫码 / 短信 / 备份机制）完成。
- 健康度可以推到我自己的监控系统吗？ 可以。回调与拉取接口都支持，常见做法是接 Prometheus / 飞书机器人 / 钉钉机器人。
- 整个矩阵的健康度有没有一个总览看板？ 控制台里默认有，详见 [产品功能页](/product.html)。
常见问题（FAQ）
Q：login_expired 出现后，未发出去的稿子会怎么处理？ 不会自动重试。回调里 retryable: false，由你侧决定是先重登再重发，还是把任务转移到分组里其他可用账号。
Q：重登过程会不会影响其他账号？ 不会。每个账号独立的浏览器 context 与登录态，重登过程被严格隔离在该账号的本地 Agent 里。
Q：如果某个账号长期不活跃，健康度怎么显示？ 会从 healthy 漂移到 warning，再到不可用。建议在你侧把"长期 warning"也作为告警条件。
Q：能不能配多个告警接收方？ 可以，按租户配置多个回调端点，或在你侧的接收端做扇出。
Q：登录健康度信息是否会被其他租户看到？ 不会。多租户严格隔离，每个租户只能看到自己名下账号的健康度。
下一步
把"账号健康度"接进你日常的监控大盘，是把发布矩阵从"作坊"做成"工业流水线"的关键一步。
→ [免费申请接入](/contact.html#form) | [API 文档](/docs.html) | [callback 工作机制](/lp/faq-how-callback-works.html)