diff --git a/openless-all/app/src-tauri/src/asr/volcengine.rs b/openless-all/app/src-tauri/src/asr/volcengine.rs
index 7d28fc05..83708fe2 100644
--- a/openless-all/app/src-tauri/src/asr/volcengine.rs
+++ b/openless-all/app/src-tauri/src/asr/volcengine.rs
@@ -50,6 +50,12 @@ pub enum VolcengineASRError {
     CredentialsMissing,
     #[error("connection failed: {0}")]
     ConnectionFailed(String),
+    /// WebSocket 握手阶段服务端返回 401 / 403：凭据被拒。
+    /// 区分自 `ConnectionFailed`（DNS/TLS/网络层失败）—— 前者通常是 App ID / Access
+    /// Token / Resource ID 错或账号没开通 bigmodel；后者是网络断 / 防火墙 / DNS。
+    /// 文案简短，原因在文档里说明，capsule 不堆长引导。
+    #[error("凭据被拒（{0}）")]
+    AuthRejected(u16),
     #[error("authentication failed")]
     AuthenticationFailed,
     #[error("no final result")]
@@ -155,9 +161,7 @@ impl VolcengineStreamingASR {
                 .map_err(|e| VolcengineASRError::ConnectionFailed(e.to_string()))?,
         );
 
-        let (ws, _resp) = connect_async(request)
-            .await
-            .map_err(|e| VolcengineASRError::ConnectionFailed(e.to_string()))?;
+        let (ws, _resp) = connect_async(request).await.map_err(classify_connect_error)?;
         let (write, read) = ws.split();
 
         let (tx, rx) = oneshot::channel();
@@ -637,6 +641,20 @@ fn normalized_result(json: &Value) -> Option<&Value> {
     None
 }
 
+/// 把 tokio-tungstenite 的 connect 错误分类：握手收到 HTTP 401 / 403 → `AuthRejected`
+/// （凭据被拒，要 user 检查 App ID / Access Token / 账号资源开通状态）；其它 → 通用
+/// `ConnectionFailed`（DNS / TLS / 网络层）。让 capsule 文案能跟泛泛 HTTP error 区分。
+fn classify_connect_error(err: tokio_tungstenite::tungstenite::Error) -> VolcengineASRError {
+    use tokio_tungstenite::tungstenite::Error as WsError;
+    if let WsError::Http(resp) = &err {
+        let status = resp.status().as_u16();
+        if status == 401 || status == 403 {
+            return VolcengineASRError::AuthRejected(status);
+        }
+    }
+    VolcengineASRError::ConnectionFailed(err.to_string())
+}
+
 fn hotword_context(entries: &[DictionaryHotword]) -> Option<String> {
     let mut seen: Vec<String> = Vec::new();
     for entry in entries {