my-openlayer 2.4.8 → 2.4.10

package/CHANGELOG.md

@@ -1,9 +1,10 @@
 # Changelog
 
-## [2.4.8] - 2026-01-30
+## [2.4.10] - 2026-03-31
 
 ### ✨ Features
 
+- **TwinkleItem:** 支持自定义闪烁点DOM元素
 - **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
 - 重构Polygon样式处理并添加示例组件
 - **core:** 添加基于GeoJSON数据的地图定位功能
@@ -47,114 +48,17 @@
 
 ### 📝 Documentation
 
+- 更新技能文档的名称与描述
+- 添加技能文档系统并更新项目文档结构
 - add vitepress documentation and github actions workflow
 - 添加详细模块文档并更新发布配置
 - update README with branch strategy and add migration guide
 
-## [2.4.7] - 2026-01-30
-
-### ✨ Features
-
-- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
-- 重构Polygon样式处理并添加示例组件
-- **core:** 添加基于GeoJSON数据的地图定位功能
-- **core:** 添加地图定位功能并重构点位相关方法
-- **Point:** 添加闪烁点功能及示例
-- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
-- **Point:** 添加setOneVisibleByProp方法控制点显示
-- **Polygon:** 优化遮罩功能支持多几何图形处理
-- **测量工具:** 添加测量距离和面积功能及工具栏样式
-- **地图:** 添加自定义投影配置支持
-- **日志管理:** 实现统一日志开关与级别控制
-- **SelectHandler:** 新增要素选择处理器模块
-- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
-- update MapBaseLayers to handle optional token and improve annotation layer management
-- 重新添加已清理的App.vue文件，移除了所有敏感token信息
-- 重构Vue模板点位功能并优化事件管理
-- **Polygon:** 改进图像图层处理逻辑并添加更新功能
-- 添加验证工具类并重构现有验证逻辑
-- **地图工具:** 重构地图工具类并增强错误处理
-- 重构类型系统并增强核心功能
-
-### 🐛 Bug Fixes
-
-- **core:** 改进Vue依赖检测逻辑并更新版本号
-- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
-- **core:** 修正Line类中layerName属性设置错误
-- resolve TypeScript build error in MapBaseLayers.ts
-
-### ⚡ Performance
-
-- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
-
-### ♻️ Refactor
-
-- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
-- **ConfigManager:** 集中管理默认配置并移除无用接口
-- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
-- 将nameKey重命名为textKey以提高语义清晰度
-- 更新依赖项并优化类型导出结构
-- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
-
-### 📝 Documentation
-
-- 添加详细模块文档并更新发布配置
-- update README with branch strategy and add migration guide
-
-## [2.4.6] - 2026-01-30
-
-### ✨ Features
-
-- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
-- 重构Polygon样式处理并添加示例组件
-- **core:** 添加基于GeoJSON数据的地图定位功能
-- **core:** 添加地图定位功能并重构点位相关方法
-- **Point:** 添加闪烁点功能及示例
-- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
-- **Point:** 添加setOneVisibleByProp方法控制点显示
-- **Polygon:** 优化遮罩功能支持多几何图形处理
-- **测量工具:** 添加测量距离和面积功能及工具栏样式
-- **地图:** 添加自定义投影配置支持
-- **日志管理:** 实现统一日志开关与级别控制
-- **SelectHandler:** 新增要素选择处理器模块
-- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
-- update MapBaseLayers to handle optional token and improve annotation layer management
-- 重新添加已清理的App.vue文件，移除了所有敏感token信息
-- 重构Vue模板点位功能并优化事件管理
-- **Polygon:** 改进图像图层处理逻辑并添加更新功能
-- 添加验证工具类并重构现有验证逻辑
-- **地图工具:** 重构地图工具类并增强错误处理
-- 重构类型系统并增强核心功能
-
-### 🐛 Bug Fixes
-
-- **core:** 改进Vue依赖检测逻辑并更新版本号
-- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
-- **core:** 修正Line类中layerName属性设置错误
-- resolve TypeScript build error in MapBaseLayers.ts
-
-### ⚡ Performance
-
-- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
-
-### ♻️ Refactor
-
-- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
-- **ConfigManager:** 集中管理默认配置并移除无用接口
-- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
-- 将nameKey重命名为textKey以提高语义清晰度
-- 更新依赖项并优化类型导出结构
-- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
-
-### 📝 Documentation
-
-- 添加详细模块文档并更新发布配置
-- update README with branch strategy and add migration guide
-
-## [2.4.5] - 2026-01-30
+## [2.4.9] - 2026-03-05
 
 ### ✨ Features
 
