---
kind: upgrade-guide
description: "桌面测试包需要在本地显式开启后，才能显示飞书更新策略鉴权弹窗。"
---

# 在本地开启测试更新策略鉴权弹窗

[English](guide.md) | 中文

## 变更

测试包此前会在启动或手动检查更新策略未通过鉴权后提供飞书登录入口。现在所有测试鉴权弹窗默认关闭，包括手动检查和强更刷新。测试网关 Cookie 不跨重启保存。禁止登录时，需要鉴权的网关无法提供新的强更决策；需开启设置、重启并登录后才能获取。鉴权失败仍保留同一进程中已知的强更阻塞；正式环境策略请求和产品账号登录保持不变。

## 迁移

1. 启动更新后的应用一次，在 `app.getPath('userData')/desktop/settings.json` 缺失时生成该文件。已有文件会保留，字段缺失时默认为 `false`。平台路径和错误恢复方法见[本地桌面设置](../../../../apps/desktop/README.zh.md#local-desktop-settings)。
2. 如需允许飞书登录，在文件中将 `updates.allowTestAuthPopupWindow` 设为 `true`，然后完全退出并重启 Desktop。此时测试策略的未鉴权响应可以提供登录入口。不需要登录弹窗时保持默认值即可。
3. 如需再次关闭弹窗，将字段设为 `false` 并重启。启动和手动检查均不得显示飞书鉴权弹窗。更新仍会查询策略，鉴权失败不会解除已知强更阻塞。