GeoLibre架构全景npm monorepo目录结构与7大包职责拆解【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibreGeoLibre 是一款开源、轻量、云原生的 GIS 平台支持在浏览器、桌面、移动端和 Jupyter Notebook 中可视化、探索和分析地理空间数据。它的整个前端世界都装在一个 npm monorepo 里顶层package.json通过 workspaces 把apps/*、packages/*、workers/*三类子项目串成一条依赖链 。本文带你快速看懂这个 monorepo 的目录结构以及 7 个核心包的职责边界。一、monorepo 顶层目录谁负责什么先看仓库根目录的分工一眼定位代码在哪目录职责apps/geolibre-desktop/唯一的应用壳React 入口、Tauri 桌面层Rust、Vite 配置与 PWA 构建packages/7 个共享包本文主角承载领域逻辑workers/5 个 Cloudflare Workerviewer、tiles、collab、ai-proxy、collab-nodebackend/Python FastAPI sidecar格式转换、栅格工具、SQL 引擎python/Jupyter 集成包geolibrePython API 与组件scripts/构建与 CI 脚本打补丁、生成 i18n 目录、扫描凭据e2e/tests/Playwright 端到端用例与 Node 原生单测400 个测试文件docs/MkDocs 站点源码含本文依据的架构文档workspace 声明见 package.jsonworkspaces: [apps/*, packages/*, workers/*]也就是说app 只是壳能力全部沉淀在 packages 里这正是 monorepo 最大的价值——同一份代码同时喂给 Web、桌面、移动端和嵌入式构建。二、7 大核心包职责拆解packages/下共 7 个包规模从 1 个文件到 160 个文件不等职责如下包名文件量级一句话职责geolibre/core58 个 TS领域类型、项目 JSON Schema、全局 Zustand 状态仓库geolibre/map70 个 TS/TSXMapLibre 生命周期、图层同步以及 Cesium 3D 地球引擎geolibre/plugins164 个文件插件接口 120 余个内置插件最大的包geolibre/processing32 个 TS客户端地理处理算法注册表Turf WASMgeolibre/ui19 个文件shadcn 风格共享 UI 组件Radix Tailwindgeolibre/embed1 个 TS无依赖的 iframe 嵌入 API 类型化客户端独立发布到 npmgeolibre/collab-core6 个 TS实时协作协议与评论校验的纯逻辑内核1.geolibre/core全仓库的大脑它是所有其他包的依赖底座存放GeoLibreLayer图层记录、MapViewState、项目文件.geolibre的读写以及一个约 2800 行的 Zustand store见 store.ts。关键点store 是渲染引擎无关的——里面只有纯数据没有 MapLibre 对象所以 2D 地图和 3D 地球才能订阅同一份状态并随时切换。2.geolibre/map渲染层双子星这个包封装了 maplibre-gl 的图层同步MapController.syncLayers同时内建整套 CesiumJS 3D 地球相机换算cesium-camera.ts、图层镜像cesium-layer-sync.ts、点云与 3D Tiles 样式。它还提供headless子入口让没有地图画布的场景如打印、截图也能复用图层同步逻辑。3.geolibre/plugins功能扩展面内置插件目录 plugins/src/plugins 下有 120 个模块覆盖 ArcGIS、Earth Engine、Planetary Computer、deck.gl 可视化、时间滑块、AI 助手工具注册表等。插件统一声明自己支持的渲染引擎即可在 2D/3D 双引擎间自动切换。4.geolibre/processing浏览器里的工具箱基于 Turf.js 与geolibre-wasmWhitebox 等 1000 工具的客户端算法注册表registry.ts支持本地 WASM 引擎与可选 Python sidecar 双通道数据不出本机。5–7.ui/embed/collab-core小而专uiDialog、Dropdown、Tabs 等 Radix 组件封装全 app 共享一套视觉语言embed单个 TS 文件发布为独立 npm 包让第三方网站能用类型安全的方式向 iframe 里的 GeoLibre 发消息collab-core纯协议层被workers/collab与workers/collab-node两个部署形态复用保证消息格式只有一份真源。三、apps 与 workers入口和边缘apps/geolibre-desktop/src/只做组合App.tsx挂载布局components/panels/放图层面板、样式管理器等Tauri 命令在src-tauri/的 Rust 侧处理文件 I/O。workers/则是部署在边缘的 5 个独立小服务共享链接渲染viewer、瓦片服务tiles、协作信令collab / collab-node、AI 代理ai-proxy。它们与 packages 共享 core 的类型接口天然对齐。四、一次添加数据的完整数据流把 7 个包的协作串起来看就通了用户在添加数据菜单或拖拽放入矢量文件apps 层入口DuckDB-WASM Spatial 将其转成 GeoJSON写入geolibre/core的 storegeolibre/map的MapCanvas订阅layersMapController.syncLayers把变更落到 MapLibre 源与图层上属性表、样式面板的编辑继续改 store地图同步更新画笔、可见性与顺序保存时projectFromStore序列化出.geolibre项目文件。这条单向状态流store → 渲染器是整个架构最值得借鉴的设计 。五、延伸阅读官方架构文档docs/architecture.md含 DuckDB、Cesium、离线 PWA 的深度说明各包清单与状态流docs/architecture.md#packages桌面端 Tauri 配置apps/geolibre-desktop/src-tauri/Python 侧 Jupyter 集成python/src/geolibre掌握了core 管状态、map 管渲染、plugins 管扩展、processing 管算法这条主线再深入任何一个包都不会迷路。【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
