普通客户端通过刷新凭证或已有登录会话获取新访问令牌,通常无需每次输入密码或 MFA。本工具现在为网页 API 服务提供同样的两阶段恢复思路,实际能否静默完成仍以微软和公司登录策略为准。微软令牌获取说明
0.6.2 修复过期 MSAL 缓存被误判为恢复完成的问题:匹配刷新材料时还必须有同账号、同资源、权限匹配且剩余有效期超过 30 秒的访问令牌。缓存里的过期条目不能提前触发验证并关闭浏览器;页面跳转时缓存执行环境暂时消失,也不会立即终止恢复,而是在本次限时内继续尝试。静默恢复的截止时间按实际 90 秒显示。
控制台区分「正在自动续期」「续期等待重试」「后台运行中」;已完成或取消的静默登录不会持续显示为进行中。等待重试显示下次尝试时间。明确需要交互时显示重新登录,停止的实例不会继续显示续期进行中。
每轮采集前检查已捕获访问令牌的时间,在到期前 5 分钟尝试更新;接口提前返回认证错误时也会尝试更新。优先通过 Node 进程提交 refresh_token。登录时同时读取本实例官方页面的 MSAL 缓存,匹配用户、租户、客户端、环境与 home account,解决页面全部命中缓存、没有发起 token 请求的情况。仅处理已保存接口证明授权的资源;使用实际捕获的请求,或微软文档规定的租户 token 端点与这些资源的 .default,不会自动同意新增权限。微软刷新协议、已授权资源的 .default
已适配当前 Teams 资源标识带/不带根路径末尾斜杠的情况;MSAL 缓存可能把展开权限与 .default 放在一起,这种缓存目标不能原样用作刷新 scope,工具会按已证明授权的资源请求 .default,避免 AADSTS70011。后续只打开聊天的登录会保留先前日历模板,并分别验证,避免覆盖整个会话时丢失日历采集。
刷新返回的新令牌必须匹配原租户、用户、客户端与资源,并包含原请求已有的权限。先持久化刷新令牌轮换结果,再替换该实例 HAR 中对应凭证,重建实时、历史及在线状态采集器。SQLite 中已提交的消息、历史页和增量游标继续使用,不重置为全量补采。在线维持关闭时,不会为了闲置的状态凭证启动恢复。
如果没有可用刷新凭证、刷新授权到期或服务要求恢复登录,则短时启动此实例独立的无窗口浏览器,加载 Teams,必要时打开日历入口,让官方页面使用保留的登录状态恢复。读取已验证身份的 MSAL 缓存与新请求凭证,完成后关闭浏览器;不会清除登录 Cookie 或刷新令牌,也不会自动点击密码、MFA 或同意授权提示。浏览器常规恢复限时 90 秒;出现可见交互提示时才标记需要人工验证,单纯重定向到登录域名不视为 MFA 要求,页面加载/网络暂时失败采用退避重试。
直接刷新不启动浏览器;会话恢复路径会短时启动浏览器进程,因此这一路线不是“任何时候都绝无浏览器进程”。公司策略、浏览器登录状态和网页接口变化仍可能使静默恢复失败。
data/network-renewal.json 和 data/network-profile/login-<随机 ID>/。data/instances/<实例 ID>/ 下的同名文件和目录。list_instances 仅投影续期状态及时间。当前只在 npm start 启动的本地服务调度续期;独立 capture:sync / capture:history 命令维持原来的静态 HAR 行为。加密或无法确认身份的访问令牌不会被直接刷新替换,需要浏览器恢复或后续适配。网页登录刷新凭证自身也可能有较短寿命,不能承诺永久免交互。微软刷新令牌说明