docs(工程文档): 同步当前架构说明

Co-authored-by: LingandRX <LingandRX@users.noreply.github.com>

src/lib/README.md

@@ -4,9 +4,10 @@
 
 ## 文件说明
 
-| 文件       | 用途                                 |
-| ---------- | ------------------------------------ |
-| `utils.ts` | `cn()` 函数 — shadcn/ui 标准工具函数 |
+| 文件/目录       | 用途                                             |
+| --------------- | ------------------------------------------------ |
+| `utils.ts`      | `cn()` 函数 — shadcn/ui 标准工具函数             |
+| `generators/`   | 测试数据生成器内置生成器库和分类注册表           |
 
 ## cn()
 
@@ -24,3 +25,32 @@ import { cn } from '@/lib/utils';
 ```
 
 所有需要动态合并 Tailwind 类名的场景都应使用 `cn()`，而非手动拼接字符串。
+
+## generators/
+
+测试数据生成器的核心生成器库，供 `src/workers/generator.worker.ts` 在后台线程中按字段配置生成数据。
+
+| 文件          | 用途                                             |
+| ------------- | ------------------------------------------------ |
+| `index.ts`    | 聚合所有生成器，导出分类、查找和搜索函数         |
+| `personal.ts` | 个人信息生成器（姓名、邮箱、手机号、身份证等）   |
+| `business.ts` | 业务数据生成器（订单号、价格、日期、状态等）     |
+| `technical.ts`| 技术数据生成器（UUID、IPv4、URL）                |
+| `basic.ts`    | 基础类型生成器（整数、浮点数、布尔值、字符串）   |
+| `types.ts`    | 生成器库内部类型与通用选项                       |
+
+使用示例：
+
+```typescript
+import { getGeneratorById, searchGenerators } from '@/lib/generators';
+
+const generator = getGeneratorById('chineseName');
+const value = generator?.generate({});
+const matched = searchGenerators('uuid');
+```
+
+约束：
+
+- 新增生成器必须实现 `GeneratorDefinition`，并加入所属分类文件的导出列表。
+- 需要唯一值或大批量稳定输出时，优先实现 `generateAtIndex(params, index)`。
+- 新增分类时同步更新 `generatorCategories`，并确保 `GeneratorSelector` 能展示该分类。