@dsh-gis/dsh-opengis-skill 0.1.2 → 0.1.3

package/assets/shapely/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: shapely
-description: "Use when performing computational geometry in Python — intersection, union, buffer, convex hull, simplification. Shapely: Python bindings for GEOS, the C++ geometry engine that powers PostGIS."
+description: "Use when doing computational geometry in Python — shapely.intersection/union/buffer/convex_hull/simplify, STRtree queries, from_wkt/to_wkt/to_geojson, make_valid, GEOS-gated ops (coverage_clean, split); also for TopologyException on self-intersecting polygons or OOP vs function buffer quad_segs mismatch. Shapely 2.2.0 binds GEOS."
 tags:
   - python
   - geometry
@@ -275,24 +275,16 @@ left_idx, right_idx = tree.query(left_geoms, predicate="intersects")
 # left_idx[i] and right_idx[i] are paired matches
 ```
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **创建几何**：使用 `shapely.points()` / `shapely.linestrings()` / `shapely.polygons()` 向量化创建，或 `Point()` / `LineString()` / `Polygon()` OOP 方式
-2. **空间运算**：使用向量化函数（`shapely.intersection()` / `shapely.buffer()`）批量处理，比逐个 OOP 调用快 10-100 倍
-3. **空间谓词**：使用 `shapely.contains()` / `shapely.intersects()` 等函数式 API，返回 bool 数组
-4. **空间索引**：`STRtree` 查询 + `predicate="intersects"` 加速批量空间关系判断
-5. **序列化**：`shapely.from_wkt()` / `shapely.to_geojson()` 等进行格式互转
-
-### 关键注意事项
-
-- **Z 坐标在分析中被忽略**：所有空间运算仅在 x-y 平面进行
-- **`contains` 不包含边界**：如需边界判断使用 `covers()` 或 `intersects()`
-- **向量化函数 vs OOP 方法**：函数式 API（`shapely.area(geoms)`）释放 GIL，支持 NumPy 广播，性能远优于 OOP（`geom.area`）
-- **`set_precision` 改变顶点顺序**：返回的几何为"温和规范形式"，不应依赖顶点顺序
-- **Prepared 状态不持久**：任何操作产生新几何后需重新 `prepare()`
-- **WKB 会丢弃 LinearRing**：WKB 序列化时 LinearRing 变为 LineString
+- **加载与引用**：用 `skill("shapely")` 加载（用户也可输入 `/shapely`）；`reference/operations-reference.md` 按需 `read`，路径相对加载结果中的 Base directory；技能目录只读，验证脚本与产物写到会话工作区。
+- **执行环境**：命令交给 dsh 的 shell 工具（Windows 用 `pwsh`，仅暴露 `run_code` 的会话在 `tools.pwsh` 里跑）；`python` 不一定是 QGIS/GDAL 自带环境，先 `python -c "import sys; print(sys.executable, sys.version)"`。
+- **先探测版本**：`python -c "import shapely; print(shapely.__version__, shapely.geos_version)"`；本技能按 2.2.0 编写，PyPI wheel 内含 GEOS 3.14.1。GEOS 低版本请按第 11 条降级（如 `coverage_clean` 需 3.14、`shapely.split` 需 3.15）。
+- **验证产物（必做）**：`print(shapely.is_valid(g), shapely.is_valid_reason(g))` 报无效原因；面积/长度做量级断言；序列化回读 `shapely.from_wkt(shapely.to_wkt(g, rounding_precision=-1)).equals(g)`，改过几何后再核对一次 `geom_type` 与 `get_num_geometries()`。
+- **报错先查有效性**：`TopologyException: side location conflict` 基本都是输入几何自相交，先 `shapely.make_valid(g)`（可指定 `method="structure"`）再算，不要直接加 `buffer(0)`。
+- **性能与内存**：批量操作走向量化函数（`shapely.union_all`、`shapely.buffer(geoms, r)`），别逐条 OOP 循环；十万级以上几何先 `STRtree(geoms)` 过滤，再对小集合做精确谓词。
+- **典型误操**：`set_coordinates()`/`shapely.prepare()` 都是原地修改，先 `.copy()`；`shapely.buffer` 默认 `quad_segs=8` 与 `Point.buffer()` 的 16 不同，比较结果前显式传参。
+- **安全**：`pip install shapely` 前先征得用户同意；输出 WKT/坐标前确认数据是否敏感（精确坐标可反推位置），大几何 dump 到文件再分段读，别刷屏。
 
 ---
 

package/assets/sharpmap/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sharpmap
-description: "Use when rendering 2D maps in legacy .NET WinForms or ASP.NET WebForms applications. SharpMap: an older .NET 2D mapping library. For new projects, prefer Mapsui."
+description: "Use when rendering 2D maps in legacy .NET Framework 4.7.2 WinForms or ASP.NET WebForms apps with SharpMap 1.2.0 — Map.GetMap() to PNG, ShapeFile/PostGIS providers, VectorLayer with CustomTheme, TileAsyncLayer via BruTile, ProjNet4GeoAPI transforms, or debugging blank output and GDI+ handle leaks. New projects should use Mapsui."
 tags:
   - dotnet
   - csharp
@@ -278,23 +278,15 @@ map.Layers.Add(new TileAsyncLayer(tileSrc, "OSM"));
 map.SRID = 3857;
 ```
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **创建 Map**：`new Map(new Size(width, height))` → 设置 SRID
-2. **添加数据源**：`ShapeFile(path)` / `PostGIS(conn, table, geomCol, idCol)` 等方式连接数据
-3. **创建图层**：`VectorLayer(name, provider)` 并设置 `Style`；按需添加 `LabelLayer`
-4. **添加底图**：`TileAsyncLayer` + `BruTile` 加载 OSM 在线底图
-5. **渲染输出**：`map.GetMap()` 获取 `Image` 对象 → 保存为 PNG 或通过 ASP.NET WMS 发布
-
-### 关键注意事项
-
-- **新项目建议 Mapsui**：SharpMap 主要面向 .NET Framework，新项目推荐使用 Mapsui（更活跃、跨平台更好）
-- **SRID 一致性**：图层与地图 SRID 必须一致，必要时通过 `CoordinateTransformation` 转换
-- **空间索引**：Shapefile 需预建 `.qix` 索引，PostGIS 用 GiST 索引加速查询
-- **资源释放**：GDI+ `Brush`/`Pen`/`Bitmap` 需及时释放避免内存泄漏
-- **Shapefile 编码**：中文数据需指定 `Encoding.UTF8` 或 `Encoding.GetEncoding("GBK")`
+- **加载与引用**：用 `skill("sharpmap")` 加载（用户也可输入 `/sharpmap`）；示例写入会话工作区的 .NET 工程，技能目录只读。
+- **执行环境**：先 `dotnet --list-sdks`；核心包 `SharpMap` 是 netstandard2.0，可被 .NET 8+ 工程引用，但 WinForms 控件 `SharpMap.UI` 只有 .NET Framework 4.7.2，目标框架必须选 net472，不能套 net8.0。
+- **验证产物**：`dotnet build` 后 `map.GetMap()` 取 `System.Drawing.Image` 再 `Save("output.png")`，用 `read_image` 看实际着色与标注；编译通过不代表渲染正确。
+- **依赖风险**：SharpMap 1.2.0（2021-03）的传递依赖含 `NetTopologySuite.Core` 1.15.3、`System.Drawing.Common` 4.6.0、`System.Data.SqlClient` 4.7.0，`dotnet restore` 会报 NU1902/NU1903/NU1904 漏洞告警，需向用户说明而不是静默忽略。
+- **坐标与 SRID**：`map.SRID` 与图层 SRID 必须一致；ProjNet 2.x 不再实现 GeoAPI 接口，坐标变换用 `ProjNet4GeoAPI` 1.4.1。
+- **资源释放**：GDI+ 的 `Brush`/`Pen`/`Bitmap` 必须 `using` 或 `Dispose`，否则长时间运行内存持续上涨。
+- **安全与权限**：新建工程、装包、连接 PostGIS 前先征得用户同意；连接串里的密码不要写进代码或回答。
 
 ## 相关技能
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-gis/dsh-opengis-skill",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "OpenGIS skill pack for DeepSeek Harness: the gis/ skills from opengis-skills (GDAL, QGIS, GeoServer, PostGIS, JTS, CesiumJS, OpenLayers and more), loaded on demand.",
   "type": "module",
   "main": "lib/index.js",

