From baad84449586b03f3c660291469f76d7ac8359b4 Mon Sep 17 00:00:00 2001
From: Your Name <your.email@example.com>
Date: Tue, 31 Mar 2026 14:01:42 +0800
Subject: [PATCH] chore: clarify fal realtime rollout messaging

---
 app/(admin)/settings/admin-settings-client.tsx | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/app/(admin)/settings/admin-settings-client.tsx b/app/(admin)/settings/admin-settings-client.tsx
index 8c15c23a1..01847df77 100644
--- a/app/(admin)/settings/admin-settings-client.tsx
+++ b/app/(admin)/settings/admin-settings-client.tsx
@@ -10505,7 +10505,7 @@ const [realtimeCanvasConfig, setRealtimeCanvasConfig] = useState({
                 实时画布配置
               </CardTitle>
               <CardDescription>
-                配置实时画布功能的 BFL（FLUX.2）参数、模型与 API Key。保存时会自动探针校验模型可用性。
+                配置实时画布功能的供应商、模型与 API Key。当前已接入 BFL / Replicate / FAL 供应商；FAL 的 WebSocket 真流式实时属于第二阶段，不是这次上线内容。
               </CardDescription>
             </CardHeader>
             <CardContent className="space-y-6 pt-6">
@@ -10543,7 +10543,7 @@ const [realtimeCanvasConfig, setRealtimeCanvasConfig] = useState({
                   <SelectContent>
                     <SelectItem value="bfl">BFL / 兼容接口</SelectItem>
                     <SelectItem value="replicate">Replicate</SelectItem>
-                    <SelectItem value="fal">FAL</SelectItem>
+                    <SelectItem value="fal">FAL（WebSocket 真流式实时为二阶段）</SelectItem>
                   </SelectContent>
                 </Select>
               </div>
@@ -10589,6 +10589,11 @@ const [realtimeCanvasConfig, setRealtimeCanvasConfig] = useState({
                 </>
               ) : realtimeCanvasConfig.providerType === "fal" ? (
                 <>
+                  <div className="rounded-lg border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-800">
+                    当前 FAL 接入的是“供应商能力接入阶段”，会通过现有 `/api/realtime/generate` 服务端链路调用 FAL。
+                    前端直连 FAL WebSocket 的“真流式实时”属于第二阶段，当前尚未启用。
+                  </div>
+
                   <div className="space-y-2">
                     <Label htmlFor="realtimeFalApiKey">
                       FAL API Key <span className="text-destructive">*</span>
@@ -10721,7 +10726,7 @@ const [realtimeCanvasConfig, setRealtimeCanvasConfig] = useState({
                     <SelectContent>
                       <SelectItem value="bfl">BFL / 兼容接口</SelectItem>
                       <SelectItem value="replicate">Replicate</SelectItem>
-                      <SelectItem value="fal">FAL</SelectItem>
+                      <SelectItem value="fal">FAL（WebSocket 真流式实时为二阶段）</SelectItem>
                     </SelectContent>
                   </Select>
                 </div>
@@ -10763,6 +10768,10 @@ const [realtimeCanvasConfig, setRealtimeCanvasConfig] = useState({
                   </>
                 ) : realtimeCanvasConfig.fallbackProviderType === "fal" ? (
                   <>
+                    <div className="rounded-lg border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-800">
+                      备用 FAL 目前同样走现有服务端生成链路，不是前端直连 WebSocket 真流式实时。
+                    </div>
+
                     <div className="space-y-2">
                       <Label htmlFor="realtimeFallbackFalApiKey">备用 FAL API Key</Label>
                       <Input