22
33## 🔄 项目重命名通知
44
5- ** 版本 ** : v0.10.5
5+ ** 最新版本 ** : v0.11.0
66** 日期** : 2025-10-28
77
8- 从 ` v0.10.5 ` 开始,项目从 ` sqlxb ` 重命名为 ` xb ` 。
8+ ### 变更历史
9+
10+ #### v0.11.0 (2025-10-28)
11+ - ⚠️ ** GitHub 组织迁移** : ` x-ream/xb ` → ` fndome/xb `
12+ - 模块路径: ` github.com/fndome/xb `
13+ - 仓库地址: ` https://github.com/fndome/xb `
14+
15+ #### v0.10.5 (2025-10-28)
16+ - 包名变更: ` sqlxb ` → ` xb `
17+ - 模块路径: ` github.com/x-ream/xb `
918
1019---
1120
1221## 📋 为什么重命名?
1322
14231 . ** 更简洁的名称** - ` xb ` 比 ` sqlxb ` 更短、更易记
15- 2 . ** 品牌统一** - 与 x-ream 组织命名风格保持一致
24+ 2 . ** 品牌统一** - 统一到 fndome 组织
16253 . ** 更好的可发现性** - 短名称在搜索和推荐时更具优势
26+ 4 . ** 包名统一** - 模块名 ` xb ` 与包名 ` xb ` 保持一致(v0.10.5)
1727
1828---
1929
@@ -35,7 +45,7 @@ require (
3545module your-project
3646
3747require (
38- github.com /x-ream /xb v0.10.5
48+ github.com /fndome /xb v0.11.0 // ⚠️ 组织已迁移
3949)
4050```
4151
@@ -46,28 +56,32 @@ require (
4656** 修改前** :
4757``` go
4858import (
49- " github.com/x-ream/sqlxb"
59+ " github.com/x-ream/sqlxb" // 旧组织 + 旧包名
5060)
5161```
5262
53- ** 修改后** :
63+ ** 修改后(v0.11.0) ** :
5464``` go
5565import (
56- " github.com/x-ream /xb"
66+ " github.com/fndome /xb" // ✅ 新组织 + 新模块名
5767)
68+
69+ // 代码中使用 xb 包名
70+ builder := xb.Of (&User{}) // ✅ 包名已改为 xb
5871```
5972
6073---
6174
62- ### 3️⃣ 包名保持不变(向后兼容 )
75+ ### 3️⃣ 包名已更改(⚠️ 破坏性变更 )
6376
64- ✅ ** 无需修改代码 ** - 包名仍然是 ` sqlxb ` :
77+ ⚠️ ** 需要修改代码 ** - 包名从 ` sqlxb ` 改为 ` xb ` :
6578
6679``` go
67- // ✅ 这些代码无需修改
80+ // ❌ 旧代码(不再有效)
6881builder := sqlxb.Of (&User{})
69- qx := sqlxb.QdrantX {}
70- built := builder.Build ()
82+
83+ // ✅ 新代码
84+ builder := xb.Of (&User{})
7185```
7286
7387---
@@ -108,12 +122,12 @@ go mod tidy
108122
109123### 1. 确认依赖更新
110124``` bash
111- go list -m all | grep " x-ream "
125+ go list -m all | grep " fndome "
112126```
113127
114128** 期望输出** :
115129```
116- github.com/x-ream /xb v0.10.5
130+ github.com/fndome /xb v0.11.0
117131```
118132
119133### 2. 运行测试
@@ -132,41 +146,62 @@ go build ./...
132146
133147### Q1: 旧版本的 ` sqlxb ` 还能用吗?
134148
135- ** A** : 可以。旧的 ` github.com/x-ream/sqlxb ` 仓库会保留到 ` v0.10.4 ` ,但不再维护。建议尽快迁移到 ` xb ` 。
149+ ** A** : 可以。旧的仓库会保留,但不再维护:
150+ - ` github.com/x-ream/sqlxb ` - 保留到 v0.10.4
151+ - ` github.com/x-ream/xb ` - 保留到 v0.10.5
152+
153+ 建议迁移到新组织:` github.com/fndome/xb v0.11.0 `
136154
137155---
138156
139157### Q2: 我需要修改代码中的 ` sqlxb ` 包名吗?
140158
141- ** A** : ** 不需要 ** 。包名仍然是 ` sqlxb ` ,只需要修改 ` import ` 路径即可 :
159+ ** A** : ** 需要! ** 从 v0.10.5 开始,包名已改为 ` xb ` :
142160
143161``` go
144162import (
145- " github.com/x-ream /xb" // ✅ 只改这里
163+ " github.com/fndome /xb" // ✅ v0.11.0 新组织路径
146164)
147165
148- // ✅ 代码无需修改
166+ // ⚠️ 需要修改所有代码
167+ // ❌ 旧代码
149168builder := sqlxb.Of (&User{})
169+
170+ // ✅ 新代码
171+ builder := xb.Of (&User{})
172+ ```
173+
174+ ** 批量替换** :
175+ ``` bash
176+ # 1. 替换 import 路径
177+ find . -name " *.go" -type f -exec sed -i ' s|github.com/x-ream/xb|github.com/fndome/xb|g' {} +
178+
179+ # 2. 替换包名(如果还在用 sqlxb)
180+ find . -name " *.go" -type f -exec sed -i ' s/sqlxb\./xb\./g' {} +
150181```
151182
152183---
153184
154185### Q3: 我的项目使用了 v0.10.4 之前的版本,怎么办?
155186
156- ** A** : 分两步迁移 :
187+ ** A** : 分三步迁移 :
157188
158- 1 . ** 先升级到 v0.10.4** (仍使用 ` sqlxb ` )
159- 2 . ** 再升级到 v0.10.5** (切换到 ` xb ` )
189+ 1 . ** 先升级到 v0.10.4** (仍使用 ` sqlxb ` ,旧组织)
190+ 2 . ** 再升级到 v0.10.5** (切换到 ` xb ` ,旧组织)
191+ 3 . ** 最后升级到 v0.11.0** (新组织)
160192
161193``` bash
162- # Step 1
194+ # Step 1: 升级到 v0.10.4(包名 sqlxb)
163195go get github.com/x-ream/
[email protected] 164196go mod tidy
165197
166- # 测试确认无误后
167- # Step 2
198+ # Step 2: 升级到 v0.10.5(包名 xb,组织 x-ream)
168199go get github.com/x-ream/
[email protected] 169- # 然后按照上面的步骤修改 import 路径
200+ # 批量替换: sqlxb. → xb.
201+
202+ # Step 3: 升级到 v0.11.0(组织 fndome)
203+ go get github.com/fndome/
[email protected] 204+ # 批量替换: github.com/x-ream/xb → github.com/fndome/xb
170205```
171206
172207---
177212
178213** 修改前** :
179214``` go
180- replace github.com /x-ream/sqlxb => /path/to/local/sqlxb
215+ replace github.com /x-ream/xb => /path/to/local/xb
181216```
182217
183- ** 修改后** :
218+ ** 修改后(v0.11.0) ** :
184219``` go
185- replace github.com /x-ream /xb => /path/to/local/xb
220+ replace github.com /fndome /xb => /path/to/local/xb
186221```
187222
188223---
189224
190225## 🔗 相关资源
191226
192- - ** GitHub 仓库** : https://github.com/x-ream/xb
193- - ** 文档** : https://github.com/x-ream/xb/blob/main/README.md
194- - ** Roadmap** : https://github.com/x-ream/xb/blob/main/doc/ROADMAP_v1.0.0.md
195- - ** Issues** : https://github.com/x-ream/xb/issues
227+ - ** GitHub 仓库** : https://github.com/fndome/xb
228+ - ** 文档** : https://github.com/fndome/xb/blob/main/README.md
229+ - ** Roadmap** : https://github.com/fndome/xb/blob/main/doc/ROADMAP_v1.0.0.md
230+ - ** Issues** : https://github.com/fndome/xb/issues
231+
232+ ### 旧仓库(只读)
233+ - ** x-ream/sqlxb** : https://github.com/x-ream/sqlxb (保留到 v0.10.4)
234+ - ** x-ream/xb** : https://github.com/x-ream/xb (保留到 v0.10.5)
196235
197236---
198237
@@ -201,7 +240,7 @@ replace github.com/x-ream/xb => /path/to/local/xb
201240如果您在迁移过程中遇到问题:
202241
2032421 . ** 查阅文档** : [ doc/README.md] ( ./doc/README.md )
204- 2 . ** 提交 Issue** : https://github.com/x-ream /xb/issues
243+ 2 . ** 提交 Issue** : https://github.com/fndome /xb/issues
2052443 . ** 查看示例** : [ examples/] ( ./examples/README.md )
206245
207246---
0 commit comments