package/upstream.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "repository": "https://github.com/znlgis/opengis-skills",
-  "commit": "c18c097b93a1e01792bdcc2d7c0f5c7f0f664988",
-  "syncedAt": "2026-10-19T04:05:40.659Z",
+  "commit": "4b64b890758af0c0abfaf853f0d5a1f6b287a1df",
+  "syncedAt": "2026-10-20T09:25:23.608Z",
   "hashAlgorithm": "sha256",
   "skillCount": 32,
   "skills": [
@@ -40,63 +40,63 @@
     "sharpmap"
   ],
   "files": {
-    "cesiumjs/SKILL.md": "d15c900b0cb4eb3d9cbba9d64f3bb2abcf49c42bdf4cfdc07074c2536691fda0",
-    "deck-gl/SKILL.md": "fd41bdddf7bef5bae98c8ee06cf5fbb1d940edf7ca38c3187d17c05bb22027d6",
-    "gdal-api/SKILL.md": "6d6c573a0c815eb56a5ba37a825fabb24616babb3e1b957031bf52a8042b7cfe",
+    "cesiumjs/SKILL.md": "a0c6c7de3b27cc5a957e7fa3330a6916f9d4868ba795a98198238328289ee7d5",
+    "deck-gl/SKILL.md": "250ff67317699ac17fbe40b64fbaaf178e9b562337bdef5de91ba6888a014b91",
+    "gdal-api/SKILL.md": "0177017e7b4d1fee16d8224ed43935d88fa8a2500a189c2573da982168fdfa61",
     "gdal-api/reference/raster-api.md": "c0d4526602bf3e2e3f80abeaa972997c132e3f6fbbabd79347d035a3cd1f1c84",
     "gdal-api/reference/vector-api.md": "5907be299d5e969f294c25a53737454f0e5abcd6d74e0d3831ddd46d9f18d03f",
-    "gdal/SKILL.md": "3db004f046ab3882a7136ecb093826b9eddb74f53e8a098e9cfcffdb889b772f",
+    "gdal/SKILL.md": "f54b984a2a939162f7cd3966927c45eb1fe41ba01436ef706fd6921f29e2f181",
     "gdal/reference/data-formats.md": "443731a0f13330ab90e7ecc3e8e46d85519fbcd7013861dfa63f693668fdffd3",
     "gdal/reference/raster-tools.md": "a3ed2dbb9571ce59973729e8cea5d68cf039d30bf39c98b614fb523a61541f97",
     "gdal/reference/vector-tools.md": "284b5685f3f72b13865a8da2bef33637eb92820aa0b3cfec57f8c745a1fe3966",
-    "geometry-api-java/SKILL.md": "7b6d41dc8c4289b6c7744daba4dbb7b61afc80709bea42ec7def5b5855bc28a0",
-    "geometry-api-net/SKILL.md": "d53ff7d848524ce132b5100f7443561f285502addac5b42f8f03ae68ec2449cb",
+    "geometry-api-java/SKILL.md": "c30c019012a88a3a2a9f954348187ccf1027ce69dbadc1d05672810612eb9d05",
+    "geometry-api-net/SKILL.md": "434757ea42153b9e828179c06c35e256566f1846b435e4eeaf2fb6d5675e6c7c",
     "geometry-api-net/reference/geometry-types.md": "121e6ef0f5c7fb053b8e14bf42e952629bfb8b0717626fd7744db59ca6cfb4e7",
-    "geopandas/SKILL.md": "26f00dea35b0a9a35ce9b0580b38ff4684ffeb64156b96437aec4e5d9e14db42",
+    "geopandas/SKILL.md": "18e0434505999642a8b4a342adeb71b749a4ac55919eaa6cfcb6a4f3ba0fb81b",
     "geopandas/reference/core-api.md": "1e233adb18510d7d4788cfc18ac47982b53784b09ce37d2171494e9beba4e05f",
-    "geopipe-agent/SKILL.md": "50c788dcb87259b1a1102d7c4aee7fc36c44bfef3b73029c84a650d693d100c3",
+    "geopipe-agent/SKILL.md": "eae0e251e1c4be6e49b9f3e70a8156c541a3076580683997cf775a1ffc228c27",
     "geopipe-agent/reference/backends.md": "00d7658470e67661d6774eb827f9ab0ccbb2262604b3cb65a0382bf27d2b331f",
     "geopipe-agent/reference/knowledge.md": "63b1d44d6f83d4e33011c35855d08b2c83cd07f2ec21722a120b1e2164685e07",
     "geopipe-agent/reference/pipeline-schema.md": "9b6a7a87002fa2fa53f61441a0f9ace804b970ba9ea6b00b0308e2dba9a77cb6",
     "geopipe-agent/reference/self-extension.md": "552be0bfaef58f3cb7f10567362c3c7328bea520b8ef61bda5f79f84529e16a1",
     "geopipe-agent/reference/steps-reference.md": "3c1adaf5f9960ea9c99919cc61bb065e59ce2b77a6a029aa2a2e9977dc794bf8",
     "geopipe-agent/reference/workflows.md": "e4e0fb32dd83b7f7b27de5a42f6a2d7eea71c4fae7e8c7764d7defe7340e1313",
-    "geoserver-cloud/SKILL.md": "f7943b645440f03bab9055201a7552b7e86be47c8ce27b5f1c57487107e4300a",
-    "geoserver-rest-api/SKILL.md": "64827e5b164687a2b7e44f668a30f52f6ea66bd205a953e03b7357a3db7427d2",
+    "geoserver-cloud/SKILL.md": "ea576232fc304779aacaadf362ed81244427d151271f5dbcb7719fa11ca5e6ef",
+    "geoserver-rest-api/SKILL.md": "97dab100753151a6793a610a6133aa0649f0e9d31554460a0b884dbf38f8030b",
     "geoserver-rest-api/reference/endpoints.md": "20fbb2ea7ccddcbb34f5ecb227d53127073a8109edbff9ad1bbcae07a3cf1be7",
-    "geoserver/SKILL.md": "0e266a7975d80c7facda8dac8d1bce3e519fca11afa2bef631b10f8023769158",
-    "geotools/SKILL.md": "1bf76ab5870adba3ca4faca7887b2081e64bd04cdb6f5154ad08f14002337d3a",
+    "geoserver/SKILL.md": "a3c3fefa66faab93a074ada02f0f90be81731f60e7e68fbf247d1f708171e73d",
+    "geotools/SKILL.md": "08ad035c6bba695e1025e1f9f3584dfaced864f33d274bf2696996109dbe3155",
     "geotools/reference/raster-rendering.md": "3b1876ad39d8c11756b1ff5eac8cda9dab0d94f958f8cafa4f32d9ff5fa6ebd3",
     "geotools/reference/vector-io.md": "2dca5de4e149bc9e79bd5bfcb345c36e45da06a9d86a53bc28869168f55902f1",
-    "grass-gis/SKILL.md": "fc908f4bf14a026cf41997415f4a7d6d43b94914d1062e31f86c133dbc7343bc",
-    "jts/SKILL.md": "a8b739bc67e65f11cc714939e7e13e98736246693f61e07a662b1470b468888e",
+    "grass-gis/SKILL.md": "cb7b1b57c6d97c0f60db2d5b9b3f50bd66c3a8e2fe0b6d42124ff9b97e8ba49f",
+    "jts/SKILL.md": "ec27aa318d7df3f5a0502734278248f2064131dfb6712b5ca30018411d01ad96",
     "jts/reference/geometry-operations.md": "a242f1f0185136baa60f632072c041fb734185b844da25c37ef1f4e3b2685124",
-    "leaflet/SKILL.md": "44238568e0682acb72bfd68d97f25fb75608e9e2683965abfb272ba0d5bd46da",
-    "mapbox-gl-js/SKILL.md": "6c10bf3f7c3968f41f3bc030c1ca0c49f51fcea2b4c42a4f347cf845f9845759",
-    "mapserver/SKILL.md": "df291706233d90be652405726740667f2b6d82eee6594dcadd7979daa4e15aaf",
-    "mapsui/SKILL.md": "1a9eac49a40477360348e9dc37ed3cde9143b6f7e7feeef6838c12c0578f213e",
-    "nettopologysuite/SKILL.md": "a045193f0e4a16a9876fc36909b256eeb93901c14c77db3c914a8f8e24c514f0",
-    "opengis-all/SKILL.md": "e4b31d462be1c52fed6b019bb45321be4a40723a0b0bb28f4e6f3631e0175ef4",
+    "leaflet/SKILL.md": "0893a1fcba27efe6e98d140b7f475de32f21c76cd3d67ea51254f067aa0fb4db",
+    "mapbox-gl-js/SKILL.md": "a0e6b1ef0610448c3099e80a8c9293a7d4b5529c72af9ed4b4f32d60291cfeaa",
+    "mapserver/SKILL.md": "79d9a2a7bb891d592747f35954bfce328bfe1dd30627fc86e142dbdb1da43ee0",
+    "mapsui/SKILL.md": "472edb3ea1ae8457dfbbb931d7f4734b2d0556fe5392258f752748d82e650fcd",
+    "nettopologysuite/SKILL.md": "2df607de5c629aaefbc3c4d10824f8f3893fc2c67a1885d8cbf8ce797bcd9a05",
+    "opengis-all/SKILL.md": "716588baeee1f3b2b7cacfdb33882a9864e07fb1a628e423b1e4d535332db269",
     "opengis-all/reference/data-stages.md": "88d0182d8a96469b0ea8857a463517b3b38c1fde72b5599cad3958da7c8cb4ed",
     "opengis-all/reference/workflow-cheatsheets.md": "3bb58ea3b966ab1bd85380cda1253056ff03accb97f37d863f3f96e7ce6dbdb7",
-    "opengis-daf/SKILL.md": "3d8c496ecb0c54cc837f83355a67ba0866787ba58ef151c077b6c40fe014c040",
-    "opengis-utils-for-java/SKILL.md": "bb883b9175ffafd649eda066cffe642a0bebe6d29cf6d03b389d71b1a97259a6",
+    "opengis-daf/SKILL.md": "03264b143ec451914b22db082ddf9ccbadb88b50a99127bb88c9e9e4f185ddc0",
+    "opengis-utils-for-java/SKILL.md": "1fef2f2ea00de6f8db0469455eff01f4e98008828de4ab300e33ac50776ae3ec",
     "opengis-utils-for-java/reference/common-tasks.md": "a32f2e1181d9c49e1c8cc16bba1345c3d8aca6d42be1cc2afe2a330bd382b47a",
-    "opengis-utils-for-net/SKILL.md": "d0e63e540ec731904551ad5ffdaa8374430ea85e7439d88126102b32b78be560",
+    "opengis-utils-for-net/SKILL.md": "99755b1526444b35defc8d599d9813d259929dae49be2adfda5d66b1975e4ddd",
     "opengis-utils-for-net/reference/code-patterns.md": "379a6a22e10b291639fa6ee07ad105522523420666ea52a5e588f19fc5c8a064",
     "opengis-utils-for-net/reference/util-classes.md": "111fc1347edb8af6660b0f9614b5ecff4b6654ea19fe1549f6924eb8b3467db2",
-    "openlayers/SKILL.md": "6cfe6f10cc69e9e36b8db8e1a2896553144d6346061bdc433fbcf9dbc3ebe96e",
-    "pdal/SKILL.md": "eb4733ad80540b9911ca0a7aa6600bb0647f32dd088693c6f8855a0a45bff90d",
-    "postgis/SKILL.md": "2f83487427263b54217d49c08ffc9ce362867c6344e3e789e3246e6cc673c621",
-    "proj/SKILL.md": "42d1cb70c732f27fb1ec687737759278a70fa73e6bca97a0b2cff641ee16c0d9",
-    "pyqgis/SKILL.md": "1d24d2072aeaa519374dca7cca0bd75de91e187f882ac460f6340eaee4cd6a79",
+    "openlayers/SKILL.md": "ed3ded2858df6d32ba676ca0d3ed40081abe1de61e66d2ae90c3fd31b1d6900c",
+    "pdal/SKILL.md": "236502dbd4ed7ed8a33d9df95296ae4308d186154ca0f5a7178ed9c73825730d",
+    "postgis/SKILL.md": "2c73f71dc1f59207533c90532b22b4601b58614909cbbd64d601e0cc2b1c67a0",
+    "proj/SKILL.md": "9614715a733212770ec63079728973b5e06466028178da8eddfd1e242d3fb4ab",
+    "pyqgis/SKILL.md": "4af5661e2251fa44317208538ee7eb1a1754ed7146999e2d7483e9996da66872",
     "pyqgis/reference/processing-rendering.md": "138644c36ca3f30e746016bb7457fd3a2d18349c5740f02d1735ba6c59173a3e",
     "pyqgis/reference/vector-raster-layers.md": "fec965918eff2d24c6e8f8c68379c52bb10727892f8d599e6c425760d168cd2d",
-    "qgis-process/SKILL.md": "d9613cf47ae041c079b24d453074e6c4f3b5477617c16e9024aca3356f751aff",
+    "qgis-process/SKILL.md": "8a223874b8cb37225507e21502c176d319bf76ea5d42c875591210e3ef43308d",
     "qgis-process/reference/algorithm-cheatsheet.md": "d88720d80a2d78efefcf1ff9027b451f291bef5ef166fa9befcae484bfa91e8f",
-    "qgis-server/SKILL.md": "2cd0aa5b4a6b4372f96c88318cd36c035c26783a8b6f5a77fb5dc0752367affa",
-    "shapely/SKILL.md": "8cc848b6ca28d2dd50ff951ca44ae90cd0255a33f5e329a62f31828947006fb0",
+    "qgis-server/SKILL.md": "d0749cb2da2be6ca5d5c6418568851497eff547c041fa38035c0f958fd61e9fd",
+    "shapely/SKILL.md": "f6c1aceba0a7027cb31614bb49c33de3c1d763feaea6a45d008eb4b10da36984",
     "shapely/reference/operations-reference.md": "a984e9cd84dbfa3bc299284725639520883a85289f67a61d7b296a00665c2714",
-    "sharpmap/SKILL.md": "4bf964bcbd663009982e4cbe06ea80b9c8ee626bfcf7b98b615612f9356a7f72"
+    "sharpmap/SKILL.md": "f4c27d56c54f9c1574bc81a0a98083258a0b6b4fba2d60ae23a9f4abced537af"
   }
 }