diff --git a/README.md b/README.md
index 9faa2cf..ae9079d 100644
--- a/README.md
+++ b/README.md
@@ -35,9 +35,13 @@ attached to other agent tooling as an MCP server.
   `api.minecraftservices.com`; third-party community auth servers; local offline profiles for
   isolated testing. Account tokens are kept on this machine only. **Microsoft sign-in needs an Azure
   public client id, and no release binary carries one** — the id is not in this repo and CI injects
-  none, so set `ULL_MSA_CLIENT_ID` before launching, or build with it. Without one, pressing sign-in
-  only raises a generic "Sign-in failed" alert with `Code: other`; nothing on that screen tells you
-  the id is what is missing. Community auth servers and local profiles need no id.
+  none, so set `ULL_MSA_CLIENT_ID=<id>` before launching, or build with it. Without one, sign-in
+  stops before any network call and the alert says what is missing: the title "Microsoft sign-in is
+  not configured", a body naming `ULL_MSA_CLIENT_ID=<id>` (set it, or build with it, then restart the
+  launcher — a running process does not pick up a new variable), and `Code: msa_not_configured`. It
+  offers no Retry button, because retrying in that same process cannot help. Every other sign-in
+  failure keeps the older shape — one category line plus its own `Code:` line, the full reason only
+  in the launcher log. Community auth servers and local profiles need no id.
 - **Engine**: multi-source download (health scoring, mirrors, chunked transfers, hash while
   downloading) and a YAML rule-based crash diagnosis engine.
 - **License**: Apache-2.0 © AskaEth (YeiJ).
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 3343e31..55d2194 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -27,8 +27,11 @@ Unlucky Launcher（ULL）是一个用 Rust 写的免费开源 Minecraft: Java 
 - **账户**：三轨——Microsoft 账户登录（OAuth 2.0 device code flow → Xbox Live → XSTS →
   `api.minecraftservices.com`）、第三方社区服、本地离线档案；账户令牌只保存在本机。**微软登录需要
   一个 Azure 公共客户端 id，而发布版二进制里没有**——这个 id 不在仓库里，CI 也不注入，所以启动前设
-  `ULL_MSA_CLIENT_ID`（或构建时注入）才会有；没配时点登录只会弹一条通用的「登录失败」，带
-  `代码：other`——那句话不会告诉你是缺了 id。第三方社区服与本地档案不需要 id。
+  `ULL_MSA_CLIENT_ID=<id>`（或构建时注入）才会有。没配时点登录**不会联网**，弹窗直接说清是这一项
+  没配：标题「微软登录未配置」，正文点名 `ULL_MSA_CLIENT_ID=<id>`（设好或构建时注入后要
+  **重启启动器**——已在运行的进程读不到新设的环境变量），并带 `代码：msa_not_configured`；它
+  **不给重试按钮**，因为在同一个进程里重试必然是同一个错。其它登录失败仍是老样子：一句分类文案 +
+  `代码：<码>`，完整原因只在启动器日志里。第三方社区服与本地档案不需要 id。
 - **引擎**：多源下载（健康度评分、镜像、分块传输、边下边算）与 YAML 规则引擎的崩溃诊断。
 - **许可**：Apache-2.0 © AskaEth (YeiJ)。
 
diff --git a/packaging/release-notes.md b/packaging/release-notes.md
index cf19ff4..4ee7559 100644
--- a/packaging/release-notes.md
+++ b/packaging/release-notes.md
@@ -89,9 +89,12 @@ Get-FileHash .\unlucky-launcher_{{VERSION}}_windows_x64.exe -Algorithm SHA256
 
 - Microsoft (MSA) sign-in needs an Azure public client id, and release binaries do not carry one: set
   `ULL_MSA_CLIENT_ID=<id>` before launching, or build with that variable set. Without it sign-in stops
-  before any network call; in the GUI that shows up as the generic "Sign-in failed" banner with
-  `Code: other` (the full reason goes to the launcher log), and `ull accounts add msa` prints the exact
-  fix. Offline profiles and authlib-injector servers need no id.
+  before any network call, and the GUI banner says so plainly: the title "Microsoft sign-in is not
+  configured", a body naming `ULL_MSA_CLIENT_ID=<id>` (set it, or build with it, then restart the
+  launcher — a running process does not pick up a new variable) and `Code: msa_not_configured`, with
+  no Retry button. Every other sign-in failure keeps the generic banner plus its own `Code:` line,
+  with the full reason only in the launcher log. `ull accounts add msa` prints the same fix on the
+  command line. Offline profiles and authlib-injector servers need no id.
 - Binaries are not code-signed / notarized yet: Windows SmartScreen and macOS Gatekeeper warn on first
   launch. The checksums above are the integrity reference for now.
 - macOS ships the bare binary (single-file promise), not a `.app` bundle: no Dock icon or Finder