文档结构调整

docs/NET_Socket_FTP_Support_Plan.md

@@ -1,80 +0,0 @@
-# NET Socket FTP 支持改造方案
-
-## 背景
-
-在 net_socket API 上移植 FTP Server（lftpd），需要支持 PASV 模式数据通道。现有 API 仅支持"一个监听 Socket 独占全部数据 Socket"的单 TCP Server 模型，改造后需支持**多监听者 + 动态 Socket 分配**。
-
-## Socket 需求量
-
-| 用途 | Socket | 说明 |
-|------|--------|------|
-| 控制通道监听（端口 21） | Socket 0 | 多连接 TCP Server |
-| 控制通道数据 | Socket 1 | backlog=1，只接受 1 个 FTP 客户端 |
-| PASV 数据监听 + 传输 | Socket 2 | 动态分配，用后释放 |
-| 空闲 | Socket 3~7 | 备胎 |
-
-## 改造项（7 项）
-
-### A. `net_sock_t` 新增 `standalone_accept` 标志
-- 位置：`net_types.h:net_sock_t`
-- 用途：区分多连接数据 Socket 和独立监听者（如 PASV）
-- 设 1：PASV 监听者 `handle_connect_event` → 原地转为 `ESTABLISHED`
-- 设 1：`handle_disconnect_event` → 释放（`CLOSED`），不恢复 `TCP_ACCEPT`
-
-### B. `net_listen()` 按 backlog 分配 + 登记 data_socks[]
-- 循环从 `NET_TCP_SERVER_DATA_SOCK_START` 到 `backlog` 个
-- 分配的数据 Socket 登记到 `p_sock->data_socks[]`，设 `data_sock_count`
-- `backlog == 0` 时：不分配数据 Socket，设 `standalone_accept=1`
-
-### C. `net_bind()` 支持 port=0 自动分配
-- `sin_port == 0` 时从 49152~65535 分配
-- 静态变量 `s_dynamic_port` 递增
-
-### D. `handle_connect_event()` 支持独立监听
-- `LISTENING + standalone_accept`：拷贝远程 IP/Port，状态转 `ESTABLISHED`
-- `LISTENING + !standalone_accept`：保持 LISTENING（现有行为）
-
-### E. `handle_disconnect_event()` 支持独立释放
-- `ESTABLISHED + standalone_accept`：设 `state = CLOSED, in_use = 0`（释放）
-- `ESTABLISHED + !standalone_accept`：恢复 `TCP_ACCEPT`（现有行为）
-- 释放时不清零整个控制块（正在 `net_recv` 中的任务仍需读取 state）
-
-### F. `net_accept()` 支持单连接 + 修复多连接
-- 先查 `data_socks[]`（修复现行 bug）
-- 再查 `standalone_accept` 监听者是否 `ESTABLISHED` → 返回自身
-
-### G. 新增 `net_getsockname()`
-- 返回 `local_port` + 本机 IP
-- 本机 IP 在 `net_init()` 时缓存（`s_local_ip`），避免 SPI 竞态
-
-## 消息队列序列化
-
-### 问题
-`net_listen()`、`net_accept()` 直接调用 CH395F SPI，从非 netTask（如 FTP 任务）调用会与 `net_poll()` 冲突。
-
-### 方案
-新增消息类型通过现有消息队列串行化：
-
-| 消息类型 | 用途 | 状态 |
-|---------|------|------|
-| `NET_MSG_LISTEN` | `net_listen()` 委托 netTask 执行 | 本次实现 |
-| `NET_MSG_ACCEPT` | `net_accept()` 委托 netTask 执行 | 本次实现 |
-
-`net_bind()` 暂不消息化（TCP 部分不碰 SPI，UDP 暂无需跨任务调用）。
-
-## 向后兼容
-
-- 控制通道 `net_listen(sockfd=0, backlog=7)` 行为不变（仍配满 Socket 1~7）
-- `backlog < 7` 时才释放多余 Socket
-- `NET_MSG_LISTEN`/`NET_MSG_ACCEPT` 仅新增，不影响现有 `NET_MSG_SEND/RECV/CLOSE/CONNECT`
-- `net_sock_t` 新增字段 `standalone_accept` 默认 0，不影响现有使用
-
-## 实施顺序
-
-1. 消息队列加 `NET_MSG_LISTEN`、`NET_MSG_ACCEPT`
-2. `net_listen()` 消息化 + 按 backlog 分配 + data_socks 登记
-3. `net_accept()` 消息化 + 单连接支持
-4. `net_bind()` port=0 支持
-5. `net_types.h` standalone_accept 字段
-6. `handle_connect_event()` / `handle_disconnect_event()` 独立监听逻辑
-7. `net_getsockname()`