From dc54d3822f946d4f4dd80f717263a4ff1a8b3f43 Mon Sep 17 00:00:00 2001
From: xfy911 <defect.y@qq.com>
Date: Wed, 3 Jun 2026 15:28:53 +0800
Subject: [PATCH] docs(proxy): add package comments for proxy module

- Add package documentation for target_selector, utils, validate,
  cache_handler, and header_modifier files
- Include author attribution (xfy)
---
 internal/proxy/cache_handler.go   | 5 +++++
 internal/proxy/header_modifier.go | 5 +++++
 internal/proxy/target_selector.go | 5 +++++
 internal/proxy/utils.go           | 5 +++++
 internal/proxy/validate.go        | 5 +++++
 5 files changed, 25 insertions(+)

diff --git a/internal/proxy/cache_handler.go b/internal/proxy/cache_handler.go
index f43062b..f646686 100644
--- a/internal/proxy/cache_handler.go
+++ b/internal/proxy/cache_handler.go
@@ -1,3 +1,8 @@
+// Package proxy 提供反向代理的核心功能，支持请求转发、负载均衡、健康检查等特性。
+//
+// 包含缓存处理器相关的结构体，用于配置代理缓存行为。
+//
+// 作者：xfy
 package proxy
 
 import (
diff --git a/internal/proxy/header_modifier.go b/internal/proxy/header_modifier.go
index 6e988ba..08b5601 100644
--- a/internal/proxy/header_modifier.go
+++ b/internal/proxy/header_modifier.go
@@ -1,3 +1,8 @@
+// Package proxy 提供反向代理的核心功能，支持请求转发、负载均衡、健康检查等特性。
+//
+// 包含请求头修改器相关的结构体，用于配置请求和响应头修改规则。
+//
+// 作者：xfy
 package proxy
 
 import (
diff --git a/internal/proxy/target_selector.go b/internal/proxy/target_selector.go
index 6393707..79a2f24 100644
--- a/internal/proxy/target_selector.go
+++ b/internal/proxy/target_selector.go
@@ -1,3 +1,8 @@
+// Package proxy 提供反向代理的核心功能，支持请求转发、负载均衡、健康检查等特性。
+//
+// 包含代理配置相关的结构体，用于配置反向代理行为。
+//
+// 作者：xfy
 package proxy
 
 import (
diff --git a/internal/proxy/utils.go b/internal/proxy/utils.go
index b75de49..52514cb 100644
--- a/internal/proxy/utils.go
+++ b/internal/proxy/utils.go
@@ -1,3 +1,8 @@
+// Package proxy 提供反向代理的核心功能，支持请求转发、负载均衡、健康检查等特性。
+//
+// 包含代理工具函数，用于处理请求和响应的转换。
+//
+// 作者：xfy
 package proxy
 
 import (
diff --git a/internal/proxy/validate.go b/internal/proxy/validate.go
index edee1b6..31057e8 100644
--- a/internal/proxy/validate.go
+++ b/internal/proxy/validate.go
@@ -1,3 +1,8 @@
+// Package proxy 提供反向代理的核心功能，支持请求转发、负载均衡、健康检查等特性。
+//
+// 包含代理验证相关的结构体，用于配置请求验证规则。
+//
+// 作者：xfy
 package proxy
 
 import "strings"