From 9eb1bde6459f72c31c875d01b653b85178445708 Mon Sep 17 00:00:00 2001
From: Misaka_Company <pengqiangqiang0@gmail.com>
Date: Thu, 21 May 2026 09:06:25 +0800
Subject: [PATCH] docs: add Flutter test proxy workaround to CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index aa7c5a4..56eabdf 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -21,3 +21,16 @@ flutter build apk --release
 # 2. Install (in-place upgrade, preserves config)
 adb install -r build/app/outputs/flutter-apk/app-release.apk
 ```
+
+## Flutter Test Rules
+
+Before running `flutter test`, temporarily remove proxy environment variables for the current shell. The Flutter tester uses a localhost WebSocket, and proxy settings can break that connection with `Invalid WebSocket upgrade request`.
+
+### PowerShell
+
+```powershell
+$env:HTTP_PROXY=''
+$env:HTTPS_PROXY=''
+$env:NO_PROXY='localhost,127.0.0.1,::1'
+flutter test
+```