SpatialHarness

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

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

✨ 核心特性

🌐 在线演示

无需安装，直接打开 https://gistudio.github.io/SpatialHarness/（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 / 天地图中国标准地图数据，单文件 < 2 MB）与场景注册表： 世界人口分级设色、按中国标准地图绘制的中国省级行政区（藏南在中国内、含台湾/港澳/南海诸岛/九段线）、世界城市、全球地震 CSV 监测、OSM 在线底图叠加、土地利用样例、一键自动制图。 场景目录、效果图与数据许可见 demo/README.md；效果图可用 scripts/capture_demos.py 自动复现。

📦 支持的格式

坐标系：内置 CGCS2000 / 西安80 / 北京54 常用带号 + .prj WKT 解析，导入时统一归一化到 EPSG:4326，原始坐标系保留在图层元信息。

🏗️ 架构一览

UI 层（React 组件）            → Toolbar / LayerPanel / AttributeTable / StylePanel / AnalysisPanel
状态管理层（zustand）           → project / selection / ui / history + engineBridge + persistence
核心层（core，引擎无关）        → engine接口 / layers模型 / style规范 / crs / datasource / analysis / storage
引擎适配层（engine/ol）        → OpenLayers v1（未来可插拔 MapLibre 等）

详细设计见 docs/ARCHITECTURE.md。

🧪 验证

• 单元测试：Web 端 73 例（存储双轨往返、手写二进制 Shapefile fixture、Shapefile / GeoPackage 导出→导入往返（含中文属性/面孔体/混合几何）、GPX 导出结构、turf 空间分析含多要素叠加语义、WKT 解析、分级/色带/图例自动化）+ MCP 端 27 例
• 冒烟测试：scripts/smoke_test.py（Playwright）覆盖完整用户旅程：新建工程 → 导入 → 自动保存 → 识别 → 样式 → Shapefile/GPX/GeoPackage 导出下载 → 分析 → 绘制 → 撤销/重做 → 刷新恢复 → GeoPackage 导入回环

🤖 AI 可操作性（MCP）

SpatialHarness 以 MCP 服务器形式暴露给 AI 客户端（DeepSeek Harness / Claude Code / Codex 等）： 空间分析（缓冲区/相交/联合/差集/裁剪/融合/质心/统计）与矢量数据解析（GeoJSON/Shapefile/KML/GPX/CSV）全部可被模型直接调用，逻辑与 Web 端同源（src/core）。

pnpm --filter @spatial-harness/mcp-server build   # 生成 mcp/dist/server.cjs

接入 DeepSeek Harness：在 cordis.yml 注册 @deepseek-ai/dsh-mcp-client 插件（stdio，command: node，args: [<仓库>/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