@vlian/infrastructure 0.9.10

package/CHANGELOG.md

@@ -0,0 +1,1181 @@
+# Changelog
+
+所有重要的项目变更都会记录在这个文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [0.9.10] - 2026-01-12
+
+### Added
+- 新增 NotificationManager API 参考文档（docs/通知管理/API参考.md），提供完整的 API 文档，包含：
+  - NotificationManager 类的所有方法说明
+  - 完整的类型定义文档
+  - 事件类型说明
+  - 错误码参考
+- 新增 NotificationManager 使用手册（docs/通知管理/使用手册.md），提供详细的使用指南，包含：
+  - 快速开始指南
+  - 基础使用示例
+  - 高级功能说明
+  - 配置选项详解
+  - 最佳实践建议
+  - 常见问题解答
+  - 故障排查指南
+- 新增 NotificationManager 最佳实践文档（docs/通知管理/最佳实践.md），提供最佳实践指南，包含：
+  - 通知设计原则
+  - 性能优化建议
+  - 类型安全实践
+  - 错误处理策略
+  - 代码组织建议
+  - 测试策略
+  - 监控和运维建议
+
+### Documentation
+- 完善 NotificationManager 模块文档体系，提供 API 参考、使用手册、最佳实践、方案设计、开发计划等完整文档
+
+## [0.9.9] - 2026-01-11
+
+### Added
+- 新增 NotificationManager（通知管理器）模块，提供完整的通知管理能力：
+  - **核心功能**：
+    - 支持获取通知列表（`getNotifications()` 异步方法）
+    - 支持获取通知列表（`getNotificationsSync()` 同步方法，仅读取缓存）
+    - 支持获取单个通知（`getNotification()` / `getNotificationSync()`）
+    - 支持标记已读（`markAsRead()`）
+    - 支持批量标记已读（`batchMarkAsRead()`）
+    - 支持标记所有已读（`markAllAsRead()`）
+    - 支持删除通知（`deleteNotification()`）
+    - 支持批量删除通知（`batchDeleteNotifications()`）
+    - 支持获取未读数量（`getUnreadCount()` / `getUnreadCountSync()`）
+    - 支持按分类获取未读数量（`getUnreadCountByCategory()`）
+    - 支持刷新通知列表（`refreshNotifications()`）
+    - 支持清除缓存（`clearCache()`）
+  - **实时推送功能**：
+    - 支持启动实时推送（`startRealtimePush()`）
+    - 支持停止实时推送（`stopRealtimePush()`）
+    - 支持获取推送连接状态（`getPushConnectionStatus()`）
+    - 支持手动触发轮询（`triggerPolling()`）
+    - 支持 WebSocket 连接管理（连接、重连、心跳）
+    - 支持轮询机制（降级方案）
+    - 支持推送策略自动切换（WebSocket <-> 轮询）
+  - **过滤和搜索功能**：
+    - 支持过滤通知列表（`filterNotifications()`）
+    - 支持搜索通知列表（`searchNotifications()`）
+    - 支持按分类过滤
+    - 支持按状态过滤（已读/未读）
+    - 支持按时间范围过滤
+    - 支持关键词搜索
+  - **并发消息一致性功能**：
+    - 支持版本号机制（每个通知维护版本号）
+    - 支持乐观锁机制（更新前检查版本号）
+    - 支持冲突检测与自动合并
+    - 支持操作优先级管理
+    - 支持版本冲突自动重试
+    - 支持 ConsistencyManager 模块实现
+  - **事务批量操作功能**：
+    - 支持事务性批量标记已读（`transactionBatchMarkAsRead()`）
+    - 支持事务性批量删除（`transactionBatchDelete()`）
+    - 支持事务性混合操作（`transactionMixed()`）
+    - 支持手动创建事务（`createTransaction()`）
+    - 支持事务提交和回滚
+    - 支持操作快照和回滚函数
+    - 支持事务隔离级别支持
+    - 支持 TransactionManager 模块实现
+  - **高级功能**：
+    - 支持通知分类管理（系统、消息、待办，支持自定义）
+    - 支持分页加载支持
+    - 支持通知数据缓存（内存缓存 + 持久化缓存）
+    - 支持并发控制（auto/queue/latest 策略）
+    - 支持性能监控和统计
+    - 支持健康检查（`healthCheck()`）
+    - 支持性能指标获取（`getPerformanceMetrics()`）
+    - 支持缓存统计信息（`getCacheStatistics()`）
+  - **架构设计**：
+    - 采用 Core/Runtime/Observability 三层架构设计
+    - **Core 层（核心层）**：包含必须的核心功能模块
+      - `NotificationDataManager`：通知数据管理
+      - `NotificationStateManager`：通知状态管理（已读/未读）
+      - `CacheManager`：缓存管理
+      - `ConcurrencyController`：并发控制
+      - `ConsistencyManager`：一致性管理（版本号、冲突检测）
+      - `TransactionManager`：事务管理（批量操作原子性）
+      - `RealtimePushManager`：实时推送管理（WebSocket/轮询）
+      - `StorageManager`：存储管理
+      - `StateManagerWrapper`：状态管理包装器
+    - **Runtime 层（运行时层）**：包含运行时功能模块
+      - `NotificationFilter`：通知过滤工具
+      - `NotificationSearcher`：通知搜索工具
+    - **Observability 层（可观测层）**：包含可观测性模块（可选）
+      - `EventManager`：事件管理（事件发布/订阅）
+      - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+      - `LoggingManager`：日志管理
+      - `MonitoringManager`：监控管理
+  - **存储和持久化**：
+    - 支持通知数据持久化（使用 @vlian/framework Storage）
+    - 支持多种存储策略（localStorage、sessionStorage、IndexedDB、内存）
+  - **状态管理集成**：
+    - 支持使用 @vlian/framework StateManager 进行跨组件共享（`stateManager` 配置项）
+    - 支持状态变化自动同步
+  - **事件系统**：
+    - 支持完整的事件系统（`NotificationEventType`），提供通知加载、更新、已读、删除、新通知到达、刷新、未读数量变化、推送连接状态等事件
+    - 支持事件订阅和取消订阅
+    - 支持事件命名空间隔离（`eventNamespace` 配置项）
+  - **性能优化**：
+    - 支持通知配置缓存（`enableCache` 配置项）
+    - 支持缓存过期时间设置（`cacheExpiry` 配置项）
+    - 支持并发控制（`ConcurrencyController`），避免并发操作冲突
+    - 支持批量更新优化
+  - **可观测性**：
+    - 支持日志记录（`enableLogging` 配置项，集成 @vlian/framework Logger）
+    - 支持监控服务集成（`enableMonitoring` 配置项，集成 @vlian/framework MonitoringService）
+    - 支持性能监控（`PerformanceMonitor`），追踪操作耗时和性能数据
+    - 支持性能统计（`getPerformanceMetrics()` 方法）
+    - 支持缓存统计（`getCacheStatistics()` 方法）
+  - **健康检查**：
+    - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、通知数据等组件健康度
+  - **配置验证**：
+    - 支持配置验证（`validateConfig()` 方法），验证配置完整性和正确性
+  - **环境适配**：
+    - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+    - 支持实例隔离模式（`isolationMode` 配置项），支持 isolated、shared、hybrid 三种模式
+  - **生产环境优化**：
+    - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义，完全泛型化，通知类型由用户定义
+- 新增通知管理方案设计文档（docs/通知管理/方案设计.md），提供完整的设计方案和技术细节
+- 新增通知管理性能优化分析文档（docs/通知管理/性能优化分析.md），提供性能优化分析
+- 新增 NotificationTest 示例组件（example/vite/src/components/NotificationTest.tsx），演示 NotificationManager 的各种功能
+- 导出 NotificationManager 及相关类型定义到主入口文件（src/index.ts）：
+  - 导出 `NotificationManager` 类
+  - 导出 `NotificationEventType` 枚举
+  - 导出 `NotificationError`、`NotificationErrorCode`、`VersionConflictError`、`TransactionError`、`TransactionTimeoutError`、`TransactionRollbackError` 错误类型
+  - 导出 `NotificationManagerOptions`、`Notification`、`NotificationList`、`GetNotificationsOptions`、`GetNotificationsSyncOptions`、`GetNotificationOptions`、`GetNotificationSyncOptions`、`UpdateNotificationOptions`、`DeleteNotificationOptions`、`BatchUpdateResult`、`GetUnreadCountOptions`、`GetUnreadCountSyncOptions`、`RefreshNotificationsOptions`、`ClearCacheOptions`、`StartRealtimePushOptions`、`PushConnectionStatus`、`NotificationFilter`、`SearchNotificationsOptions`、`EventMetadata`、`EventListenerOptions`、`HealthCheckResult`、`PerformanceMetrics`、`CacheStatistics`、`ConfigValidationResult`、`Transaction`、`TransactionOperation`、`TransactionResult`、`TransactionOperationResult` 等类型
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 NotificationManager 和相关类型
+- 更新示例项目（example/vite/src/App.tsx），集成 NotificationTest 组件
+- 更新通知管理开发计划文档（docs/通知管理/开发计划.md），标记所有功能为已完成状态
+
+### Infrastructure
+- 完善 NotificationManager 模块结构，包含多个子模块：
+  - **核心层（core/）**：
+    - `NotificationDataManager`：通知数据管理
+    - `NotificationStateManager`：通知状态管理
+    - `CacheManager`：缓存管理
+    - `ConcurrencyController`：并发控制
+    - `ConsistencyManager`：一致性管理
+    - `TransactionManager`：事务管理
+    - `RealtimePushManager`：实时推送管理
+    - `StorageManager`：存储管理
+    - `StateManagerWrapper`：状态管理包装器
+  - **运行时层（runtime/）**：
+    - `NotificationFilter`：通知过滤工具
+    - `NotificationSearcher`：通知搜索工具
+  - **可观测层（observability/）**：
+    - `EventManager`：事件管理
+    - `PerformanceMonitor`：性能监控
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+  - **公共模块（modules/）**：
+    - `StorageManager`：存储管理
+    - `EnvironmentDetector`：环境检测
+    - `ErrorHandler`：错误处理
+  - **工具模块（utils/）**：
+    - `IsolationUtils`：隔离工具
+
+## [0.9.8] - 2026-01-11
+
+### Added
+- 新增 SystemConfigManager API 参考文档（docs/系统配置/API参考.md），提供完整的 API 文档，包含：
+  - SystemConfigManager 类的所有方法说明
+  - 完整的类型定义文档
+  - 事件类型说明
+  - 错误码参考
+- 新增 SystemConfigManager 使用手册（docs/系统配置/使用手册.md），提供详细的使用指南，包含：
+  - 快速开始指南
+  - 基础使用示例
+  - 高级功能说明
+  - 配置选项详解
+  - 最佳实践建议
+  - 常见问题解答
+  - 故障排查指南
+- 新增 SystemConfigManager 最佳实践文档（docs/系统配置/最佳实践.md），提供最佳实践指南，包含：
+  - 配置设计原则
+  - 性能优化建议
+  - 类型安全实践
+  - 错误处理策略
+  - 代码组织建议
+  - 测试策略
+  - 监控和运维建议
+
+### Changed
+- 更新 SystemConfigManager 开发计划文档（docs/系统配置/开发计划.md），标记所有功能为已完成状态
+
+### Documentation
+- 完善 SystemConfigManager 模块文档体系，提供 API 参考、使用手册、最佳实践、方案设计、开发计划等完整文档
+
+## [0.9.7] - 2026-01-11
+
+### Added
+- SystemConfigManager 新增 SyncManager（同步管理器）模块（Core 层），将配置同步逻辑模块化：
+  - 支持三种同步策略（`immediate`、`batch`、`queue`）的统一管理
+  - 支持同步重试机制（指数退避策略）
+  - 支持离线队列（`enableOfflineQueue` 配置项），网络恢复时自动同步
+  - 支持批量同步优化（`batchSyncDelay` 配置项）
+  - 支持队列统计信息（`getQueueStats()` 方法）
+  - 支持强制处理所有待同步任务（`flush()` 方法）
+  - 支持清除所有队列（`clear()` 方法）
+- 新增 SystemConfigManager 单元测试文件（test/SystemConfigManager.test.ts），提供完整的测试覆盖：
+  - 测试初始化和配置
+  - 测试配置获取（getConfig, getConfigSync, getAllConfig, getAllConfigSync, getConfigs, getConfigsSync）
+  - 测试配置更新（updateConfig, batchUpdateConfig）
+  - 测试配置刷新（refreshConfig）
+  - 测试清除缓存（clearCache）
+  - 测试配置验证（validateConfig, validateAllConfig）
+  - 测试一致性级别管理（getConfigConsistency, getConfigsByConsistency）
+  - 测试配置差异计算（calculateConfigDiff, calculateConfigDiffSync, applyConfigPatch）
+  - 测试事件系统（on, off, once）
+  - 测试健康检查（healthCheck）
+  - 测试性能指标（getPerformanceMetrics, clearPerformanceMetrics）
+  - 测试缓存统计（getCacheStatistics, resetCacheStatistics）
+  - 测试资源清理（destroy）
+  - 测试错误处理、并发控制、持久化缓存
+
+### Changed
+- **SystemConfigManager 架构优化**：将同步逻辑从主类中提取到独立的 `SyncManager` 模块，提升代码可维护性和可读性
+- **ConfigDataManager 优化**：
+  - 移除未使用的 `configUpdater` 和 `configBatchUpdater` 参数（同步逻辑已迁移到 SyncManager）
+  - 新增配置合并功能，支持默认配置与静态配置的深度合并
+  - 优化配置获取逻辑，自动合并默认配置
+- 更新 SystemConfigTest 示例组件，补充更多功能演示和测试用例
+
+### Infrastructure
+- 完善 SystemConfigManager 模块结构：
+  - **核心层（core/）**新增：
+    - `SyncManager`：同步管理器（负责配置同步策略、重试机制和离线队列）
+- 新增 SystemConfigManager 单元测试文件，提升代码质量和测试覆盖率
+
+## [0.9.6] - 2026-01-11
+
+### Added
+- 新增 SystemConfigManager（系统配置管理器）模块，提供完整的系统配置管理能力：
+  - **核心功能**：
+    - 支持获取配置（`getConfig(key: string)` 异步方法）
+    - 支持获取配置（`getConfigSync(key: string)` 同步方法，仅读取缓存）
+    - 支持获取所有配置（`getAllConfig()` 异步方法）
+    - 支持获取所有配置（`getAllConfigSync()` 同步方法）
+    - 支持批量获取配置（`getConfigs(keys: string[])` 异步方法）
+    - 支持批量获取配置（`getConfigsSync(keys: string[])` 同步方法）
+    - 支持更新配置（`updateConfig(key: string, value: unknown)` 异步方法）
+    - 支持批量更新配置（`batchUpdateConfig(configs: Partial<TConfig>)` 异步方法）
+    - 支持刷新配置（`refreshConfig(key?: string, force?: boolean)` 异步方法）
+    - 支持刷新所有配置（`refreshAllConfig(force?: boolean)` 异步方法）
+  - **一致性级别管理**：
+    - 支持一致性级别管理（`enableConsistencyLevel` 配置项）
+    - 支持三种一致性级别：`local`（本地一致）、`synced`（已同步）、`eventual`（最终一致）
+    - 支持获取配置一致性级别（`getConfigConsistency(key?: string)` / `getConfigConsistencySync()`）
+    - 支持按一致性级别查询配置（`getConfigsByConsistency(level: ConsistencyLevel)` / `getConfigsByConsistencySync()`）
+  - **配置差异计算**：
+    - 支持计算配置差异（`calculateConfigDiff(newConfig, oldConfig?)`）
+    - 支持应用配置差异（`applyConfigPatch(diff: ConfigDiff)`）
+    - 支持自定义变更检测函数（`configChangeDetector` 配置项）
+  - **高级功能**：
+    - 支持配置数据缓存（内存缓存 + 持久化缓存）
+    - 支持配置数据验证（`configValidator` 配置项）
+    - 支持配置类型定义（`configTypes` 配置项），支持类型检查和值范围验证
+    - 支持默认配置（`defaultConfig` 配置项）
+    - 支持配置数据来源配置（`configFetcher`、`configUpdater`、`configBatchUpdater` 配置项）
+    - 支持配置同步到服务器（`syncStrategy` 配置项，支持 `immediate`、`batch`、`queue` 三种策略）
+    - 支持同步失败重试机制（`syncRetryConfig` 配置项）
+    - 支持离线队列（`enableOfflineQueue` 配置项）
+  - **并发控制**：
+    - 支持自动策略（`auto`）- 根据操作类型自动选择最优策略
+    - 支持队列策略（`queue`）- 串行队列，保证操作顺序执行
+    - 支持最新策略（`latest`）- 只应用最新操作，适合高频查询
+  - **架构设计**：
+    - 采用 Core/Runtime/Observability 三层架构设计
+    - **Core 层（核心层）**：包含必须的核心功能模块
+      - `ConfigDataManager`：配置数据管理
+      - `CacheManager`：缓存管理
+      - `ConfigValidator`：配置验证
+      - `ConsistencyManager`：一致性级别管理
+      - `ConcurrencyController`：并发控制
+      - `StateManagerWrapper`：状态管理包装器
+    - **Runtime 层（运行时层）**：包含运行时功能模块
+      - `DiffCalculator`：配置差异计算
+    - **Observability 层（可观测层）**：包含可观测性模块（可选）
+      - `EventManager`：事件管理（事件发布/订阅）
+      - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+      - `LoggingManager`：日志管理
+      - `MonitoringManager`：监控管理
+  - **存储和持久化**：
+    - 支持配置数据持久化（使用 @vlian/framework Storage）
+    - 支持多种存储策略（localStorage、sessionStorage、IndexedDB、内存）
+  - **状态管理集成**：
+    - 支持使用 @vlian/framework StateManager 进行跨组件共享（`stateManager` 配置项）
+    - 支持状态变化自动同步
+  - **事件系统**：
+    - 支持完整的事件系统（`SystemConfigEventType`），提供配置加载、更新、刷新、同步等事件
+    - 支持事件订阅和取消订阅
+    - 支持事件命名空间隔离（`eventNamespace` 配置项）
+  - **性能优化**：
+    - 支持配置缓存（`enableCache` 配置项）
+    - 支持缓存过期时间设置（`cacheExpiry` 配置项）
+    - 支持并发控制（`ConcurrencyController`），避免并发操作冲突
+    - 支持批量更新优化
+  - **可观测性**：
+    - 支持日志记录（`enableLogging` 配置项，集成 @vlian/framework Logger）
+    - 支持监控服务集成（`enableMonitoring` 配置项，集成 @vlian/framework MonitoringService）
+    - 支持性能监控（`PerformanceMonitor`），追踪操作耗时和性能数据
+    - 支持性能统计（`getPerformanceMetrics()` 方法）
+    - 支持缓存统计（`getCacheStatistics()` 方法）
+  - **健康检查**：
+    - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、配置数据等组件健康度
+  - **配置验证**：
+    - 支持配置验证（`validateConfig()` 方法），验证配置完整性和正确性
+  - **环境适配**：
+    - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+    - 支持实例隔离模式（`isolationMode` 配置项），支持 isolated、shared、hybrid 三种模式
+  - **生产环境优化**：
+    - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义，完全泛型化，配置类型由用户定义
+- 新增系统配置方案设计文档（docs/系统配置/方案设计.md），提供完整的设计方案和技术细节
+- 新增 SystemConfigTest 示例组件（example/vite/src/components/SystemConfigTest.tsx），演示 SystemConfigManager 的各种功能
+- 导出 SystemConfigManager 及相关类型定义到主入口文件（src/index.ts）：
+  - 导出 `SystemConfigManager` 类
+  - 导出 `SystemConfigEventType` 枚举
+  - 导出 `SystemConfigError`、`SystemConfigErrorCode` 错误类型
+  - 导出 `SystemConfigOptions`、`GetConfigOptions`、`GetConfigSyncOptions`、`UpdateConfigOptions`、`ConsistencyLevel`、`ConfigDiff`、`ValidationResult`、`BatchUpdateResult`、`HealthCheckResult`、`PerformanceMetrics`、`CacheStatistics`、`ConfigTypeDefinition`、`ConfigUpdatedEventData`、`ConfigBatchUpdatedEventData` 等类型
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 SystemConfigManager 和相关类型
+- 更新示例项目（example/vite/src/App.tsx），集成 SystemConfigTest 组件
+
+### Infrastructure
+- 完善 SystemConfigManager 模块结构，包含多个子模块：
+  - **核心层（core/）**：
+    - `ConfigDataManager`：配置数据管理
+    - `CacheManager`：缓存管理
+    - `ConfigValidator`：配置验证
+    - `ConsistencyManager`：一致性级别管理
+    - `ConcurrencyController`：并发控制
+    - `StateManagerWrapper`：状态管理包装器
+  - **运行时层（runtime/）**：
+    - `DiffCalculator`：配置差异计算
+  - **可观测层（observability/）**：
+    - `EventManager`：事件管理
+    - `PerformanceMonitor`：性能监控
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+  - **公共模块（modules/）**：
+    - `StorageManager`：存储管理
+    - `EnvironmentDetector`：环境检测
+    - `ErrorHandler`：错误处理
+
+## [0.9.5] - 2026-01-11
+
+### Added
+- 新增 DictionaryManager 单元测试文件（test/DictionaryManager.test.ts），提供完整的测试覆盖：
+  - 测试初始化和配置
+  - 测试字典数据获取（getDictionary, getDictionarySync）
+  - 测试字典值获取（getDictionaryValue, getDictionaryValueSync）
+  - 测试格式化字典值（formatDictionary）
+  - 测试批量获取（getDictionaries, getDictionariesSync, getDictionaryValues, getDictionaryValuesSync）
+  - 测试可用字典列表（getAvailableDictionaries, getAvailableDictionariesSync）
+  - 测试刷新字典（refreshDictionary, refreshDictionaries）
+  - 测试清除缓存（clearCache）
+  - 测试预加载（preloadDictionaries, getPreloadStatus）
+  - 测试索引相关（getDictionaryItemByIndex, getDictionaryIndex）
+  - 测试差异计算（calculateDictionaryDiff, applyDictionaryPatch）
+  - 测试事件系统（on, off, once）
+  - 测试健康检查（healthCheck）
+  - 测试性能指标（getPerformanceMetrics, clearPerformanceMetrics）
+  - 测试缓存统计（getCacheStatistics, resetCacheStatistics）
+  - 测试资源清理（destroy）
+  - 测试错误处理
+
+## [0.9.4] - 2026-01-11
+
+### Added
+- 新增 DictionaryManager（数据字典管理器）模块，提供完整的字典管理能力：
+  - **核心功能**：
+    - 支持获取字典数据（`getDictionary(code: string)` 异步方法）
+    - 支持获取字典数据（`getDictionarySync(code: string)` 同步方法，仅读取缓存）
+    - 支持获取字典值（`getDictionaryValue(code: string, key: string | number)` 异步方法）
+    - 支持获取字典值（`getDictionaryValueSync(code: string, key: string | number)` 同步方法）
+    - 支持格式化字典值（`formatDictionary(code: string, value: string | number, options?: FormatDictionaryOptions)`）
+    - 支持批量获取字典数据（`getDictionaries(codes: string[])` 异步方法）
+    - 支持批量获取字典数据（`getDictionariesSync(codes: string[])` 同步方法）
+    - 支持批量获取字典值（`getDictionaryValues(queries: DictionaryValueQuery[])` 异步方法）
+    - 支持批量获取字典值（`getDictionaryValuesSync(queries: DictionaryValueQuery[])` 同步方法）
+    - 支持获取可用字典列表（`getAvailableDictionaries()` / `getAvailableDictionariesSync()`）
+  - **高级功能**：
+    - 支持字典数据缓存（内存缓存 + 持久化缓存）
+    - 支持字典数据预加载（`preloadDictionaries(codes: string[])`）
+    - 支持预加载状态查询（`getPreloadStatus(code?: string)`）
+    - 支持字典数据刷新机制（`refreshDictionary(code?: string, force?: boolean)`）
+    - 支持批量刷新字典（`refreshDictionaries(codes: string[], force?: boolean)`）
+    - 支持清除缓存（`clearCache(code?: string)`）
+    - 支持字典数据变化事件通知（基于 @vlian/framework AppEventBus）
+    - 支持批量获取字典数据（支持批量 fetch 优化）
+  - **索引功能**：
+    - 支持 Map 索引存储（`Map<string, TDictionaryItem>`）
+    - 支持自定义索引键配置（`indexKeyField`）
+    - 支持索引自动维护（字典更新时自动更新索引）
+    - 支持通过索引键获取字典项（`getDictionaryItemByIndex(code, indexKey)` / `getDictionaryItemByIndexSync()`）
+    - 支持获取字典索引 Map（`getDictionaryIndex(code)` / `getDictionaryIndexSync()`）
+    - 支持 O(1) 查询性能优化
+  - **Diff & Patch 功能**：
+    - 支持计算字典差异（`calculateDictionaryDiff(code, newItems, oldItems?)`）
+    - 支持应用字典差异（`applyDictionaryPatch(code, diff)`）
+    - 支持自定义字典项比较函数（`itemComparator`）
+    - 支持自定义变更检测函数（`itemChangeDetector`）
+    - 字典更新事件包含 Diff 信息
+  - **并发控制**：
+    - 支持自动策略（`auto`）- 根据操作类型自动选择最优策略
+    - 支持队列策略（`queue`）- 串行队列，保证操作顺序执行
+    - 支持最新策略（`latest`）- 只应用最新操作，适合高频查询
+  - **架构设计**：
+    - 采用 Core/Runtime/Observability 三层架构设计
+    - **Core 层（核心层）**：包含必须的核心功能模块
+      - `DictionaryDataManager`：字典数据管理
+      - `CacheManager`：缓存管理
+      - `IndexManager`：索引管理
+      - `DiffCalculator`：差异计算
+      - `DictionaryValidator`：字典数据验证
+      - `ConcurrencyController`：并发控制
+      - `StateManagerWrapper`：状态管理包装器
+    - **Runtime 层（运行时层）**：包含运行时功能模块
+      - `DictionaryFormatter`：字典格式化器
+      - `DictionaryBatchProcessor`：批量处理器
+    - **Observability 层（可观测层）**：包含可观测性模块（可选）
+      - `EventManager`：事件管理（事件发布/订阅）
+      - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+      - `LoggingManager`：日志管理
+      - `MonitoringManager`：监控管理
+  - **存储和持久化**：
+    - 支持字典数据持久化（使用 @vlian/framework Storage）
+    - 支持多种存储策略（localStorage、sessionStorage、IndexedDB）
+  - **状态管理集成**：
+    - 支持使用 @vlian/framework StateManager 进行跨组件共享（`stateManager` 配置项）
+    - 支持状态变化自动同步
+  - **事件系统**：
+    - 支持完整的事件系统（`DictionaryEventType`），提供字典加载、更新、刷新等事件
+    - 支持事件订阅和取消订阅
+    - 支持事件命名空间隔离（`eventNamespace` 配置项）
+  - **性能优化**：
+    - 支持字典配置缓存（`enableCache` 配置项）
+    - 支持缓存过期时间设置（`cacheExpiry` 配置项）
+    - 支持并发控制（`ConcurrencyController`），避免并发操作冲突
+    - 支持批量更新优化
+  - **可观测性**：
+    - 支持日志记录（`enableLogging` 配置项，集成 @vlian/framework Logger）
+    - 支持监控服务集成（`enableMonitoring` 配置项，集成 @vlian/framework MonitoringService）
+    - 支持性能监控（`PerformanceMonitor`），追踪操作耗时和性能数据
+    - 支持性能统计（`getPerformanceStatistics()` 方法）
+    - 支持缓存统计（`getCacheStatistics()` 方法）
+  - **健康检查**：
+    - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、字典数据等组件健康度
+  - **配置验证**：
+    - 支持配置验证（`validateConfig()` 方法），验证配置完整性和正确性
+  - **环境适配**：
+    - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+    - 支持实例隔离模式（`isolationMode` 配置项），支持 isolated、shared、hybrid 三种模式
+  - **生产环境优化**：
+    - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义，完全泛型化，字典项类型由用户定义
+- 新增数据字典方案设计文档（docs/数据字典/方案设计.md），提供完整的设计方案和技术细节
+- 新增数据字典 API 参考文档（docs/数据字典/API参考.md），提供完整的 API 文档
+- 新增数据字典使用手册（docs/数据字典/使用手册.md），提供详细的使用指南和最佳实践
+- 新增数据字典最佳实践文档（docs/数据字典/最佳实践.md），提供最佳实践指南
+- 新增数据字典开发计划文档（docs/数据字典/开发计划.md），标记所有功能为已完成状态
+- 新增 DictionaryTest 示例组件（example/vite/src/components/DictionaryTest.tsx），演示 DictionaryManager 的各种功能
+- 导出 DictionaryManager 及相关类型定义到主入口文件（src/index.ts）：
+  - 导出 `DictionaryManager` 类
+  - 导出 `DictionaryEventType` 枚举
+  - 导出 `DictionaryError`、`DictionaryErrorCode` 错误类型
+  - 导出 `DictionaryOptions`、`DictionaryItem`、`DictionaryData`、`GetDictionaryOptions`、`GetDictionarySyncOptions`、`FormatDictionaryOptions`、`DictionaryValueQuery`、`PreloadStatus`、`HealthCheckResult`、`PerformanceMetrics`、`CacheStatistics`、`DictionaryDiff` 等类型
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 DictionaryManager 和相关类型
+- 更新示例项目（example/vite/src/App.tsx），集成 DictionaryTest 组件
+
+### Infrastructure
+- 完善 DictionaryManager 模块结构，包含多个子模块：
+  - **核心层（core/）**：
+    - `DictionaryDataManager`：字典数据管理
+    - `CacheManager`：缓存管理
+    - `IndexManager`：索引管理
+    - `DiffCalculator`：差异计算
+    - `DictionaryValidator`：字典数据验证
+    - `ConcurrencyController`：并发控制
+    - `StateManagerWrapper`：状态管理包装器
+  - **运行时层（runtime/）**：
+    - `DictionaryFormatter`：字典格式化器
+    - `DictionaryBatchProcessor`：批量处理器
+  - **可观测层（observability/）**：
+    - `EventManager`：事件管理
+    - `PerformanceMonitor`：性能监控
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+  - **公共模块（modules/）**：
+    - `StorageManager`：存储管理
+    - `EnvironmentDetector`：环境检测
+    - `ErrorHandler`：错误处理
+
+## [0.9.3] - 2026-01-11
+
+### Changed
+- **PermissionManager 架构重构**：将模块按 Core/Runtime/Observability 三层架构重新组织，提升代码可维护性和可读性：
+  - **Core 层（核心层）**：包含必须的核心功能模块
+    - `PermissionCore`：权限核心逻辑
+    - `ConcurrencyController`：并发控制（避免并发操作冲突）
+    - `StateManagerWrapper`：状态管理包装器
+  - **Runtime 层（运行时层）**：包含运行时功能模块
+    - `EnvironmentAdapter`：环境适配器（自动检测运行环境）
+  - **Observability 层（可观测层）**：包含可观测性模块（可选）
+    - `EventManager`：事件管理（事件发布/订阅）
+    - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+- **代码优化**：PermissionManager 代码重构，将模块按架构层重新组织，提升代码可读性和维护性
+- 更新权限管理文档（docs/权限管理/），补充三层架构说明：
+  - 更新 API 参考文档，补充架构分层说明
+  - 更新使用手册，补充架构说明
+  - 更新方案设计文档，补充 Core/Runtime/Observability 三层架构的详细说明
+  - 更新最佳实践文档，补充架构相关的最佳实践
+
+### Infrastructure
+- 重构 PermissionManager 模块结构，按架构层组织：
+  - 新增分层模块结构：
+    - `core/`：核心层模块（3 个模块）
+    - `runtime/`：运行时层模块（1 个模块）
+    - `observability/`：可观测层模块（4 个模块）
+  - 保留 `modules/` 目录用于功能模块（权限检查、数据管理、限流、审计等）
+- 更新模块导出结构（`index.ts`），按架构层统一导出
+- 更新示例组件（example/vite/src/components/PermissionTest.tsx），适配新的架构结构
+
+## [0.9.2] - 2026-01-11
+
+### Changed
+- **UserManager 架构重构**：将模块按 Core/Runtime/Observability 三层架构重新组织，提升代码可维护性和可读性：
+  - **Core 层（核心层）**：包含必须的核心功能模块
+    - `UserCore`：用户核心逻辑
+    - `UserInfoManager`：用户信息管理（从 modules 迁移）
+    - `UserSettingsManager`：用户设置管理（从 modules 迁移）
+    - `UserValidator`：用户数据验证
+    - `ConcurrencyController`：并发控制（避免并发操作冲突）
+    - `StateManagerWrapper`：状态管理包装器
+    - `CacheManager`：缓存管理
+  - **Runtime 层（运行时层）**：包含运行时功能模块
+    - `SyncManager`：数据同步管理
+    - `QueueManager`：队列管理
+  - **Observability 层（可观测层）**：包含可观测性模块（可选）
+    - `EventManager`：事件管理（事件发布/订阅）
+    - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+- **代码优化**：UserManager 代码从 564 行优化到 388 行，减少 31% 代码量，提升代码可读性和维护性
+- 更新用户管理文档（docs/用户管理/），补充三层架构说明：
+  - 更新 API 参考文档，补充架构分层说明
+  - 更新使用手册，补充架构说明
+  - 更新方案设计文档，补充 Core/Runtime/Observability 三层架构的详细说明
+
+### Infrastructure
+- 重构 UserManager 模块结构，按架构层组织：
+  - 删除旧的扁平模块结构（`modules/UserInfoManager.ts`、`modules/UserSettingsManager.ts`）
+  - 新增分层模块结构：
+    - `core/`：核心层模块（7 个模块）
+    - `runtime/`：运行时层模块（2 个模块）
+    - `observability/`：可观测层模块（4 个模块）
+- 更新模块导出结构（`modules/index.ts`），按架构层统一导出
+- 新增 UserManager 核心层单元测试（test/UserManager.core.test.ts）
+
+## [0.9.1] - 2026-01-11
+
+### Added
+- 新增主题管理 API 参考文档（docs/主题管理/API参考.md），提供完整的 API 文档，包含：
+  - ThemeManager 类的所有方法说明
+  - 完整的类型定义文档
+  - 事件类型说明
+  - 错误码参考
+- 新增主题管理使用手册（docs/主题管理/使用手册.md），提供详细的使用指南，包含：
+  - 快速开始指南
+  - 基础使用示例
+  - 高级功能说明
+  - 配置选项详解
+  - 最佳实践建议
+  - 常见问题解答
+  - 故障排查指南
+- 新增主题管理最佳实践文档（docs/主题管理/最佳实践.md），提供最佳实践指南，包含：
+  - 主题设计原则
+  - 性能优化建议
+  - 安全实践指南
+  - 错误处理策略
+  - 代码组织建议
+  - 测试策略
+  - 监控和运维建议
+
+### Changed
+- 更新主题管理开发计划文档（docs/主题管理/开发计划.md），标记所有功能为已完成状态
+- 更新认证管理方案设计文档（docs/认证管理/方案设计.md），补充三层架构（Core/Runtime/Observability）的详细说明和架构图
+- 更新框架设计评估清单文档（docs/框架设计评估清单2.md），优化标题表述
+
+### Documentation
+- 完善主题管理模块文档体系，提供 API 参考、使用手册、最佳实践、方案设计、开发计划等完整文档
+
+## [0.9.0] - 2026-01-11
+
+### Changed
+- **AuthManager 架构重构**：将模块按 Core/Runtime/Observability 三层架构重新组织，提升代码可维护性和可读性：
+  - **Core 层（核心层）**：包含必须的核心功能模块
+    - `TokenManager`：Token 管理（刷新、过期检测等）
+    - `AuthStateManager`：认证状态管理（设置、清除、更新）
+    - `StorageManager`：存储管理（持久化、批量写入优化）
+    - `EncryptionService`：加密服务（Token 加密/解密）
+    - `EnvironmentDetector`：环境检测（浏览器、Node.js、SSR、Worker 等）
+    - `ConcurrencyController`：并发控制（避免并发操作冲突）
+  - **Runtime 层（运行时层）**：包含运行时功能模块
+    - `RefreshScheduler`：Token 刷新调度器（智能调度、页面可见性检测）
+  - **Observability 层（可观测层）**：包含可观测性模块（可选）
+    - `EventManager`：事件管理（事件发布/订阅）
+    - `PerformanceMonitor`：性能监控（操作耗时、性能指标）
+    - `ErrorHandler`：错误处理（统一错误处理、错误脱敏）
+- **代码优化**：AuthManager 代码从 3440 行优化到 925 行，减少 73% 代码量，提升代码可读性和维护性
+- 更新示例项目（example/vite/src/components/AuthTest.tsx），适配新的架构结构
+- 更新框架设计评估清单文档（docs/框架设计评估清单2.md），补充架构分层说明
+
+### Infrastructure
+- 重构 AuthManager 模块结构，按架构层组织：
+  - 删除旧的扁平模块结构（`modules/EncryptionService.ts`、`modules/EnvironmentDetector.ts` 等）
+  - 新增分层模块结构：
+    - `modules/core/`：核心层模块（6 个模块）
+    - `modules/runtime/`：运行时层模块（1 个模块）
+    - `modules/observability/`：可观测层模块（3 个模块）
+- 更新模块导出结构（`modules/index.ts`），按架构层统一导出
+- 更新 .cursorrules，补充架构分层说明
+
+## [0.8.0] - 2026-01-11
+
+### Added
+- 新增 ThemeManager（主题管理器）模块，提供完整的主题管理能力：
+  - **核心功能**：
+    - 支持设置主题（`setTheme(theme: string)` 方法）
+    - 支持获取当前主题（`getTheme()` 方法）
+    - 支持获取可用主题列表（`getAvailableThemes()` 方法）
+    - 支持获取主题配置（`getThemeConfig(theme: string)` 方法）
+    - 支持更新主题配置（`updateThemeConfig(theme: string, config: TThemeConfig)` 方法）
+    - 支持批量更新主题配置（`batchUpdateThemeConfigs(updates: BatchUpdateItem[])` 方法）
+  - **主题配置管理**：
+    - 支持完全泛型化的主题配置类型（`TThemeConfig`），由用户定义配置结构
+    - 支持主题配置对象（颜色、字体、间距等任意配置）
+    - 支持默认主题配置（`defaultThemeConfig` 配置项）
+    - 支持主题配置合并（`ThemeConfigMerger`）
+    - 支持主题配置验证（`themeConfigValidator` 配置项）
+  - **CSS 变量支持**：
+    - 支持 CSS 变量生成（`generateCssVariables(theme?: string)` 方法）
+    - 支持自定义 CSS 变量格式化器（`cssVariableFormatter` 配置项）
+    - 支持动态 CSS 变量注入（由 UI 层使用）
+  - **存储和持久化**：
+    - 支持主题选择持久化（使用 @vlian/framework Storage）
+    - 支持主题配置持久化
+    - 支持多种存储策略（localStorage、sessionStorage、IndexedDB）
+  - **状态管理集成**：
+    - 支持使用 @vlian/framework StateManager 进行跨组件共享（`stateManager` 配置项）
+    - 支持状态变化自动同步
+  - **事件系统**：
+    - 支持完整的事件系统（`ThemeEventType`），提供主题切换、配置更新等事件
+    - 支持事件订阅和取消订阅
+    - 支持事件命名空间隔离（`eventNamespace` 配置项）
+  - **生命周期钩子**：
+    - 支持生命周期钩子（`hooks` 配置项），提供主题切换前后、配置更新前后等钩子
+    - 支持钩子返回值控制操作是否继续执行
+  - **性能优化**：
+    - 支持主题配置缓存（`enableCache` 配置项）
+    - 支持缓存过期时间设置（`cacheExpiry` 配置项）
+    - 支持并发控制（`ConcurrencyController`），避免并发操作冲突
+    - 支持批量更新优化
+  - **可观测性**：
+    - 支持日志记录（`enableLogging` 配置项，集成 @vlian/framework Logger）
+    - 支持监控服务集成（`enableMonitoring` 配置项，集成 @vlian/framework MonitoringService）
+    - 支持性能监控（`PerformanceMonitor`），追踪操作耗时和性能数据
+    - 支持性能统计（`getPerformanceStatistics()` 方法）
+    - 支持缓存统计（`getCacheStatistics()` 方法）
+  - **健康检查**：
+    - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、主题数据等组件健康度
+  - **配置验证**：
+    - 支持配置验证（`validateConfig()` 方法），验证配置完整性和正确性
+  - **环境适配**：
+    - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+    - 支持实例隔离模式（`isolationMode` 配置项），支持 isolated、shared、hybrid 三种模式
+  - **生产环境优化**：
+    - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义，完全泛型化，主题配置类型由用户定义
+- 新增主题管理方案设计文档（docs/主题管理/方案设计.md），提供完整的设计方案和技术细节
+- 新增主题管理开发计划文档（docs/主题管理/开发计划.md），提供开发计划和功能清单
+- 新增 ThemeTest 示例组件（example/vite/src/components/ThemeTest.tsx），演示 ThemeManager 的各种功能
+- 新增示例项目启动说明文档（example/vite/启动说明.md），提供示例项目的使用指南
+- 导出 ThemeManager 及相关类型定义到主入口文件（src/index.ts）：
+  - 导出 `ThemeManager` 类
+  - 导出 `ThemeEventType` 枚举
+  - 导出 `ThemeError`、`ThemeErrorCode` 错误类型
+  - 导出 `ThemeOptions`、`ThemeConfig`、`ThemeChangedEventData`、`ThemeConfigUpdatedEventData`、`HealthCheckResult`、`PerformanceMetrics`、`ConfigValidationResult`、`LifecycleHooks`、`CacheStatistics`、`BatchUpdateItem`、`BatchUpdateResult` 等类型
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 ThemeManager 和相关类型
+- 更新示例项目（example/vite/src/App.tsx），集成 ThemeTest 组件
+- 更新框架设计评估清单文档（docs/框架设计评估清单2.md），补充 ThemeManager 相关内容
+- 优化 AuthManager 代码，移除未使用的变量（`timeoutOccurred`），简化代码逻辑
+
+### Infrastructure
+- 完善 ThemeManager 模块结构，包含多个子模块：
+  - **核心层（core/）**：
+    - `ThemeCore`：主题核心逻辑
+    - `ThemeConfigManager`：主题配置管理
+    - `ThemeValidator`：主题配置验证
+    - `ConcurrencyController`：并发控制
+    - `StateManagerWrapper`：状态管理包装器
+    - `LifecycleHookManager`：生命周期钩子管理
+    - `CacheManager`：缓存管理
+  - **运行时层（runtime/）**：
+    - `CssVariableGenerator`：CSS 变量生成器
+    - `ThemeConfigMerger`：主题配置合并器
+    - `ThemeFormatter`：主题格式化器
+  - **可观测层（observability/）**：
+    - `EventManager`：事件管理
+    - `PerformanceMonitor`：性能监控
+    - `LoggingManager`：日志管理
+    - `MonitoringManager`：监控管理
+  - **公共模块（modules/）**：
+    - `StorageManager`：存储管理
+    - `EnvironmentDetector`：环境检测
+    - `ErrorHandler`：错误处理
+  - **工具模块（utils/）**：
+    - `IsolationUtils`：隔离工具
+
+## [0.7.1] - 2026-01-10
+
+### Added
+- AuthManager 新增用户信息管理功能：
+  - 新增 `updateUserInfo(userInfo)` 方法，支持更新用户信息而不改变登录状态
+  - 改进 `setAuth()` 方法，现在可以接受 `TokenInfo` 或 `AuthData`，支持在设置认证时同时设置用户信息
+  - 改进 `getUserInfo()` 方法，现在可以从 `authData` 中返回用户信息（之前总是返回 null）
+  - 新增 `USER_INFO_UPDATE` 事件类型，用户信息更新时自动触发事件
+  - 改进 `AuthData` 类型定义，支持泛型用户信息类型（`AuthData<TUserInfo>`）
+- 新增 UserManager 单元测试文件（test/UserManager.test.ts），提供完整的测试覆盖
+
+### Changed
+- 优化 AuthManager Token 刷新机制：
+  - 改进 Token 刷新超时控制，修复超时定时器管理问题，避免内存泄漏
+  - 改进 `checkAndRefreshToken()` 方法，修复检查逻辑，确保即使 Token 过期也能正确刷新
+  - 优化超时错误处理，超时错误不再重试，避免不必要的重试操作
+  - 改进刷新 Promise 的错误处理，避免未处理的 Promise rejection
+  - 在 `setAuth()` 后立即检查 Token 状态，自动处理已过期的 Token
+
+### Fixed
+- 修复 AuthManager Token 刷新超时定时器未正确清理的问题，可能导致内存泄漏
+- 修复 `checkAndRefreshToken()` 方法在 Token 过期时无法正确触发刷新的问题
+- 修复 Token 刷新超时后仍会重试的问题，超时错误现在会立即抛出
+
+## [0.7.0] - 2026-01-10
+
+### Added
+- 新增 UserManager（用户管理器）模块，提供完整的用户管理能力：
+  - **用户信息管理**：
+    - 支持获取用户信息（`getUserInfo()` 方法）
+    - 支持更新用户信息（`updateUserInfo(info)` 方法）
+    - 支持用户信息缓存（内存缓存和状态管理缓存）
+    - 支持用户信息数据验证（`userInfoValidator` 配置项）
+    - 支持用户信息获取器（`userInfoFetcher` 配置项）
+    - 支持用户信息更新器（`userInfoUpdater` 配置项）
+  - **用户设置管理**：
+    - 支持获取用户设置（`getUserSettings()` 方法）
+    - 支持更新用户设置（`updateUserSettings(settings)` 方法）
+    - 支持用户设置持久化（使用 @vlian/framework Storage）
+    - 支持用户设置数据验证（`userSettingsValidator` 配置项）
+    - 支持用户设置获取器（`userSettingsFetcher` 配置项）
+    - 支持用户设置更新器（`userSettingsUpdater` 配置项）
+  - **数据同步**：
+    - 支持用户信息/设置同步到服务器
+    - 支持离线更新队列（`enableSyncQueue` 配置项）
+    - 支持同步重试机制（`syncRetryConfig` 配置项）
+    - 支持同步状态查询（`getSyncQueueStatus()` 方法）
+  - **缓存管理**：
+    - 支持用户信息内存缓存（`enableCache` 配置项）
+    - 支持用户设置持久化缓存
+    - 支持缓存失效机制（`cacheExpiry` 配置项）
+    - 支持缓存预热（`preloadUserInfo` 配置项）
+  - **状态管理集成**：
+    - 支持使用 @vlian/framework StateManager 进行跨组件共享（`stateManager` 配置项）
+    - 支持状态变化自动同步
+  - **事件系统**：
+    - 支持完整的事件系统（`UserEventType`），提供用户信息更新、用户设置更新、同步状态变化等事件
+    - 支持事件订阅和取消订阅
+  - **健康检查**：
+    - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、用户数据等组件健康度
+  - **性能监控**：
+    - 支持性能指标收集（`PerformanceMetrics` 类型），可追踪操作耗时和性能数据
+    - 支持性能统计（`getPerformanceStatistics()` 方法）
+  - **配置验证**：
+    - 支持配置验证（`ConfigValidationResult` 类型），验证配置完整性和正确性
+  - **环境适配**：
+    - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+  - **生产环境优化**：
+    - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义，完全泛型化，用户信息类型由用户定义
+- 新增用户管理方案设计文档（docs/用户管理/方案设计.md），提供完整的设计方案和技术细节
+- 新增用户管理 API 参考文档（docs/用户管理/API参考.md），提供完整的 API 文档
+- 新增用户管理使用手册（docs/用户管理/使用手册.md），提供详细的使用指南和最佳实践
+- 新增 UserTest 示例组件（example/vite/src/components/UserTest.tsx），演示 UserManager 的各种功能
+- 导出 UserManager 及相关类型定义到主入口文件（src/index.ts）：
+  - 导出 `UserManager` 类
+  - 导出 `UserEventType` 枚举
+  - 导出 `UserError`、`UserErrorCode` 错误类型
+  - 导出 `UserOptions`、`EventMetadata`、`EventListenerOptions`、`SyncQueueStatus`、`HealthCheckResult`、`PerformanceMetrics`、`ConfigValidationResult` 等类型
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 UserManager 和相关类型
+- 更新示例项目（example/vite/src/App.tsx），集成 UserTest 组件
+- 优化 AuthManager 代码结构，提升代码可读性和维护性
+- 更新模块开发计划文档（docs/模块开发计划.md），补充 UserManager 开发完成情况
+
+### Infrastructure
+- 完善 UserManager 模块结构，包含多个子模块：
+  - `CacheManager`：缓存管理模块
+  - `EnvironmentDetector`：环境检测模块
+  - `ErrorHandler`：错误处理模块
+  - `EventManager`：事件管理模块
+  - `PerformanceMonitor`：性能监控模块
+  - `QueueManager`：队列管理模块
+  - `StateManager`：状态管理模块
+  - `StorageManager`：存储管理模块
+  - `SyncManager`：同步管理模块
+  - `UserInfoManager`：用户信息管理模块
+  - `UserSettingsManager`：用户设置管理模块
+- 新增工具模块（utils/）：
+  - `DataManagerUtils`：数据管理工具
+  - `LoggingUtils`：日志工具
+  - `MonitoringUtils`：监控工具
+
+## [0.6.2] - 2026-01-10
+
+### Added
+- 新增权限管理 API 参考文档（docs/权限管理/API参考.md），提供完整的 API 文档，包含：
+  - PermissionManager 类的所有方法说明
+  - 完整的类型定义文档
+  - 事件类型说明
+  - 错误码参考
+- 新增权限管理使用手册（docs/权限管理/使用手册.md），提供详细的使用指南，包含：
+  - 快速开始指南
+  - 基础使用示例
+  - 高级功能说明
+  - 配置选项详解
+  - 最佳实践建议
+  - 常见问题解答
+  - 故障排查指南
+- 新增权限管理最佳实践文档（docs/权限管理/最佳实践.md），提供最佳实践指南，包含：
+  - 权限设计原则
+  - 性能优化建议
+  - 安全实践指南
+  - 错误处理策略
+  - 代码组织建议
+  - 测试策略
+  - 监控和运维建议
+
+### Changed
+- 更新权限管理方案设计文档（docs/权限管理/方案设计.md），补充和完善功能特性说明：
+  - 更新核心职责描述，补充新增功能（限流保护、审计日志、变更历史、多数据源、策略管理、中间件系统、插件系统、环境适配等）
+  - 更新架构图，补充新增模块
+  - 更新性能优化说明，补充 TTL 缓存、缓存统计、性能统计等功能
+  - 更新扩展能力说明，补充中间件优先级、插件系统、多数据源合并策略、限流策略等
+  - 更新健康检查说明，补充详细诊断和调试信息功能
+
+### Documentation
+- 完善权限管理模块文档体系，提供 API 参考、使用手册、最佳实践、方案设计等完整文档
+
+## [0.6.1] - 2026-01-10
+
+### Changed
+- PermissionManager 代码优化和重构：
+  - **统一类型声明**：创建 `types/framework.d.ts` 统一存放框架类型定义（`AppEventBus`、`Logger`、`MonitoringService`、`AuthManager`），消除 4 处重复的类型声明
+  - **合并性能监控模块**：将 `PerformanceStatisticsCollector` 的功能整合到 `PerformanceMonitor` 中，统一数据源，避免重复存储
+  - **统一缓存策略**：为 `permissionData` 和 `permissionTreeCache` 也使用 `CacheManager` 管理，统一所有缓存使用 TTL 机制
+  - **优化性能指标记录**：在 `recordPerformance` 方法开始就检查 `enableDetailedMetrics`，避免不必要的对象创建
+  - **统一配置验证逻辑**：将验证逻辑统一到 `configUtils.validateConfig()`，避免验证逻辑分散
+  - **提取重复代码**：提取 `updatePermissionDataCache()` 私有方法统一管理权限数据缓存更新
+  - **优化类型定义**：创建 `InternalPermissionOptions` 类型别名，提高类型定义可读性
+  - **修复批量检查逻辑**：移除 `hasPermissions()` 方法中无效的并发逻辑，简化代码
+
+### Fixed
+- 修复 `hasPermissions()` 方法中无效的 `Promise.all` 并发逻辑，由于 `hasPermission` 是同步方法，无需并发优化
+
+### Documentation
+- 新增权限管理代码优化分析报告（docs/权限管理/代码优化分析报告.md），详细分析代码优化点
+- 新增权限管理优化实施总结（docs/权限管理/优化实施总结.md），记录优化完成情况
+
+### Infrastructure
+- 新增 `src/managers/PermissionManager/types/framework.d.ts` 文件，统一管理框架类型定义
+- 优化 PermissionManager 模块结构，提升代码可维护性和可读性
+
+## [0.6.0] - 2026-01-10
+
+### Added
+- PermissionManager 全面优化和功能增强：
+  - **核心性能优化**：
+    - 新增缓存 TTL 机制（`cacheExpiry` 配置项），支持缓存过期时间设置
+    - 新增同步/异步模式：`hasPermission()`（同步）和 `hasPermissionAsync()`（异步）
+    - 新增批量检查并发优化（`enableConcurrentCheck` 配置项），提升批量检查性能
+  - **安全性增强**：
+    - 新增生产环境安全检查，自动检测并阻止不安全配置
+    - 新增权限检查限流功能（`rateLimit` 配置项），支持滑动窗口、令牌桶、固定窗口三种策略
+    - 新增安全错误码体系（`SECURITY_ERROR_400-401`）
+  - **用户体验优化**：
+    - 新增统一错误码体系（`CONFIG_ERROR`、`DATA_ERROR`、`CHECK_ERROR`、`STORAGE_ERROR`、`SECURITY_ERROR`）
+    - 新增权限状态变化事件（`PERMISSION_STATE_CHANGED`），权限数据变化时自动触发
+    - 权限检查结果包含失败原因（`no_data`、`denied`、`expired`、`rate_limited`、`error`）
+  - **开发者体验优化**：
+    - 新增配置预设功能（`preset` 配置项），提供 `production`、`development`、`minimal` 三种预设
+    - 新增调试工具（`getDebugInfo()` 方法），提供实例信息、配置信息、权限数据状态、缓存状态、性能统计、最近操作历史等调试信息
+  - **架构可演进性**：
+    - 新增策略模式支持（`checkStrategies` 配置项），支持自定义权限检查策略
+    - 新增插件系统（`plugins` 配置项），支持生命周期钩子扩展
+  - **扩展能力**：
+    - 新增中间件机制（`middlewares` 配置项），支持权限检查中间件
+    - 新增多数据源支持（`dataSources` 配置项），支持从多个数据源获取权限数据，支持并集、交集、优先级三种合并策略
+  - **配置体系优化**：
+    - 新增配置分组功能，配置按 `storage`、`security`、`performance`、`events` 分组
+  - **团队协作与治理**：
+    - 新增审计日志功能（`enableAuditLog` 配置项），记录所有权限相关操作
+    - 新增变更历史功能（`enableChangeHistory` 配置项），记录权限和角色的变更历史
+    - 新增 `getAuditLogs()` 和 `exportAuditLogs()` 方法
+    - 新增 `getChangeHistory()` 方法
+  - **跨环境适配**：
+    - 新增环境适配器（`environmentAdapter`），自动适配浏览器、Node.js、SSR、Worker 等环境
+    - 新增 SSR 支持，提供 `hydrate()` 方法用于数据水合
+  - **可观测性增强**：
+    - 新增性能统计功能（`getPerformanceStatistics()` 方法），提供调用次数、平均耗时、P95/P99 耗时、缓存命中率、错误率等指标
+    - 新增健康检查增强（`getHealthCheckDiagnostics()` 方法），提供详细的健康检查诊断信息
+- 新增权限管理优化功能说明文档（docs/权限管理/优化功能说明.md），详细说明所有优化功能和使用方法
+- 新增框架设计评估清单文档（docs/框架设计评估清单2.md）
+- 新增 PermissionTest 示例组件（example/vite/src/components/PermissionTest.tsx），演示 PermissionManager 的各种功能
+- 导出新增的类型定义到主入口文件（src/index.ts）：
+  - `PermissionCheckResult`、`PermissionCheckReason`、`PermissionError`、`PermissionErrorCode`
+  - `PermissionCheckStrategy`、`PermissionCheckMiddleware`、`PermissionPlugin`
+  - `PermissionDataSource`、`DataSourceMergeStrategy`、`PermissionConfigPreset`
+  - `PermissionAuditLog`、`PermissionChangeHistory`、`PermissionDebugInfo`
+  - `PerformanceStatistics`、`HealthCheckDiagnostics`、`EnvironmentAdapter`
+
+### Changed
+- 优化 PermissionManager 核心实现，重构代码结构，提升代码可读性和维护性
+- 优化 PermissionManager 类型定义，新增大量类型定义，提升类型安全性
+- 优化 PermissionManager 常量定义，新增错误码、配置预设等常量
+- 更新示例项目（example/vite/src/App.tsx），集成 PermissionTest 组件
+- 更新主入口文件（src/index.ts），导出所有新增的类型定义
+
+### Infrastructure
+- 完善 PermissionManager 模块结构，新增多个子模块：
+  - `AuditLogger`：审计日志模块
+  - `CacheManager`：缓存管理模块（支持 TTL）
+  - `ChangeHistory`：变更历史模块
+  - `DataSourceManager`：数据源管理模块
+  - `MiddlewareManager`：中间件管理模块
+  - `PerformanceStatistics`：性能统计模块
+  - `PluginManager`：插件管理模块
+  - `RateLimiter`：限流模块
+  - `StrategyManager`：策略管理模块
+- 新增 `configUtils.ts` 工具文件，提供配置处理工具函数
+
+## [0.5.1] - 2026-01-10
+
+### Fixed
+- 修复 AuthManager `isTokenExpired()` 方法：当没有认证数据时，正确返回 `true` 表示 Token 已过期
+- 修复 PermissionManager 初始化问题：确保 `authManager` 在构造函数中正确赋值
+- 修复 PermissionManager 权限数据恢复时的空值检查：增加对 `permissionData` 的空值判断，避免潜在的空指针异常
+- 优化 PermissionManager 加密数据处理逻辑：改进加密数据的类型处理，移除未使用的变量
+
+### Changed
+- 优化示例项目（example/vite/src/components/AuthTest.tsx）：简化代码结构，提升代码可读性和维护性
+
+## [0.5.0] - 2026-01-11
+
+### Added
+- 新增 PermissionManager（权限管理器）模块，提供完整的权限管理能力：
+  - 支持权限检查（`hasPermission(permission: string): boolean`）方法
+  - 支持角色检查（`hasRole(role: string): boolean`）方法
+  - 支持权限数据管理（`getPermissions()`、`getRoles()`、`setPermissions()`、`refresh()` 等方法）
+  - 支持权限树结构（`PermissionTree`），支持父子权限关系和权限继承
+  - 支持权限数据加密存储（`enableEncryption` 配置项），获取时自动解密
+  - 支持通配符匹配（`enableWildcardMatch` 配置项），支持直接匹配和递归匹配模式
+  - 支持权限数据缓存（`enableCache` 配置项），提升权限检查性能
+  - 支持权限数据来源配置（`permissionExtractor`、`permissionFetcher` 配置项）
+  - 支持状态管理集成（`stateManager` 配置项），使用 @vlian/framework StateManager 进行跨组件共享
+  - 支持完整的事件系统（`PermissionEventType`），提供权限加载、更新、刷新等事件
+  - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、权限数据等组件健康度
+  - 支持性能指标收集（`PerformanceMetrics` 类型），可追踪权限检查耗时和性能数据
+  - 支持配置验证（`ConfigValidationResult` 类型），验证配置完整性和正确性
+  - 支持生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 提供完整的 TypeScript 类型定义
+- 新增权限管理方案设计文档（docs/权限管理/方案设计.md），提供完整的设计方案和技术细节
+- 导出 PermissionManager 及相关类型定义到主入口文件（src/index.ts）
+
+### Changed
+- 更新主入口文件（src/index.ts），导出 PermissionManager 和相关类型：
+  - 导出 `PermissionManager` 类
+  - 导出 `PermissionEventType` 枚举
+  - 导出 `PermissionOptions`、`PermissionData`、`PermissionTree`、`PermissionTreeNode`、`PermissionTreeConfig` 等类型
+
+### Infrastructure
+- 完善 PermissionManager 模块结构（PermissionManager.ts、types.ts、constants.ts、index.ts）
+- 构建产物包含 PermissionManager 的完整实现
+
+## [0.4.2] - 2026-01-10
+
+### Added
+- 新增测试框架支持（Vitest），提供完整的单元测试能力
+- 新增测试目录（test/），包含 AuthManager 的完整测试用例
+- 新增测试配置文件（vitest.config.ts），配置测试环境和覆盖率要求
+- 新增测试辅助工具（test/helpers.ts），提供测试所需的 Mock 和工具函数
+- 新增测试脚本：
+  - `test`: 运行所有测试
+  - `test:watch`: 监听模式运行测试
+  - `test:coverage`: 运行测试并生成覆盖率报告
+
+### Changed
+- 更新模块开发计划文档（docs/模块开发计划.md），补充测试相关规划
+- 更新认证管理开发计划文档（docs/认证管理/开发计划.md），补充测试用例说明
+
+### Infrastructure
+- 添加 Vitest 和 @vitest/coverage-v8 到 devDependencies
+- 配置测试覆盖率阈值（80%），确保代码质量
+
+## [0.4.1] - 2026-01-09
+
+### Added
+- 新增认证管理 API 参考文档（docs/认证管理/API参考.md），提供完整的 API 文档
+- 新增认证管理使用手册（docs/认证管理/使用手册.md），提供详细的使用指南和最佳实践
+
+### Changed
+- 更新认证管理方案设计文档（docs/认证管理/方案设计.md），补充中间件支持、生命周期钩子等新功能特性说明
+
+### Documentation
+- 完善认证管理模块文档体系，提供 API 参考、使用手册、方案设计等完整文档
+
+## [0.4.0] - 2026-01-09
+
+### Added
+- AuthManager 高级功能扩展：
+  - 支持中间件机制（`middlewares` 配置项），可在认证操作前后执行自定义逻辑
+  - 支持生命周期钩子（`lifecycleHooks` 配置项），提供初始化、销毁等生命周期回调
+  - 支持环境自动检测（`Environment` 类型），自动识别浏览器、Node.js、SSR、Worker 等环境
+  - 支持健康检查功能（`healthCheck()` 方法），检查存储、事件总线、认证状态等组件健康度
+  - 支持性能指标收集（`PerformanceMetrics` 类型），可追踪操作耗时和性能数据
+  - 支持配置验证（`ConfigValidationResult` 类型），验证配置完整性和正确性
+  - 支持网络状态监听（`NetworkStatusListener` 类型），监听网络在线/离线状态
+  - 支持 Token 刷新重试机制（`RefreshRetryConfig` 配置项），可配置重试次数、延迟、退避策略
+  - 支持批量写入优化（`batchWriteDelay` 配置项），减少频繁的存储操作
+  - 支持智能调度（`useSmartScheduling` 配置项），优化 Token 刷新时机
+  - 支持详细性能指标（`enableDetailedMetrics` 配置项），收集详细的性能数据
+  - 支持链路追踪（`enableTracing` 配置项），为操作生成唯一追踪 ID
+- AuthManager 生产环境优化：
+  - 新增生产环境配置覆盖（`PRODUCTION_OVERRIDES`），自动应用生产环境最佳实践
+  - 新增存储和事件总线缓存机制，优化性能和减少重复初始化
+  - 支持从环境变量读取配置（`envPrefix` 配置项）
+  - 支持开发模式检测（`devMode` 配置项）
+- 新增类型导出：
+  - 导出 `Environment`、`HealthCheckResult`、`PerformanceMetrics` 等高级类型
+  - 导出 `ConfigValidationResult`、`RefreshRetryConfig`、`NetworkStatusListener` 等配置类型
+  - 导出 `LifecycleHooks`、`Middleware`、`MiddlewareContext` 等扩展类型
+
+### Changed
+- 优化 AuthManager 构造函数，增加环境检测和配置合并逻辑
+- 改进配置验证机制，提供更详细的验证结果和错误信息
+- 增强类型定义，新增多个高级类型和配置接口
+- 优化示例项目（example/vite），增加更多功能演示和测试用例
+- 更新认证管理文档，完善安全最佳实践和方案设计说明
+
+### Infrastructure
+- 完善 AuthManager 常量定义，新增生产环境配置覆盖和开发模式检测函数
+- 优化代码结构，增加缓存机制提升性能
+
+## [0.3.0] - 2024-12-19
+
+### Added
+- AuthManager 安全增强功能：
+  - 支持 Token 存储加密/解密（`encryptToken`、`decryptToken` 配置项）
+  - 支持错误信息脱敏（`errorSanitizer`、`sanitizeErrors` 配置项）
+  - 支持监控服务集成（`monitoring` 配置项，可集成 @vlian/framework 的 MonitoringService）
+- AuthManager 性能优化功能：
+  - 支持 Token 刷新超时控制（`refreshTimeout` 配置项，默认 30 秒）
+  - 支持页面可见性监听（`pauseRefreshOnHidden` 配置项，页面隐藏时自动暂停刷新）
+- 新增认证管理安全最佳实践文档（docs/认证管理/安全最佳实践.md）
+- 新增认证管理监控和日志集成分析文档（docs/认证管理/监控和日志集成分析.md）
+- 新增示例项目（example/）用于演示 AuthManager 的使用
+
+### Changed
+- 优化 AuthManager 错误处理机制，提供更完善的错误信息
+- 改进 Token 刷新逻辑，增加超时控制和页面可见性检测
+- 增强类型定义，新增 `EncryptFunction`、`DecryptFunction`、`ErrorSanitizer` 类型
+
+### Fixed
+- 修复加密/解密配置验证逻辑，确保配置完整性
+
+## [0.2.0] - 2024-12-19
+
+### Added
+- 新增 AuthManager（认证管理器）模块，提供完整的认证状态管理能力：
+  - 支持 Token 存储和管理（accessToken、refreshToken）
+  - 支持多种存储策略（localStorage、sessionStorage、内存存储）
+  - 支持 Token 自动刷新机制
+  - 支持泛型用户信息类型，完全由用户定义
+  - 提供完整的事件系统（登录、登出、Token 更新、状态变化等）
+  - 支持 Token 过期检测和处理
+  - 提供完整的 TypeScript 类型定义
+- 新增认证管理方案设计文档（docs/认证管理/方案设计.md）
+- 导出 AuthManager 及相关类型定义到主入口文件
+
+### Changed
+- 更新 @vlian/framework 依赖版本从 ^1.0.3 到 ^1.1.0
+- 将 @vlian/framework 添加到 devDependencies 中
+
+### Infrastructure
+- 完善 AuthManager 模块结构（AuthManager.ts、types.ts、constants.ts、index.ts）
+- 构建产物包含 AuthManager 的完整实现
+
+## [0.1.1] - 2024-12-19
+
+### Added
+- 添加项目文档目录（docs/）和文档规范
+- 添加各模块开发计划文档：
+  - 认证管理模块开发计划
+  - 权限管理模块开发计划
+  - 主题管理模块开发计划
+  - 用户管理模块开发计划
+  - 通知管理模块开发计划
+  - 数据字典模块开发计划
+  - 系统配置模块开发计划
+- 添加模块开发优先级规划文档
+- 添加模块开发计划文档
+
+### Changed
+- 更新 .cursorrules，添加文档目录规范和中文命名规范
+- 完善 .gitignore，添加更完整的忽略规则（IDE、操作系统、构建产物等）
+- 更新 package.json 中 @vlian/framework 的 peerDependencies 版本要求为 ^1.0.3
+
+### Documentation
+- 统一文档存放规范：所有项目文档存放在 `docs/` 目录下
+- 文档文件名使用中文命名规范
+
+## [0.1.0] - 2024-12-19
+
+### Added
+- 项目初始化
+- 基础项目结构配置
+- TypeScript 配置
+- SWC 构建配置（ESM 和 CJS 双格式输出）
+- 项目开发规则文档（.cursorrules）
+- 基础入口文件（src/index.ts）
+
+### Infrastructure
+- 配置 package.json，支持 ESM 和 CJS 双格式导出
+- 配置 TypeScript 编译选项
+- 配置 SWC 构建工具
+- 添加 .gitignore 和 .npmrc 配置文件