refactor(edge): Server 协议统一与 wsclient 收敛（Phase 3 Batch 3）

- openflare/agent/relay/flared 协议类型改为 pkg/protocol 别名，删除重复 struct
- 新增 edge/wsclient Preset 表，三组件 wsclient 改为薄包装
- 更新设计文档、计划与 changelog

docs/changelog/index.md

@@ -21,6 +21,8 @@ sidebar: false
 - 边缘组件运行时去重：新增 `internal/apps/edge/` 共享包（`updater`、`httpclient`、`nodeip`、`logging`、`heartbeat/autoupdate`、`runner`），Agent/Relay/Flared 三组件改为薄包装委托，删除约 1100 行重复自更新与 HTTP 传输层代码。
 - 边缘运行时 Phase 3 Batch 1：抽取 `edge/config/duration`、`edge/observability/linux`、`edge/heartbeat/loop`，统一 MillisecondDuration、Linux 指标采集与 relay/flared 心跳循环。
 - 边缘运行时 Phase 3 Batch 2：Agent 心跳周期下沉至 `heartbeat/cycle.go`；`pkg/protocol/agent.go` 统一 Agent 客户端协议类型。
+- 边缘运行时 Phase 3 Batch 3（T6）：Server 侧 `openflare/agent`、`relay`、`flared` 协议类型统一为 `pkg/protocol` 别名，消除与客户端的重复定义。
+- 边缘运行时 Phase 3 Batch 3（T7）：新增 `edge/wsclient`，Agent/Relay/Flared 三组件 `wsclient/` 改为 Preset 薄包装，删除约 150 行重复 WebSocket 传输层代码。
 - 合并并简化仓库结构：将 `openflare-server` 单体目录下的所有文件/目录提升至仓库根目录（去除了 `openflare-server` 嵌套层级），保留 `.github` 目录不变；统一配置 `docker-compose.yaml` 及所有 Dockerfile 的构建上下文为根目录。
 - 调整子项目结构与包路径：将 `agent`、`relay` 和 `flared` 子项目从 `internal/` 移动至 `internal/apps/`（分别为 `internal/apps/agent`、`internal/apps/relay` 和 `internal/apps/flared`），并递归更新了所有涉及的 Go 导入路径（如 `github.com/Rain-kl/Wavelet/internal/apps/agent` 等）。
 - 调整编译产物输出名称与 Makefile：

docs/design/edge-runtime-refactor.md

@@ -34,6 +34,7 @@ internal/apps/edge/
 ├── logging/          # Setup、ParseLevel
 ├── nodeip/           # Detect、DetectLocal（可注入 LookupOutboundIP）
 ├── httpclient/       # 基础 HTTP 客户端（鉴权头可配置）
+├── wsclient/         # 基础 WebSocket 客户端（组件 Preset 驱动 HeaderKey + WSPath）
 ├── updater/          # GitHub Release 自更新 + 二进制替换重启
 ├── heartbeat/        # TryAutoUpdate 统一入口
 └── runner/           # WS 重连循环、SleepContext
@@ -49,7 +50,7 @@ internal/apps/edge/
 | Relay | `frps/`、`observability/` |
 | Flared | `frpc/`、`sync/`（tunnel） |
 
-各组件 `updater/`、`httpclient/` 变为类型别名 + `New()` 工厂函数。
+各组件 `updater/`、`httpclient/`、`wsclient/` 变为类型别名 + `New()` 工厂函数。
 
 ---
 
@@ -72,6 +73,14 @@ edgehttp.New(baseURL, token, timeout, "X-Agent-Token")   // Agent/Relay
 edgehttp.New(baseURL, token, timeout, "X-Tunnel-Token")  // Flared
 ```
 
+### WebSocket 客户端
+
+```go
+edgews.New(edgews.PresetAgent, baseURL, token, timeout)   // HeaderKey=X-Agent-Token,  /api/v1/agent/ws
+edgews.New(edgews.PresetRelay, baseURL, token, timeout)   // HeaderKey=X-Agent-Token,  /api/v1/relay/ws
+edgews.New(edgews.PresetFlared, baseURL, token, timeout)  // HeaderKey=X-Tunnel-Token, /api/v1/tunnel/ws
+```
+
 ### 节点 IP 探测
 
 ```go
@@ -104,12 +113,15 @@ nodeip.Detect() // outbound → local 回退
 - [x] `heartbeat/cycle.go` — Agent HTTP 心跳周期从 runner 下沉（payload 构建、同步、自动更新）
 - [x] `pkg/protocol/agent.go` — Agent 客户端协议类型迁入公共包，`internal/apps/agent/protocol` 保留别名 re-export
 
+## 已完成（Phase 3 Batch 3）
+
+- [x] `edge/wsclient` — Agent/Relay/Flared WebSocket 传输层收敛（Preset 配置表 + `AgentConnection` 适配 `protocol.WebSocketConnection`）
+- [x] Server 侧协议统一 — `internal/apps/openflare/{agent,relay,flared}` 心跳/观测类型改为 `pkg/protocol` 别名
+
 ## 可选后续
 
 | 项 | 说明 |
 | --- | --- |
-| Server 侧协议统一 | 评估 `internal/apps/openflare/agent` 与 `pkg/protocol` 类型去重 |
-| `wsclient` 薄包装收敛 | relay/flared/agent wsclient 配置表化 |
 
 ---
 

docs/plan/20260619-edge-phase3-tasks.md

@@ -1,6 +1,6 @@
 # 边缘运行时 Phase 3 — 任务拆解
 
-> **状态**：Batch 1 + Batch 2 已完成（2026-06-19）
+> **状态**：Batch 3 已完成（2026-06-19）
 > **前置**：[边缘运行时重构设计](../design/edge-runtime-refactor.md) Phase 0–2 已完成
 
 ---
@@ -45,9 +45,31 @@ Batch 2（串行，依赖 Batch 1 或需独立评审）
 
 ---
 
-## 验收标准（Batch 1）
+## Batch 3 — 并行任务（已完成）
+
+| ID | 任务 | 修改范围 | 状态 |
+| --- | --- | --- | --- |
+| **T6** | Server 侧协议统一 | `pkg/protocol/` + `internal/apps/openflare/{agent,relay,flared}/` | ✅ 子代理 F |
+| **T7** | `wsclient` 收敛 | `edge/wsclient/` + 三组件 `wsclient/` 薄包装 | ✅ 子代理 G |
+
+### T6 要点
+
+- `openflare/agent` 的 `NodePayload`、观测类型、WAF 类型改为 `pkg/protocol` 别名
+- 保留 Server 专有响应：`RegistrationResponse`（`access_token`）、`HeartbeatResponse`（含 `*model.OpenFlareNode`）
+- `openflare/relay`、`openflare/flared` 心跳/配置载荷改为 `pkg/protocol` 别名
+
+### T7 要点
+
+- 新增 `internal/apps/edge/wsclient/`，配置表驱动（HeaderKey + WSPath）
+- Agent 保留 `SendStatus` + `protocol.WebSocketConnection` 适配
+- relay/flared/agent 的 `wsclient/` 仅保留 `New()` 工厂
+
+---
+
+## 验收标准
 
 ```bash
 go build ./cmd/agent ./cmd/relay ./cmd/flared
-go test ./internal/apps/edge/... ./internal/apps/agent/... ./internal/apps/relay/... ./internal/apps/flared/... -count=1
+go test ./internal/apps/edge/... ./internal/apps/agent/... ./internal/apps/relay/... ./internal/apps/flared/... ./internal/apps/openflare/... ./pkg/protocol/... -count=1
+make code-check
 ```