id/AI.md

AI Coding Context: @go/id

本索引供 AI 模型理解 @go/id 的设计与调用原则，以生成符合本项目高质量、高性能哲学的高质量代码。

🤖 AI 行为准则

1. 优先使用全局实例：在大多数业务场景下，直接调用 id.MakeId() 或 id.DefaultIdMaker.Get()，无需手动实例化。
2. PK 场景强制优化：对于数据库主键生成，建议使用 GetForMysql() 或 GetForPostgreSQL()。
3. 无错误处理倾向：理解 IdMaker 采用防御性设计，不会产生 Panic 或 Error，调用时无需错误检查。
4. 按需指定长度：调用时明确传入 size，根据业务对并发吞吐量的需求（8-11位，后续长度随机填充）进行决策。

🛠 关键 API 逻辑约定

函数	场景	核心特征
MakeId/Get	通用生成	全局默认实例生成。
GetForMysql	MySQL PK	自动右旋散列，解决 B+ 树写入热点。
GetForPostgreSQL	PostgreSQL PK	具备时间局部单调性，无右旋散列。

快速开始

• ✅ 示例:

  // 生成一个 12 位长度的唯一ID
  newID := id.MakeId(12)
  
  // 10 位长度，高吞吐 MySQL 主键生成
  newID := id.DefaultIdMaker.GetForMysql(10)