@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,5 +1,14 @@
1
1
  # GDAL Vector API Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 矢量数据读取
6
+ - 矢量数据创建与写入
7
+ - 矢量格式转换与空间过滤
8
+ - 几何操作
9
+ - GeoPackage 读写
10
+ - 常用矢量数据格式
11
+
3
12
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录 C++/Python/Java/C# 四种语言的矢量读写、格式转换、几何操作与 GeoPackage 示例。
4
13
 
5
14
  ---
@@ -1,17 +1,10 @@
1
1
  ---
2
2
  name: geolibre
3
- description: "Use when scripting or self-hosting the GeoLibre GIS app — geolibre Python anywidget (Map/add_geojson/add_cog/save_project), geolibre-mcp stdio server for AI agents, ghcr.io/opengeos/geolibre Docker image, DuckDB-WASM SQL workspace, ?data= and ?url= deep links; also for a blank window on Linux WebKitGTK, sidecar path not allowed from GEOLIBRE_CONVERSION_ROOTS, and Jupyter relay not connected. GeoLibre 3.5.1."
4
- tags:
5
- - geolibre
6
- - gis
7
- - python
8
- - jupyter
9
- - mcp
10
- - duckdb
11
- - docker
12
- - webgis
13
- - tauri
14
- - geospatial
3
+ description: "Use when scripting or self-hosting the GeoLibre GIS app — geolibre Python anywidget (Map/add_geojson/add_cog/save_project), geolibre-mcp stdio server for AI agents, ghcr.io/opengeos/geolibre Docker image, DuckDB-WASM SQL workspace, ?data= and ?url= deep links; also for a blank window on Linux WebKitGTK, sidecar path not allowed from GEOLIBRE_CONVERSION_ROOTS, and Jupyter relay not connected. GeoLibre 3.7.0."
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "geolibre, gis, python, jupyter, mcp, duckdb, docker, webgis, tauri, geospatial"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/opengeos/GeoLibre>
@@ -20,7 +13,7 @@ tags:
20
13
  >
21
14
  > **在线版:** <https://web.geolibre.app>
22
15
  >
