27 lines
1.7 KiB
Markdown
27 lines
1.7 KiB
Markdown
# df-relay — 已迁移（deprecated）
|
||
|
||
> **本 crate 已于 2026-08-23 提取为独立产品 [`u-relay`](../../../u-relay)**（`E:/wk-lab/u-relay`，git filter-repo 保留完整提交历史，脱敏改名 df_\*→u_\*）。
|
||
|
||
- **新功能一律在 u-relay 仓库开发**，本 crate 不再接受功能演进（防双份漂移）
|
||
- 本目录暂保留：现役生产部署（容器 :9180）仍从 devflow 侧构建，待 devflow 客户端（df-tunnel / df-miniapp ws.ts）迁移 u-relay 后整体下线（设计 Q7）
|
||
|
||
## ⚠️ 协议兼容性（2026-10-04 更正）
|
||
|
||
早期陈述「u-relay 协议为 df-relay 超集，hello/device_id 原样兼容，迁移只需切 host」**已过时**。
|
||
u-relay 在协议正名（agent/commander 第三代）时**已拆除全部兼容层**：
|
||
|
||
| 维度 | df-relay（本 crate） | u-relay（现行） |
|
||
|---|---|---|
|
||
| 端点 | `/ws/device`、`/ws/miniapp` | **`/ws/agent`、`/ws/commander`**（旧端点不存在） |
|
||
| Hello.kind | `"device"`、`"miniapp"` | **`"agent"`、`"commander"`**（旧 kind 握手期直接拒绝） |
|
||
| 配对键字段 | `device_id` | **`channel_id`**（不再 alias） |
|
||
| 错误码 | `invalid_device_id` | `invalid_channel_id` |
|
||
| token env | `DF_RELAY_TOKEN` | `U_RELAY_TOKEN` |
|
||
|
||
**迁移不是"切 host"而是协议升级**。devflow 侧客户端已于 2026-10-04 完成升级：
|
||
- `crates/df-tunnel`（Rust，桌面端 Agent）✅
|
||
- `apps/df-miniapp`（uni-app，Commander：config.ts / ws.ts / types/relay.ts / settings 页 + storage 旧字段迁移）✅
|
||
|
||
协议规格见 `docs/02-架构设计/专项设计/u-relay-wire-protocol-2026-10-04.md`。
|
||
设计文档：`C:/Users/23780/docs/u-box-design.md` §3.3 + `u-relay-extract-plan.md`
|