Initial Dever 0.0.1

lib/doc/dever-http-pool.md

@@ -0,0 +1,45 @@
+# HTTP 连接池
+
+连接池固定使用一个 origin，在创建它的任务作用域结束时关闭。
+
+## dever.http.PoolLimits
+
+空闲保活和流读取限额。
+
+字段：
+- `idle_ms`：空闲连接期限
+- `chunk_bytes`：流分块上限
+- `read_ms`：流读取期限
+
+## dever.http.ClientResult
+
+HTTP 连接池的创建结果。
+
+分支：
+- `Ready(client: dever.system.HttpClient)`：共享资源
+- `error Failed(message: Text)`：配置或资源失败
+
+## dever.http.defaultPoolLimits
+
+使用有限的默认保活与读取配置。
+
+## dever.http.client
+
+创建共享资源；第一次请求才连接。HTTPS 校验 CA 和主机名。
+未声明端口时使用协议默认端口；显式端口非法时立即报错。
+
+## dever.http.request
+
+在固定 origin 发送独立请求；所有排队和 I/O 共用本次期限。
+
+## dever.http.closeClient
+
+关闭所有连接并等待驱动释放；其他别名随后请求失败。
+
+## dever.http.readClient
+
+取出连接池；创建失败时继续传播错误。
+
+## dever.http.closedClient
+
+关闭成功时继续执行，失败时传播错误。