http/AI.md

AI 指导规则 (AI.md)

模块信息

• 模块名: http
• 当前版本: v1.1.0
• 核心意图: 高性能 HTTP 客户端，支持泛型绑定、并行分段下载与线程安全的全局 Header 管理。

AI 调用建议

• 初始化: 优先使用 NewClient(timeout)。
• 结果解析:
  • 结构化数据：使用 Bind[T](result)。
  • 列表数据：使用 result.Slice() 或 Bind[[]T](result)。
  • 键值数据：使用 result.Map() 或 Bind[map[string]T](result)。
• 并行下载: 使用 Download，可通过 client.MaxConnsPerHost 调节并发。
• 表单提交: 使用 PostMultipart 处理带文件的多部分表单。
• 全局配置: 使用 SetGlobalHeader(k, v) 设置线程安全的全局头。

注意事项

• 并发安全: Client 的方法是并发安全的，但 Result 对象不是。
• 内存池: 内部使用 sync.Pool 优化了 Buffer 分配，在大负载下表现优异。
• Body 释放: Bind, String, Bytes, Map, Slice 均会自动关闭 Body。ManualDo 需要手动关闭。