From 4497e9312ad02d6aec9028d8e49d1177f7f905f7 Mon Sep 17 00:00:00 2001
From: AI Engineer <ai@apigo.cc>
Date: Sun, 10 May 2026 10:49:58 +0800
Subject: [PATCH] feat: introduce semantic ID generation and IDMaker SOP
 alignment (by AI)

---
 README.md | 28 +++++++++++++++++-----------
 go.mod    |  4 ----
 id.go     | 40 ++++++++++++++++++++++++++++++++++++++++
 3 files changed, 57 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index ca1a28b..1dba45e 100644
--- a/README.md
+++ b/README.md
@@ -25,25 +25,31 @@ ID 结构由 `secTag` (1位) + `sec` (5-6位) + `secIndex` (1-5位) + `padding`
 ## API Reference
 
 ### 核心生成器
-- `func NewIdMaker(incr func(sec uint64) uint64) *IdMaker`：创建自定义步长的 ID 生成器。
-- `var DefaultIdMaker`：默认全局 ID 生成器（单机模式）。
+- `func NewIDMaker(incr func(sec uint64) uint64) *IDMaker`：创建自定义步长的 ID 生成器。
+- `var DefaultIDMaker`：默认全局 ID 生成器（单机模式）。
 
-### 格式化生成 (推荐作为 PK)
-- `func MakeId(size int) string`：DefaultIdMaker.Get(size) 的别名。
-- `func (im *IdMaker) Get(size int) string`：生成随机唯一ID。
-- `func (im *IdMaker) GetForMysql(size int) string`：MySQL 优化版，自动右旋散列，解决写入热点。
-- `func (im *IdMaker) GetForPostgreSQL(size int) string`：PostgreSQL 优化版，保持时间局部单调。
+### 格式化生成 (语义化方法推荐)
+- `func (im *IDMaker) Get8Bytes4KPerSecond() string`：8 位长度，并发上限 3,844/s。
+- `func (im *IDMaker) Get9Bytes90KPerSecond() string`：9 位长度，并发上限 9 万/s。
+- `func (im *IDMaker) Get10Bytes14MPerSecond() string`：10 位长度，并发上限 1,477 万/s。
+- `func (im *IDMaker) Get11Bytes900MPerSecond() string`：11 位长度，并发上限 9 亿/s。
+- `func (im *IDMaker) Get12BytesUltraPerSecond() string`：12 位长度，支持超越 9 亿并发。
+
+### 数据库专用生成 (推荐作为 PK)
+- `func (im *IDMaker) Get(size int) string`：生成指定长度的随机唯一ID。
+- `func (im *IDMaker) GetForMysql(size int) string`：MySQL 优化版，自动右旋散列，解决写入热点。
+- `func (im *IDMaker) GetForPostgreSQL(size int) string`：PostgreSQL 优化版，保持时间局部单调。
 
 ## 快速开始
 
 ```go
 import "apigo.cc/go/id"
 
-// 生成一个 12 位长度的唯一ID
-newID := id.MakeId(12)
+// 语义化生成示例 (推荐)
+requestId := id.Get10Bytes14MPerSecond()
 
-// 生成一个 10 位长度的 MySQL 友好主键
-newID := id.DefaultIdMaker.GetForMysql(10)
+// 数据库主键生成示例
+userId := id.DefaultIDMaker.GetForMysql(10)
 ```
 
 ## 分布式集群扩展示例
diff --git a/go.mod b/go.mod
index 8d99e06..692d02b 100644
--- a/go.mod
+++ b/go.mod
@@ -6,7 +6,3 @@ require (
 	apigo.cc/go/encoding v1.0.5
 	apigo.cc/go/rand v1.0.5
 )
-
-replace apigo.cc/go/encoding => ../encoding
-
-replace apigo.cc/go/rand => ../rand
diff --git a/id.go b/id.go
index 8391be5..82995ff 100644
--- a/id.go
+++ b/id.go
@@ -103,6 +103,26 @@ func (im *IDMaker) Get(size int) string {
 	return im.get(size, false, false)
 }
 
+func (im *IDMaker) Get8Bytes4KPerSecond() string {
+	return im.get(8, false, false)
+}
+
+func (im *IDMaker) Get9Bytes90KPerSecond() string {
+	return im.get(9, false, false)
+}
+
+func (im *IDMaker) Get10Bytes14MPerSecond() string {
+	return im.get(10, false, false)
+}
+
+func (im *IDMaker) Get11Bytes900MPerSecond() string {
+	return im.get(11, false, false)
+}
+
+func (im *IDMaker) Get12BytesUltraPerSecond() string {
+	return im.get(12, false, false)
+}
+
 func (im *IDMaker) GetForMysql(size int) string {
 	return im.get(size, true, true)
 }
@@ -110,3 +130,23 @@ func (im *IDMaker) GetForMysql(size int) string {
 func (im *IDMaker) GetForPostgreSQL(size int) string {
 	return im.get(size, true, false)
 }
+
+func Get8Bytes4KPerSecond() string {
+	return DefaultIDMaker.Get8Bytes4KPerSecond()
+}
+
+func Get9Bytes90KPerSecond() string {
+	return DefaultIDMaker.Get9Bytes90KPerSecond()
+}
+
+func Get10Bytes14MPerSecond() string {
+	return DefaultIDMaker.Get10Bytes14MPerSecond()
+}
+
+func Get11Bytes900MPerSecond() string {
+	return DefaultIDMaker.Get11Bytes900MPerSecond()
+}
+
+func Get12BytesUltraPerSecond() string {
+	return DefaultIDMaker.Get12BytesUltraPerSecond()
+}