@dsh-gis/dsh-opengis-skill 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +33 -19
  3. package/adaptations/brutile.md +6 -6
  4. package/adaptations/cesiumjs.md +6 -6
  5. package/adaptations/common.md +16 -13
  6. package/adaptations/deck-gl.md +6 -6
  7. package/adaptations/duckdb-spatial.md +6 -6
  8. package/adaptations/gdal-api.md +6 -6
  9. package/adaptations/gdal.md +6 -6
  10. package/adaptations/geolibre.md +6 -6
  11. package/adaptations/geometry-api-java.md +6 -6
  12. package/adaptations/geometry-api-net.md +6 -6
  13. package/adaptations/geonode.md +6 -6
  14. package/adaptations/geopandas.md +6 -6
  15. package/adaptations/geopipe-agent.md +6 -6
  16. package/adaptations/geoserver-cloud.md +6 -6
  17. package/adaptations/geoserver-rest-api.md +6 -6
  18. package/adaptations/geoserver.md +6 -6
  19. package/adaptations/geotools.md +6 -6
  20. package/adaptations/grass-gis.md +6 -6
  21. package/adaptations/jts.md +6 -6
  22. package/adaptations/kepler-gl.md +6 -6
  23. package/adaptations/leaflet.md +6 -6
  24. package/adaptations/mapbox-gl-js.md +6 -6
  25. package/adaptations/mapserver.md +6 -6
  26. package/adaptations/mapsui.md +6 -6
  27. package/adaptations/nettopologysuite.md +6 -6
  28. package/adaptations/opengis-all.md +7 -6
  29. package/adaptations/opengis-daf.md +7 -6
  30. package/adaptations/opengis-utils-for-java.md +6 -6
  31. package/adaptations/opengis-utils-for-net.md +6 -6
  32. package/adaptations/openlayers.md +6 -6
  33. package/adaptations/pdal.md +6 -6
  34. package/adaptations/postgis.md +6 -6
  35. package/adaptations/proj.md +6 -6
  36. package/adaptations/projnet4geoapi.md +6 -6
  37. package/adaptations/pyqgis.md +6 -6
  38. package/adaptations/qgis-process.md +6 -6
  39. package/adaptations/qgis-server.md +6 -6
  40. package/adaptations/shapely.md +6 -6
  41. package/adaptations/sharpmap.md +6 -6
  42. package/adaptations/spatialite.md +6 -6
  43. package/adaptations/whitebox-tools.md +6 -6
  44. package/assets/brutile/SKILL.md +6 -12
  45. package/assets/cesiumjs/SKILL.md +14 -18
  46. package/assets/deck-gl/SKILL.md +8 -15
  47. package/assets/duckdb-spatial/SKILL.md +5 -12
  48. package/assets/gdal/SKILL.md +5 -12
  49. package/assets/gdal/reference/raster-tools.md +14 -0
  50. package/assets/gdal/reference/vector-tools.md +5 -0
  51. package/assets/gdal-api/SKILL.md +6 -14
  52. package/assets/gdal-api/reference/raster-api.md +7 -0
  53. package/assets/gdal-api/reference/vector-api.md +9 -0
  54. package/assets/geolibre/SKILL.md +10 -17
  55. package/assets/geometry-api-java/SKILL.md +5 -10
  56. package/assets/geometry-api-net/SKILL.md +5 -11
  57. package/assets/geometry-api-net/reference/geometry-types.md +5 -0
  58. package/assets/geonode/SKILL.md +5 -12
  59. package/assets/geopandas/SKILL.md +5 -10
  60. package/assets/geopandas/reference/core-api.md +4 -0
  61. package/assets/geopipe-agent/SKILL.md +7 -14
  62. package/assets/geopipe-agent/reference/steps-reference.md +12 -0
  63. package/assets/geopipe-agent/reference/workflows.md +8 -0
  64. package/assets/geoserver/SKILL.md +5 -12
  65. package/assets/geoserver-cloud/SKILL.md +12 -19
  66. package/assets/geoserver-rest-api/SKILL.md +5 -12
  67. package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
  68. package/assets/geotools/SKILL.md +5 -12
  69. package/assets/geotools/reference/raster-rendering.md +5 -0
  70. package/assets/geotools/reference/vector-io.md +7 -0
  71. package/assets/grass-gis/SKILL.md +8 -14
  72. package/assets/jts/SKILL.md +5 -12
  73. package/assets/jts/reference/geometry-operations.md +13 -0
  74. package/assets/kepler-gl/SKILL.md +9 -16
  75. package/assets/leaflet/SKILL.md +18 -22
  76. package/assets/mapbox-gl-js/SKILL.md +10 -16
  77. package/assets/mapserver/SKILL.md +5 -11
  78. package/assets/mapsui/SKILL.md +25 -16
  79. package/assets/nettopologysuite/SKILL.md +5 -11
  80. package/assets/opengis-all/SKILL.md +13 -19
  81. package/assets/opengis-all/reference/data-stages.md +7 -0
  82. package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
  83. package/assets/opengis-daf/SKILL.md +5 -13
  84. package/assets/opengis-utils-for-java/SKILL.md +7 -11
  85. package/assets/opengis-utils-for-java/reference/common-tasks.md +4 -0
  86. package/assets/opengis-utils-for-net/SKILL.md +5 -10
  87. package/assets/opengis-utils-for-net/reference/code-patterns.md +4 -0
  88. package/assets/opengis-utils-for-net/reference/util-classes.md +10 -0
  89. package/assets/openlayers/SKILL.md +16 -20
  90. package/assets/pdal/SKILL.md +6 -12
  91. package/assets/postgis/SKILL.md +21 -26
  92. package/assets/proj/SKILL.md +5 -12
  93. package/assets/projnet4geoapi/SKILL.md +5 -11
  94. package/assets/pyqgis/SKILL.md +5 -10
  95. package/assets/pyqgis/reference/processing-rendering.md +6 -0
  96. package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
  97. package/assets/qgis-process/SKILL.md +5 -12
  98. package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
  99. package/assets/qgis-server/SKILL.md +7 -13
  100. package/assets/shapely/SKILL.md +5 -10
  101. package/assets/shapely/reference/operations-reference.md +12 -0
  102. package/assets/sharpmap/SKILL.md +5 -11
  103. package/assets/spatialite/SKILL.md +7 -14
  104. package/assets/whitebox-tools/SKILL.md +9 -16
  105. package/lib/adaptations.d.ts +6 -0
  106. package/lib/adaptations.js +79 -4
  107. package/lib/catalog.d.ts +7 -1
  108. package/lib/catalog.js +9 -1
  109. package/lib/index.d.ts +9 -0
  110. package/lib/index.js +20 -1
  111. package/lib/skill-file.d.ts +12 -0
  112. package/lib/skill-file.js +107 -16
  113. package/locale/en.json +1 -1
  114. package/locale/zh.json +1 -1
  115. package/package.json +2 -2
  116. package/upstream.json +63 -63
