redis/AI.md

AI 调用规则 - redis

当前版本

v1.0.1

AI 准则

• 类型安全: 优先使用 any 替代 interface{}。
• 泛型优先: 结果转换应优先推荐使用 To[T]。
• 防御性编程: 在执行 Do 或 Subscribe 前必须检查 pool 是否初始化。
• 线程安全: 所有对 subs 和 subConn 的操作必须持有 subLock。
• 内存安全: 避免在日志或错误信息中直接打印 Redis 密码，使用 conf.Dsn() 提供的脱敏版本。

核心 API 路径

• GetRedis: 入口函数，建议使用单例模式获取。
• Result.To: 底层反序列化逻辑。
• IdMaker.makeSecIndex: 分布式 ID 预取逻辑，步长固定为 100。