feat: readPreference 副本集读偏好支持 (P2 Option B)

- 添加 config.readPreference 全局配置参数
- 支持 5 种读偏好模式（primary/primaryPreferred/secondary/secondaryPreferred/nearest）
- 适用场景：副本集部署、读写分离、全球分布式部署
- 完整文档：docs/readPreference.md (300+ 行)
- 示例代码：examples/readPreference.examples.js (7 个场景)
- 测试覆盖：3 个测试用例，12/12 测试通过
- TypeScript 类型声明已同步更新

参考: P2 高级查询选项评估 (analysis-reports/2025-11-06-advanced-query-options-evaluation.md)

Author: rockyshi1993

CHANGELOG.md

@@ -5,6 +5,15 @@
 ## [未发布]
 
 ### 新增
+- **readPreference 副本集读偏好支持**（2025-11-07）
+  - 在连接配置中添加 `readPreference` 选项，支持副本集读写分离场景
+  - 支持 5 种读偏好模式：`primary`（默认）、`primaryPreferred`、`secondary`、`secondaryPreferred`、`nearest`
+  - 适用场景：副本集部署、降低主节点负载、全球分布式部署
+  - TypeScript 类型声明已同步更新（`BaseOptions.readPreference`）
+  - 示例文件：`examples/readPreference.examples.js`（7 个使用场景）
+  - 测试覆盖：mongodb-connect.test.js 新增 readPreference 配置透传测试
+  - ⚠️ 注意：仅全局配置（连接级别），MongoDB 专属特性，读从节点可能有复制延迟
+
 - **comment 参数支持**（2025-11-07）
   - 为 `find`、`findOne`、`count` 方法添加 `comment` 参数，用于生产环境日志跟踪
   - 支持在 MongoDB 日志中标识查询来源、业务场景、用户/会话/traceId 等关键信息

README.md

@@ -290,7 +290,42 @@ await msq.close();
 
 ---
 
-### 6. 事件监听
+### 6. 副本集读偏好配置（readPreference）
+
+```js
+// 副本集读写分离（降低主节点负载）
+const msq = new MonSQLize({
+  type: 'mongodb',
+  databaseName: 'shop',
+  config: {
+    uri: 'mongodb://host1:27017,host2:27018,host3:27019/?replicaSet=rs0',
+    readPreference: 'secondaryPreferred'  // 优先读从节点
+  }
+});
+
+await msq.connect();
+const { collection } = msq;
+
+// 所有查询自动从从节点读取（降低主节点负载）
+const products = await collection('products').find({
+  query: { category: 'electronics' }
+});
+
+console.log(`✅ 从从节点读取 ${products.length} 条数据`);
+```
+
+**支持的读偏好模式**:
+- `primary` - 仅读主节点（默认）
+- `primaryPreferred` - 优先读主节点，主节点故障时读从节点
+- `secondary` - 仅读从节点（适合分析/报表）
+- `secondaryPreferred` - 优先读从节点（推荐，读写分离）
+- `nearest` - 读最近的节点（全球分布式部署）
+
+**详细文档**: [docs/readPreference.md](./docs/readPreference.md)
+
+---
+
+### 7. 事件监听
 
 ```js
 // 监听慢查询

STATUS.md

@@ -146,8 +146,8 @@
       - 缓存可用性检查：缓存不可用时抛出 CACHE_UNAVAILABLE 错误
     - 使用场景：系统启动预热、运维监控、数据变更后清除缓存、内存管理
 - ☑️ 高级查询/游标选项（已评估，分阶段实施）
-    - ✅ 已支持: hint, collation, batchSize, comment (find/findOne/count/aggregate)
-    - 🗺️ P2 可选实施: readPreference (全局配置), max/min, readConcern, let
+    - ✅ 已支持: hint, collation, batchSize, comment (find/findOne/count/aggregate), **readPreference (全局配置)**
+    - 🗺️ P2 可选实施: max/min, readConcern, let
     - ❌ 不实施: noCursorTimeout, tailable, returnKey, allowPartialResults, readPreferenceTags
     - 详细评估: [analysis-reports/2025-11-06-advanced-query-options-evaluation.md](../../guidelines/analysis-reports/2025-11-06-advanced-query-options-evaluation.md)