@@ -1,26 +1,19 @@
1
1
  ---
2
2
  name: kepler-gl
3
- description: "Use when building React/Redux web apps or Jupyter notebooks for large-scale geospatial visual exploration with Kepler.gl 3.3.0-alpha.16 — @kepler.gl/components KeplerGl, @kepler.gl/actions addDataToMap, @kepler.gl/processors processGeojson/processCsvData, and the Python keplergl widget. Also for fixing blank maps from a missing reducer or wrong getState (react-redux 'Could not find ... in the context of Connect(...)'), Mapbox token basemap errors, and oversized addDataToMap payloads."
4
- tags:
5
- - javascript
6
- - react
7
- - redux
8
- - webgl
9
- - geospatial
10
- - data-visualization
11
- - map-layers
12
- - jupyter
13
- - python
14
- - maplibre
3
+ description: "Use when building React/Redux web apps or Jupyter notebooks for large-scale geospatial visual exploration with Kepler.gl 3.3.0-alpha.20 — @kepler.gl/components KeplerGl, @kepler.gl/actions addDataToMap, @kepler.gl/processors processGeojson/processCsvData, and the Python keplergl widget. Also for fixing blank maps from a missing reducer or wrong getState (react-redux 'Could not find ... in the context of Connect(...)'), Mapbox token basemap errors, and oversized addDataToMap payloads."
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "javascript, react, redux, webgl, geospatial, data-visualization, map-layers, jupyter, python, maplibre"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/keplergl/kepler.gl>
18
11
  >
19
12
  > **官方文档:** <https://docs.kepler.gl/>
20
13
  >
