docs: add package and exported symbol comments for revive lint compliance

internal/util/cap/prng.go

@@ -22,6 +22,8 @@ import (
 )
 
 // fnv1a returns the 32-bit FNV-1a hash of a string
+//
+//nolint:mnd // FNV-1a 算法位移常量
 func fnv1a(str string) uint32 {
 	var hash uint32 = 2166136261
 	for i := 0; i < len(str); i++ {
@@ -32,6 +34,8 @@ func fnv1a(str string) uint32 {
 }
 
 // fnv1aResume resumes FNV-1a hashing from a given state
+//
+//nolint:mnd // FNV-1a 算法位移常量
 func fnv1aResume(state uint32, str string) uint32 {
 	h := state
 	for i := 0; i < len(str); i++ {
@@ -42,6 +46,8 @@ func fnv1aResume(state uint32, str string) uint32 {
 }
 
 // prngFromHash generates a hex string of specified length using an initial hash state
+//
+//nolint:mnd // xorshift 算法位移常量
 func prngFromHash(initialHash uint32, length int) string {
 	state := initialHash
 	var result strings.Builder