GIStudio/SpatialHarness

SpatialHarness

纯本地 WebGIS 工作台 —— 把桌面 GIS 装进浏览器。
模仿 QGIS 交互范式、采用通用 GIS 数据格式、现代化组件化架构。

CI
GitHub Pages
License: MIT
TypeScript

本地优先：数据全部保存在你自己的电脑上（磁盘文件夹或浏览器工作区），不经过任何服务器；
计算下发：格式解析与空间分析运行在 Web Worker，主线程不卡顿；
自动保存：所有操作自动保存，关闭浏览器也不丢失。

✨ 核心特性

| 特性 | 说明 |
|---|---|
| 🗂️ 数据本地化 | File System Access API 直接读写本地磁盘文件夹（工程文件 + 数据文件）；IndexedDB 作为浏览器内持久层，全浏览器可用 |
| ⚙️ 计算下发 | 数据解析与空间分析全部运行在 Web Worker（comlink），主线程不卡顿 |
| 💾 自动保存 | 任意变更 1.2s 防抖自动保存（双轨：IndexedDB 必写 + 磁盘尽力写），重启浏览器自动恢复 |
| 🧩 引擎可插拔 | 引擎抽象层为核心（MapEngine 接口 + 注册表），OpenLayers 为 v1 实现；未来可注册 MapLibre GL 等新引擎，UI 零改动 |
| 🎨 QGIS 风格符号化 | 单一符号 / 分类符号 / 渐变符号 + 标注，实时预览 |
| 🧭 自动制图 | 分级方法（等距/分位数/Jenks 自然间断点）+ 制图色带库（顺序/发散/定性，插值与反转）+ 一键自动符号化；图例自动生成，地图浮层与导出图一致 |
| 🌐 在线底图 | OpenStreetMap / Carto 浅色 / Carto 深色（CORS 友好），无底图纯本地模式为默认 |
| 🖼️ PNG 导出 | 当前视图一键导出 PNG：图题 + 自动图例 + 底图版权合成，支持 2x 高清 |
| ✨ 标准示例库 | 内置 7 个 demo 场景（开源数据 + 自动符号化 + 底图 + 视图）一键载入，见 demo/README.md |
| 📊 属性表 | 虚拟滚动大表、排序、筛选、单元格直接编辑、与地图选择联动 |
| 🔬 空间分析工具箱 | 缓冲区 / 相交 / 联合 / 差集 / 裁剪 / 融合 / 质心 / 字段统计 / 图层统计 / 外包矩形 |
| ✏️ 编辑与绘制 | 绘制点线面、顶点编辑、属性编辑，支持撤销/重做（命令模式） |

🌐 在线演示

无需安装，直接打开 ***（GitHub Pages 部署，main 分支推送自动更新）。
纯前端静态托管：示例数据与 WASM 运行时均从 Pages 加载，数据操作仍全部留在本地浏览器。

提示：File System Access API 在部分浏览器/隐私模式下不可用，此时 IndexedDB 工作区仍可完整使用。

🚀 快速开始

pnpm install
pnpm dev          # http://localhost:5173 （推荐 Chrome / Edge）

pnpm test         # 单元测试（vitest）
pnpm build        # 类型检查 + 生产构建

首次使用：点击「新建工程」→ 可选「选择文件夹」作为磁盘保存位置 → 用「导入文件」或「打开数据文件夹」加载你的 GIS 数据；或直接打开「示例库」体验 7 个标准 demo 场景（也可访问 http://localhost:5173/?demo=world-population 直达）。

✨ 标准 demo

demo/ 内置轻量开源数据（Natural Earth / USGS / 天地图中国标准地图数据，单文件 /mcp/dist/server.cjs]）。
完整说明与工具清单见 docs/dsh-integration.md。

🤝 贡献

欢迎 PR。开发约定：

- 业务逻辑只依赖 src/core/ 的引擎无关契约，禁止在 UI 层 import ol
- 所有计算放入 src/core//worker.ts，主线程只调 service
- 提交前保证：pnpm exec tsc -b --noEmit 零错误、pnpm test 全绿、pnpm build 成功

🗺️ 路线图

- 引擎：MapLibre GL 适配器、Cesium 3D
- 格式：GeoPackage 瓦片表、gdal3.js WASM 栅格处理
- 分析：网络分析、栅格计算器、热力图
- 制图：打印布局（PNG 导出已实现：图题/图例/版权合成，1x/2x）

📄 License

MIT © GIStudio