chore: infrastructure alignment and doc sync (by AICoder)

chore: infrastructure alignment and doc sync (by checkall)
对齐 Tag v1.3.0 （By AI）
2026-05-16 01:28:35 +08:00 · 2026-05-14 21:54:04 +08:00 · 2026-05-10 15:48:28 +08:00 · 2026-05-10 13:12:30 +08:00 · 2026-05-10 13:04:34 +08:00 · 2026-05-09 21:01:01 +08:00
9 changed files with 351 additions and 141 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1 +1,8 @@
 .log.meta.json
+.ai/
+.geminiignore
+.gemini
+env.json
+env.yml
+env.yaml
+/CODE-FULL.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@ -1,5 +1,34 @@
 # CHANGELOG

+## v1.0.10 (2026-05-09)
+- **CI/CD 对齐**:
+    - 修复测试用例由于默认绑定泛地址导致的 `connection refused` 错误，显式绑定本地测试服务器至 `127.0.0.1`，提高 macOS 与多网卡环境下的测试稳定性。
+    - 更新 `TEST.md`，同步最新的测试用例覆盖场景（包括 `Multipart` 和 `Form` 的验证）及真实 Benchmark。
+
+## v1.0.9 (2026-05-09)
+- **基础设施对齐**: 
+    - 升级 `apigo.cc/go/log` 至 `v1.1.13`。
+    - 确保与 `log` 包最新的“绝对索引”和“强制 Reset 契约”兼容。`http` 包不涉及自定义日志类型，故无代码变更。
+
+## v1.0.8 (2026-05-08)
+- **性能优化 (Memory Efficiency)**:
+    - 重构 `Multipart` 处理逻辑，采用 `io.Pipe` 实现流式上传，彻底解决大文件上传时的内存撑爆问题。
+    - 引入 `writeMultipartPart` 与 `writeMultipartFile` 辅助函数，优化分块写入逻辑。
+- **功能增强 (Unified Type Handling)**:
+    - 统一 `do` 方法内部逻辑，通过类型分组消除冗余代码。
+    - 将 `map[string][]any` 提升为 `Multipart` 处理，确保复杂/混合数据类型的正确流式发送。
+    - 完善对 `url.Values`, `map[string][]string`, `Form` 的统一表单编码支持。
+    - 优化 `Multipart` 对多值字段的支持，允许在 `Multipart` 映射中使用 `[]string` 或 `[]any` 发送同名多参数。
+- **基础设施对齐**: 
+    - 更新 `go/encoding` 至 v1.0.6。
+    - 移除 `bufferPool` 在 `Multipart` 中的使用，转向更高效的流式 IO。
+
+## v1.0.6 (2026-05-07)
+- 内部版本，优化 Header 自动透传逻辑。
+
+## v1.0.5 (2026-05-06)
+- 内部版本，增强对 H2C 场景下的连接池管理。
+
 ## v1.0.4 (2026-05-05)
 - **基础设施对齐**: 
    - 更新 `go/file` 至 v1.0.5, `go/log` 至 v1.1.1, `go/config` 至 v1.0.5。
--- a/README.md
+++ b/README.md
@ -36,8 +36,12 @@ user, err := http.To[User](r)
 if err == nil {
    fmt.Println(user.Name)
 }
+
+// 支持 map[string][]string 或 map[string][]any 作为表单 (application/x-www-form-urlencoded)
+c.Post("https://api.example.com/update", map[string][]string{"tags": {"go", "http"}})
 ```

+
 ### 2. Header 透传 (Discover Relay)
 在处理外部请求时，自动从原请求中提取并续传关键 Header。
 ```go
