技能介绍

解决什么问题

当业务插件或上层技能需要天翼账号的 idToken 时，直接调用业务接口往往缺少可信认证凭证。该技能把天翼账号的 AST 扫码登录和 /ast/verify 直连校验封装成一条稳定链路，避免各业务重复处理二维码、票据状态和本地会话恢复。

如何工作

核心路径只有一条：通过 /ast/verify 完成直连认证，不走 gateway 模式，也不调用 /ast/introspect。

先读取 direct_auth_init.json 或调用方显式参数。
用内置 Python helper 检查 agent_session.json。
解析业务 appId，若会话有效则调用 /ast/verify。
若会话缺失、过期或格式异常，则调用 /ast/login/start 与 /ast/login/qrcode，展示二维码和登录链接。
用户确认已登录后，查询 /ast/login/status/{ticket}。
登录成功后保存本地会话与身份材料，再调用 /ast/verify 返回 idToken 与 expiresAt。

适用边界

它适合被其他技能或代码插件作为认证依赖调用。成功标准是状态接口返回成功、agent_session.json 保存成功，且直连认证拿到 idToken 与 expiresAt。不要向调用方暴露 agentSessionToken、私钥材料、签名明文、本地路径或 appId，也不要把它用于 refresh、logout 或 gateway 回退场景。