23
- > **PyPI:** geolibre 3.5.1(要求 Python >= 3.11,截至 2026-10);conda-forge 渠道为 3.5.0
16
+ > **最新版本:** 3.7.0(截至 2026-11,[PyPI](https://pypi.org/project/geolibre/) / [GitHub Releases](https://github.com/opengeos/GeoLibre/releases));要求 Python >= 3.11,conda-forge 同步为 3.7.0
24
17
  >
25
18
  > **许可证:** MIT
26
19
 
@@ -55,12 +48,12 @@ GeoLibre 是一个云原生 GIS 应用,同一份代码可运行在浏览器、
55
48
  | Flatpak | `flatpak install flatpark app.geolibre.GeoLibre` |
56
49
  | Debian / Ubuntu | `sudo apt install ./GeoLibre.Desktop_<version>_amd64.deb` |
57
50
 
58
- 验证:启动后 **Help → About** 核对版本为 3.5.1,**Help → Diagnostics** 应无红色错误项。
51
+ 验证:启动后 **Help → About** 核对版本为 3.7.x,**Help → Diagnostics** 应无红色错误项。
59
52
 
60
53
  ### 路径三:Python 包(Notebook / 脚本)
61
54
 
62
55
  ```bash
63
- pip install geolibre==3.5.1
56
+ pip install geolibre==3.7.0
64
57
 
65
58
  # 或 conda-forge
66
59
  conda install -c conda-forge geolibre
@@ -342,8 +335,8 @@ python -c "import json;d=json.load(open('beijing.geolibre.json'));print(len(d.ge
342
335
 
343
336
  ## AI 使用建议
344
337
 
345
- - **先确认版本与入口**:pip show geolibre 看版本,geolibre-mcp --help 看参数;桌面版看 Help → About。教程可能对应 3.4,遇到差异以 3.5.1 的实际行为为准。
346
- - **装包前确认 Python 版本**:PyPI 的 geolibre 3.5.1 要求 Python >= 3.11;低版本解释器会直接安装失败,不要误判为网络问题。
338
+ - **先确认版本与入口**:pip show geolibre 看版本,geolibre-mcp --help 看参数;桌面版看 Help → About。教程可能对应 3.4/3.5,遇到差异以 3.7.0 的实际行为为准。
339
+ - **装包前确认 Python 版本**:PyPI 的 geolibre 3.7.0 要求 Python >= 3.11;低版本解释器会直接安装失败,不要误判为网络问题。
347
340
  - **MCP 路径要显式**:Windows 上 JSON 里写正向斜杠(C:/Users/you/maps),反斜杠需成对转义,容易出错。
348
341
  - **验证产物**:写完工程先 json.load 检查图层数与 mapView,再用浏览器打开导出的 HTML 看渲染;不要只看工具返回的成功。
349
342
  - **写操作确认**:export_html、save_project 与 MCP 的覆盖写会改写磁盘文件;覆盖前确认目标,或先写新文件名。
@@ -1,15 +1,10 @@
1
1
  ---
2
2
  name: geometry-api-java
3
3
  description: "Use when working with Esri geometry types (Point, Polyline, Polygon, Envelope) in Java — GeometryEngine, com.esri.geometry:esri-geometry-api:2.2.4, WKT/WKB/GeoJSON/Esri JSON I/O, geodesic distance; also when GeometryEngine has no intersects or WKB method and you need OperatorFactoryLocal, or when 2.3.1 coordinates fail to resolve on Maven Central. Esri Geometry API for Java."
4
- tags:
5
- - java
6
- - geometry
7
- - esri
8
- - spatial
9
- - wkt
10
- - wkb
11
- - geojson
12
- - geodesic
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, geometry, esri, spatial, wkt, wkb, geojson, geodesic"
13
8
  ---
14
9
 
15
10
  > **项目地址:** <https://github.com/Esri/geometry-api-java>
@@ -18,7 +13,7 @@ tags:
18
13
  >
19
14
  > **Maven Central:** `com.esri.geometry:esri-geometry-api`
20
15
  >
21
- > **最新版本:** 2.2.4(Maven Central,截至 2026-10);上游源码 2.3.1(2026-10-09),未发布到 Central
16
+ > **最新版本:** 2.2.4(Maven Central,截至 2026-11);上游源码 2.3.1(2026-10-09),未发布到 Central
22
17
  >
23
18
  > **许可证:** Apache-2.0
24
19
 
@@ -1,23 +1,17 @@
1
1
  ---
2
2
  name: geometry-api-net
3
3
  description: "Use when working with Esri geometry types (Point, Polyline, Polygon, Envelope) in .NET/C# — GeometryEngine, NuGet OpenGIS.Esri.Geometry.Core 1.0.9, WKT/EWKT, WKB, GeoJSON and Esri JSON I/O, System.Text.Json converters, geodesic distance; also for unclosed polygon rings, Geometry base-class casts after overlay, or the retired Esri/geometry-api-net repo. Esri Geometry API for .NET."
4
- tags:
5
- - dotnet
6
- - geometry
7
- - esri
8
- - spatial
9
- - wkt
10
- - wkb
11
- - geojson
12
- - geodesic
13
- - csharp
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, geometry, esri, spatial, wkt, wkb, geojson, geodesic, csharp"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/znlgis/geometry-api-net>
17
11
  >
18
12
  > **官方文档:** <https://github.com/znlgis/geometry-api-net/wiki>
19
13
  >
20
- > **NuGet:** `OpenGIS.Esri.Geometry.Core`(最新 1.0.9,截至 2026-10)
14
+ > **最新版本:** 1.0.9(2026-09-21 发布,[NuGet](https://www.nuget.org/packages/OpenGIS.Esri.Geometry.Core);截至 2026-11)
21
15
  >
22
16
  > **许可证:** LGPL-2.1
23
17
  >
@@ -1,5 +1,10 @@
1
1
  # Geometry API for .NET Geometry Types Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 几何类型
6
+ - 两种 API 风格
7
+
3
8
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录几何类型体系与 GeometryEngine / Operator 两种 API 风格的完整说明。
4
9
 
5
10
  ---
@@ -1,17 +1,10 @@
1
1
  ---
2
2
  name: geonode
3
3
  description: "Use when deploying or automating GeoNode 5.1.1 — docker compose with create-envfile.py, geonode/geonode:5.1.1 image, django4geonode logs, /api/v2/resources and /api/v2/uploads/upload (action=upload|replace|upsert|create), OGC WMS/WFS links from resource.links[], geonode-project customization; also for 502 after compose up, 'GeoNode has no attribute' after upgrade, and upload 401/403 with Basic vs Bearer auth."
4
- tags:
5
- - geonode
6
- - gis
7
- - django
8
- - python
9
- - docker
10
- - postgis
11
- - geoserver
12
- - rest-api
13
- - metadata
14
- - webgis
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "geonode, gis, django, python, docker, postgis, geoserver, rest-api, metadata, webgis"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/GeoNode/geonode>
@@ -20,7 +13,7 @@ tags:
20
13
  >
21
14
  > **演示站:** <https://development.demo.geonode.org>
22
15
  >
23
- > **最新版本:** 5.1.1(GitHub Release 与 PyPI 均为 5.1.1,截至 2026-10);官方镜像 `geonode/geonode:5.1.1`
16
+ > **最新版本:** 5.1.1(GitHub Release 与 PyPI 均为 5.1.1,截至 2026-11);官方镜像 `geonode/geonode:5.1.1`
24
17
  >
25
18
  > **运行环境:** Python >= 3.10(PyPI 元数据),依赖 Django 5.2.18、psycopg2 2.9.13、Celery 5.6.3
26
19
  >
@@ -1,15 +1,10 @@
1
1
  ---
2
2
  name: geopandas
3
3
  description: "Use when doing vector spatial analysis in Python — gpd.read_file/to_file via pyogrio (GPKG, Shapefile, GeoParquet), sjoin/sjoin_nearest, overlay, clip, dissolve, to_crs vs set_crs, gdf.plot choropleth; also for CRSError from a missing PROJ data dir, area/distance computed in degrees, or GeoDataFrame geometry-column conflicts. GeoPandas 1.2.0 extends pandas DataFrames with geometry columns."
4
- tags:
5
- - python
6
- - pandas
7
- - vector
8
- - geometry
9
- - geodataframe
10
- - spatial-analysis
11
- - io
12
- - visualization
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "python, pandas, vector, geometry, geodataframe, spatial-analysis, io, visualization"
13
8
  ---
14
9
 
15
10
  > **项目地址:** <https://github.com/geopandas/geopandas>
@@ -18,7 +13,7 @@ tags:
18
13
  >
19
14
  > **官网:** <https://geopandas.org>
20
15
  >
21
- > **最新版本:** 1.2.0(截至 2026-10,PyPI)
16
+ > **最新版本:** 1.2.0(截至 2026-11,PyPI)
22
17
  >
23
18
  > **许可证:** BSD-3-Clause
24
19
 
@@ -1,5 +1,9 @@
1
1
  # GeoPandas Core API Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 核心类 API
6
+
3
7
  GeoSeries and GeoDataFrame core API details split from SKILL.md.
4
8
 
5
9
  ---
@@ -1,24 +1,17 @@
1
1
  ---
2
2
  name: geopipe-agent
3
- description: "Use when building YAML GIS pipelines with GeoPipeAgent — geopipe-agent validate/run, io.read_vector → vector.buffer → io.write_vector chains, 36 built-in steps (33 analysis + 3 passthrough), qc.geometry_validity/attribute_completeness/topology, native_python|qgis_process|gdal_cli backends, $step.output refs; also for validate "not registered" errors, silent when-condition skips, and resolve/knowledge gaps. 0.1.0, source install only (not on PyPI)."
4
- tags:
5
- - gis
6
- - agent
7
- - pipeline
8
- - yaml
9
- - qc
10
- - spatial-analysis
11
- - vector
12
- - raster
13
- - geoprocessing
14
- - python
3
+ description: "Use when building YAML GIS pipelines with GeoPipeAgent — geopipe-agent validate/run, io.read_vector to vector.buffer to io.write_vector chains, 36 built-in steps (33 analysis + 3 passthrough), qc.geometry_validity/attribute_completeness/topology, native_python|qgis_process|gdal_cli backends, $step.output refs; also for validate not-registered errors, silent when-condition skips, and resolve/knowledge gaps. 0.1.0, source install only (not on PyPI)."
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "gis, agent, pipeline, yaml, qc, spatial-analysis, vector, raster, geoprocessing, python"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/znlgis/GeoPipeAgent>
18
11
  >
19
12
  > **文档:** <https://github.com/znlgis/GeoPipeAgent#readme>(README + `cookbook/` 示例 + `docs/`)
20
13
  >
21
- > **版本:** 0.1.0(截至 2026-10,实测 `pyproject.toml`;`geopipe-agent` 未发布到 PyPI,只能源码安装)
14
+ > **最新版本:** 0.1.0(截至 2026-11,实测仓库 `pyproject.toml`;`geopipe-agent` 未发布到 PyPI,只能源码安装)
22
15
  >
23
16
  > **许可证:** MIT
24
17
 
@@ -277,7 +270,7 @@ QC 步骤遵循 **「检查即透传」** 模式:输入数据原样通过为 `
277
270
 
278
271
  ## AI 使用建议
279
272
 
280
- - **本技能的组织**:主文件给高频用法,完整参数表与高级示例在 `reference/backends.md`、`reference/knowledge.md`、`reference/pipeline-schema.md`、`reference/self-extension.md`、`reference/steps-reference.md`、`reference/workflows.md`,需要时再展开;示例工程与生成的数据写到工作目录,不要改动技能目录本身。
273
+ - **本技能的组织**:主文件给高频用法,完整参数表与高级示例在 [reference/backends.md](reference/backends.md)、[reference/knowledge.md](reference/knowledge.md)、[reference/pipeline-schema.md](reference/pipeline-schema.md)、[reference/self-extension.md](reference/self-extension.md)、[reference/steps-reference.md](reference/steps-reference.md)、[reference/workflows.md](reference/workflows.md),需要时再展开;示例工程与生成的数据写到工作目录,不要改动技能目录本身。
281
274
  - **执行环境**:命令在终端 / shell 中执行(Windows 用 PowerShell);`python` 可能指向 QGIS/GDAL 自带解释器,建议在工作区建独立 venv 后 `pip install -e .`,避免污染系统环境。
282
275
  - **源码安装(未上 PyPI)**:`git clone https://github.com/znlgis/GeoPipeAgent.git && pip install -e ".[analysis,network]"`;验证 `geopipe-agent --help`、`geopipe-agent list-steps --category qc`、`pip show geopipe-agent | Select-String Version`。不要写 `pip install geopipe-agent`——PyPI 上还没有这个包。
283
276
  - **先探测能力**:`geopipe-agent backends` 看当前环境可用后端(默认 `native_python`),`geopipe-agent list-steps --format json` 拿真实步骤 ID;`validate` 报 `not registered` 时先用 `geopipe-agent resolve "<需求>"` 与 `knowledge search`,不要猜参数。
@@ -1,5 +1,17 @@
1
1
  # GeoPipeAgent Steps Reference
2
2
 
3
+ ## Contents
4
+
5
+ - analysis
6
+ - gdal
7
+ - http
8
+ - io
9
+ - network
10
+ - qc
11
+ - qgis
12
+ - raster
13
+ - vector
14
+
3
15
  Auto-generated reference of all available pipeline steps.
4
16
 
5
17
  ## analysis
@@ -1,5 +1,13 @@
1
1
  # GeoPipeAgent 典型工作流(可套用 YAML)
2
2
 
3
+ ## Contents
4
+
5
+ - 工作流 1:数据质检 + 修复流水线
6
+ - 工作流 2:缓冲区 + 叠加分析
7
+ - 工作流 3:DEM 分析 + 等值线
8
+ - 工作流 4:网络分析
9
+ - 工作流 5:空间聚类 + 热力图
10
+
3
11
  ### 工作流 1:数据质检 + 修复流水线
4
12
 
5
13
  ```yaml
@@ -1,17 +1,10 @@
1
1
  ---
2
2
  name: geoserver
3
3
  description: "Use when deploying GeoServer 3.0.x to publish WMS/WFS/WMTS/WCS/MVT, or configuring SLD/CSS styles, RBAC security, and GeoWebCache seeding. Covers geoserver-3.0.2-bin.zip, docker.osgeo.org/geoserver:3.0.2 on Java 17/21, /rest/about/version.json, blank GetMap from wrong native bounds, and Shapefile charset mojibake."
4
- tags:
5
- - java
6
- - server
7
- - wms
8
- - wfs
9
- - wmts
10
- - wcs
11
- - wps
12
- - ogc
13
- - map
14
- - web
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, server, wms, wfs, wmts, wcs, wps, ogc, map, web"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/geoserver/geoserver>
@@ -20,7 +13,7 @@ tags:
20
13
  >
21
14
  > **下载:** <https://geoserver.org/release/stable/>
22
15
  >
23
- > **最新版本:** 3.0.2(2026-10-17 发布,安全修复版,生产应优先升级;[官方下载](https://geoserver.org/release/stable/))
16
+ > **最新版本:** 3.0.2(2026-10-19 发布,安全修复版,生产应优先升级;截至 2026-11,[官方下载](https://geoserver.org/release/stable/))
24
17
  >
25
18
  > **运行环境:** Java 17 或 21;3.0.2 内含 GeoTools 35.2、GeoWebCache 2.0.2
26
19
  >
@@ -1,26 +1,19 @@
1
1
  ---
2
2
  name: geoserver-cloud
3
- description: "Use when deploying GeoServer Cloud 3.0.2 on Docker Compose or Kubernetes — gateway serving WMS/WFS/WCS/WPS/GWC microservices under /geoserver/cloud, PgConfig vs datadir backends, RabbitMQ config-bus sync, Helm chart geoservercloud 3.0.2, and diagnosing 502s via actuator/health and Consul registration."
4
- tags:
5
- - java
6
- - server
7
- - wms
8
- - wfs
9
- - wmts
10
- - cloud
11
- - kubernetes
12
- - docker
13
- - microservices
14
- - spring-cloud
3
+ description: "Use when deploying GeoServer Cloud 3.0.2.1 on Docker Compose or Kubernetes — gateway serving WMS/WFS/WCS/WPS/GWC microservices under /geoserver/cloud, PgConfig vs datadir backends, RabbitMQ config-bus sync, Helm chart geoservercloud 3.0.3, and diagnosing 502s via actuator/health and Consul registration."
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, server, wms, wfs, wmts, cloud, kubernetes, docker, microservices, spring-cloud"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/geoserver/geoserver-cloud>
18
11
  >
19
12
  > **官方文档:** <https://geoserver.org/geoserver-cloud/>
20
13
  >
21
- > **Docker Hub:** <https://hub.docker.com/u/geoservercloud>(镜像标签与 GeoServer 主版本对应,如 `3.0.2`)
14
+ > **Docker Hub:** <https://hub.docker.com/u/geoservercloud>(镜像标签形如 `3.0.2.1`,尾段为该版本线的补丁号)
22
15
  >
23
- > **最新版本:** 3.0.2(2026-10-20,[GitHub Releases](https://github.com/geoserver/geoserver-cloud/releases))
16
+ > **最新版本:** 3.0.2.1(2026-11-03,截至 2026-11,[GitHub Releases](https://github.com/geoserver/geoserver-cloud/releases));配套 Helm chart `geoservercloud` 3.0.3
24
17
  >
25
18
  > **许可证:** GPL-2.0
26
19
 
@@ -43,7 +36,7 @@ GeoServer Cloud(GS Cloud):
43
36
  | 服务 | 镜像 | 用途 |
44
37
  |------|------|------|
45
38
  | `gateway` | `geoservercloud/geoserver-cloud-gateway` | 网关 |
46
- | `discovery` | —(3.x 不再发布该镜像) | 服务发现:官方 compose/K8s 改用 `hashicorp/consul`,`geoservercloud/geoserver-cloud-discovery:3.0.2` 在 Docker Hub 已 404 |
39
+ | `discovery` | —(3.x 不再发布该镜像) | 服务发现:官方 compose/K8s 改用 `hashicorp/consul`,`geoservercloud/geoserver-cloud-discovery` 镜像在 Docker Hub 已 404 |
47
40
  | `config` | `geoservercloud/geoserver-cloud-config` | 配置中心 |
48
41
  | `web-ui` | `geoservercloud/geoserver-cloud-webui` | 管理界面 |
49
42
  | `rest` | `geoservercloud/geoserver-cloud-rest` | REST API |
@@ -98,7 +91,7 @@ PGCONFIG_SCHEMA: "pgconfig" # 启动时自动创建 schema
98
91
  ## Kubernetes(Helm)
99
92
 
100
93
  ```bash
101
- # Chart:camptocamp/helm-geoserver-cloud(chart 名 geoservercloud,最新 3.0.2)
94
+ # Chart:camptocamp/helm-geoserver-cloud(chart 名 geoservercloud,最新 3.0.3)
102
95
  helm repo add geoserver-cloud https://camptocamp.github.io/helm-geoserver-cloud
103
96
  helm repo update
104
97
  ```
@@ -110,7 +103,7 @@ helm repo update
110
103
  > dependencies:
111
104
  > - name: geoservercloud
112
105
  > repository: https://camptocamp.github.io/helm-geoserver-cloud
113
- > version: 3.0.2
106
+ > version: 3.0.3
114
107
  > ```
115
108
  >
116
109
  > ```yaml
@@ -182,7 +175,7 @@ management:
182
175
  ```bash
183
176
  docker run -e SPRING_PROFILES_ACTIVE=datadir \
184
177
  -v /mnt/gsdata:/opt/app/data_directory \
185
- geoservercloud/geoserver-cloud-wms:3.0.2
178
+ geoservercloud/geoserver-cloud-wms:3.0.2.1
186
179
  ```
187
180
 
188
181
  ---
@@ -254,7 +247,7 @@ kubectl -n gis scale deploy <wms-deployment> --replicas=10
254
247
  - **验证产物**:部署后逐服务探活,再经网关 `.../rest/workspaces.json` 与一次 WMS `GetMap` 走通全链路;`docker compose ps` 显示 Up 不等于 OGC 服务可用。
255
248
  - **排障顺序**:502 → 查 Consul 注册与目标服务健康(`kubectl -n gis logs deploy/<wms>`);配置不生效 → 查 RabbitMQ 与 `GEOSERVER_BUS_ENABLED`;瓦片 404 → 查 gwc 是否部署、`GEOSERVER_BASE_PATH` 前缀是否一致。
256
249
  - **安全与权限**:`admin:geoserver`、`PGCONFIG_PASSWORD`、RabbitMQ 口令不要回显到报告;`docker compose down -v`、`helm uninstall`、删 PVC 或 PgConfig schema 会丢配置,先向用户确认并备份。
257
- - **先本地复现**:能在 docker compose 复现的问题再上 K8s;镜像标签与 chart 版本保持同一版本号(3.0.2),避免网关与服务错配。
250
+ - **先本地复现**:能在 docker compose 复现的问题再上 K8s;同一套部署里所有 `geoserver-cloud-*` 镜像用同一标签(当前 3.0.2.1);Helm chart 当前为 3.0.3,chart 版本与本仓库镜像标签不必相同,但升级时先查 chart values 默认镜像标签。
258
251
 
259
252
  ## 相关技能
260
253
 
@@ -1,17 +1,10 @@
1
1
  ---
2
2
  name: geoserver-rest-api
3
3
  description: "Use when automating GeoServer 3.0.2 over REST — POST /rest/workspaces, datastores, featuretypes, PUT Shapefile ZIP to file.shp, GeoTIFF to coveragestores, upload SLD as application/vnd.ogc.sld+xml, ?recurse=true deletes. curl -u admin:geoserver, single-key JSON like {\"workspace\":{...}}, 401 on POST but 200 on GET, GWC cache masking style changes."
4
- tags:
5
- - rest
6
- - api
7
- - http
8
- - server
9
- - wms
10
- - wfs
11
- - automation
12
- - curl
13
- - geoserver
14
- - json
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "rest, api, http, server, wms, wfs, automation, curl, geoserver, json"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/geoserver/geoserver>
@@ -20,7 +13,7 @@ tags:
20
13
  >
21
14
  > **API 参考:** <https://docs.geoserver.org/stable/en/user/rest/api/index.html>
22
15
  >
23
- > **最新版本:** GeoServer 3.0.2(2026-10-17 发布,安全修复版;[官方下载](https://geoserver.org/release/stable/))
16
+ > **最新版本:** GeoServer 3.0.2(2026-10-19 发布,安全修复版;截至 2026-11,[官方下载](https://geoserver.org/release/stable/))
24
17
  >
25
18
  > **许可证:** GPL-2.0
26
19
 
@@ -1,5 +1,21 @@
1
1
  # GeoServer REST API 端点清单
2
2
 
3
+ ## Contents
4
+
5
+ - 系统管理
6
+ - 工作空间 (Workspaces)
7
+ - 命名空间 (Namespaces)
8
+ - 数据存储 (Data Stores) — 矢量数据
9
+ - 要素类型 (Feature Types) — 矢量图层资源
10
+ - 覆盖存储 (Coverage Stores) — 栅格数据
11
+ - 覆盖 (Coverages) — 栅格图层资源
12
+ - 图层 (Layers)
13
+ - 图层组 (Layer Groups)
14
+ - 样式 (Styles)
15
+ - OGC 服务设置
16
+ - 安全管理 (Security)
17
+ - GeoWebCache 集成
18
+
3
19
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录 GeoServer REST API 全部端点分组清单(系统管理、工作空间、命名空间、数据存储、要素类型、覆盖存储、覆盖、图层、图层组、样式、OGC 服务设置、安全、GeoWebCache)。
4
20
 
5
21
  **基础 URL:** `http://{host}:{port}/geoserver/rest`
@@ -1,24 +1,17 @@
1
1
  ---
2
2
  name: geotools
3
3
  description: "Use when building Java GIS apps on GeoTools 35.2 (JDK 17) — org.geotools:gt-main / gt-shapefile / gt-geopkg / gt-epsg-hsql from repo.osgeo.org (not Maven Central), CQL/ECQL filters, CRS.decode plus JTS.transform reprojection, StreamingRenderer PNG output, and disposing DataStore/SimpleFeatureIterator."
4
- tags:
5
- - java
6
- - gis
7
- - ogc
8
- - wms
9
- - wfs
10
- - vector
11
- - raster
12
- - crs
13
- - rendering
14
- - jts
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, gis, ogc, wms, wfs, vector, raster, crs, rendering, jts"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/geotools/geotools>
18
11
  >
19
12
  > **Maven GroupId:** `org.geotools`
20
13
  >
21
- > **最新版本:** 35.2(2026-10-16,[OSGeo Maven 仓库](https://repo.osgeo.org/repository/release/))
14
+ > **最新版本:** 35.2(2026-10-16,截至 2026-11,[OSGeo Maven 仓库](https://repo.osgeo.org/repository/release/))
22
15
  >
23
16
  > **许可证:** LGPL 2.1
24
17
  >
@@ -1,5 +1,10 @@
1
1
  # GeoTools Raster and Rendering Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 栅格数据(GeoTIFF)
6
+ - 地图渲染
7
+
3
8
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录 GeoTIFF 栅格处理与地图渲染输出示例。
4
9
 
5
10
  ---
@@ -1,5 +1,12 @@
1
1
  # GeoTools Vector I/O Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 矢量数据读取
6
+ - 矢量数据写入
7
+ - GeoJSON 读写
8
+ - WKT / WKB 格式转换
9
+
3
10
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录矢量数据读写(Shapefile / GeoPackage / PostGIS)与 GeoJSON、WKT/WKB 格式示例。
4
11
 
5
12
  ---
@@ -1,16 +1,10 @@
1
1
  ---
2
2
  name: grass-gis
3
3
  description: "Use when doing GIS geoprocessing with GRASS GIS headlessly — grass --exec and --tmp-project for servers and CI, g.region computational region management, r.* raster, v.* vector, r3.* 3D raster and t.* temporal modules, r.import/v.import data import, or Python scripting with grass.script, grass.script.array and grass.tools."
4
- tags:
5
- - gis
6
- - raster
7
- - vector
8
- - python
9
- - cli
10
- - headless
11
- - temporal
12
- - automation
13
- - qgis
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "gis, raster, vector, python, cli, headless, temporal, automation, qgis"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/OSGeo/grass>
@@ -19,7 +13,7 @@ tags:
19
13
  >
20
14
  > **手册入口:** <https://grass.osgeo.org/grass-stable/manuals/>
21
15
  >
22
- > **最新版本:** 8.5.0(截至 2026-10,GitHub Releases;8.4 系列最新补丁 8.4.2)
16
+ > **最新版本:** 8.5.0(截至 2026-11,GitHub Releases;8.4 系列最新补丁 8.4.2)
23
17
  >
24
18
  > **许可证:** GPL-2.0
25
19
 
@@ -33,7 +27,7 @@ GRASS GIS(Geographic Resources Analysis and Support System)是 OSGeo 创始
33
27
  - **计算区域独立管理**:栅格模块在 `g.region` 定义的窗口上运算,与地图本身范围解耦。
34
28
  - **无头执行**:`grass --exec` / `--tmp-project` / `--tmp-mapset` 支持服务器与 CI 场景。
35
29
  - **时空框架**:`t.*` 模块管理 strds / str3ds / stvds 时空数据集。
36
- - **Python 接口**:`grass.script`(命令封装)、`grass.script.array`(NumPy 读写栅格)、`grass.tools`(8.4+ 面向对象工具调用)、`grass.jupyter`(笔记本集成)。
30
+ - **Python 接口**:`grass.script`(命令封装)、`grass.script.array`(NumPy 读写栅格)、`grass.tools`(8.5+ 面向对象工具调用)、`grass.jupyter`(笔记本集成)。
37
31
 
38
32
  ## 环境准备
39
33
 
@@ -231,7 +225,7 @@ elev_ft.write(mapname="elev_ft", overwrite=True)
231
225
  elev3d = garray.array3d(mapname="elev3d")
232
226
  ```
233
227
 
234
- 8.4+ 提供面向对象的工具调用接口 `grass.tools`(模块名中的点替换为下划线,支持 numpy 输入输出):
228
+ 8.5+ 提供面向对象的工具调用接口 `grass.tools`(模块名中的点替换为下划线,支持 numpy 输入输出);8.4.x 及更早版本没有该模块,只能用 `grass.script`:
235
229
 
236
230
  ```python
237
231
  from grass.tools import Tools
@@ -313,7 +307,7 @@ grass $HOME/grassdata/ndvi_project/PERMANENT --exec sh -c '
313
307
  ## AI 使用建议
314
308
 
315
309
  - **执行环境**:命令在终端 / shell 中执行(Windows 用 PowerShell)。正文里 `grass ... --exec sh -c '...'` 的多行引用在 PowerShell 下不可靠,改为把模块序列写进 `.py` 脚本(首行 `#!/usr/bin/env python3`),再 `grass --tmp-project EPSG:3857 --exec python3 analysis.py`。
316
- - **先探测版本**:`grass --version`(应为 8.5.0,LTR 8.4.2)、`grass --tmp-project EPSG:3857 --exec g.region -p`;8.4 之前没有 `grass.tools`,Python 脚本改用 `gs.run_command`。
310
+ - **先探测版本**:`grass --version`(应为 8.5.0,LTR 8.4.2)、`grass --tmp-project EPSG:3857 --exec g.region -p`;`grass.tools` 自 8.5.0 起提供,8.4.x/LTR 上 Python 脚本改用 `gs.run_command`。
317
311
  - **验证产物**:`--tmp-project` 内的地图最后必须导出——`r.out.gdal input=slope output=/work/slope.tif format=GTiff`,随后 `gdalinfo -json slope.tif` 核对 CRS 与范围;会话内核对用 `g.region -p format=json`、`g.list type=raster`。
318
312
  - **区域语义优先**:栅格模块只处理计算区域内的像元,结果范围不对先看 `g.region -p`;重复运行加 `--overwrite`,否则模块报地图已存在并非零退出。
319
313
  - **错误识别**:GRASS 模块的失败以 `ERROR:` 开头并返回非零码(如 `Raster map <x> not found`),据此区分地图名、区域为空还是输出已存在问题,不要只读最后一行日志。
@@ -1,24 +1,17 @@
1
1
  ---
2
2
  name: jts
3
3
  description: "Use when doing precise 2D computational geometry in Java with org.locationtech.jts:jts-core 1.20.0 — GeometryFactory construction, contains/intersects predicates, overlay via OverlayNGRobust, buffer, STRtree and PreparedGeometry speedups, WKT/WKB/GeoJSON I/O, and fixing TopologyException or unclosed rings."
4
-
5
- tags:
6
- - java
7
- - geometry
8
- - topology
9
- - spatial
10
- - de9im
11
- - wkt
12
- - wkb
13
- - geojson
14
- - gis
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "java, geometry, topology, spatial, de9im, wkt, wkb, geojson, gis"
15
8
  ---
16
9
 
17
10
  > **项目地址:** <https://github.com/locationtech/jts>
18
11
  >
19
12
  > **Maven Central:** `org.locationtech.jts:jts-core`
20
13
  >
21
- > **最新版本:** 1.20.0(截至 2026-10,[Maven Central](https://central.sonatype.com/artifact/org.locationtech.jts/jts-core))
14
+ > **最新版本:** 1.20.0(截至 2026-11,[Maven Central](https://central.sonatype.com/artifact/org.locationtech.jts/jts-core))
22
15
  >
23
16
  > **许可证:** Eclipse Public License 2.0 / Eclipse Distribution License 1.0(BSD 风格)
24
17
  >
@@ -1,5 +1,18 @@
1
1
  # JTS Geometry Operations and Index Reference
2
2
 
3
+ ## Contents
4
+
5
+ - 空间关系判断
6
+ - 集合运算
7
+ - 几何分析
8
+ - 几何简化
9
+ - 精度模型
10
+ - 格式读写
11
+ - 空间索引
12
+ - PreparedGeometry(加速重复判断)
13
+ - 线性参考
14
+ - 仿射变换
15
+
3
16
  > 这是 [../SKILL.md](../SKILL.md) 的补充文件,收录空间关系、集合运算、几何分析、格式读写与空间索引的完整参考。
4
17
 
5
18
  ---