@ -73,11 +77,13 @@ c.Download("local_file.zip", "https://example.com/large_file.zip", func(start, e

 ### 特殊类型
 - `type Form map[string]string`: 用于 `Post/Put` 等方法，显式指定为 `application/x-www-form-urlencoded` 格式。
-    - 注意：直接传入 `map[string]string` 会被默认识别为 `application/json`。
- `type Multipart map[string]any`: 用于 `Post/Put` 等方法，支持混合表单字段与文件上传。
-    - 如果值为 `string` 且指向有效文件路径，则作为文件上传。
-    - 如果值为 `[]byte` 或 `io.Reader`，则作为文件上传。
-    - 其他类型将作为普通表单字段（复杂类型会自动转为 JSON）。
+    - 注意：直接传入 `map[string]string` 会被默认识别为 `application/json`；传入 `map[string][]string` 或 `map[string][]any` 会被识别为 `application/x-www-form-urlencoded`。
+- `type Multipart map[string]any`: 用于 `Post/Put` 等方法，支持混合表单字段与文件流式上传。
+    - **流式上传**: 内部使用 `io.Pipe` 结合 `multipart.Writer` 实现，支持超大文件而不会占用过多内存。
+    - **文件识别**: 如果值为 `string` 且指向有效文件路径，则作为文件上传。
+    - **流/字节**: 如果值为 `[]byte` 或 `io.Reader`，则作为文件上传。
+    - **多值支持**: 如果值为 `[]string` 或 `[]any`，将产生多个同名的表单字段或文件。
+    - **其他类型**: 将作为普通表单字段（复杂类型会自动转为 JSON）。

 ### 响应处理 (Result)
 - `func (rs *Result) String() string`: 返回响应体字符串。
--- a/TEST.md
+++ b/TEST.md
@ -4,9 +4,10 @@
 - **基础请求**: 验证了使用 `Get` 获取 JSON 响应并通过 `To[T]` 进行泛型绑定的功能。
 - **本地服务器**: 验证了客户端与本地测试服务器的交互。
 - **H2C 支持**: 验证了 H2C (HTTP/2 Cleartext) 的兼容性。
- **手动请求**: 验证了通过 `ManualDo` 进行精细化控制的流程。
+- **手动请求**: 验证了通过 `ManualDo` 进行精细化控制的流式请求。
 - **文件下载**: 验证了使用 `Download` 进行并发分段下载的功能。
- **多部分表单**: 验证了使用 `MPost` 上传文件和表单数据的正确性。
+- **多部分表单 (Multipart)**: 验证了使用流式 `io.Pipe` 的 `Multipart` 发送，以及多类型、多值字段的支持。
+- **表单与映射**: 验证了使用 `Form`, `map[string]string`, `map[string][]string`, 和 `map[string][]any` 自动转为正确的 `application/x-www-form-urlencoded` 或 `application/json`。

 ## 性能测试结果 (Benchmark)
 ```
@ -14,5 +15,8 @@ goos: darwin
 goarch: amd64
 pkg: apigo.cc/go/http
 cpu: Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz
-BenchmarkGet-16            15944             73379 ns/op
+BenchmarkGet-16            16364             74735 ns/op
 ```
+
+## 测试覆盖率
+- **整体覆盖率**: 56.5% of statements
--- a/client.go
+++ b/client.go
@ -45,10 +45,26 @@ type Result struct {
 type Form map[string]string
 type Multipart map[string]any

-var bufferPool = sync.Pool{
-	New: func() any {
-		return new(bytes.Buffer)
-	},
+var DefaultClient = NewClient(30 * time.Second)
+
+func Get(url string, headers ...string) *Result {
+	return DefaultClient.Get(url, headers...)
+}
+
+func Post(url string, data any, headers ...string) *Result {
+	return DefaultClient.Post(url, data, headers...)
+}
+
+func Put(url string, data any, headers ...string) *Result {
+	return DefaultClient.Put(url, data, headers...)
+}
+
+func Delete(url string, data any, headers ...string) *Result {
+	return DefaultClient.Delete(url, data, headers...)
+}
+
+func Do(method, url string, data any, headers ...string) *Result {
+	return DefaultClient.Do(method, url, data, headers...)
 }

 func NewClient(timeout time.Duration) *Client {
@ -324,72 +340,100 @@ func (client *Client) Download(filename, url string, callback func(start, end in
 	return result, err
 }

-func (client *Client) buildMultipart(writer *multipart.Writer, data map[string]any) []error {
-	errs := make([]error, 0)
+func (client *Client) buildMultipart(writer *multipart.Writer, data map[string]any) error {
 	for key, value := range data {
+		if err := client.writeMultipartPart(writer, key, value); err != nil {
+			return err
+		}
+	}
+	return nil
+}
+
+func (client *Client) writeMultipartPart(writer *multipart.Writer, key string, value any) error {
+	if value == nil {
+		return nil
+	}
+
+	// 检查是否是文件
 	if filename, ok := value.(string); ok && file.Exists(filename) {
+		return client.writeMultipartFile(writer, key, filename)
+	}
+
+	switch t := value.(type) {
+	case []string:
+		for _, v := range t {
+			if err := client.writeMultipartPart(writer, key, v); err != nil {
+				return err
+			}
+		}
+		return nil
+	case []any:
+		for _, v := range t {
+			if err := client.writeMultipartPart(writer, key, v); err != nil {
+				return err
+			}
+		}
+		return nil
+	case io.Reader:
+		h := make(textproto.MIMEHeader)
+		h.Set("Content-Disposition", fmt.Sprintf(`form-data; name="%s"; filename="%s"`, key, key))
+		h.Set("Content-Type", "application/octet-stream")
+		part, err := writer.CreatePart(h)
+		if err != nil {
+			return err
+		}
+		_, err = io.Copy(part, t)
+		return err
+	case []byte:
+		h := make(textproto.MIMEHeader)
+		h.Set("Content-Disposition", fmt.Sprintf(`form-data; name="%s"; filename="%s"`, key, key))
+		h.Set("Content-Type", "application/octet-stream")
+		part, err := writer.CreatePart(h)
+		if err != nil {
+			return err
+		}
+		_, err = part.Write(t)
+		return err
+	case string:
+		return writer.WriteField(key, t)
+	default:
+		// 其他复杂类型序列化为 JSON
+		bytesData, err := cast.ToJSONBytes(value)
+		if err != nil {
+			return err
+		}
+		part, err := writer.CreateFormField(key)
+		if err != nil {
+			return err
+		}
+		_, err = part.Write(bytesData)
+		return err
+	}
+}
+
+func (client *Client) writeMultipartFile(writer *multipart.Writer, key, filename string) error {
 	var r io.Reader
 	var closer io.Closer
 	if mf := file.ReadFileFromMemory(filename); mf != nil {
 		r = bytes.NewReader(mf.GetData())
 	} else {
-				if fp, err := os.Open(filename); err == nil {
+		fp, err := os.Open(filename)
+		if err != nil {
+			return err
+		}
 		r = fp
 		closer = fp
-				} else {
-					errs = append(errs, err)
-					continue
 	}
-			}
-
-			if part, err := writer.CreateFormFile(key, filepath.Base(filename)); err == nil {
-				if _, err = io.Copy(part, r); err != nil {
-					errs = append(errs, err)
-				}
-			} else {
-				errs = append(errs, err)
-			}
-
 	if closer != nil {
-				_ = closer.Close()
-			}
-		} else {
-			var dataBytes []byte
-			h := make(textproto.MIMEHeader)
-			isField := false
-			switch t := value.(type) {
-			case io.Reader:
-				dataBytes, _ = io.ReadAll(t)
-				h.Set("Content-Disposition", fmt.Sprintf(`form-data; name="%s"; filename="%s"`, key, key))
-				h.Set("Content-Type", "application/octet-stream")
-			case []byte:
-				dataBytes = t
-				h.Set("Content-Disposition", fmt.Sprintf(`form-data; name="%s"; filename="%s"`, key, key))
-				h.Set("Content-Type", "application/octet-stream")
-			case string:
-				isField = true
-				dataBytes = []byte(t)
-			default:
-				isField = true
-				dataBytes, _ = cast.ToJSONBytes(value)
+		defer closer.Close()
 	}

-			if isField {
-				if err := writer.WriteField(key, string(dataBytes)); err != nil {
-					errs = append(errs, err)
+	part, err := writer.CreateFormFile(key, filepath.Base(filename))
+	if err != nil {
+		return err
 	}
-			} else {
-				if part, err := writer.CreatePart(h); err == nil {
-					if _, err = part.Write(dataBytes); err != nil {
-						errs = append(errs, err)
-					}
-				} else {
-					errs = append(errs, err)
-				}
-			}
-		}
-	}
-	return errs
+	_, err = io.Copy(part, r)
+	return err
 }

 func (client *Client) do(fetchBody bool, method, url string, data any, headers ...string) *Result {
@ -409,39 +453,52 @@ func (client *Client) do(fetchBody bool, method, url string, data any, headers .
 		case string:
 			reader = strings.NewReader(t)
 			contentLength = len(t)
+		case url2.Values, map[string][]string, Form:
+			var values url2.Values
+			switch v := t.(type) {
 			case url2.Values:
-			encoded := t.Encode()
-			reader = strings.NewReader(encoded)
-			contentType = "application/x-www-form-urlencoded"
-			contentLength = len(encoded)
+				values = v
+			case map[string][]string:
+				values = v
 			case Form:
-			values := url2.Values{}
-			for k, v := range t {
-				values.Set(k, v)
+				values = url2.Values{}
+				for k, v1 := range v {
+					values.Set(k, v1)
+				}
 			}
 			encoded := values.Encode()
 			reader = strings.NewReader(encoded)
 			contentType = "application/x-www-form-urlencoded"
 			contentLength = len(encoded)
-		case Multipart:
-			buf := bufferPool.Get().(*bytes.Buffer)
-			buf.Reset()
-			defer bufferPool.Put(buf)
-			writer := multipart.NewWriter(buf)
-			errs := client.buildMultipart(writer, t)
-			if err := writer.Close(); err != nil {
-				errs = append(errs, err)
+		case Multipart, map[string][]any:
+			var mData map[string]any
+			if m, ok := t.(Multipart); ok {
+				mData = m
+			} else {
+				m := t.(map[string][]any)
+				mData = make(map[string]any, len(m))
+				for k, v := range m {
+					mData[k] = v
 				}
-			if len(errs) > 0 {
-				return &Result{Error: errors.Join(errs...)}
 			}
-			bytesData := buf.Bytes()
-			reader = bytes.NewReader(bytesData)
+			pr, pw := io.Pipe()
+			writer := multipart.NewWriter(pw)
 			contentType = writer.FormDataContentType()
-			contentLength = len(bytesData)
+			reader = pr
+			go func() {
+				err := client.buildMultipart(writer, mData)
+				if err == nil {
+					err = writer.Close()
+				}
+				if err != nil {
+					_ = pw.CloseWithError(err)
+				} else {
+					_ = pw.Close()
+				}
+			}()
 		default:
 			bytesData, _ := cast.ToJSONBytes(data)
-			if len(bytesData) > 0 && string(bytesData) != "null" {
+			if len(bytesData) > 0 && !bytes.Equal(bytesData, []byte("null")) {
 				reader = bytes.NewReader(bytesData)
 				contentType = "application/json"
 				contentLength = len(bytesData)
--- a/client_test.go
+++ b/client_test.go
@ -44,7 +44,7 @@ func TestLocalServer(t *testing.T) {
 		_, _ = w.Write([]byte("world"))
 	})

-	server := &http.Server{Addr: ":18080", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18080", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()

@ -102,7 +102,7 @@ func BenchmarkGet(b *testing.B) {
 	handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		_, _ = w.Write([]byte("ok"))
 	})
-	server := &http.Server{Addr: ":18082", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18082", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()
 	time.Sleep(100 * time.Millisecond)
@ -121,7 +121,7 @@ func TestManualDo(t *testing.T) {
 	handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
 		_, _ = w.Write([]byte("stream"))
 	})
-	server := &http.Server{Addr: ":18083", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18083", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()
 	time.Sleep(100 * time.Millisecond)
@ -157,7 +157,7 @@ func TestDownload(t *testing.T) {
 		}
 		_, _ = w.Write([]byte(content))
 	})
-	server := &http.Server{Addr: ":18084", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18084", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()
 	time.Sleep(100 * time.Millisecond)
@ -189,7 +189,7 @@ func TestMultipartDo(t *testing.T) {
 		}
 		fmt.Fprintf(w, "foo=%s,file=%s", f, string(fileContent))
 	})
-	server := &http.Server{Addr: ":18086", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18086", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()
 	time.Sleep(100 * time.Millisecond)
@ -210,7 +210,7 @@ func TestFormAndMap(t *testing.T) {
 		body, _ := io.ReadAll(r.Body)
 		fmt.Fprintf(w, "ct=%s,body=%s", ct, string(body))
 	})
-	server := &http.Server{Addr: ":18087", Handler: handler}
+	server := &http.Server{Addr: "127.0.0.1:18087", Handler: handler}
 	go func() { _ = server.ListenAndServe() }()
 	defer server.Close()
 	time.Sleep(100 * time.Millisecond)
--- a/go.mod
+++ b/go.mod
@ -3,36 +3,21 @@ module apigo.cc/go/http
 go 1.25.0

 require (
-	apigo.cc/go/cast v1.2.8
-	apigo.cc/go/encoding v1.0.5
-	apigo.cc/go/file v1.0.7
-	apigo.cc/go/log v1.1.9
-	apigo.cc/go/rand v1.0.5
-	golang.org/x/net v0.53.0
+	apigo.cc/go/cast v1.3.3
+	apigo.cc/go/encoding v1.3.1
+	apigo.cc/go/file v1.3.2
+	apigo.cc/go/log v1.3.4
+	apigo.cc/go/rand v1.3.1
+	golang.org/x/net v0.54.0
 )

 require (
-	apigo.cc/go/config v1.0.6 // indirect
-	apigo.cc/go/safe v1.0.5 // indirect
-	apigo.cc/go/shell v1.0.5 // indirect
-	golang.org/x/crypto v0.50.0 // indirect
-	golang.org/x/sys v0.43.0 // indirect
-	golang.org/x/text v0.36.0 // indirect
+	apigo.cc/go/config v1.3.1 // indirect
+	apigo.cc/go/id v1.3.1 // indirect
+	apigo.cc/go/safe v1.3.1 // indirect
+	apigo.cc/go/shell v1.3.1 // indirect
+	golang.org/x/crypto v0.51.0 // indirect
+	golang.org/x/sys v0.44.0 // indirect
+	golang.org/x/text v0.37.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )
-
-replace apigo.cc/go/cast => ../cast
-
-replace apigo.cc/go/encoding => ../encoding
-
-replace apigo.cc/go/file => ../file
-
-replace apigo.cc/go/log => ../log
-
-replace apigo.cc/go/rand => ../rand
-
-replace apigo.cc/go/config => ../config
-
-replace apigo.cc/go/shell => ../shell
-
-replace apigo.cc/go/safe => ../safe
--- a/go.sum
+++ b/go.sum
@ -1,17 +1,35 @@
+apigo.cc/go/cast v1.3.3 h1:aln5eDR5DZVWVzZ/y5SJh1gQNgWv2sT82I25NaO9g34=
+apigo.cc/go/cast v1.3.3/go.mod h1:lGlwImiOvHxG7buyMWhFzcdvQzmSaoKbmr7bcDfUpHk=
+apigo.cc/go/config v1.3.1 h1:wZzUh4oL+fGD6SayVgX6prLPMsniM25etWFcEH8XzIE=
+apigo.cc/go/config v1.3.1/go.mod h1:7KHz/1WmtBLM762Lln/TaXh2dmlMvJTLhnlk33zbS3U=
+apigo.cc/go/encoding v1.3.1 h1:y8O58KYAyulkThg1O2ji2BqjnFoSvk42sit9I3z+K7Y=
+apigo.cc/go/encoding v1.3.1/go.mod h1:xAJk5b83VZ31mXMTnyp0dfMoBKfT/AHDn0u+cQfojgY=
+apigo.cc/go/file v1.3.2 h1:pu4oiDyiqgj3/eykfnJf+/6+A9v/Z0b3ClP5XK+lwG4=
+apigo.cc/go/file v1.3.2/go.mod h1:vci4h0Pz94mV6dkniQkuyBYERVYeq7/LX4jJVuCg9hs=
+apigo.cc/go/id v1.3.1 h1:pkqi6VeWyQoHuIu0Zbx/RRxIAdM61Js0j6cY1M9XVCk=
+apigo.cc/go/id v1.3.1/go.mod h1:P2/vl3tyW3US+ayOFSMoPIOCulNLBngNYPhXJC/Z7J4=
+apigo.cc/go/log v1.3.4 h1:UT8Neb9r4QjjbCFbTzw+ZeTxd+DmdmR5gNExeR4Cj+g=
+apigo.cc/go/log v1.3.4/go.mod h1:/Q/2r51xWSsrS4QN5U9jLiTw8n6qNC8kG9nuVHweY20=
+apigo.cc/go/rand v1.3.1 h1:7FvsI6PtQ5XrWER0dTiLVo0p7GIxRidT/TBKhVy93j8=
+apigo.cc/go/rand v1.3.1/go.mod h1:mZ/4Soa3bk+XvDaqPWJuUe1bfEi4eThBj1XmEAuYxsk=
+apigo.cc/go/safe v1.3.1 h1:irTCqPAC97gGsX/Lw5AzLelDt1xXLEZIAaVhLELWe9Q=
+apigo.cc/go/safe v1.3.1/go.mod h1:XdOpBhN2vkImalaykYXXmEpczqWa1y3ah6/Q72cdRqE=
+apigo.cc/go/shell v1.3.1 h1:M8oD0b2HcJuCC6frQFx11b3UTcTx3lATX8XK+YXSVm8=
+apigo.cc/go/shell v1.3.1/go.mod h1:ZMdJjpCpWdvsHKUXlelh/AxsV/nWdkH/k3lISfzMdUw=
 github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
 github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
 github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
-golang.org/x/crypto v0.50.0 h1:zO47/JPrL6vsNkINmLoo/PH1gcxpls50DNogFvB5ZGI=
-golang.org/x/crypto v0.50.0/go.mod h1:3muZ7vA7PBCE6xgPX7nkzzjiUq87kRItoJQM1Yo8S+Q=
-golang.org/x/net v0.53.0 h1:d+qAbo5L0orcWAr0a9JweQpjXF19LMXJE8Ey7hwOdUA=
-golang.org/x/net v0.53.0/go.mod h1:JvMuJH7rrdiCfbeHoo3fCQU24Lf5JJwT9W3sJFulfgs=
-golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
-golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
-golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+golang.org/x/crypto v0.51.0 h1:IBPXwPfKxY7cWQZ38ZCIRPI50YLeevDLlLnyC5wRGTI=
+golang.org/x/crypto v0.51.0/go.mod h1:8AdwkbraGNABw2kOX6YFPs3WM22XqI4EXEd8g+x7Oc8=
+golang.org/x/net v0.54.0 h1:2zJIZAxAHV/OHCDTCOHAYehQzLfSXuf/5SoL/Dv6w/w=
+golang.org/x/net v0.54.0/go.mod h1:Sj4oj8jK6XmHpBZU/zWHw3BV3abl4Kvi+Ut7cQcY+cQ=
+golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
+golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.37.0 h1:Cqjiwd9eSg8e0QAkyCaQTNHFIIzWtidPahFWR83rTrc=
+golang.org/x/text v0.37.0/go.mod h1:a5sjxXGs9hsn/AJVwuElvCAo9v8QYLzvavO5z2PiM38=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
 gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
--- a/optimization_test.go
+++ b/optimization_test.go
@ -0,0 +1,104 @@
+package http_test
+
+import (
+	"fmt"
+	"io"
+	"net/http"
+	"strings"
+	"testing"
+	"time"
+
+	ah "apigo.cc/go/http"
+)
+
+func TestOptimizationForms(t *testing.T) {
+	handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if strings.HasPrefix(r.Header.Get("Content-Type"), "multipart/form-data") {
+			_ = r.ParseMultipartForm(10 << 20)
+		} else {
+			_ = r.ParseForm()
+		}
+		fmt.Fprintf(w, "foo=%v", r.Form["foo"])
+	})
+	server := &http.Server{Addr: "127.0.0.1:18088", Handler: handler}
+	go func() { _ = server.ListenAndServe() }()
+	defer server.Close()
+	time.Sleep(100 * time.Millisecond)
+
+	c := ah.NewClient(time.Second)
+
+	// Test map[string][]string
+	r1 := c.Post("http://127.0.0.1:18088/", map[string][]string{"foo": {"bar", "baz"}})
+	if r1.Error != nil {
+		t.Fatalf("map[string][]string failed: %v", r1.Error)
+	}
+	if r1.String() != "foo=[bar baz]" {
+		t.Errorf("expected foo=[bar baz], got %s", r1.String())
+	}
+
+	// Test map[string][]any (now Multipart)
+	r2 := c.Post("http://127.0.0.1:18088/", map[string][]any{"foo": {"bar", 123}})
+	if r2.Error != nil {
+		t.Fatalf("map[string][]any failed: %v", r2.Error)
+	}
+	// Multipart output might look different depending on how the server parses it, 
+	// but r.Form["foo"] should still work if it's multipart.
+	if r2.String() != "foo=[bar 123]" {
+		t.Errorf("expected foo=[bar 123], got %s", r2.String())
+	}
+}
+
+func TestMultipartStreaming(t *testing.T) {
+	handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		err := r.ParseMultipartForm(10 << 20)
+		if err != nil {
+			t.Errorf("ParseMultipartForm failed: %v", err)
+		}
+		f1 := r.FormValue("foo")
+		file, _, err := r.FormFile("file")
+		var fileContent []byte
+		if file != nil {
+			fileContent, _ = io.ReadAll(file)
+		}
+		fmt.Fprintf(w, "foo=%s,file=%s", f1, string(fileContent))
+	})
+	server := &http.Server{Addr: "127.0.0.1:18089", Handler: handler}
+	go func() { _ = server.ListenAndServe() }()
+	defer server.Close()
+	time.Sleep(100 * time.Millisecond)
+
+	c := ah.NewClient(time.Second)
+	// Test streaming Multipart
+	r := c.Post("http://127.0.0.1:18089/", ah.Multipart{
+		"foo": "bar",
+		"file": io.NopCloser(strings.NewReader("baz")), // use Reader to force streaming
+	})
+	if r.Error != nil {
+		t.Fatalf("Post with Multipart streaming failed: %v", r.Error)
+	}
+	if r.String() != "foo=bar,file=baz" {
+		t.Errorf("expected foo=bar,file=baz, got %s", r.String())
+	}
+}
+
+func TestMultipartMultipleParts(t *testing.T) {
+	handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		_ = r.ParseMultipartForm(10 << 20)
+		fmt.Fprintf(w, "foo=%v", r.MultipartForm.Value["foo"])
+	})
+	server := &http.Server{Addr: "127.0.0.1:18090", Handler: handler}
+	go func() { _ = server.ListenAndServe() }()
+	defer server.Close()
+	time.Sleep(100 * time.Millisecond)
+
+	c := ah.NewClient(time.Second)
+	r := c.Post("http://127.0.0.1:18090/", ah.Multipart{
+		"foo": []string{"bar", "baz"},
+	})
+	if r.Error != nil {
+		t.Fatalf("Post with Multipart multiple parts failed: %v", r.Error)
+	}
+	if r.String() != "foo=[bar baz]" {
+		t.Errorf("expected foo=[bar baz], got %s", r.String())
+	}
+}
Author	SHA1	Message	Date
AI Engineer	8db540a5c3	chore: infrastructure alignment and doc sync (by AICoder)	2026-05-16 01:28:35 +08:00
AI Engineer	ea6f01f7be	chore: infrastructure alignment and doc sync (by checkall)	2026-05-14 21:54:04 +08:00
AI Engineer	829742e9c7	对齐 Tag v1.3.0 （By AI）	2026-05-10 15:48:28 +08:00
AI Engineer	e2b4f5523e	chore: final infrastructure alignment	2026-05-10 13:12:30 +08:00
AI Engineer	6db9c7c174	chore: infrastructure alignment	2026-05-10 13:04:34 +08:00
AI Engineer	44c3115709	feat: 完善内存安全与底层接口优化（by AI）	2026-05-09 21:01:01 +08:00
AI Engineer	71dfe96959	fix(test): 修复 macOS 环境下泛地址绑定导致的 connection refused 错误，同步更新文档（by AI）	2026-05-09 16:33:11 +08:00
AI Engineer	81161fa2ad	chore(deps): align with log v1.1.13	2026-05-09 14:51:09 +08:00
AI Engineer	aa43171c4a	Optimize form and multipart support with streaming (by AI)	2026-05-08 22:47:36 +08:00