From 4a53d3032aa508c7a74d53cbdbdc5724fa66030e 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(utils): add package comments for utils module

- Add package documentation for internal, etag, and bytes files
- Include author attribution (xfy)
---
 internal/utils/bytes.go    | 5 +++++
 internal/utils/etag.go     | 5 +++++
 internal/utils/internal.go | 5 +++++
 3 files changed, 15 insertions(+)

diff --git a/internal/utils/bytes.go b/internal/utils/bytes.go
index 1741fea..bc890a8 100644
--- a/internal/utils/bytes.go
+++ b/internal/utils/bytes.go
@@ -1,3 +1,8 @@
+// Package utils 提供通用的工具函数和辅助类型。
+//
+// 包含字节操作相关的工具函数，用于处理字节切片和缓冲区。
+//
+// 作者：xfy
 package utils
 
 import "unsafe"
diff --git a/internal/utils/etag.go b/internal/utils/etag.go
index 3385b15..3c6ab37 100644
--- a/internal/utils/etag.go
+++ b/internal/utils/etag.go
@@ -1,3 +1,8 @@
+// Package utils 提供通用的工具函数和辅助类型。
+//
+// 包含 ETag 生成相关的工具函数，用于处理缓存验证。
+//
+// 作者：xfy
 package utils
 
 import (
diff --git a/internal/utils/internal.go b/internal/utils/internal.go
index 835bf20..62b3f9b 100644
--- a/internal/utils/internal.go
+++ b/internal/utils/internal.go
@@ -1,3 +1,8 @@
+// Package utils 提供通用的工具函数和辅助类型。
+//
+// 包含内部工具函数，用于处理内部逻辑。
+//
+// 作者：xfy
 package utils
 
 import "github.com/valyala/fasthttp"