+- **TwinkleItem:** 支持自定义闪烁点DOM元素
 - **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
 - 重构Polygon样式处理并添加示例组件
 - **core:** 添加基于GeoJSON数据的地图定位功能
@@ -198,11 +102,217 @@
 
 ### 📝 Documentation
 
+- 更新技能文档的名称与描述
+- 添加技能文档系统并更新项目文档结构
+- add vitepress documentation and github actions workflow
 - 添加详细模块文档并更新发布配置
 - update README with branch strategy and add migration guide
 
 # Changelog
 
+## [2.4.8] - 2026-01-30
+
+### ✨ Features
+
+- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
+- 重构Polygon样式处理并添加示例组件
+- **core:** 添加基于GeoJSON数据的地图定位功能
+- **core:** 添加地图定位功能并重构点位相关方法
+- **Point:** 添加闪烁点功能及示例
+- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
+- **Point:** 添加setOneVisibleByProp方法控制点显示
+- **Polygon:** 优化遮罩功能支持多几何图形处理
+- **测量工具:** 添加测量距离和面积功能及工具栏样式
+- **地图:** 添加自定义投影配置支持
+- **日志管理:** 实现统一日志开关与级别控制
+- **SelectHandler:** 新增要素选择处理器模块
+- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
+- update MapBaseLayers to handle optional token and improve annotation layer management
+- 重新添加已清理的App.vue文件，移除了所有敏感token信息
+- 重构Vue模板点位功能并优化事件管理
+- **Polygon:** 改进图像图层处理逻辑并添加更新功能
+- 添加验证工具类并重构现有验证逻辑
+- **地图工具:** 重构地图工具类并增强错误处理
+- 重构类型系统并增强核心功能
+
+### 🐛 Bug Fixes
+
+- **core:** 改进Vue依赖检测逻辑并更新版本号
+- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
+- **core:** 修正Line类中layerName属性设置错误
+- resolve TypeScript build error in MapBaseLayers.ts
+
+### ⚡ Performance
+
+- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
+
+### ♻️ Refactor
+
+- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
+- **ConfigManager:** 集中管理默认配置并移除无用接口
+- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
+- 将nameKey重命名为textKey以提高语义清晰度
+- 更新依赖项并优化类型导出结构
+- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
+
+### 📝 Documentation
+
+- add vitepress documentation and github actions workflow
+- 添加详细模块文档并更新发布配置
+- update README with branch strategy and add migration guide
+
+## [2.4.7] - 2026-01-30
+
+### ✨ Features
+
+- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
+- 重构Polygon样式处理并添加示例组件
+- **core:** 添加基于GeoJSON数据的地图定位功能
+- **core:** 添加地图定位功能并重构点位相关方法
+- **Point:** 添加闪烁点功能及示例
+- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
+- **Point:** 添加setOneVisibleByProp方法控制点显示
+- **Polygon:** 优化遮罩功能支持多几何图形处理
+- **测量工具:** 添加测量距离和面积功能及工具栏样式
+- **地图:** 添加自定义投影配置支持
+- **日志管理:** 实现统一日志开关与级别控制
+- **SelectHandler:** 新增要素选择处理器模块
+- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
+- update MapBaseLayers to handle optional token and improve annotation layer management
+- 重新添加已清理的App.vue文件，移除了所有敏感token信息
+- 重构Vue模板点位功能并优化事件管理
+- **Polygon:** 改进图像图层处理逻辑并添加更新功能
+- 添加验证工具类并重构现有验证逻辑
+- **地图工具:** 重构地图工具类并增强错误处理
+- 重构类型系统并增强核心功能
+
+### 🐛 Bug Fixes
+
+- **core:** 改进Vue依赖检测逻辑并更新版本号
+- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
+- **core:** 修正Line类中layerName属性设置错误
+- resolve TypeScript build error in MapBaseLayers.ts
+
+### ⚡ Performance
+
+- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
+
+### ♻️ Refactor
+
+- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
+- **ConfigManager:** 集中管理默认配置并移除无用接口
+- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
+- 将nameKey重命名为textKey以提高语义清晰度
+- 更新依赖项并优化类型导出结构
+- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
+
+### 📝 Documentation
+
+- 添加详细模块文档并更新发布配置
+- update README with branch strategy and add migration guide
+
+## [2.4.6] - 2026-01-30
+
+### ✨ Features
+
+- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
+- 重构Polygon样式处理并添加示例组件
+- **core:** 添加基于GeoJSON数据的地图定位功能
+- **core:** 添加地图定位功能并重构点位相关方法
+- **Point:** 添加闪烁点功能及示例
+- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
+- **Point:** 添加setOneVisibleByProp方法控制点显示
+- **Polygon:** 优化遮罩功能支持多几何图形处理
+- **测量工具:** 添加测量距离和面积功能及工具栏样式
+- **地图:** 添加自定义投影配置支持
+- **日志管理:** 实现统一日志开关与级别控制
+- **SelectHandler:** 新增要素选择处理器模块
+- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
+- update MapBaseLayers to handle optional token and improve annotation layer management
+- 重新添加已清理的App.vue文件，移除了所有敏感token信息
+- 重构Vue模板点位功能并优化事件管理
+- **Polygon:** 改进图像图层处理逻辑并添加更新功能
+- 添加验证工具类并重构现有验证逻辑
+- **地图工具:** 重构地图工具类并增强错误处理
+- 重构类型系统并增强核心功能
+
+### 🐛 Bug Fixes
+
+- **core:** 改进Vue依赖检测逻辑并更新版本号
+- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
+- **core:** 修正Line类中layerName属性设置错误
+- resolve TypeScript build error in MapBaseLayers.ts
+
+### ⚡ Performance
+
+- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
+
+### ♻️ Refactor
+
+- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
+- **ConfigManager:** 集中管理默认配置并移除无用接口
+- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
+- 将nameKey重命名为textKey以提高语义清晰度
+- 更新依赖项并优化类型导出结构
+- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
+
+### 📝 Documentation
+
+- 添加详细模块文档并更新发布配置
+- update README with branch strategy and add migration guide
+
+## [2.4.5] - 2026-01-30
+
+### ✨ Features
+
+- **SelectHandler:** 重构选择交互以支持独立样式渲染和多选隔离
+- 重构Polygon样式处理并添加示例组件
+- **core:** 添加基于GeoJSON数据的地图定位功能
+- **core:** 添加地图定位功能并重构点位相关方法
+- **Point:** 添加闪烁点功能及示例
+- **core:** 为Polygon添加layerName选项并调整图层添加逻辑
+- **Point:** 添加setOneVisibleByProp方法控制点显示
+- **Polygon:** 优化遮罩功能支持多几何图形处理
+- **测量工具:** 添加测量距离和面积功能及工具栏样式
+- **地图:** 添加自定义投影配置支持
+- **日志管理:** 实现统一日志开关与级别控制
+- **SelectHandler:** 新增要素选择处理器模块
+- upgrade OpenLayers to v10.6.1 and update project to v2.0.0
+- update MapBaseLayers to handle optional token and improve annotation layer management
+- 重新添加已清理的App.vue文件，移除了所有敏感token信息
+- 重构Vue模板点位功能并优化事件管理
+- **Polygon:** 改进图像图层处理逻辑并添加更新功能
+- 添加验证工具类并重构现有验证逻辑
+- **地图工具:** 重构地图工具类并增强错误处理
+- 重构类型系统并增强核心功能
+
+### 🐛 Bug Fixes
+
+- **core:** 改进Vue依赖检测逻辑并更新版本号
+- **VueTemplatePoint:** 修复Vue3环境下pointData的类型定义
+- **core:** 修正Line类中layerName属性设置错误
+- resolve TypeScript build error in MapBaseLayers.ts
+
+### ⚡ Performance
+
+- **Polygon:** 优化GeoJSON解析性能，直接注入layerName
+
+### ♻️ Refactor
+
+- **MapBaseLayers:** 重构图层管理逻辑，优化代码结构和可维护性
+- **ConfigManager:** 集中管理默认配置并移除无用接口
+- **样式处理:** 统一处理自定义样式逻辑并修复代码格式
+- 将nameKey重命名为textKey以提高语义清晰度
+- 更新依赖项并优化类型导出结构
+- **core:** 重构DomPoint和MapBaseLayers类，优化代码结构和功能
+
+### 📝 Documentation
+
+- 添加详细模块文档并更新发布配置
+- update README with branch strategy and add migration guide
+
+# Changelog
+
 ## [2.4.3] - 2026-01-27
 
 ### ✨ Features

