@caoguo/maplibre-ai 0.0.1 → 0.0.2

package/README.md

@@ -0,0 +1,83 @@
+# @caoguo/maplibre-ai
+
+> 草果地图 AI 工具链 — 性能诊断 / 样式生成器 v2
+
+[![npm version](https://img.shields.io/npm/v/@caoguo/maplibre-ai.svg)](https://www.npmjs.com/package/@caoguo/maplibre-ai)
+[![license](https://img.shields.io/npm/l/@caoguo/maplibre-ai.svg)](LICENSE)
+
+## 安装
+
+```bash
+npm install @caoguo/maplibre-ai
+```
+
+## 功能模块
+
+| 模块 | 导出 | 说明 |
+|------|------|------|
+| 诊断 | `aiDebug` | AI Debug 诊断工具（性能 Profiler / 瓦片监控 / 内存泄漏 / 优化建议） |
+| 样式生成 | `styleGenerator` | 样式生成器 v2（色板提取 / 行业模板 / 品牌定制 / 运营商主题 / 昼夜切换） |
+
+## 快速开始
+
+### 性能诊断
+
+```ts
+import { aiDebug } from '@caoguo/maplibre-ai/debug';
+
+// 在地图实例上启动性能 Profiler
+const profiler = aiDebug.startProfiler(map.instance, {
+  tileMonitor: true,   // 瓦片加载耗时监控
+  memoryLeak: true,    // 内存泄漏检测
+  fpsSampleHz: 10,
+});
+
+// 结束诊断获取报告
+const report = profiler.stop();
+console.log('平均 FPS', report.avgFps);
+console.log('瓦片加载 P95', report.tileLoadP95);
+console.log('优化建议', report.suggestions);
+```
+
+### 样式生成器 v2
+
+```ts
+import { styleGenerator } from '@caoguo/maplibre-ai/stylegen';
+
+// 从品牌色板生成完整 MapLibre 样式
+const style = await styleGenerator.fromPalette({
+  brandColors: ['#0a0e1a', '#4a9eff', '#e8edf3'],
+  theme: 'dark',
+  industry: 'pipeline',   // 管网/电网/水网 等行业模板
+  notoFonts: true,
+});
+
+// 从图片提取色板再生成
+const palette = await styleGenerator.extractPalette('/path/to/logo.png');
+const style2 = await styleGenerator.fromPalette({ brandColors: palette });
+```
+
+### 运营商/昼夜主题
+
+```ts
+import { styleGenerator } from '@caoguo/maplibre-ai/stylegen';
+
+const dayTheme = styleGenerator.operatorTheme('china-mobile', 'day');
+const nightTheme = styleGenerator.operatorTheme('china-mobile', 'night');
+```
+
+## 设计原则
+
+1. **AI 增强，非 AI 替代**：诊断与样式生成加速开发流程，不替代工程师判断。
+2. **本地优先**：所有工具优先在前端运行，不依赖外部 LLM（可选项）。
+3. **可解释**：所有诊断建议附原因与修复方案链接。
+
+## 浏览器 / 环境要求
+
+- 现代浏览器（Chrome 90+）
+- 样式生成器需支持 `OffscreenCanvas`（Chrome 69+）
+- 核心模块在 Node.js 可测（已含 16 个 vitest 用例）
+
+## 许可
+
+Apache-2.0

package/package.json

@@ -1,7 +1,30 @@
 {
   "name": "@caoguo/maplibre-ai",
-  "version": "0.0.1",
-  "description": "草果地图 AI 工具链 - AI Debug 诊断 + 样式生成器 v2",
+  "version": "0.0.2",
+  "description": "草果地图 AI 工具链 - 性能诊断 / 样式生成器 v2",
+  "license": "Apache-2.0",
+  "author": "caoguo <caoguo@hb.cn>",
+  "homepage": "https://github.com/caoguo/map/blob/main/packages/ai/README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caoguo/map.git",
+    "directory": "packages/ai"
+  },
+  "bugs": {
+    "url": "https://github.com/caoguo/map/issues"
+  },
+  "keywords": [
+    "maplibre",
+    "caoguo",
+    "gis",
+    "ai",
+    "performance-profiler",
+    "tile-monitor",
+    "memory-leak",
+    "style-generator",
+    "palette-extraction",
+    "industry-template"
+  ],
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,7 +50,7 @@
     "dist"
   ],
   "dependencies": {
-    "@caoguo/theme": "0.0.1"
+    "@caoguo/theme": "0.0.2"
   },
   "publishConfig": {
     "access": "public",