优化: aichat效率剩余(压缩后台化防阻塞/审计批量事务/只读缓存轮内去重/流式增量渲染/AiCommandOutput合批/双渲染合并) + 跨端加固(df-project路径保留大小写/tunnel文档更正supervisor重连/relay固定时间比较与帧上限/启动校验) + 销账

crates/df-tunnel/src/lib.rs

@@ -9,7 +9,9 @@
 //!
 //! ## 边界
 //! - 不依赖 src-tauri(TunnelEvent/TunnelCommand 独立定义,避免跨 crate path 引用二进制)
-//! - 不含业务逻辑(Phase2 填充 WS 握手/鉴权/重连/路由)
+//! - 不含业务逻辑(Phase2 填充 WS 握手/鉴权/收发循环;断线**自动重连由调用方 supervisor
+//!   负责**,src-tauri 已实现指数退避重连,本 crate 提供 connect/disconnect/is_connected
+//!   原语 + `backoff_delay` 退避工具)
 //!
 //! ## 模块
 //! - [`events`]:隧道透传事件/指令/消息包装类型

crates/df-tunnel/src/tunnel.rs

@@ -1,7 +1,9 @@
 //! df-tunnel 隧道客户端(Phase2 完整实现)
 //!
 //! 设计依据:设计文档「Layer1」—— 桌面端主动出站连云后端 `wss://host/ws/device`,
-//! 穿 NAT 无需端口映射。tokio-tungstenite WS + Hello 握手 + 收发循环 + 指数退避重连。
+//! 穿 NAT 无需端口映射。tokio-tungstenite WS + Hello 握手 + 收发循环。
+//! 断线重连由**调用方 supervisor** 负责(src-tauri 已实现指数退避重连,见其 tunnel 初始化处):
+//! 本 crate 提供 connect/disconnect/is_connected 原语 + [`reconnect_params`] 参数复用 + [`backoff_delay`] 退避工具。
 //!
 //! ## 协议对齐(df-relay Phase2 commit 2b8b30e)
 //! - 桌面端连 `/ws/device`,首帧发 `Hello { kind:"device", device_id, token }`
@@ -130,9 +132,9 @@ enum OutFrame {
 
 /// 默认 WS 隧道客户端(完整实现)
 pub struct WsTunnelClient {
-    /// 目标服务器 URL(connect 后保存,重连用;字段供未来 auto-reconnect 读)
-    /// 注:当前 connect 一次性建立,未实现自动后台重连(手动 connect 即重连),
-    /// 该字段保留以备 Phase3「断线后台自动重连」消费。
+    /// 目标服务器 URL(connect 后保存,供调用方 supervisor 经 [`reconnect_params`] 复用)。
+    /// 注:本 crate 不内置后台自动重连(见模块文档);重连由调用方 supervisor 轮询
+    /// is_connected + 再 connect 完成(src-tauri 已实现,指数退避)。
     server_url: Mutex<Option<String>>,
     device_id: Mutex<Option<String>>,
     token: Mutex<Option<String>>,
@@ -155,7 +157,7 @@ impl WsTunnelClient {
         }
     }
 
-    /// 当前已连接时取一份重连参数(未来自动重连用)
+    /// 当前已连接时取一份重连参数(URL/device_id/token,供调用方 supervisor 断线重连复用)
     pub async fn reconnect_params(&self) -> Option<(String, String, String)> {
         let url = self.server_url.lock().await.clone()?;
         let device_id = self.device_id.lock().await.clone()?;
@@ -344,8 +346,9 @@ impl WsTunnelClient {
 /// 3. 心跳定时器:每 HEARTBEAT_INTERVAL 发一次 Ping
 /// 4. 任一端断开 → 退出 task,置 connected=false
 ///
-/// 注:本任务范围不含「自动后台重连」(disconnect 即退出)。Phase3 可在外层包一层
-/// supervisor task,检测 task 退出后用指数退避重新 connect(参数从 reconnect_params 取)。
+/// 注:本任务范围不含「自动后台重连」(断开即退出)。自动重连由**调用方 supervisor** 承担:
+/// 轮询 is_connected → 用 [`reconnect_params`](WsTunnelClient::reconnect_params) 取参数
+/// + [`backoff_delay`] 退避 → 再 connect。src-tauri 已实现该 supervisor。
 async fn run_loop(
     mut sink: futures_util::stream::SplitSink<
         tokio_tungstenite::WebSocketStream<tokio_tungstenite::MaybeTlsStream<tokio::net::TcpStream>>,
@@ -497,9 +500,11 @@ fn parse_relay_error(msg: &WsMessage) -> Option<RelayControlError> {
     }
 }
 
-/// 计算指数退避延迟(供未来 supervisor 重连使用,本任务未直接调用,但属完整重连语义的一部分)
-#[allow(dead_code)]
-fn backoff_delay(attempt: u32) -> Duration {
+/// 计算指数退避延迟(1s, 2s, 4s, 8s, 16s, 30s, 30s, ...)
+///
+/// 供调用方 supervisor 断线重连使用(本 crate 不内置自动重连,见模块文档)。
+/// 暴露为 pub 使外部(supervisor / src-tauri)可直接复用,不再属死代码。
+pub fn backoff_delay(attempt: u32) -> Duration {
     // 1s, 2s, 4s, 8s, 16s, 30s, 30s, ...
     let secs = RECONNECT_BASE
         .as_secs()