package/MyOl.js

@@ -149,6 +149,8 @@ class MyOl {
      */
     static createView(options = MyOl.DefaultOptions) {
         try {
+            // 确保坐标系已注册（支持独立调用 createView 而不先实例化 MyOl）
+            MyOl.initializeProjections(options);
             const code = options.projection?.code ?? MyOl.PROJECTIONS.CGCS2000;
             const projection = new olProjProjection({
                 code,

package/README.md

@@ -1,156 +1,156 @@
-# my-openlayer
-
-my-openlayer 是一个基于 [OpenLayers](https://openlayers.org/) 的现代地图组件库，专为 Web GIS 应用开发者设计。提供完整的 TypeScript 支持、模块化的类型定义、强大的错误处理和事件管理系统，支持天地图底图加载、要素绘制、图层管理、事件监听等丰富功能，极大提升地图开发效率。
-
-[![npm version](https://img.shields.io/npm/v/my-openlayer.svg)](https://www.npmjs.com/package/my-openlayer)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
----
-
-## 项目概述
-
-- **项目名称**：`my-openlayer`
-- **用途**：基于 OpenLayers 的 TypeScript 地图组件库，提供点/线/面要素、底图切换、热力图、事件与配置管理等能力。
-- **目标用户**：Web GIS 开发者、可视化工程师、前端开发者
-
-## 功能亮点
-
-- **🗺️ 底图管理 (MapBaseLayers)**
-  - 支持天地图矢量、影像、地形底图切换
-  - 动态切换底图与注记图层管理
-  - 地图裁剪与自定义范围显示
-  - 支持 GeoServer WMS 图层
-
-- **📍 要素操作**
-  - **点位管理 (Point)**：点位标注（自定义图标、聚合、闪烁）
-  - **线要素绘制 (Line)**：线要素绘制（虚线、样式自定义）
-  - **面要素 (Polygon)**：面要素绘制、分区高亮、遮罩层
-  - **Vue组件支持 (VueTemplatePoint)**：支持将 Vue 组件作为地图点位渲染
-  - **河流图层 (RiverLayerManager)**：支持分级显示的河流图层管理
-
-- **🛠️ 地图工具**
-  - **测量工具 (MeasureHandler)**：距离和面积测量
-  - **要素选择 (SelectHandler)**：支持点击、悬停、多选等交互选择
-  - **地图工具 (MapTools)**：图层管理、定位、视图自适应
-  - **事件管理 (EventManager)**：统一的地图事件监听与管理
-
-- **⚡ 高级特性**
-  - **TypeScript 完全支持**：提供完整的类型定义
-  - **错误处理 (ErrorHandler)**：统一的错误捕获与日志
-  - **配置管理 (ConfigManager)**：集中管理默认配置
-  - **坐标系支持**：内置 CGCS2000 坐标系支持
-
-## 安装
-
-```bash
-npm install my-openlayer
-# 或
-yarn add my-openlayer
-# 或
-pnpm add my-openlayer
-```
-
-### 依赖要求
-
-- **Node.js**: >= 18
-- **OpenLayers**: ^10.6.1
-- **proj4**: ^2.7.5
-- **@turf/turf**: ^7.2.0
-
-## 快速上手
-
-### 1. 初始化地图
-
-```typescript
-import MyOl, { MapInitType } from 'my-openlayer';
-
-const mapConfig: MapInitType = {
-  center: [119.81, 29.969],
-  zoom: 10,
-  token: import.meta.env.VITE_TIANDITU_TOKEN, // 天地图 Token
-  annotation: true
-};
-
-const map = new MyOl('map-container', mapConfig);
-```
-
-### 2. 使用功能模块
-
-```typescript
-// 获取模块实例
-const point = map.getPoint();
-const line = map.getLine();
-const polygon = map.getPolygon();
-
-// 添加点位
-point.addPoint([{ lgtd: 119.81, lttd: 29.969, name: '示例点' }], {
-  layerName: 'example-point',
-  img: 'marker.png'
-});
-```
-
-## 文档索引
-
-为了提供更详细的说明，我们将文档拆分为独立的模块文件：
-
-### 核心类库
-- **[MyOl](docs/MyOl.md)**: 地图入口类，负责初始化和模块访问。
-- **[MapBaseLayers](docs/MapBaseLayers.md)**: 底图与注记管理。
-- **[ConfigManager](docs/ConfigManager.md)**: 配置管理。
-- **[EventManager](docs/EventManager.md)**: 事件管理。
-- **[ErrorHandler](docs/ErrorHandler.md)**: 错误处理。
-
-### 要素操作
-- **[Point](docs/Point.md)**: 点要素（含聚合、DOM点位）。
-- **[Line](docs/Line.md)**: 线要素。
-- **[Polygon](docs/Polygon.md)**: 面要素（含热力图、图片层）。
-- **[VueTemplatePoint](docs/VueTemplatePoint.md)**: Vue 组件点位。
-- **[RiverLayerManager](docs/RiverLayerManager.md)**: 河流图层管理。
-
-### 交互与工具
-- **[SelectHandler](docs/SelectHandler.md)**: 要素选择交互（支持独立样式渲染、多选隔离）。
-- **[MeasureHandler](docs/MeasureHandler.md)**: 测量工具。
-- **[MapTools](docs/MapTools.md)**: 通用地图工具。
-- **[ValidationUtils](docs/ValidationUtils.md)**: 验证工具。
-
-## 详细用法示例
-
-### 底图切换
-
-```typescript
-const baseLayers = map.getMapBaseLayers();
-baseLayers.switchBaseLayer('img_c'); // 切换到影像底图
-```
-
-### 测量工具
-
-```typescript
-import { MeasureHandler } from 'my-openlayer';
-
-// 需要传入原生的 OpenLayers map 实例
-const measure = new MeasureHandler(map.map);
-
-measure.start('LineString'); // 开始测距
-measure.end(); // 结束测量
-```
-
-> 注意：部分高级功能（如 SelectHandler）可以通过 `map.getSelectHandler()` 访问。
-
-## 贡献指南
-
-欢迎提交 Issue 或 Pull Request！
-
-1. Fork 本仓库
-2. 新建分支：`git checkout -b feature/your-feature`
-3. 提交更改：`git commit -m 'feat: 新功能描述'`
-4. 推送分支：`git push origin feature/your-feature`
-5. 提交 Pull Request
-
-## 许可证
-
-[MIT](LICENSE)
-
----
-
-**联系方式**: 2364184627@qq.com | [GitHub Issues](https://github.com/cuteyuchen/my-openlayer/issues)
+# my-openlayer
+
+my-openlayer 是一个基于 [OpenLayers](https://openlayers.org/) 的现代地图组件库，专为 Web GIS 应用开发者设计。提供完整的 TypeScript 支持、模块化的类型定义、强大的错误处理和事件管理系统，支持天地图底图加载、要素绘制、图层管理、事件监听等丰富功能，极大提升地图开发效率。
+
+[![npm version](https://img.shields.io/npm/v/my-openlayer.svg)](https://www.npmjs.com/package/my-openlayer)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 项目概述
+
+- **项目名称**：`my-openlayer`
+- **用途**：基于 OpenLayers 的 TypeScript 地图组件库，提供点/线/面要素、底图切换、热力图、事件与配置管理等能力。
+- **目标用户**：Web GIS 开发者、可视化工程师、前端开发者
+
+## 功能亮点
+
+- **🗺️ 底图管理 (MapBaseLayers)**
+  - 支持天地图矢量、影像、地形底图切换
+  - 动态切换底图与注记图层管理
+  - 地图裁剪与自定义范围显示
+  - 支持 GeoServer WMS 图层
+
+- **📍 要素操作**
+  - **点位管理 (Point)**：点位标注（自定义图标、聚合、闪烁）
+  - **线要素绘制 (Line)**：线要素绘制（虚线、样式自定义）
+  - **面要素 (Polygon)**：面要素绘制、分区高亮、遮罩层
+  - **Vue组件支持 (VueTemplatePoint)**：支持将 Vue 组件作为地图点位渲染
+  - **河流图层 (RiverLayerManager)**：支持分级显示的河流图层管理
+
+- **🛠️ 地图工具**
+  - **测量工具 (MeasureHandler)**：距离和面积测量
+  - **要素选择 (SelectHandler)**：支持点击、悬停、多选等交互选择
+  - **地图工具 (MapTools)**：图层管理、定位、视图自适应
+  - **事件管理 (EventManager)**：统一的地图事件监听与管理
+
+- **⚡ 高级特性**
+  - **TypeScript 完全支持**：提供完整的类型定义
+  - **错误处理 (ErrorHandler)**：统一的错误捕获与日志
+  - **配置管理 (ConfigManager)**：集中管理默认配置
+  - **坐标系支持**：内置 CGCS2000 坐标系支持
+
+## 安装
+
+```bash
+npm install my-openlayer
+# 或
+yarn add my-openlayer
+# 或
+pnpm add my-openlayer
+```
+
+### 依赖要求
+
+- **Node.js**: >= 18
+- **OpenLayers**: ^10.6.1
+- **proj4**: ^2.7.5
+- **@turf/turf**: ^7.2.0
+
+## 快速上手
+
+### 1. 初始化地图
+
+```typescript
+import MyOl, { MapInitType } from 'my-openlayer';
+
+const mapConfig: MapInitType = {
+  center: [119.81, 29.969],
+  zoom: 10,
+  token: import.meta.env.VITE_TIANDITU_TOKEN, // 天地图 Token
+  annotation: true
+};
+
+const map = new MyOl('map-container', mapConfig);
+```
+
+### 2. 使用功能模块
+
+```typescript
+// 获取模块实例
+const point = map.getPoint();
+const line = map.getLine();
+const polygon = map.getPolygon();
+
+// 添加点位
+point.addPoint([{ lgtd: 119.81, lttd: 29.969, name: '示例点' }], {
+  layerName: 'example-point',
+  img: 'marker.png'
+});
+```
+
+## 文档索引
+
+为了提供更详细的说明，我们将文档拆分为独立的模块文件：
+
+### 核心类库
+- **[MyOl](docs/MyOl.md)**: 地图入口类，负责初始化和模块访问。
+- **[MapBaseLayers](docs/MapBaseLayers.md)**: 底图与注记管理。
+- **[ConfigManager](docs/ConfigManager.md)**: 配置管理。
+- **[EventManager](docs/EventManager.md)**: 事件管理。
+- **[ErrorHandler](docs/ErrorHandler.md)**: 错误处理。
+
+### 要素操作
+- **[Point](docs/Point.md)**: 点要素（含聚合、DOM点位）。
+- **[Line](docs/Line.md)**: 线要素。
+- **[Polygon](docs/Polygon.md)**: 面要素（含热力图、图片层）。
+- **[VueTemplatePoint](docs/VueTemplatePoint.md)**: Vue 组件点位。
+- **[RiverLayerManager](docs/RiverLayerManager.md)**: 河流图层管理。
+
+### 交互与工具
+- **[SelectHandler](docs/SelectHandler.md)**: 要素选择交互（支持独立样式渲染、多选隔离）。
+- **[MeasureHandler](docs/MeasureHandler.md)**: 测量工具。
+- **[MapTools](docs/MapTools.md)**: 通用地图工具。
+- **[ValidationUtils](docs/ValidationUtils.md)**: 验证工具。
+
+## 详细用法示例
+
+### 底图切换
+
+```typescript
+const baseLayers = map.getMapBaseLayers();
+baseLayers.switchBaseLayer('img_c'); // 切换到影像底图
+```
+
+### 测量工具
+
+```typescript
+import { MeasureHandler } from 'my-openlayer';
+
+// 需要传入原生的 OpenLayers map 实例
+const measure = new MeasureHandler(map.map);
+
+measure.start('LineString'); // 开始测距
+measure.end(); // 结束测量
+```
+
+> 注意：部分高级功能（如 SelectHandler）可以通过 `map.getSelectHandler()` 访问。
+
+## 贡献指南
+
+欢迎提交 Issue 或 Pull Request！
+
+1. Fork 本仓库
+2. 新建分支：`git checkout -b feature/your-feature`
+3. 提交更改：`git commit -m 'feat: 新功能描述'`
+4. 推送分支：`git push origin feature/your-feature`
+5. 提交 Pull Request
+
+## 许可证
+
+[MIT](LICENSE)
+
+---
+
+**联系方式**: 2364184627@qq.com | [GitHub Issues](https://github.com/cuteyuchen/my-openlayer/issues)