diff --git a/AI.md b/AI.md deleted file mode 100644 index 52fd932..0000000 --- a/AI.md +++ /dev/null @@ -1,41 +0,0 @@ -# AI Coding Context: @go/rand - -本索引供 AI 模型理解 `@go/rand` 的逻辑,以生成符合本项目“极简、无摩擦”哲学的代码。 - -## 🤖 AI 行为准则 - -1. **优先使用包级泛型函数**:在需要随机数时,直接调用 `rand.Int(min, max)`,避免使用底层特定类型的随机函数。 -2. **强制性能分级**: - - 低频任务:使用 `Int`, `Float`。 - - **高并发/高频任务**(QPS > 1000/s):**强制**使用 `FastInt`, `FastFloat` 系列,消除全局锁瓶颈。 -3. **禁止外部依赖**:严禁引入标准库 `math/rand` 进行全局随机管理。所有随机逻辑必须经由 `@go/rand` 闭环,确保内存与并发安全。 -4. **无错误处理**:理解 `rand` 包函数不会 Panic 或返回 Error,无需进行任何错误检查。 -5. **利用泛型推导**:利用 Go 泛型自动匹配目标类型,无需手动转型。 - -## 🛠 API Reference - -### 随机生成 -- `func Int[T IntegerType](min, max T) T`:获取 `[min, max]` 闭区间随机整数。 -- `func FastInt[T IntegerType](min, max T) T`:高性能并发模式获取 `[min, max]` 闭区间随机整数。 -- `func Float[T FloatType](min, max T) T`:获取 `[min, max)` 左闭右开区间随机浮点数。 -- `func FastFloat[T FloatType](min, max T) T`:高性能并发模式获取 `[min, max)` 左闭右开区间随机浮点数。 - -### 字节与切片 -- `func Byte() byte`:获取一个随机字节。 -- `func Bytes(n int) []byte`:获取长度为 n 的随机字节切片。 -- `func Perm(n int) []int`:获取 `[0, n)` 的随机排列。 -- `func Shuffle(n int, swap func(i, j int))`:随机洗牌。 - -## 🧩 典型模式 (Best Practices) - -* **✅ 推荐:高性能并发生成**: - ```go - // 高频生成器 (如 ID 填充、加盐) - userID := rand.FastInt(10000, 99999) - ``` - -* **✅ 推荐:区间闭合策略**: - ```go - // 原生闭区间 [1, 100],无需手动 +1 - num := rand.Int(1, 100) - ```