21
- > **npm:** `kepler.gl`(npm `latest` 标签 3.3.0-alpha.16;GitHub Release v3.3.0-alpha.18 尚未回填 `latest`,截至 2026-10)
14
+ > **最新版本:** 3.3.0-alpha.20(2026-11-08,npm `kepler.gl` `latest` 标签与 [GitHub Release v3.3.0-alpha.20](https://github.com/keplergl/kepler.gl/releases) 一致;仍为 3.3 预发布线,4.0 尚无稳定版)
22
15
  >
23
- > **PyPI:** `keplergl` 0.4.0(Jupyter 小组件,版本节奏落后于前端,截至 2026-10)
16
+ > **PyPI:** `keplergl` 0.4.0(Jupyter 小组件,版本节奏落后于前端,截至 2026-11)
24
17
  >
25
18
  > **许可证:** MIT
26
19
 
@@ -75,7 +68,7 @@ UMD 构建的库名为 `KeplerGl`,AMD 加载时同样以 `KeplerGl` 注册;
75
68
  ```bash
76
69
  pip install keplergl==0.4.0
77
70
 
78
- # 或使用 conda
71
+ # 或使用 conda(注意:conda-forge 当前仍停在 0.3.2,需要 0.4.0 请用 pip)
79
72
  conda install -c conda-forge keplergl
80
73
  ```
81
74
 
@@ -290,7 +283,7 @@ React 侧的等价流程是:`processGeojson` / `processCsvData` 解析 → `di
290
283
  ## AI 使用建议
291
284
 
292
285
  - **执行环境**:`npm install` / `pnpm install`、`pip install keplergl` 在终端中执行 或 `ops_bash`,长输出重定向到文件再分段读。
293
- - **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions`,子包必须与主包同为 3.3.0-alpha.16;Python 侧 `python -c "import keplergl; print(keplergl.__version__)"` 应为 0.4.0。
286
+ - **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions`,子包必须与主包同为 3.3.0-alpha.20;Python 侧 `python -c "import keplergl; print(keplergl.__version__)"` 应为 0.4.0。
294
287
  - **验证产物**:前端用 `npm run build` 确认编译,再用 `npx serve dist` 起本地静态服务;是否真出图只能由浏览器确认,AI 助手通常看不到浏览器画面,请用户看画面与控制台,环境支持读图时用截图核对。
295
288
  - **无 GPU 环境**:无头环境无法验证 WebGL 渲染,构建通过不等于地图可用,此时不要报告「已渲染」。
296
289
  - **常见症状**:空白组件先查 reducer 与 `getState`;无图层查 `dataId` 与字段类型;token 报错查底图样式。
@@ -1,17 +1,10 @@
1
1
  ---
2
2
  name: leaflet
3
3
  description: "Use when adding lightweight 2D tile maps to web pages with leaflet 1.9.4 — L.map/L.tileLayer, markers, popups, GeoJSON overlays, layer control, [lat, lng] ordering, or debugging blank maps, broken default marker icons after bundling, and sizing fixed by invalidateSize()."
4
- tags:
5
- - javascript
6
- - web
7
- - 2d
8
- - map
9
- - geojson
10
- - tile-layer
11
- - markers
12
- - plugins
13
- - vue
14
- - react
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "javascript, web, 2d, map, geojson, tile-layer, markers, plugins, vue, react"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/Leaflet/Leaflet>
@@ -22,7 +15,7 @@ tags:
22
15
  >
23
16
  > **示例:** <https://leafletjs.com/examples.html>
24
17
  >
25
- > **最新版本:** 1.9.4(截至 2026-10,npm `leaflet`)
18
+ > **最新版本:** 1.9.4(截至 2026-11,[npm `leaflet`](https://www.npmjs.com/package/leaflet) 与 [GitHub Release](https://github.com/Leaflet/Leaflet/releases) 一致;1.9.4 发布于 2023-05,仍是当前稳定版)
26
19
  >
27
20
  > **许可证:** BSD-2-Clause
28
21
 
@@ -337,16 +330,19 @@ export default function MapView() {
337
330
 
338
331
  ## 常见问题
339
332
 
340
- | 问题 | 原因与解决 |
341
- |------|------------|
342
- | 地图区域空白 / 不显示 | 容器缺少高度:为 `#map` 设置 `height`(如 `400px`),或地图初始化后调用 `map.invalidateSize()` |
343
- | 标记图标 404 / 显示为破图 | npm + 打包器下 `leaflet.css` 引用的默认图标路径失效,需手动设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl` 或改用 CDN 引入 CSS |
344
- | 地图在弹窗/隐藏容器中显示错乱 | 容器尺寸变化后调用 `map.invalidateSize()` 重算 |
345
- | `L is not defined` | CDN 脚本未加载或引入顺序错误:先加载 `leaflet.js` 再执行代码;npm 下确认 `import L from 'leaflet'` |
346
- | 经纬度颠倒导致点跑到别处 | 参数顺序为 `[lat, lng]`;GeoJSON 坐标是 `[lng, lat]`,必要时用 `coordsToLatLng` 转换 |
347
- | 组件切换后内存持续增长 | 卸载时未调用 `map.remove()`,或事件监听器未 `off` 解绑 |
348
- | 瓦片加载失败 / 跨域 | 检查瓦片服务 URL 模板与 CORS 头;WMS 需确认服务端允许跨域 |
349
- | 与 Vue/React 响应式冲突 | 不要把 `L.map` 实例放进 `reactive`/`useState`(会代理内部对象),用普通变量或 `useRef` 持有 |
333
+ | 报错 / 现象 | 原因 | 处置 |
334
+ |------|------|------|
335
+ | 报错 `Uncaught Error: Map container is already initialized.` | 同一个 DOM 容器被 `L.map()` 初始化两次(React StrictMode 双调用、热更新、路由复用组件最常见) | 复用前先 `map.remove()` 并把引用置空;React 在 `useEffect` 的 cleanup 里 `remove()`,初始化前判断容器是否已带 `_leaflet_id` |
336
+ | 报错 `Uncaught Error: Map container not found.` | `L.map(id)` 执行时容器 DOM 尚未挂载,或 id 与模板不一致 | 等 DOM 就绪再初始化(React `useEffect`、Vue `onMounted`),并核对传入的 id/元素 |
337
+ | 报错 `Uncaught Error: Map container is being reused by another instance` | 容器仍被一个未销毁的 `Map` 实例占用 | 先 `remove()` 旧实例再初始化;同一容器不要并存两个地图 |
338
+ | 报错 `Uncaught ReferenceError: L is not defined` | CDN 脚本未加载、加载失败,或自定义代码先于 `leaflet.js` 执行 | 先引 `leaflet.js` 再执行业务代码;npm 下确认 `import L from 'leaflet'` 且打包产物真的包含它 |
339
+ | 地图区域空白 / 不显示 | 容器没有显式高度(Leaflet 不自带尺寸),或初始化后容器尺寸才变化 | 给 `#map` 设 `height`(如 `400px`);尺寸变化后调用 `map.invalidateSize()` |
340
+ | 默认标记图标 404 / 显示为破图 | npm + 打包器下 `leaflet.css` 里相对的默认图标路径失效 | 显式设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl`,或改用 CDN 引入 CSS 与图片 |
341
+ | 地图在弹窗 / 隐藏容器中显示错乱 | 容器尺寸在初始化时已知为零,或标签页切回后尺寸变化 | 容器可见后再初始化,并在可见性变化后调用 `map.invalidateSize()` |
342
+ | 点跑到别的位置 / 坐标颠倒 | 参数顺序是 `[lat, lng]`,而 GeoJSON 是 `[lng, lat]` | 统一在入口处用 `L.latLng(lat, lng)` 或 `coordsToLatLng` 转换,不要混用两种顺序 |
343
+ | 组件切换后内存持续增长 | 卸载时未调用 `map.remove()`,或自定义事件未 `off` 解绑 | cleanup 中 `map.remove()`;自定义监听器用具名函数并 `map.off(type, handler)` |
344
+ | 瓦片加载失败 / 跨域报错 | 瓦片 URL 模板错误,或瓦片服务未返回 CORS 头 | 核对 `{z}/{x}/{y}` 模板与该服务实际路径;WMS 需服务端放行跨域,前端 `crossOrigin` 选项按需设置 |
345
+ | 地图与 Vue/React 响应式冲突 | 把 `L.map` 实例放进 `reactive`/`useState`,代理了 Leaflet 内部对象 | 用普通变量或 `useRef` 持有实例,不要放进响应式容器 |
350
346
 
351
347
  ---
352
348
 
@@ -1,16 +1,10 @@
1
1
  ---
2
2
  name: mapbox-gl-js
3
- description: "Use when building vector web maps with mapbox-gl 3.33.0 — WebGL rendering, Style Spec layers, data-driven expressions, setTerrain raster-dem, fill-extrusion, or debugging 401 'A valid Mapbox access token is required', 'Style is not done loading', and pk./sk. token handling. Note: v2+ is proprietary under Mapbox TOS and requires a token; MapLibre GL JS is the open-source fork."
4
- tags:
5
- - javascript
6
- - web
7
- - map
8
- - vector-tiles
9
- - webgl
10
- - 3d-terrain
11
- - data-driven-styling
12
- - style-spec
13
- - access-token
3
+ description: "Use when building vector web maps with mapbox-gl 3.34.2 — WebGL rendering, Style Spec layers, data-driven expressions, setTerrain raster-dem, fill-extrusion, or debugging 401 'A valid Mapbox access token is required', 'Style is not done loading', and pk./sk. token handling. Note: v2+ is proprietary under Mapbox TOS and requires a token; MapLibre GL JS is the open-source fork."
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "javascript, web, map, vector-tiles, webgl, 3d-terrain, data-driven-styling, style-spec, access-token"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/mapbox/mapbox-gl-js>
@@ -19,7 +13,7 @@ tags:
19
13
  >
20
14
  > **API 参考:** <https://docs.mapbox.com/mapbox-gl-js/api/>
21
15
  >
22
- > **最新版本:** 3.33.0(截至 2026-10,npm `mapbox-gl` 与 GitHub Release 一致)
16
+ > **最新版本:** 3.34.2(截至 2026-11,npm `mapbox-gl` 与 GitHub Release 一致;[CHANGELOG](https://github.com/mapbox/mapbox-gl-js/blob/main/CHANGELOG.md))
23
17
  >
24
18
  > **许可证:** v2+ 为 Mapbox 专有许可(v1.x 为 BSD-3-Clause;需 Mapbox 账号 access token)
25
19
 
@@ -67,8 +61,8 @@ v3 提供更小的 ESM 入口:`import * as mapboxgl from 'mapbox-gl/esm'`。
67
61
  <head>
68
62
  <meta charset="utf-8" />
69
63
  <meta name="viewport" content="width=device-width, initial-scale=1" />
70
- <link href="https://api.mapbox.com/mapbox-gl-js/v3.33.0/mapbox-gl.css" rel="stylesheet" />
71
- <script src="https://api.mapbox.com/mapbox-gl-js/v3.33.0/mapbox-gl.js"></script>
64
+ <link href="https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.css" rel="stylesheet" />
65
+ <script src="https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.js"></script>
72
66
  <style>
73
67
  /* 容器必须显式设置高度,否则地图不可见 */
74
68
  #map { height: 400px; }
@@ -382,7 +376,7 @@ map.on('load', () => {
382
376
  1. **token 安全**:前端只用 `pk.` public token,配置 URL restrictions;`sk.` secret token 仅限服务端
383
377
  2. **许可与费用**:v2+ 受 Mapbox TOS 约束,免费层每月 50,000 次地图加载(map loads),超出按量计费,额度与价格以 <https://www.mapbox.com/pricing> 为准;开源或零成本场景评估 MapLibre GL JS
384
378
  3. **等待样式加载**:`addSource` / `addLayer` / `setTerrain` 必须在 `load` 事件之后调用
385
- 4. **固定版本**:CDN 引用固定版本号(如 `v3.33.0`),JS 与 CSS 版本保持一致
379
+ 4. **固定版本**:CDN 引用固定版本号(如 `v3.34.2`),JS 与 CSS 版本保持一致
386
380
  5. **坐标顺序**:Mapbox GL JS 使用 `[经度, 纬度]`,与 GeoJSON 一致,与 Leaflet 的 `[lat, lng]` 相反
387
381
  6. **大数据量**:优先矢量瓦片而非大量 GeoJSON;GeoJSON 点数据开启 `cluster` 聚合
388
382
  7. **资源清理**:SPA 卸载组件时调用 `map.remove()`,注销自定义事件监听
@@ -409,7 +403,7 @@ map.on('load', () => {
409
403
  ## AI 使用建议
410
404
 
411
405
  - **执行环境**:`npm install`、`npm run build` 在终端中执行;Windows 下用 `npm.cmd`,长构建放后台运行。
412
- - **先探测版本**:`npm ls mapbox-gl`(未装则 `npm view mapbox-gl version`);本技能按 3.33.0 编写,CDN 的 JS 与 CSS 必须同为 `v3.33.0`,联网时 `curl.exe -I https://api.mapbox.com/mapbox-gl-js/v3.33.0/mapbox-gl.js` 应为 200。
406
+ - **先探测版本**:`npm ls mapbox-gl`(未装则 `npm view mapbox-gl version`);本技能按 3.34.2 编写,CDN 的 JS 与 CSS 必须同为 `v3.34.2`,联网时 `curl.exe -I https://api.mapbox.com/mapbox-gl-js/v3.34.2/mapbox-gl.js` 应为 200。
413
407
  - **验证产物**:`npm run build` 后 `npx serve dist`,`curl.exe -I http://localhost:5173/` 确认入口;地图是否真加载、有没有 401 只能看浏览器 Network(`api.mapbox.com`),AI 助手通常看不到浏览器画面,请用户确认或提供截图后再判断。
414
408
  - **token 安全**:前端只允许 `pk.` 公开 token,`sk.` 绝不能进构建产物;用 `VITE_MAPBOX_TOKEN` 等环境变量注入,提交前用 agent 的 `grep` 搜 `sk.` 与硬编码 `pk.`,回答和日志里不要回显 token。
415
409
  - **许可提醒**:v2+ 是 Mapbox 专有许可并受配额计费约束;用户要求开源或免 token 时改写为 MapLibre(`maplibregl` 替代 `mapboxgl`,`mapbox://` 样式换成自建瓦片)。
@@ -1,23 +1,17 @@
1
1
  ---
2
2
  name: mapserver
3
3
  description: "Use when publishing WMS/WFS/WCS/OGC API Features from a MapServer 8.6.6 .map mapfile — MAP/LAYER/CLASS/STYLE objects, STATUS/PROJECTION/EXTENT errors, WEB.METADATA wms_enable_request and wfs_enable_request, SLD binding, FastCGI plus MS_MAP_PATTERN hardening, and blank GetMap / \"No query information to decode\" symptoms."
4
- tags:
5
- - c
6
- - server
7
- - wms
8
- - wfs
9
- - wcs
10
- - ogc
11
- - mapfile
12
- - cgi
13
- - web
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "c, server, wms, wfs, wcs, ogc, mapfile, cgi, web"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/MapServer/MapServer>
17
11
  >
18
12
  > **官方文档:** <https://mapserver.org/>
19
13
  >
20
- > **最新版本:** 8.6.6(rel-8-6-6,2026-09-06 发布,截至 2026-10;[发布记录](https://github.com/MapServer/MapServer/releases))
14
+ > **最新版本:** 8.6.6(rel-8-6-6,2026-09-06 发布,截至 2026-11;[发布记录](https://github.com/MapServer/MapServer/releases))
21
15
  >
22
16
  > **许可证:** MIT
23
17
 
@@ -1,24 +1,17 @@
1
1
  ---
2
2
  name: mapsui
3
3
  description: "Use when embedding interactive 2D maps in .NET desktop (WPF/WinUI/WinForms) or mobile (MAUI/Avalonia/Blazor) apps with Mapsui 5.1.0 (net8.0/net9.0) — Mapsui.Wpf/Mapsui.Maui packages, Map and Layers, OpenStreetMap.CreateTileLayer, Shapefile/GeoJSON via Mapsui.Nts, SphericalMercator.FromLonLat, or fixing a blank MapControl."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - map
8
- - wpf
9
- - maui
10
- - avalonia
11
- - blazor
12
- - skia
13
- - wms
14
- - tiles
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, map, wpf, maui, avalonia, blazor, skia, wms, tiles"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/Mapsui/Mapsui>
18
11
  >
19
12
  > **官方文档:** <https://mapsui.com/v5/documentation/index.html>
20
13
  >
21
- > **最新版本:** 5.1.0(截至 2026-10,NuGet 稳定版;5.2.0-beta.1 为预发布)
14
+ > **最新版本:** 5.1.0(截至 2026-11,[NuGet `Mapsui`](https://www.nuget.org/packages/Mapsui) 稳定版;上游 5.2.0-beta.1 为预发布,未计入)
22
15
  >
23
16
  > **许可证:** MIT
24
17
 
@@ -98,7 +91,7 @@ MapControl.Map = map;
98
91
  ```csharp
99
92
  using Mapsui.Nts;
100
93
  using Mapsui.Styles;
101
- using NetTopologySuite.NtsGeometryServices;
94
+ using NetTopologySuite;
102
95
 
103
96
  // 视图坐标系为 EPSG:3857,经纬度数据必须先投影
104
97
  var factory = NtsGeometryServices.Instance.CreateGeometryFactory(3857);
@@ -151,13 +144,29 @@ map.Layers.Add(new TileLayer(mb));
151
144
 
152
145
  ## WMS
153
146
 
147
+ WMS 支持由主包 `Mapsui` 提供,命名空间 `Mapsui.Providers.Wms`,**没有**单独的 WMS NuGet 包。5.x 起必须用异步工厂 `WmsProvider.CreateAsync` 创建(旧的同步构造函数已不可用),再挂到 `ImageLayer` 上:
148
+
154
149
  ```csharp
150
+ using Mapsui.Layers;
155
151
  using Mapsui.Providers.Wms;
156
- var wms = new WmsProvider("https://demo.mapserver.org/cgi-bin/wms?",
157
- new[] { "continents" });
158
- map.Layers.Add(new ImageLayer("WMS") { DataSource = wms });
152
+ using Mapsui.Styles;
153
+
154
+ var wms = await WmsProvider.CreateAsync("https://demo.mapserver.org/cgi-bin/wms?", userAgent: "MyApp");
155
+ wms.CRS = "EPSG:3857"; // 请求用的 CRS,需与 Map 的 CRS 一致
156
+ wms.ContinueOnError = true;
157
+ wms.TimeOut = 40000;
158
+ wms.AddLayer("continents"); // 可多次调用,加多个 WMS 图层
159
+ wms.SetImageFormat(wms.OutputFormats[0]); // 从服务端 GetCapabilities 的可用格式里选
160
+
161
+ map.Layers.Add(new ImageLayer("WMS")
162
+ {
163
+ DataSource = wms,
164
+ Style = new RasterStyle()
165
+ });
159
166
  ```
160
167
 
168
+ > 排错要点:`CreateAsync` 会先拉 `GetCapabilities`,服务端地址写错会在此步抛异常;`AddLayer` 的图层名必须与能力文档里完全一致;`CRS` 与 `Map.CRS` 不匹配时地图空白而非报错。
169
+
161
170
  ---
162
171
 
163
172
  ## 样式
@@ -1,21 +1,15 @@
1
1
  ---
2
2
  name: nettopologysuite
3
3
  description: "Use when doing 2D computational geometry in .NET with NuGet NetTopologySuite 2.6.0 — GeometryFactory with SRID, Contains/Intersects predicates, Intersection/Union/Buffer overlays, STRtree, GeometryFixer, WKT/WKB/GeoJSON I/O, Shapefile via IO.Esri, and EF Core spatial queries on SQL Server/Npgsql."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - geometry
8
- - spatial
9
- - wkt
10
- - wkb
11
- - geojson
12
- - ef-core
13
- - npgsql
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, geometry, spatial, wkt, wkb, geojson, ef-core, npgsql"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/NetTopologySuite/NetTopologySuite>
17
11
  >
18
- > **NuGet:** `NetTopologySuite`(最新稳定版 2.6.0,截至 2026-10,NuGet)
12
+ > **最新版本:** 2.6.0(截至 2026-11,[NuGet](https://www.nuget.org/packages/NetTopologySuite) 稳定版;[GitHub Release](https://github.com/NetTopologySuite/NetTopologySuite/releases))
19
13
  >
20
14
  > **官方文档:** <https://nettopologysuite.github.io/NetTopologySuite/>
21
15
  >
@@ -1,28 +1,22 @@
1
1
  ---
2
2
  name: opengis-all
3
3
  description: "Use when navigating end-to-end GIS workflows — GDAL CLI/API (ogr2ogr, gdalwarp, gdal_calc.py), qgis_process and PyQGIS analysis, GeoServer REST publishing, and OpenLayers/CesiumJS visualization. One-stop index covering the complete open-source GIS data pipeline."
4
-
5
- tags:
6
- - gis
7
- - entrypoint
8
- - workflow
9
- - fullstack
10
- - gdal
11
- - qgis
12
- - geoserver
13
- - pyqgis
14
- - tutorial
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "gis, entrypoint, workflow, fullstack, gdal, qgis, geoserver, pyqgis, tutorial"
15
8
  ---
16
9
 
17
10
  > **涵盖工具与项目:**
18
11
  >
19
- > | 工具/接口 | 项目地址 | 文档 | 许可证 |
20
- > |-----------|----------|------|--------|
21
- > | GDAL 命令行 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/latest/programs/> | MIT |
22
- > | GDAL API (C++/Python/Java/C#) | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/stable/api/index.html> | MIT |
23
- > | qgis_process | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/user_manual/processing/standalone.html> | GPL-2.0+ |
24
- > | PyQGIS | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/pyqgis_developer_cookbook/> | GPL-2.0+ |
25
- > | GeoServer REST API | <https://github.com/geoserver/geoserver> | <https://docs.geoserver.org/latest/en/user/rest/index.html> | GPL-2.0+ |
12
+ > | 工具/接口 | 最新版本(截至 2026-11) | 项目地址 | 文档 | 许可证 |
13
+ > |-----------|------------------------|----------|------|--------|
14
+ > | GDAL 命令行 | 3.13.3 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/latest/programs/> | MIT |
15
+ > | GDAL API (C++/Python/Java/C#) | 3.13.3 | <https://github.com/OSGeo/gdal> | <https://gdal.org/en/stable/api/index.html> | MIT |
16
+ > | QGIS / qgis_process | 4.2.3(LTR 3.44.15) | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/user_manual/processing/standalone.html> | GPL-2.0+ |
17
+ > | PyQGIS | 4.2.3(LTR 3.44.15) | <https://github.com/qgis/QGIS> | <https://docs.qgis.org/3.44/en/docs/pyqgis_developer_cookbook/> | GPL-2.0+ |
18
+ > | GeoServer REST API | 3.0.2 | <https://github.com/geoserver/geoserver> | <https://docs.geoserver.org/latest/en/user/rest/index.html> | GPL-2.0+ |
19
+ > | OpenLayers / CesiumJS(前端) | ol 10.11.0 / Cesium 1.147.0 | <https://github.com/openlayers/openlayers> | <https://openlayers.org/doc/> | BSD-2-Clause / Apache-2.0 |
26
20
 
27
21
  ## 概述
28
22
 
@@ -76,7 +70,7 @@ python3 -c "from osgeo import gdal; print(gdal.VersionInfo())"
76
70
  ### QGIS(qgis_process + PyQGIS)
77
71
 
78
72
  ```bash
79
- # 安装 QGIS 3.44 LTR 或 4.x(qgis_process 从 3.16 开始可用)
73
+ # 安装 QGIS 4.2.3 或 3.44 LTR(qgis_process 从 3.16 开始可用)
80
74
  # Ubuntu
81
75
  apt-get install qgis qgis-plugin-grass
82
76
 
@@ -1,5 +1,12 @@
1
1
  # OpenGIS Data Pipeline Stages Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 阶段一:数据获取与信息查询
6
+ - 阶段二:数据处理与转换
7
+ - 阶段三:空间分析
8
+ - 阶段四:发布 GIS 地图服务(GeoServer REST API)
9
+
3
10
  Stage 1 (data acquisition/query), stage 2 (processing/conversion), stage 3 (spatial analysis) and stage 4 (GeoServer publishing) split from SKILL.md.
4
11
 
5
12
  ---
@@ -1,5 +1,12 @@
1
1
  # OpenGIS Workflow Examples and Cheatsheets
2
2
 
3
+ ## Contents
4
+
5
+ - 端到端工作流示例
6
+ - 常用内置算法速查(qgis_process / PyQGIS)
7
+ - GDAL 命令行工具速查
8
+ - 数据格式支持
9
+
3
10
  End-to-end workflow examples, built-in algorithm cheatsheet, GDAL CLI cheatsheet, data formats and env vars split from SKILL.md.
4
11
 
5
12
  ---
@@ -1,23 +1,15 @@
1
1
  ---
2
2
  name: opengis-daf
3
3
  description: "Use when building JSON-plan GIS analysis or QC pipelines with OpenGisDAF (.NET 10 / C# 14) — daf validate/run, operators buffer/clip/intersect_check/containment_check/coordinate_transform, DAG upstream bindings, GeoJSON/Shapefile/PostGIS sinks, qcMode QC reports, AssemblyLoadContext plugins; also for \"zero tests ran\" exit code 5, missing --recurse-submodules GDAL build errors, or PostGIS Layer already exists. Plan-driven ETL."
4
-
5
- tags:
6
- - gis
7
- - csharp
8
- - dotnet
9
- - spatial-analysis
10
- - data-quality
11
- - geojson
12
- - shapefile
13
- - postgis
14
- - vector
15
- - pipeline
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "gis, csharp, dotnet, spatial-analysis, data-quality, geojson, shapefile, postgis, vector, pipeline"
16
8
  ---
17
9
 
18
10
  > **项目地址:** <https://github.com/znlgis/opengis-daf>
19
11
  >
20
- > **版本:** 仓库主线(截至 2026-10,无 Release tag、无 NuGet 包;以 `global.json` 的 .NET SDK 10.0.301 为准)
12
+ > **最新版本:** 仓库 `main` 主线(截至 2026-11,[无 Release tag](https://github.com/znlgis/opengis-daf/releases)、无 NuGet 包;以 `global.json` 的 .NET SDK 10.0.301 为准)
21
13
  >
22
14
  > **许可证:** MIT License
23
15
  >
@@ -1,23 +1,19 @@
1
1
  ---
2
2
  name: opengis-utils-for-java
3
3
  description: "Use when needing common GIS utilities in Java — OguLayerUtil layer read/write, GeometryUtil 60+ ops, CrsUtil CGCS2000 (EPSG:4490, 4502-4554), Shapefile/GeoJSON/FileGDB/PostGIS/land TXT I/O, topology validation; also for GDAL UnsatisfiedLinkError on gdal_jni, missing osgeo repo on GeoTools, or resolving com.znlgis.ogu4j:ogu4j:1.0.0 that is not on Maven Central. OGU4J."
4
- tags:
5
- - java
6
- - gis
7
- - geotools
8
- - jts
9
- - gdal
10
- - geometry
11
- - vector
12
- - crs
13
- - cgcs2000
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, gis, geotools, jts, gdal, geometry, vector, crs, cgcs2000"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/znlgis/opengis-utils-for-java>
17
11
  >
18
12
  > **官方文档:** <https://github.com/znlgis/opengis-utils-for-java#readme>
19
13
  >
20
- > **Maven 坐标:** `com.znlgis.ogu4j:ogu4j:1.0.0`(截至 2026-10 尚未发布到 Maven Central,需从源码 `mvn install` 安装到本地仓库)
14
+ > **最新版本:** 1.0.0(截至 2026-11,[仓库 `main` 分支 `pom.xml`](https://github.com/znlgis/opengis-utils-for-java/blob/main/pom.xml),无 Git tag;**尚未发布到 Maven Central**,需从源码 `mvn install` 安装到本地仓库)
15
+ >
16
+ > **Maven 坐标:** `com.znlgis.ogu4j:ogu4j`
21
17
  >
22
18
  > **许可证:** LGPL-2.1-or-later
23
19
 
@@ -1,5 +1,9 @@
1
1
  # OpenGIS Utils for Java 常用任务参考
2
2
 
3
+ ## Contents
4
+
5
+ - 常用任务速查
6
+
3
7
  从 SKILL.md 拆出的常用任务速查,Java 版本按 OGU4J 1.0.0 编写。
4
8
 
5
9
  ---
@@ -1,15 +1,10 @@
1
1
  ---
2
2
  name: opengis-utils-for-net
3
3
  description: "Use when needing common GIS utilities in .NET/C# — OguLayerUtil ReadLayer/WriteLayer/ConvertFormat, GeometryUtil 50+ ops, CrsUtil CGCS2000 transforms, Shapefile/GeoJSON/FileGDB/GeoPackage/KML/PostGIS I/O; also for Unable to load DLL gdal / DllNotFoundException, GBK shapefile mojibake, or ArgumentException from Geojson2Wkt on a whole FeatureCollection. OpenGIS.Utils 1.1.2."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - gdal
8
- - ogr
9
- - geometry
10
- - vector
11
- - crs
12
- - cgcs2000
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, gdal, ogr, geometry, vector, crs, cgcs2000"
13
8
  ---
14
9
 
15
10
  > **项目地址:** <https://github.com/znlgis/opengis-utils-for-net>
@@ -18,7 +13,7 @@ tags:
18
13
  >
19
14
  > **NuGet 包:** `OpenGIS.Utils`
20
15
  >
21
- > **最新版本:** 1.1.2(截至 2026-10,NuGet)
16
+ > **最新版本:** 1.1.2(截至 2026-11,[NuGet `OpenGIS.Utils`](https://www.nuget.org/packages/OpenGIS.Utils);[GitHub Release v1.1.2](https://github.com/znlgis/opengis-utils-for-net/releases))
22
17
  >
23
18
  > **许可证:** LGPL-2.1-or-later
24
19
 
@@ -1,5 +1,9 @@
1
1
  # OpenGIS Utils for .NET 常用代码模式
2
2
 
3
+ ## Contents
4
+
5
+ - 常用代码模式
6
+
3
7
  从 SKILL.md 拆出的常用代码模式与示例,.NET 版本按 OpenGIS.Utils 1.1.2 编写。
4
8
 
5
9
  ---
@@ -1,5 +1,15 @@
1
1
  # OpenGIS Utils for .NET 工具类参考
2
2
 
3
+ ## Contents
4
+
5
+ - 数据读写 — OguLayerUtil(推荐入口)
6
+ - 几何运算 — GeometryUtil
7
+ - 坐标参考系 — CrsUtil
8
+ - Shapefile 工具 — ShpUtil
9
+ - PostGIS 工具 — PostgisUtil
10
+ - 国土调查 TXT 格式 — GtTxtUtil
11
+ - GDAL 配置
12
+
3
13
  从 SKILL.md 拆出的 OguLayerUtil、GeometryUtil、CrsUtil、ShpUtil、PostgisUtil、GtTxtUtil 与 GDAL 配置参考,按 OpenGIS.Utils 1.1.2 编写。
4
14
 
5
15
  ---
@@ -1,16 +1,10 @@
1
1
  ---
2
2
  name: openlayers
3
3
  description: "Use when adding interactive 2D maps to web apps with npm ol 10.11.0 — Map/View, fromLonLat to EPSG:3857, WMS/WMTS/XYZ sources, MVT with featureClass, Draw/Modify/Snap interactions, or debugging blank layers (missing setStyle), offset centers and ol/... module-not-found errors."
4
- tags:
5
- - javascript
6
- - web
7
- - 2d
8
- - map
9
- - wms
10
- - wmts
11
- - vector-tiles
12
- - geojson
13
- - drawing
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "javascript, web, 2d, map, wms, wmts, vector-tiles, geojson, drawing"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/openlayers/openlayers>
@@ -21,7 +15,7 @@ tags:
21
15
  >
22
16
  > **示例:** <https://openlayers.org/en/latest/examples/>
23
17
  >
24
- > **最新版本:** 10.11.0(截至 2026-10,npm `ol`)
18
+ > **最新版本:** 10.11.0(截至 2026-11,[npm `ol`](https://www.npmjs.com/package/ol) 与 [GitHub Release](https://github.com/openlayers/openlayers/releases) 一致)
25
19
  >
26
20
  > **许可证:** BSD-2-Clause
27
21
 
@@ -305,15 +299,17 @@ drawSource.on('addfeature', () => {
305
299
 
306
300
  ## 常见问题
307
301
 
308
- | 问题 | 解决 |
309
- |------|------|
310
- | 中心点偏移 | 投影未对齐:`fromLonLat()` 转换 |
311
- | WMS 不显示 | 检查 CORS、`LAYERS` 名、`SRS` 参数 |
312
- | 字体未生效 | 加载字体后再创建 Text 样式 |
313
- | MVT 字段缺失 | 使用 `MVT({ featureClass: Feature })` |
314
- | 矢量图层完全不显示 | 图层未设置样式时默认不渲染,需为图层 `setStyle()` |
315
- | 点击拾取不到要素 | `map.forEachFeatureAtPixel` 设置 `hitTolerance`(触摸设备/细小要素场景) |
316
- | 运行时报 `ol/...` 模块找不到 | 确认使用 npm 包 `ol` 并配置打包器(或改用官方全量构建 `dist/ol.js`) |
302
+ | 报错 / 现象 | 原因 | 处置 |
303
+ |------|------|------|
304
+ | 报错 `Uncaught AssertionError: Assertion failed: The view center is not defined` | `new View()` 未给 `center`,或给的是 `undefined`(坐标变量还没算出来) | 构造 View 时显式传 `center: fromLonLat([lng, lat])` 与 `zoom`;异步取数时等数据到了再 `view.setCenter()` |
305
+ | 报错 `Assertion failed: Expected a list of style instances` | `setStyle()` 收到单个 `Style` 之外的非法值(数组里混入 `null`/`undefined`,或传了函数却返回非 Style) | 传 `new Style({...})` 或其数组;用样式函数时确保每个分支都返回 Style |
306
+ | 中心点偏移 / 图层跑到别处 | 经纬度直接当投影坐标用,未做 `EPSG:4326 → EPSG:3857` 转换 | 所有经纬度经 `fromLonLat()` 转换;自定义投影先 `register(proj4)`;用 `map.getView().getCenter()` 回读核对 |
307
+ | 矢量图层完全不显示 | 矢量图层未设置样式时默认不渲染 | 为图层 `setStyle(new Style({...}))`,或在构造时传 `style` |
308
+ | WMS 返回空白或 404 | `LAYERS` 用了图层短名而非全名、`SRS`/`CRS` 与请求版本不匹配,或服务端未放行 CORS | 用 `GetCapabilities` 里的全名填 `LAYERS`;WMS 1.3.0 用 `CRS`、1.1.1 用 `SRS`;服务端补 CORS 头 |
309
+ | MVT 要素取不到属性 | MVT 源未指定要素类,属性被丢弃 | 用 `new MVT({ featureClass: Feature })`,再通过 `feature.getProperties()` 读取 |
310
+ | 文字标注不显示 / 字体不生效 | 字体尚未加载就创建了 Text 样式,或字体族名与服务端不一致 | 先用 `document.fonts.load()`/CSS 加载字体再建样式;确认 `font` 字符串里的字体族名可用 |
311
+ | 点击拾取不到要素 | 要素过小或触摸设备命中容差不足 | `map.forEachFeatureAtPixel(evt.pixel, cb, { hitTolerance: 5 })` 加大容差 |
312
+ | 运行时报 `ol/...` 模块找不到(如 `Failed to resolve module specifier "ol/Map.js"`) | 直接用 `<script>` 引 ESM 源码,或打包器未按 ESM 解析 | 用 npm 的 `ol` 包并配置打包器;不想打包就用官方全量构建 `dist/ol.js` |
317
313
 
318
314
  ---
319
315
 
@@ -1,25 +1,19 @@
1
1
  ---
2
2
  name: pdal
3
3
  description: "Use when processing point cloud data (LAS/LAZ/BPF/EPT/COPC) via CLI or Python — pipeline JSON workflows, format conversion, reprojection, cropping, outlier removal, ground classification (SMRF), and DEM generation from LiDAR. PDAL (Point Data Abstraction Library) is the point cloud equivalent of GDAL: pdal info/translate/pipeline commands plus pdal.Pipeline Python bindings."
4
- tags:
5
- - pdal
6
- - point-cloud
7
- - lidar
8
- - las
9
- - laz
10
- - pipeline
11
- - dem
12
- - gis
13
- - geospatial
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "pdal, point-cloud, lidar, las, laz, pipeline, dem, gis, geospatial"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/PDAL/PDAL>
17
11
  >
18
12
  > **官方文档:** <https://pdal.io/>
19
13
  >
20
- > **Conda:** `pdal` / `python-pdal`(conda-forge,最新 2.10.2,截至 2026-10)
14
+ > **最新版本:** 2.10.2(截至 2026-11,[GitHub Release](https://github.com/PDAL/PDAL/releases);conda-forge `pdal` 同为 2.10.2)
21
15
  >
22
- > **PyPI:** `pdal`(Python 绑定,最新 3.5.5,截至 2026-10;版本号与主库独立)
16
+ > **PyPI:** `pdal`(Python 绑定,最新 3.5.5,截至 2026-11;版本号与主库独立)
23
17
  >
24
18
  > **许可证:** BSD-3-Clause
25
19