@dsh-gis/dsh-opengis-skill 0.2.0 → 0.4.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 (126) hide show
  1. package/CHANGELOG.md +126 -1
  2. package/README.md +51 -25
  3. package/adaptations/brutile.md +6 -6
  4. package/adaptations/cesiumjs.md +6 -6
  5. package/adaptations/common.md +20 -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/geos.md +8 -0
  17. package/adaptations/geoserver-cloud.md +6 -6
  18. package/adaptations/geoserver-rest-api.md +6 -6
  19. package/adaptations/geoserver.md +6 -6
  20. package/adaptations/geotools.md +6 -6
  21. package/adaptations/grass-gis.md +6 -6
  22. package/adaptations/jts.md +6 -6
  23. package/adaptations/kepler-gl.md +6 -6
  24. package/adaptations/leaflet.md +6 -6
  25. package/adaptations/mapbox-gl-js.md +6 -6
  26. package/adaptations/maplibre-gl-js.md +8 -0
  27. package/adaptations/maplibre-native.md +8 -0
  28. package/adaptations/mapserver.md +6 -6
  29. package/adaptations/mapsui.md +6 -6
  30. package/adaptations/nettopologysuite.md +6 -6
  31. package/adaptations/opendronemap.md +8 -0
  32. package/adaptations/opengis-all.md +7 -6
  33. package/adaptations/opengis-daf.md +7 -6
  34. package/adaptations/opengis-utils-for-java.md +6 -6
  35. package/adaptations/opengis-utils-for-net.md +6 -6
  36. package/adaptations/openlayers.md +6 -6
  37. package/adaptations/pdal.md +6 -6
  38. package/adaptations/postgis.md +6 -6
  39. package/adaptations/proj.md +6 -6
  40. package/adaptations/projnet4geoapi.md +6 -6
  41. package/adaptations/pyqgis.md +6 -6
  42. package/adaptations/qgis-process.md +6 -6
  43. package/adaptations/qgis-server.md +6 -6
  44. package/adaptations/shapely.md +6 -6
  45. package/adaptations/sharpmap.md +6 -6
  46. package/adaptations/spatialite.md +6 -6
  47. package/adaptations/stac-cog-titiler.md +8 -0
  48. package/adaptations/whitebox-tools.md +6 -6
  49. package/assets/brutile/SKILL.md +6 -12
  50. package/assets/cesiumjs/SKILL.md +14 -18
  51. package/assets/deck-gl/SKILL.md +9 -15
  52. package/assets/duckdb-spatial/SKILL.md +41 -25
  53. package/assets/gdal/SKILL.md +11 -18
  54. package/assets/gdal/reference/raster-tools.md +14 -0
  55. package/assets/gdal/reference/vector-tools.md +5 -0
  56. package/assets/gdal-api/SKILL.md +8 -16
  57. package/assets/gdal-api/reference/raster-api.md +7 -0
  58. package/assets/gdal-api/reference/vector-api.md +9 -0
  59. package/assets/geolibre/SKILL.md +11 -17
  60. package/assets/geometry-api-java/SKILL.md +5 -10
  61. package/assets/geometry-api-net/SKILL.md +5 -11
  62. package/assets/geometry-api-net/reference/geometry-types.md +5 -0
  63. package/assets/geonode/SKILL.md +8 -15
  64. package/assets/geopandas/SKILL.md +46 -17
  65. package/assets/geopandas/reference/core-api.md +55 -0
  66. package/assets/geopipe-agent/SKILL.md +7 -14
  67. package/assets/geopipe-agent/reference/steps-reference.md +12 -0
  68. package/assets/geopipe-agent/reference/workflows.md +8 -0
  69. package/assets/geos/SKILL.md +372 -0
  70. package/assets/geoserver/SKILL.md +6 -13
  71. package/assets/geoserver-cloud/SKILL.md +12 -21
  72. package/assets/geoserver-rest-api/SKILL.md +5 -12
  73. package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
  74. package/assets/geotools/SKILL.md +5 -12
  75. package/assets/geotools/reference/raster-rendering.md +5 -0
  76. package/assets/geotools/reference/vector-io.md +7 -0
  77. package/assets/grass-gis/SKILL.md +36 -18
  78. package/assets/jts/SKILL.md +5 -12
  79. package/assets/jts/reference/geometry-operations.md +13 -0
  80. package/assets/kepler-gl/SKILL.md +10 -16
  81. package/assets/leaflet/SKILL.md +19 -23
  82. package/assets/mapbox-gl-js/SKILL.md +11 -16
  83. package/assets/maplibre-gl-js/SKILL.md +478 -0
  84. package/assets/maplibre-native/SKILL.md +383 -0
  85. package/assets/mapserver/SKILL.md +12 -16
  86. package/assets/mapsui/SKILL.md +29 -18
  87. package/assets/nettopologysuite/SKILL.md +5 -11
  88. package/assets/opendronemap/SKILL.md +309 -0
  89. package/assets/opengis-all/SKILL.md +14 -19
  90. package/assets/opengis-all/reference/data-stages.md +7 -0
  91. package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
  92. package/assets/opengis-daf/SKILL.md +5 -13
  93. package/assets/opengis-utils-for-java/SKILL.md +7 -11
  94. package/assets/opengis-utils-for-java/reference/common-tasks.md +4 -0
  95. package/assets/opengis-utils-for-net/SKILL.md +5 -10
  96. package/assets/opengis-utils-for-net/reference/code-patterns.md +4 -0
  97. package/assets/opengis-utils-for-net/reference/util-classes.md +10 -0
  98. package/assets/openlayers/SKILL.md +16 -20
  99. package/assets/pdal/SKILL.md +15 -13
  100. package/assets/postgis/SKILL.md +21 -26
  101. package/assets/proj/SKILL.md +5 -12
  102. package/assets/projnet4geoapi/SKILL.md +6 -12
  103. package/assets/pyqgis/SKILL.md +5 -10
  104. package/assets/pyqgis/reference/processing-rendering.md +6 -0
  105. package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
  106. package/assets/qgis-process/SKILL.md +5 -12
  107. package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
  108. package/assets/qgis-server/SKILL.md +7 -13
  109. package/assets/shapely/SKILL.md +29 -14
  110. package/assets/shapely/reference/operations-reference.md +42 -0
  111. package/assets/sharpmap/SKILL.md +5 -11
  112. package/assets/spatialite/SKILL.md +15 -16
  113. package/assets/stac-cog-titiler/SKILL.md +420 -0
  114. package/assets/whitebox-tools/SKILL.md +28 -19
  115. package/lib/adaptations.d.ts +18 -0
  116. package/lib/adaptations.js +164 -7
  117. package/lib/catalog.d.ts +7 -1
  118. package/lib/catalog.js +9 -1
  119. package/lib/index.d.ts +9 -0
  120. package/lib/index.js +48 -3
  121. package/lib/skill-file.d.ts +12 -0
  122. package/lib/skill-file.js +107 -16
  123. package/locale/en.json +1 -1
  124. package/locale/zh.json +1 -1
  125. package/package.json +8 -3
  126. package/upstream.json +74 -64
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:单文件技能,没有 reference 子目录;代码块密集,先按章节标题(几何工厂、空间关系与运算、WKT/WKB/GeoJSON、STRtree、EF Core、ProjNet)定位再 `read` 片段,比整篇读省上下文。跨投影转 `projnet4geoapi`,Java 侧对照转 `jts`。
4
- - **执行环境**:`dotnet add package`、`dotnet build`、`dotnet run` 走 `ops_bash`;首次 restore 需要访问 NuGet,离线或受限时先说明再换源,不要反复重试。中文输出建议写进文件再用 `read` 看,避免控制台编码干扰判断。
5
- - **先探测版本**:`dotnet --version` 确认 SDK 6.0+,工程里 `dotnet list package` 核对 `NetTopologySuite` 2.6.0、`NetTopologySuite.IO.GeoJSON`(或 `IO.GeoJSON4STJ`)4.0.0、`NetTopologySuite.IO.Esri.Shapefile` 1.2.0、`ProjNet` 2.1.0;IO 包与主库错配是这类工程最常见的编译/运行期报错源。
6
- - **验证产物**:`dotnet build` 后跑 `dotnet test`,或最小控制台做 WKT 往返 + `IsValid` 断言;`GeoJsonConverterFactory` 序列化后再反序列化,比对坐标数与 `IsValid`,只打日志不算验证。
7
- - **风险与权限**:`WKBWriter` 默认丢 Z/M,需要就用 `HandleOrdinates`;SRID 只是元数据、计算在平面进行,跨投影交给 ProjNet;`GeometryFixer.Fix` 可能把无效面拆成 `MultiPolygon`,不要照抄正文那种 `(Polygon)GeometryFixer.Fix(poly)` 强转,否则遇到拆分的输入会抛转换异常,改用 `Geometry` 接收。EF Core 里不要同时引 `Microsoft.SqlServer.Types`,类型冲突会直接报错。装包、建工程、连数据库前征得用户同意。
8
- - **常见失败**:`TopologyException` 先 `GeometryFixer.Fix`;`TypeInitializationException` 或程序集加载失败多半是 IO 包版本与主库不匹配;`GeoJsonConverterFactory` 找不到说明装的是 Newtonsoft 版 `IO.GeoJSON`,该类只在 `IO.GeoJSON4STJ`;Shapefile 读取报错通常是用了 `NetTopologySuite.IO.Esri.Shapefile` 之外的包或命名空间。
3
+ - **加载与引用**:单文件技能,无 reference 目录。正文代码块密集,先按「核心 API:几何工厂」「WKT / WKB / GeoJSON」「空间索引」「几何修复与简化」「EF Core」「ProjNet」「典型工作流」定位小节再 `read` 片段,或 `grep` 搜 `GeometryFixer`、`GeoJsonConverterFactory`、`HandleOrdinates` 直接跳到行号,不要整篇读。需要 Java 原版对照时用 `skill` 加载 `jts`,要 GDAL 侧读写时加载 `opengis-utils-for-net` 或 `gdal`。
4
+ - **执行环境**:建工程、装包、构建、运行走 `ops_bash`(本机 Windows 是 MSYS bash,先 `command -v dotnet` 确认);只有需要 `Get-Command` 或带反斜杠的 `.exe` 参数时才换 `pwsh`。探测代码放会话工作区(`dotnet new console -o work/nts-probe`),不要往 `assets/` 写;首次 `dotnet restore` 要访问 NuGet,内网先确认源可用,失败一次就报告,不要反复重试。MSYS 的 `/d/...` 传给 .NET 进程常解析失败,代码里的路径写 `D:\...`。
5
+ - **先探测版本**:`dotnet --version` 确认 SDK 6+,`dotnet list package --include-transitive` 核对 `NetTopologySuite` 2.6.0、`NetTopologySuite.IO.GeoJSON`(或 `IO.GeoJSON4STJ`)4.0.0、`IO.Esri.Shapefile` 1.2.0、`ProjNet` 2.1.0——正文按这组版本编写。低于 2.6 没有 `NtsGeometryServices` 工厂重载与 `GeometryFixer`;`WKTReader(GeometryFactory)` 在 2.6 已标记过时,能编但告警;旧 `ProjNet4GeoAPI` 停在 1.4.1,新工程用 `ProjNet`。
6
+ - **验证产物**:`dotnet build` 只证明编译过。写最小控制台跑正文「典型工作流」的判据:`parcel.Intersection(zone).Area` 为 12.5、`back.IsValid` 为 `true`、WKT 往返坐标数一致;输出重定向到 `run.log` 再 `read`,或写成 xunit 用例交给 `dotnet test`。Shapefile 产物用 `Shapefile.ReadAllFeatures` 回读要素数,机上有 GDAL 时再 `ogrinfo -so out.shp` 复核。要交付的 GeoJSON 用 `present` 列给用户。
7
+ - **风险与权限**:装 SDK、加 NuGet 包、连 SQL Server/PostgreSQL 都要先问人——用 `ask_user_question` 给「只读连接/新建库/跳过」选项,生产库不直接读写。`Shapefile.WriteAllFeatures` 与 `GeoJsonWriter` 写同名文件会覆盖,先换名或备份;EF Core 的 `EnsureCreated`、迁移、批量 `UPDATE` 都改库。`GeometryFixer.Fix` 可能返回 `MultiPolygon`,别照抄正文的 `(Polygon)` 强转;`WKBWriter` 默认丢 Z/M,需要时设 `HandleOrdinates`。
8
+ - **常见失败**:`TopologyException` 先用 `GeometryFixer.Fix`;`TypeInitializationException` 或程序集加载失败多为 IO 包与主库版本错配;`GeoJsonConverterFactory` 找不到说明装的是 Newtonsoft 版 `IO.GeoJSON`,该类只在 `IO.GeoJSON4STJ`;EF Core 类型冲突是同时引了 `Microsoft.SqlServer.Types`。
@@ -0,0 +1,8 @@
1
+ ## DeepSeek Harness 使用建议
2
+
3
+ - **加载与引用**:单文件技能,没有 reference 目录;正文「核心命令」的参数表与预设组合是主要入口,「典型工作流」四条链路按场景取用,「常见问题」表先对症状。成果入库转换用 `skill` 加载 `gdal`,点云清洗用 `pdal`,三维发布用 `cesiumjs`;不要 `read` 兄弟目录的 SKILL.md。
4
+ - **执行环境**:全部命令在 `ops_bash` 里跑,Windows 侧依赖 Docker Desktop,动手前确认守护进程在跑(`docker info` 能出 Server 段)。正文的 `docker run -ti` 在 DSH 里会因无 TTY 报 `the input device is not a TTY`,去掉 `-t` 只留 `-i` 或直接不加;MSYS bash 会把 `-v /datasets:/datasets` 这类参数当路径改写,挂载统一写成宿主 `-v /d/datasets:/datasets` 并在命令前加 `MSYS_NO_PATHCONV=1`,或改用 `pwsh` 调 `docker run -v d:/datasets:/datasets`。整条流水线以小时计、镜像首次拉取就上 GB,必须 `run_in_background` 起作业、`job_output`(可带 `wait`)收进度与末尾日志,跑错再 `job_kill`,不要在一条前台命令里等完。
5
+ - **先探测版本**:`docker --version` 与 `docker info --format '{{.MemTotal}}'` 先看引擎与可用内存(OOM 是头号失败原因),`docker run --rm opendronemap/odm:3.6.2 --version` 确认镜像标签是正文写的 3.6.2 而不是 `latest`,第一次会先拉镜像,同样放后台。WebODM 侧 `curl -s http://localhost:8000/api/` 应返回带 version 的 JSON,起 `./webodm.sh` 前先 `curl -s -o /dev/null -w '%{http_code}' http://localhost:8000/` 看端口有没有被占。
6
+ - **验证产物**:先数输入 `ls images | wc -l` 与预计张数一致,再看退出码——137 就是 OOM,别当普通失败。产物按正文目录约定逐项核:`gdalinfo -json odm_orthophoto/odm_orthophoto.tif` 核对 CRS 与尺寸、`gdalinfo -stats odm_dem/dsm.tif` 看高程范围是否合理,`odm_report/` 里的重叠度与重投影误差才是质量判据,只出图不代表成果可信。要肉眼确认正射影像,用 OSGeo4W 的 `gdal_translate -of PNG -outsize 1024 0 odm_orthophoto.tif preview.png` 生成缩略图后 `read_image` 看一眼,纯白或被裁成一条与空文件同罪;WebODM 的成果最终由用户在 2D/3D 查看器确认,写明「打开哪个地址、应看到什么」。
7
+ - **风险与权限**:`--rerun` 会就地重算并覆盖已有阶段产物、`./webodm.sh down` 删容器、`docker system prune` 清镜像层,都不可逆,执行前用 `ask_user_question` 给「换项目目录重跑/覆盖现有成果/取消」;WebODM 的 `admin` 密码与 JWT token 从环境变量传入、命令里只引用 `$TOKEN`,日志与回答里不回显。对外暴露 8000/3000 端口、上传航拍影像、把成果传给第三方之前,确认数据合规(测绘资质与隐私)。
8
+ - **常见失败**:`No images found` 是缺 `images/` 子目录或 `--project-path` 传成了数据集本身;空三大量未注册先查重叠度与糊片,改参数救不回来;正射空白或被裁条先去 `--auto-boundary` 再试;没有 `dsm.tif` 是没传 `--dsm`;Windows 挂载失败基本是路径写了反斜杠或 Docker Desktop 没共享该盘符。
@@ -1,8 +1,9 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:这是索引型技能,先按四个阶段定位要用的工具,再加载对应子技能(`gdal`、`gdal-api`、`qgis-process`、`pyqgis`、`geoserver-rest-api`、`openlayers`)读细节,不要指望本文件给全参数。参考文件较长:`reference/data-stages.md` 按阶段一至阶段四的标题分段读,`reference/workflow-cheatsheets.md` 只取端到端示例、内置算法速查与 GDAL 命令速查三节。
4
- - **执行环境**:四个阶段的命令都在 `ops_bash` 里跑;GeoServer 这类要起服务的阶段用后台作业启动 `docker run -d -p 8080:8080 docker.osgeo.org/geoserver:3.0.2`,再用 `curl` 轮询 `/geoserver/rest/about/version.json` 确认就绪,不要让一次调用阻塞。`QT_QPA_PLATFORM=offscreen` 在 bash 写成命令前缀,在 `pwsh` 写成 `$env:QT_QPA_PLATFORM = "offscreen"`。
5
- - **先探测版本**:`gdalinfo --version`、`ogrinfo --version`、`qgis_process --version`(本技能按 QGIS 3.44 LTR 或 4.x 编写,`qgis_process` 自 3.16 起可用)、`curl -u admin:geoserver "http://localhost:8080/geoserver/rest/about/version.json"`。缺哪个阶段的工具就直接加载相邻技能,不要在工具缺失时硬编整条链路。
6
- - **验证产物**:每阶段产物落盘到工作区(GeoPackage/COG/GeoJSON),下一阶段只读产物;转换后用 `ogrinfo -so`、`gdalinfo -json` 核对 CRS、范围与要素数;发布后用 `curl -u admin:geoserver "$BASE/layers/demo:roads_buffer.json"` 回读,确认 HTTP 200 且含 `"enabled": true`,或查 `GetCapabilities`。任一步失败先修当前阶段的产物,不要带着坏数据往下走。
7
- - **风险与权限**:`gdal_edit.py`、`?recurse=true` 删除、覆盖已有输出都不可逆,先备份并确认路径;GeoServer 默认 `admin:geoserver` 只适合本地演示,真实凭据不要写进命令行或回复里;`GDAL_DATA`、`PROJ_LIB`、`QT_QPA_PLATFORM` 等环境变量会影响同机其它工具,改动前征得用户同意。
8
- - **常见失败**:`qgis_process` 在无显示器环境崩溃是缺 `QT_QPA_PLATFORM=offscreen`;GeoServer 上传 Shapefile 失败要把数据打成 ZIP 且根目录含 `.shp`/`.shx`/`.dbf`/`.prj`;REST 返回 401/403 先查 HTTP Basic Auth 与用户权限;分析结果整体错位是全链路 CRS 没统一,用 `ogr2ogr -t_srs`、`gdalwarp -t_srs` 或 `native:reprojectlayer` 对齐;找不到 `gdal_calc.py` 是缺 Python 绑定,可改用 `qgis_process run gdal:rastercalculator`。
3
+ - **加载与引用**:本技能是索引型入口:先按四个阶段定位工具,再用 `skill` 加载子技能读细节(`gdal`、`gdal-api`、`qgis-process`、`pyqgis`、`geoserver-rest-api`、`openlayers`、`cesiumjs`、`stac-cog-titiler`),别指望本文给全参数;影像云原生链路(COG 出图、STAC 编目、TiTiler 动态切片)从 `stac-cog-titiler` 进。两份参考要分段取:`reference/data-stages.md` 先看开头 `## Contents` 定位阶段一至阶段四的小节,再按 `offset`/`limit` 读;`reference/workflow-cheatsheets.md` 只取端到端示例、内置算法速查、GDAL 命令速查几节,用 `grep` 定位比整读快。
4
+ - **执行环境**:四个阶段的命令都在 `ops_bash` 里跑。Windows 没有 `apt-get`/`sudo`:GDAL 走 OSGeo4W 绝对路径或 conda-forge,QGIS 用官方安装包(`qgis_process` 随安装自带),GeoServer 用 Docker。`QT_QPA_PLATFORM=offscreen` 在 bash 写成单条命令前缀,在 `pwsh` 写 `$env:QT_QPA_PLATFORM = "offscreen"`。起服务用后台作业:`docker run -d -p 8080:8080 docker.osgeo.org/geoserver:3.0.2` 以 `run_in_background` 启动,再用 `job_output` 轮询就绪,别让一次调用阻塞;收尾 `job_kill`。`qgis_process` 参数多,先 `qgis_process help <id> --json`。
5
+ - **先探测版本**:`gdalinfo --version` / `ogrinfo --version`(正文基准 GDAL 3.13.3)、`qgis_process --version`(基准 QGIS 4.2.3,LTR 3.44.15;4.x 与 3.44 的 Processing 算法 ID 和 Qt 版本不同,混用会报未知算法)、`curl -u admin:geoserver "http://localhost:8080/geoserver/rest/about/version.json"`(GeoServer 3.0.2)、`python3 -c "from osgeo import gdal; print(gdal.VersionInfo())"`。缺哪个阶段的工具就加载相邻子技能,不要硬拼整条链路。
6
+ - **验证产物**:每阶段产物落工作区(GeoPackage/COG/GeoJSON),下一阶段只读产物。转换后 `ogrinfo -so -al`、`gdalinfo -json` 核对 CRS、范围与要素数;发布后 `curl` 回读 `layers/demo:roads_buffer.json`,要求 HTTP 200 且含 `"enabled": true`,或查 `GetCapabilities`;WMS 出图后用 `read_image` 看一眼贴图是否真有内容。要交付的 GeoJSON、地图包用 `present` 列出。任一步失败先修本阶段产物,别带坏数据往下走。
7
+ - **风险与权限**:`gdal_edit.py` 就地改元数据、`ogr2ogr` 同名输出、GeoServer `?recurse=true` 删除都不可逆,先备份并确认路径;GeoServer 默认 `admin:geoserver` 只用于本地演示,真实凭据不进命令行与回复。装 GDAL/QGIS、拉镜像、监听端口、连生产库前用 `ask_user_question` 让用户选方案;对外暴露 8080 端口要单独确认。
8
+ - **常见失败**:`qgis_process` 在无显示器环境崩溃先设 `QT_QPA_PLATFORM=offscreen`;上传 Shapefile 失败先打成 ZIP 且根目录含 `.shp/.shx/.dbf/.prj`;报找不到 `gdal_calc.py` 是缺 Python 绑定,改用 `qgis_process run gdal:rastercalculator`;REST 401/403 查 Basic Auth 与用户权限;大栅格内存不足先 `gdal_translate -srcwin` 分块并调 `GDAL_CACHEMAX`、`GDAL_NUM_THREADS`。
9
+ - **工作流**:端到端链路先 `todo_write` 拆成「取数→转换→分析→发布→回读」,阶段间以文件为契约;多数据源核对这类互不依赖的活可以 `subagent` 并行,但发布步骤必须串行等验证通过。
@@ -1,8 +1,9 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能没有 `reference/` 分册,正文 269 行可一次读完;算子参数与方案字段以正文表格为准。仓库里的 `docs/plan-config-guide.md`、`docs/operator-reference.md` 要 clone 上游才存在,别当成技能目录内的文件去 `read`。
4
- - **执行环境**:`dotnet` 走 `pwsh`;`git clone --recurse-submodules` 走 `ops_bash`,漏了 `--recurse-submodules` 会缺 `opengis-utils-for-net` 子模块、编译期报 GDAL 绑定类型缺失。Windows 用 `.\build.ps1` 与 `demo/run-demo.ps1`,Linux 才是 `./build.sh`。
5
- - **先探测版本**:`dotnet --version` 必须是 10.0(`global.json` 锁定 10.0.301);`dotnet run --project src/OpenGisDAF.Cli -- help` 确认 CLI 可用。本项目无 NuGet 包,不要写 `dotnet add package OpenGisDAF`。
6
- - **验证产物**:先 `daf validate --plan plans/my.json` 再 `daf run --plan plans/my.json`,退出码 `0` 才是成功(失败或跳过都返回 1);只有 QC 方案才生成 `{plan}.qc-report.json`,看 `totalChecked` / `failed` / `passRate`。测试必须 `dotnet build OpenGisDAF.slnx --configuration Release` 加 `dotnet test OpenGisDAF.slnx --configuration Release --no-build`,同一条 `dotnet test` 会“运行了零个测试”并退出码 5。
7
- - **风险与权限**:`daf plan` 写 `%APPDATA%\opengis-daf\plans`;PostGIS 输出的 `encryptedPassword` 只接受当前用户生成的 DPAPI / AES-256-GCM 密文,明文直接失败;输出表已存在会报 `Layer already exists` 而不是覆盖,删表前先问用户。
8
- - **常见失败**:`buffer` 的 `distance` 单位随数据坐标系,EPSG:4326 下 800 就是 800 度,先 `coordinate_transform` 转米制;插件目录里出现 `OpenGisDAF.Core.dll` 会让 `IOperator` 类型不同源、算子被静默跳过,csproj 必须 `Private="false" ExcludeAssets="runtime"`;`daf operator import` 只对当前进程有效,要让插件参与 `daf run` 得用 `demo/plugin/OpenGisDAF.PluginHostDemo` 同进程宿主。
3
+ - **加载与引用**:单文件技能,无 reference 目录;正文的「方案配置」「内置算子」「CLI 命令」「常见问题」是查表区,按小节定位即可。正文提到的 `docs/plan-config-guide.md`、`docs/operator-reference.md` 在上游仓库里,clone 后才有、不在技能目录内,别用 `read` 硬找。需要几何语义用 `skill` 加载 `nettopologysuite`,GDAL 绑定细节加载 `opengis-utils-for-net`。
4
+ - **执行环境**:`git clone --recurse-submodules` 走 `ops_bash`(漏 `--recurse-submodules` 会缺 `opengis-utils-for-net` 子模块,编译期报 GDAL 绑定类型缺失);`dotnet` 系列与 `.\build.ps1`、`demo/run-demo.ps1` 走 `pwsh`。要求 .NET SDK 10.0(`global.json` 锁 10.0.301),没有就如实报告,不要拿 .NET 8/9 硬编。克隆目录与 `plans/` 放会话工作区;长构建用后台作业加 `job_output` 收日志。
5
+ - **先探测版本**:正文按 .NET SDK 10.0.301(C# 14)编写;`dotnet --version` 与 `dotnet --list-sdks` 确认 10.0.301 在列;`dotnet build OpenGisDAF.slnx --configuration Release` 成功后 `dotnet run --project src/OpenGisDAF.Cli -- help` 确认 CLI 可用。本项目无 Release tag、无 NuGet 包,别写 `dotnet add package OpenGisDAF`;SDK 低于 `global.json` 要求时会直接拒绝构建。
6
+ - **验证产物**:先 `daf validate --plan plans/my.json`(只校验 21 条规则)再 `daf run --plan plans/my.json`,退出码 `0` 才算成功(失败或跳过都返回 1)。QC 方案额外生成 `{plan}.qc-report.json`,看 `totalChecked`/`failed`/`passRate` 与 issue 清单;非 QC 方案不生成该文件。输出 GeoJSON 用 `ogrinfo -so` 或 `read` 回读核对 `crs`、要素数、字段。测试必须两步:先 `dotnet build OpenGisDAF.slnx -c Release` 再 `dotnet test OpenGisDAF.slnx -c Release --no-build`,同一条命令会报「运行了零个测试」并退出码 5。
7
+ - **风险与权限**:`daf plan` 写 `%APPDATA%\opengis-daf\plans`,`copy`/`export` 会覆盖同名方案;PostGIS 输出的 `encryptedPassword` 只接受当前用户生成的 DPAPI/AES-256-GCM 密文,明文直接失败且不回显密文。目标表已存在报 `Layer already exists` 是有意防误覆盖,删表或换表名都要先问用户;`buffer` 的 `distance` 单位随数据坐标系,EPSG:4326 下 800 就是 800 度。删表、覆盖方案、连生产库前用 `ask_user_question` 给选项。
8
+ - **常见失败**:`dotnet test` 报「运行了零个测试」+退出码 5 是 xunit.v3 工具链的固有行为,按上面两步走;缺子模块时编译报 GDAL 类型缺失,重新 clone 带 `--recurse-submodules`;插件算子不出现,先查是否把 `OpenGisDAF.Core.dll` 复制进插件目录(类型不同源会被静默跳过),且 `daf operator import` 只对当前进程有效,要让插件参与 `daf run` 必须用同进程宿主。
9
+ - **交付**:方案 JSON、QC 报告、输出 GeoJSON/Shapefile 都以工作区相对路径写回复,成品用 `present` 列出;qc-report 里的 WKT 违规几何可单独抽成文件再给用户。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:`OguLayerUtil` 读写的完整重载与常用任务速查在 `reference/common-tasks.md`;主文件的数据模型、枚举与异常层次够定位时不必展开参考文件。
4
- - **执行环境**:`git clone` 与 `mvn install -DskipTests` 走 `ops_bash`;Windows 下 `~/.m2` 实际是 `%USERPROFILE%\.m2`,`ogu4j-1.0.0.jar` 落在 `~/.m2/repository/com/znlgis/ogu4j/ogu4j/1.0.0/`。Java 代码里的路径写 Windows 形式,MSYS 的 `/d/...` 传进 JVM 会找不到文件。
5
- - **先探测版本**:`java -version` 与 `mvn -version`(JDK 17+、Maven 3.8+),`mvn -v` 显示的 JDK 才是 Maven 实际使用的;`mvn dependency:tree -Dincludes=com.znlgis.ogu4j` 确认坐标;原生 GDAL 用 `java -XshowSettings:properties -version` 查 `java.library.path`,输出重定向到文件再 `grep`。
6
- - **验证产物**:最小 main 用 `OguLayerUtil.readLayer(DataFormatType.SHP, path, null, null, null, GisEngineType.AUTO)` 打印 `getWkid()` 与 `getFeatureCount()`,再 `writeLayer` 成 GeoJSON 回读比对;产物可用 `ogrinfo -so` 复核。
7
- - **风险与权限**:`AUTO` 在本机有原生 GDAL 时会优先走 GDAL,要复现纯 Java 结果必须显式传 `GisEngineType.GEOTOOLS`;PostGIS 连接串里的密码不要回显;`mvn install` 写 `~/.m2`、示例写 `/data` 这类绝对路径,覆盖前先确认并问用户。
8
- - **常见失败**:`UnsatisfiedLinkError: no gdal_jni in java.library.path` 是原生 GDAL 缺失或与 `org.gdal:gdal` 3.13.0 不匹配,改用 GEOTOOLS;`Could not resolve dependencies for org.geotools:*` 是 `pom.xml` 缺 `https://repo.osgeo.org/repository/release/`;FileGDB 只有 GDAL 引擎支持;DBF 字段名超 10 字符会被截断。
3
+ - **加载与引用**:主文件给高频入口(`OguLayerUtil`、枚举、数据模型、异常层次),完整示例在 `reference/common-tasks.md`:先 `read` 该文件开头 `## Contents`,再跳到「常用任务速查」下的读取/写出/几何运算小节,或 `grep` 搜 `readLayer`、`writeLayer`、`GeometryUtil.bufferWkt` 定位,别整份读。需要 JTS 几何语义用 `skill` 加载 `jts`,GDAL 命令行核对加载 `gdal`。
4
+ - **执行环境**:`java`、`mvn` 走 `ops_bash`(MSYS bash);需要 `java.library.path` 这类带反斜杠的 Windows 属性时换 `pwsh`。本库未发布到 Maven Central,必须先 `git clone` 后 `mvn install -DskipTests` 装到本地仓库,再在业务工程里引 `com.znlgis.ogu4j:ogu4j:1.0.0`;`~/.m2` 在 Windows 实为 `%USERPROFILE%\.m2`。示例 Java 代码里的路径写 Windows 形式(`D:/work/parcels.shp`),MSYS 的 `/d/...` 传给 JVM 常找不到文件。长构建用后台作业加 `job_output` 收日志。
5
+ - **先探测版本**:`java -version` 与 `mvn -version`(JDK 17+、Maven 3.8+),`mvn -v` 里显示的 JDK 才是 Maven 实际使用的,与 shell 的 `java` 不一致先改 `JAVA_HOME`。正文按 OGU4J 1.0.0、`org.gdal:gdal` 3.13.0 编写;`mvn dependency:tree -Dincludes=com.znlgis.ogu4j` 确认坐标;原生 GDAL 版本低于 3.13 时 GDAL 引擎会链不上,FileGDB 直接不可用。找不到 CI 里的 `1.0.0` 包就是没做本地 `mvn install`,不要去 Central 找。
6
+ - **验证产物**:`mvn -q -DskipTests package` 只证明能编译。写最小 main 跑正文「典型工作流」:`OguLayerUtil.readLayer(DataFormatType.SHP, path, null, null, null, GisEngineType.AUTO)` 打印 `getWkid()` 与 `getFeatureCount()`,`CrsUtil.reproject(layer, 4528)` 后再 `writeLayer` 成 GeoJSON,回读的 WKID 必须是 4528、要素数与筛选结果一致;机上有 GDAL 时再 `ogrinfo -so out.geojson` 复核。`mvn -v` 的输出与测试日志重定向到 `run.log` 再 `read`。成品 GeoJSON 用 `present` 交付。
7
+ - **风险与权限**:`mvn install` 写 `~/.m2` 并可能覆盖同名 SNAPSHOT;`OguLayerUtil.writeLayer` 写同名 Shapefile/GeoJSON 会整份覆盖,先换名或备份。PostGIS 连接串(`PG: host=... password=...`)的密码不要回显,连接生产库前用 `ask_user_question` 让用户选只读还是跳过。`DataStore` 与 OGR `DataSource` 要在 `finally` 释放,否则文件被占用后覆盖失败;`GisEngineType.AUTO` 在装了原生 GDAL 时优先 GDAL,要复现纯 Java 结果必须显式传 `GEOTOOLS`。
8
+ - **常见失败**:`UnsatisfiedLinkError: no gdal_jni in java.library.path` 是原生 GDAL 缺失或版本不匹配,装 GDAL 3.13.x 或改 `GEOTOOLS`;`Could not resolve dependencies for org.geotools:*` 是 `pom.xml` 缺 `https://repo.osgeo.org/repository/release/`;`找不到 com.znlgis.ogu4j:ogu4j` 是没本地安装;Shapefile 字段名被截断用 `ShpUtil.formatFieldName()`。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:`OguLayerUtil`、`GeometryUtil`、`CrsUtil`、`ShpUtil`、`PostgisUtil` 的完整签名在 `reference/util-classes.md`,从零构造图层等模式在 `reference/code-patterns.md`;主文件 490 行,先按章节定位再分段 `read`。
4
- - **执行环境**:`dotnet` 走 `pwsh`;正文里的 `findstr` 是 Windows cmd 写法,MSYS 下等价 `grep`。GDAL 原生运行时由 `MaxRev.Gdal.Universal` 随包分发,不要手写 `GdalConfiguration.ConfigureGdal()`。
5
- - **先探测版本**:`dotnet --version`;`dotnet restore` 能解析即包可用,`dotnet list package --include-transitive` 过滤 `OpenGIS.Utils` 核对 1.1.2;`NU1101` / `NU1102` 表示源或版本不可用,如实报告而不是改版本号重试。
6
- - **验证产物**:`dotnet build` 成功只说明编译通过,GDAL 原生库是运行期才加载;`dotnet run > run.log 2>&1` 后 `read` 日志,确认 `ReadLayer` 打印的 `GetFeatureCount()` 与 `Wkid`,再 `WriteLayer` 写出 GeoJSON 回读比对,必要时 `ogrinfo -so` 复核。
7
- - **风险与权限**:写 Shapefile / GeoPackage 会覆盖同名文件,先确认目标路径;PostGIS 连接串与 GDAL 配置里的密码不要回显;`dotnet restore`、改 `NuGet.config`、装 SDK 前先问用户。
8
- - **常见失败**:`DllNotFoundException` / `Unable to load DLL 'gdal'` 多是 RID 与运行环境不一致,`dotnet publish -r win-x64` 后跑发布目录;`Geojson2Wkt` 传整份 FeatureCollection 文件会抛 `ArgumentException`,整文件走 `OguLayerUtil.ReadLayer`;GBK 乱码先 `Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)`;`GisEngineType.GEOTOOLS` 在 .NET 版实际重定向到 GDAL。
3
+ - **加载与引用**:主文件给 `OguLayerUtil` 入口、模型类与枚举;`OguLayerUtil`/`GeometryUtil`/`CrsUtil`/`ShpUtil`/`PostgisUtil`/`GtTxtUtil` 的完整签名在 `reference/util-classes.md`(开头 `## Contents` 按类分节,`read` 时带 `offset`/`limit`),从零构造图层、读写筛选的成段示例在 `reference/code-patterns.md`。主文件 480 余行,用 `grep` 搜 `ReadLayer(`、`CrsUtil.Transform`、`Geojson2Wkt` 定位行号再局部读,别整篇搬进上下文。
4
+ - **执行环境**:`dotnet new/restore/build/run/test` 走 `ops_bash`;确需 `Get-Command` 或带反斜杠的 Windows 路径参数时换 `pwsh`。探测工程建在会话工作区(`dotnet new console -o work/ogu-probe`),别写进 `assets/`。正文里的 `findstr` 是 cmd 写法,MSYS 下用 `grep`:`dotnet list package --include-transitive | grep OpenGIS.Utils`。GDAL 原生运行时由 `MaxRev.Gdal.Universal` 随包分发,不要手写 `GdalConfiguration.ConfigureGdal()`。长构建放后台作业,用 `job_output` 收日志。
5
+ - **先探测版本**:`dotnet --version`(库目标 .NET Standard 2.0,.NET Core 2.0+/5+ 均可引用),正文按 `OpenGIS.Utils` 1.1.2 编写;`dotnet restore` 能解析即包可用,`dotnet list package --include-transitive | grep OpenGIS.Utils` 核对实际解析到的 1.1.2。`NU1101`/`NU1102` 表示源或版本不可用,如实报告,不要自行改版本号重试。低于 1.1.2 的版本没有 `GEOPACKAGE`/`KML`/`DXF` 这些 `DataFormatType` 与 `ConvertFormat`。
6
+ - **验证产物**:`dotnet build` 成功只说明编译过,GDAL 原生库是运行期才加载。写最小控制台跑正文「典型工作流」:读 Shapefile 后打印 `layer.Wkid` 与 `layer.GetFeatureCount()`,`CrsUtil.Transform` 逐要素转到 4528 并改 `layer.Wkid`,`WriteLayer` 出 GeoPackage 后回读,核对 WKID 为 4528、要素数与筛选结果一致;`dotnet run > run.log 2>&1` 再 `read` 日志确认,机上有 GDAL 时补 `ogrinfo -so data/parcels_4528.gpkg`。成品用 `present` 交付。
7
+ - **风险与权限**:`WriteLayer` 写 Shapefile/GeoPackage/KML 会覆盖同名文件,先换名或备份;`ConvertFormat` 同理。PostGIS 连接串与 GDAL 配置里的密码不要回显,连生产库前用 `ask_user_question` 给「只读/新库/跳过」选项。`dotnet restore`、装 SDK、改 `NuGet.config` 前先问用户。`OgrGeometry` 实现 `IDisposable`,用完 `Dispose()`,否则大批量几何会吃满内存;`GEOTOOLS` 在 .NET 版被重定向到 GDAL,别据此以为有纯托管路径。
8
+ - **常见失败**:`DllNotFoundException` / `Unable to load DLL 'gdal'` 多是 RID 与运行环境不一致,`dotnet publish -r win-x64` 后跑发布目录,别跑 `bin/Debug`;`Geojson2Wkt` 传整份 FeatureCollection 文件内容会抛 `ArgumentException`,整文件走 `OguLayerUtil.ReadLayer`;GBK Shapefile 乱码先 `Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)` 再传 `Encoding.GetEncoding('GBK')`;`CrsUtil` 只有 WKT/`OgrGeometry` 重载,没有整层变换方法。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:正文的「典型工作流」是最完整的示例(全部 import 加 `dataProjection`/`featureProjection`),直接照它起步比自己拼 `ol/...` 更稳;要联动服务端时用 `read` 打开 `../geoserver/SKILL.md`,三维对照看 `../cesiumjs/SKILL.md`。
4
- - **执行环境**:`npm install ol`、`npm run build` 走 `ops_bash`;Windows 下 `npm` 实为 `npm.cmd`,长构建放后台作业并把输出重定向到文件再 `grep`;预览用 `npx serve dist` 或 `python -m http.server 5173 -d dist` 起后台,验证完 `job_kill`。
5
- - **先探测版本**:`npm ls ol`,未装再 `npm view ol version`;正文按 10.11.0,只用 `ol/Map.js`、`ol/layer/Tile.js`、`ol/source/OSM.js` 这类 ESM 子路径。动手改前用 `grep` 搜代码里的 `ol.source.`、`ol.layer.` 全量命名空间写法,混用会在打包或运行时报错。
6
- - **验证产物**:`npm run build` 通过只代表编译过;再确认 `curl.exe -I http://localhost:5173/` 与产物里的 `assets/*.js` 为 200。图层是否显示看不到,把预期写清楚交给用户:底图与行政区面同现、画一个多边形后控制台输出 EPSG:4326 的 GeoJSON;有截图再用 `read_image` 核对。
7
- - **风险与权限**:矢量图层不 `setStyle()` 默认不渲染,别把空白当数据没加载;经纬度必须 `fromLonLat()` 转 EPSG:3857,自定义投影先 `register(proj4)`;内网 WMS 地址与凭据不要写进示例;起 dev server、对外暴露端口前先问用户。
8
- - **常见失败**:WMS 空白查 CORS、`LAYERS` 全名与 `SRS`;MVT 属性缺失用 `MVT({ featureClass: Feature })`;容器尺寸变化后调 `map.updateSize()`;`ol/...` 模块找不到是打包器没按 ESM 解析(或改用 `dist/ol.js`)。
3
+ - **加载与引用**:单文件技能,无 reference 目录。正文的「典型工作流」是最完整、可直接跑的示例(含 `dataProjection`/`featureProjection` 与样式函数),照它起步比自己拼 `ol/...` 导入稳;有疑问时按「常见问题」表的报错原文定位小节,再 `grep` 搜对应类名。要联动服务端时用 `skill` 加载 `geoserver`,三维对照加载 `cesiumjs`,不要 `read` 兄弟目录的 `SKILL.md`。
4
+ - **执行环境**:`npm install ol`、`npm run build`、`npx serve dist` 走 `ops_bash`(Windows 下 `npm` 实为 `npm.cmd`)。构建与起静态服务放后台作业(`run_in_background`),输出重定向到文件后用 `grep` 找错,收尾 `job_kill`;`python -m http.server 5173 -d dist` 同理。起 server、对外暴露端口前先用 `ask_user_question` 确认。工程建在会话工作区,别写进 `assets/`。
5
+ - **先探测版本**:`npm ls ol`,未装再 `npm view ol version`;正文按 10.11.0 编写,只用 `ol/Map.js`、`ol/layer/Tile.js`、`ol/source/OSM.js` 这类 ESM 子路径。动手前用 `grep` 搜代码里的 `ol.source.`、`ol.layer.` 全量命名空间写法——10.x 里混用会在打包或运行时报错(`Failed to resolve module specifier`);低于 10 的版本 `MVT({ featureClass })`、`hitTolerance` 行为不同,按实际版本对 `--help` 与 API 文档核对。
6
+ - **验证产物**:`npm run build` 通过只代表编译过;再 `curl.exe -I http://localhost:5173/` 与打包出的 `assets/*.js` 确认 200,并核验页面真能出图——底图与行政区面同现、画一个多边形后控制台输出 EPSG:4326 的 GeoJSON。有截图或渲染产物时用 `read_image` 真看一眼;交付给用户的页面与示例数据用 `present` 列出。
7
+ - **风险与权限**:矢量图层不 `setStyle()` 默认不渲染,别把空白页面当成数据没加载;经纬度必须 `fromLonLat()` 转 EPSG:3857,自定义投影先 `register(proj4)`;内网 WMS 地址与凭据不要写进示例代码或回复。`npm install` 会改 `package-lock.json` 与 `node_modules`,在用户仓库里执行前先确认;起 dev server、改端口、对外暴露服务要单独确认。
8
+ - **常见失败**:`Assertion failed: The view center is not defined` 是 `View` 没给 `center`;`Assertion failed: Expected a list of style instances` 是 `setStyle()` 收到非 Style 值;WMS 空白查 CORS、`LAYERS` 全名与 `SRS`/`CRS` 版本;MVT 属性丢失用 `new MVT({ featureClass: Feature })`;容器尺寸变化后调 `map.updateSize()`;模块找不到说明打包器没按 ESM 解析。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能只有 SKILL.md,没有 reference 子目录;参数不确定时先跑 `pdal --options filters.smrf` 或 `pdal --drivers` 取运行时定义,不要凭记忆写 stage 参数。管线较长时用 `write` 把 JSON 存成工作区里的 `pipeline.json`,复用与逐条修改都比命令行内联可靠。
4
- - **执行环境**:`pdal info`/`translate`/`pipeline` 走 `ops_bash`;Windows 上 PDAL 一般来自 conda-forge 或 OSGeo4W,`pdal` 不在 PATH 时用 `command -v pdal`(`pwsh` 里 `Get-Command pdal`)定位。正文的 `sudo apt` 不可用,改用 `conda install -c conda-forge pdal python-pdal`,或 `docker run --rm -v "$PWD":/data -w /data pdal/pdal pdal pipeline pipeline.json`,注意容器内路径要按 `/data` 重写。
5
- - **先探测版本**:`pdal --version`(本技能基准 2.10.2)与 `pdal --drivers`。`pip install PDAL` 依赖系统已装 PDAL 库(需 `pdal-config`),拿不到就改用 conda 的 `python-pdal`;PyPI 上 `pdal` 的 3.5.5 与主库 2.10.2 是两套独立版本号,不要混为一谈。`pdal ground` 自 2.6 弃用、2.8 完全移除,见到它一律换成 `filters.smrf` 的管线写法。
6
- - **验证产物**:点云用 `pdal info --summary out.laz` 核对 `num_points`、`bounds`、`srs`;DEM 用 `gdalinfo -json dem.tif` 核对波段数与范围,注意 `writers.gdal` 默认 `output_type: "all"` 会输出多波段,要单波段必须显式写 `idw`/`mean`。管线先 `pdal pipeline --validate` 再实跑,退出码 0 不能证明结果正确。
7
- - **风险与权限**:`pdal translate` 与各 writer 会按 `filename` 覆盖同名输出,先确认目标文件名;`filters.outlier`、`filters.smrf` 需要全局统计、无法流式,大数据先分块,别一次把整片点云读进内存;拉取 Docker 镜像或下载大点云前征得用户同意。
8
- - **常见失败**:`Couldn't create <cls> stage of type '<type>'.` 多为 stage 名拼错或该版本没有此 stage,先 `pdal --drivers` 确认再核对 `readers.*`/`filters.*`/`writers.*` 前缀;`filters.reprojection` 报缺 SRS 时补 `out_srs`,数据无坐标系再补 `in_srs`;重投影后精度变差在 writer 里加 `scale_x/y/z` 与 `offset_x/y/z: "auto"`;Python 里 `pipeline.execute()` 返回的是点数,数据在 `pipeline.arrays`,失败细节看 `pipeline.log` 而不是异常栈。
3
+ - **加载与引用**:单文件技能,无 reference 目录;参数不确定时先跑 `pdal --options filters.smrf` 或 `pdal --drivers` 取运行时定义,别凭记忆写 stage 参数——正文的算子参数表与这些命令输出以实际版本为准。管线较长时用 `write` 把 JSON 存成工作区里的 `pipeline.json`,复用和逐条改动都比命令行内联可靠;复杂管线按「读取→裁剪/重投影→过滤→写出」分段拼,出错好定位。需要 DEM 后处理时用 `skill` 加载 `gdal`。
4
+ - **执行环境**:`pdal info/translate/pipeline/--drivers` 走 `ops_bash`;`Get-Command pdal` 或带反斜杠的 Windows 路径参数走 `pwsh`。本机 Windows 无 `sudo`/`apt`:PDAL 来自 conda-forge(`conda install -c conda-forge pdal python-pdal`)、OSGeo4W,或容器 `docker run --rm -v "$PWD":/data -w /data pdal/pdal pdal pipeline pipeline.json`(容器内路径写 `/data/...`,不要传宿主 `D:\...`)。整片点云处理、DEM 全量栅格化放后台作业,用 `job_output` 收日志、`job_kill` 收尾。
5
+ - **先探测版本**:`pdal --version` 与 `pdal --drivers`;正文按 2.10.2 编写,`pdal ground` 自 2.6 弃用、2.7 移出默认安装、2.8 完全移除,见到旧命令一律换 `filters.smrf` 管线写法;2.10 才有的 `filters.m3c2`、`filters.radiusassign`、`writers.gdal` 的 `p<percentile>` 波段需先确认驱动列表里有;`readers.spz`/`writers.spz` 在 2.10 变成插件,标准安装的 `--drivers` 里看不到属正常,别当成损坏。低版本没有 `filters.expression` 时退回 `filters.range`(2.5 起推荐 expression、3.0 弃用 range)。Python 侧 `pip install PDAL` 依赖系统已装 PDAL 库(需 `pdal-config`),PyPI 的 `pdal` 3.5.5 与主库 2.10.2 是两套独立版本号。
6
+ - **验证产物**:点云用 `pdal info --summary out.laz` 核对 `num_points`、`bounds`、`srs`(转换前后的点数差异要能解释,比如裁剪后减少、去噪后仍保留全部点仅标 Class=7);DEM 用 `gdalinfo -json dem.tif` 看波段数与范围:`writers.gdal` 默认 `output_type: "all"` 输出多波段,`p95` 这类百分位波段不计入 `all`,要单波段必须显式写 `idw`/`mean`,`binmode: true` 时只统计落在像元内的点、值域会变。`filters.georeference` 在 2.10 输出 ECEF(EPSG:4978),要经纬度必须再接 `filters.reprojection`,否则 `pdal info` 里的 srs 会是 4978。管线先 `pdal pipeline --validate` 再实跑,退出码 0 不能证明结果正确;DEM 或点云渲染图用 `read_image` 看一眼,成品用 `present` 交付。
7
+ - **风险与权限**:`pdal translate` 与各 writer 按 `filename` 覆盖同名输出,先确认目标文件名、换名或备份;`filters.outlier`、`filters.smrf` 需要全局统计、不能流式,大点云先按 tile 拆分。拉取 Docker 镜像、下载大点云、安装 PDAL、写用户目录外的路径前用 `ask_user_question` 让用户选方案;从源码编译时 GDAL 必须 3.8+(`cmake/gdal.cmake` 硬校验,报 `Required at least GDAL version 3.8`),SMRF 参数改动会影响地面分类结果,交付前说明用了哪组参数。
8
+ - **常见失败**:`Couldn't create <cls> stage of type '<type>'` 是 stage 名拼错或版本没有该 stage,先 `pdal --drivers` 确认;`pipeline` 解析失败用 `--validate` 定位 JSON 语法与顶层结构;`filters.reprojection` 报缺 SRS 补 `out_srs`(数据本身无坐标系时再给 `in_srs`);重投影后精度变差在 writer 设 `scale_x/y/z` 与 `offset_x/y/z: "auto"`;Python 侧 `execute()` 返回点数不是数组,数据在 `pipeline.arrays`,失败看 `pipeline.log`。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:单文件技能,无 reference 目录;验收 SQL 与 EXPLAIN 判据在「典型工作流」「性能优化」「常见问题」三节,按标题定位即可。GDAL 侧导入转 `gdal`、发布转 `geoserver`,不在此重写。
4
- - **执行环境**:`psql`、`shp2pgsql`、`raster2pgsql`、`pgsql2shp`、`ogr2ogr` 都在 `ops_bash` 里跑;导入用管道 `shp2pgsql ... | psql -d gisdb -v ON_ERROR_STOP=1`,别在 `pwsh` 里照搬。元命令不能进交互式会话,单条传:`psql -d gisdb -c "\d+ poi"`。`command -v shp2pgsql` 找不到时就改走 `ogr2ogr -f PostgreSQL "PG:host=localhost dbname=gisdb user=postgres"`。
5
- - **先探测版本**:`psql -c "SELECT version(), PostGIS_Full_Version();"` 一次拿到 PostgreSQL、PostGIS、GEOS、PROJ;本技能按 PostGIS 3.6.4、PostgreSQL 12–18 编写,3.7 仍是 RC。连不上先探服务端:`psql -h 127.0.0.1 -U postgres -c "SELECT 1"`,connection refused 是服务端没起而非 SQL 写错;本机无实例时用正文的 `docker run --name pg -e POSTGRES_PASSWORD=pg -p 5432:5432 -d postgis/postgis:17-3.6`。扩展缺失查 `SELECT * FROM pg_available_extensions WHERE name LIKE 'postgis%';`。
6
- - **验证产物**:导入后回读 `SELECT count(*), ST_SRID(geom), ST_IsValid(geom) FROM t GROUP BY 2,3;`,导出后再跑 `ogrinfo -al -so out.geojson` 核对要素数与字段;性能结论必须附 `EXPLAIN (ANALYZE, BUFFERS)` 输出,并指出计划里出现 `poi_geom_idx` 上的 Index/Bitmap Index Scan,没计划就直说未验证。写操作后回读 `\d+ t` 与 `geometry_columns`,别只看 `INSERT 0 n`。
7
- - **风险与权限**:`DROP TABLE/SCHEMA`、整表改写 geom、`VACUUM FULL`、重启 PostgreSQL 都难回滚,先备份并征得同意;口令用 `PGPASSWORD`/`.pgpass` 传入,命令与报告里不要回显。大表建索引会长时间锁表,用 `CREATE INDEX CONCURRENTLY`,且不能包进事务块。
8
- - **常见失败**:`Operation on mixed SRID` 是两边 SRID 不一致让 `&&` 退化为逐行比较,先 `ST_Transform` 统一到 4326 再入库;`CREATE EXTENSION postgis` 报找不到扩展文件是缺对应 `postgis-<pgver>` 包;距离单位不对其实是 4326 下按度算,转 `geography` 或米制投影;多边形无效先 `ST_IsValidReason` 再 `ST_MakeValid`。
3
+ - **加载与引用**:单文件技能,无 reference 目录;验收判据集中在「典型工作流」的输出与验收、「性能优化」、「常见问题」三节,按标题定位再读。导入/导出链路的细节用 `skill` 加载 `gdal`,发布图层加载 `geoserver`,不要在本文件重写。SQL 大段结果先落文件再 `grep` 关键行,别把整份 `EXPLAIN` 贴进上下文。
4
+ - **执行环境**:`psql`、`shp2pgsql`、`raster2pgsql`、`pgsql2shp`、`ogr2ogr` 都在 `ops_bash` 里跑。导入用管道 `shp2pgsql -s 4326 -I -W UTF-8 data/poi.shp public.poi | psql -d gisdb -v ON_ERROR_STOP=1`;元命令不能进交互式会话,单条传:`psql -d gisdb -c "\d+ poi"`。Windows 上没有这些 CLI 时改走 `ogr2ogr -f PostgreSQL "PG:host=localhost dbname=gisdb user=postgres"`,或用容器 `docker exec -i pg psql -U postgres`。整库导入、`VACUUM FULL`、大表 `CREATE INDEX` 放后台作业,用 `job_output` 收日志。
5
+ - **先探测版本**:连上去先 `psql -c "SELECT version(), PostGIS_Full_Version();"` 一次拿到 PostgreSQL、PostGIS、GEOS、PROJ。正文按 PostGIS 3.7.0 编写(2026-10-30 发布),要求 PostgreSQL 14–19、GEOS ≥ 3.10、PROJ ≥ 6.1;3.6 及更早还能配 PostgreSQL 12+,升级前先确认 GEOS/PROJ 满足新下限。连不上先探服务端 `psql -h 127.0.0.1 -U postgres -c "SELECT 1"`,connection refused 是服务没起而非 SQL 写错;本机无实例时用 `docker run --name pg -e POSTGRES_PASSWORD=pg -p 5432:5432 -d postgis/postgis:17-3.7`。扩展缺失查 `SELECT * FROM pg_available_extensions WHERE name LIKE 'postgis%';`。
6
+ - **验证产物**:导入后别只看 `INSERT 0 n`,回读 `SELECT count(*), ST_SRID(geom), ST_IsValid(geom) FROM t GROUP BY 2,3;`;空间连接按正文判据核对已匹配数与 `unmatched` 差值、`ST_SRID(geom)` 为 4326;性能结论必须附 `EXPLAIN (ANALYZE, BUFFERS)` 输出并指出计划里出现 `poi_geom_idx` 上的 Index/Bitmap Index Scan,没计划就直说未验证。导出后再 `ogrinfo -al -so out/poi_with_district.geojson` 核对要素数与字段;出图后用 `read_image` 看一眼,成品用 `present` 交付。
7
+ - **风险与权限**:`DROP TABLE/SCHEMA`、整表 `UPDATE ... SET geom=`、`UpdateGeometrySRID`、`VACUUM FULL`、重启 PostgreSQL 都不可逆,执行前必须备份并向用户确认。连生产库、建库、删表、批量改写用 `ask_user_question` 给「只读查询/新建临时库/取消」选项;密码走 `PGPASSWORD`/`.pgpass`/环境变量,不写进命令行与回复。大表 `UPDATE`/`CREATE INDEX` 放可控事务避免长时间锁表,`CREATE INDEX CONCURRENTLY` 不能包在事务块里。`shp2pgsql -d` 会先删表,`-a` 是追加,别拿错。
8
+ - **常见失败**:`Operation on mixed SRID geometries` 先用 `ST_SRID(geom)` 核对两侧、`ST_Transform` 统一;`Boundary geometry is invalid` 用 `ST_IsValidReason` 定位、`ST_MakeValid` 修复;`transform: Failed to transform` 查 `spatial_ref_sys` 与 PROJ 数据(`projinfo EPSG:<code>` 能否解析);`type "geometry" does not exist` 是扩展没装或 `search_path` 不对;查询慢先确认 GiST 索引存在且几何没被函数包裹导致索引失效。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能只有 SKILL.md,没有 reference 子目录,工具清单与坑都在正文;`projinfo` 的 WKT 输出动辄上百行,重定向到文件再分段 `read`/`grep`,或直接加 `-q`(只出字符串本体)、`-o PROJJSON -q`(结构化),不要把整段 WKT 贴进上下文。
4
- - **执行环境**:`projinfo`、`cs2cs`、`proj`、`cct`、`projsync`、`geod` 都在 `ops_bash` 里跑;正文的 heredoc(`<<'EOF'`)在 bash 可用、在 `pwsh` 不可用,Windows 会话优先用管道 `echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:32650`,或把坐标写成文件再重定向。设数据目录在 bash 是 `export PROJ_DATA=...`,在 `pwsh` 是 `$env:PROJ_DATA = "C:\OSGeo4W\share\proj"`。
5
- - **先探测版本**:`projinfo --version` 会同时打印版本与 `proj.db` 路径,是最可靠的入口;`projinfo --searchpaths` 看搜索路径。`proj` 直接执行会进交互模式,不能当版本检查用。本技能按 PROJ 9.9.0 编写:9.1 起变量是 `PROJ_DATA`(旧名 `PROJ_LIB` 仍兼容),9.3 起 `proj` 才能直接接受 `EPSG:xxxx`。Windows 上 PROJ 一般随 GDAL/QGIS 安装包自带,`command -v projinfo` 或 `Get-Command projinfo` 找不到时先定位 OSGeo4W 或 conda 的 bin 目录。
6
- - **验证产物**:用已知点对拍——`echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:32650` 应得到东坐标约 44 万、北坐标约 442 万,量级明显不对通常是轴序或单位问题;转换路径用 `projinfo -s EPSG:4326 -t EPSG:4547 --summary` 看候选操作与精度,结构化核对用 `projinfo -o PROJJSON -q EPSG:4326`。
7
- - **风险与权限**:`projsync --all` 会从 CDN 下载数 GB 网格,`PROJ_NETWORK=ON` 也会联网,先确认网络与磁盘;`sqlite3 proj.db` 只做只读查询,不要写库;改 `PROJ_DATA` 会连带影响同机 GDAL/QGIS/PostGIS 的坐标运算,动手前征得用户同意。
8
- - **常见失败**:`Cannot find proj.db` 用 `projinfo --searchpaths` 核对目录;`DATABASE.LAYOUT.VERSION` 不匹配是系统、conda、PostGIS 多套 PROJ 混用,统一 `PROJ_DATA` 指向与所用库一致的库文件;`The EPSG code is unknown` 说明本地 `proj.db` 太旧,先用 `projinfo --list-crs` 确认;输出轴序与预期相反时用 `-r` 反转输入、`-s` 反转输出。
3
+ - **加载与引用**:单文件技能,无 reference 目录;`projinfo` 的 WKT 输出动辄上百行,重定向到文件再分段 `read`/`grep`,或直接加 `-q`(只出字符串本体)、`-o PROJJSON -q`(结构化,可交给 `jq`),不要把整段 WKT 贴进上下文。工具清单与坑都在正文;重投影栅格/矢量文件改用 `skill` 加载 `gdal`,`ST_Transform` 侧加载 `postgis`。
4
+ - **执行环境**:`projinfo`、`cs2cs`、`proj`、`cct`、`projsync`、`geod` 都在 `ops_bash` 里跑。正文的 heredoc(`<<'EOF'`)在 bash 可用、在 `pwsh` 不可用,Windows 优先用管道 `echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:32650`,或把坐标写成文件再重定向。设数据目录在 bash 是 `export PROJ_DATA=...`,在 `pwsh` 是 `$env:PROJ_DATA = "C:\OSGeo4W\share\proj"`。本机 PROJ 一般随 GDAL/QGIS 安装包(OSGeo4W)自带,`command -v projinfo` 找不到时先定位其 bin 目录。
5
+ - **先探测版本**:`projinfo --version` 会同时打印版本与 `proj.db` 路径,是最可靠的入口;`projinfo --searchpaths` 看搜索路径。`proj` 直接执行会进交互模式,不能当版本检查用。正文按 PROJ 9.9.0 编写:9.1 起变量是 `PROJ_DATA`(旧名 `PROJ_LIB` 仍兼容),9.3 起 `proj` 才能直接接受 `EPSG:xxxx`;低版本遇到 `PROJ_DATA` 不识别先查 `--version` 实际值。`projinfo --list-crs` 确认某个 EPSG 代码在本地库里是否存在。
6
+ - **验证产物**:用已知点对拍——`echo 39.907 116.391 | cs2cs EPSG:4326 EPSG:32650` 应得到东坐标约 44 万、北坐标约 442 万,量级明显不对通常是轴序或单位问题;`echo 30.5 114.0 | cs2cs EPSG:4326 EPSG:4547` 核对 CGCS2000 3 度带结果。转换路径用 `projinfo -s EPSG:4326 -t EPSG:4547 --summary` 看候选操作与精度,结构化核对用 `projinfo -o PROJJSON -q EPSG:4326`。批量转换后抽首尾各一行回算,逐行只打日志不算验证。
7
+ - **风险与权限**:`projsync --all` 会从 CDN 下载数 GB 网格、`PROJ_NETWORK=ON` 也会联网,先确认网络与磁盘,用 `projsync --bbox` 按区域只取需要的网格;`sqlite3 proj.db` 只做只读查询,不要写库。改 `PROJ_DATA` 会连带影响同机 GDAL/QGIS/PostGIS 的坐标运算,动手前用 `ask_user_question` 让用户确认;涉及基准面转换的成果,交付时要说明用了哪个转换、精度多少、是否需要 `--only-best`。
8
+ - **常见失败**:`Cannot find proj.db` 查 `PROJ_DATA` 与 `projinfo --searchpaths`;`DATABASE.LAYOUT.VERSION` 不匹配是多套 PROJ 副本混用;`The EPSG code is unknown` 是本地库没有该码,升级 PROJ 或改用等效 WKT/PROJJSON;`cs2cs` 输出轴序相反用 `-r` 反输入、`-s` 反输出;精度不足加 `projsync` 网格与 `--only-best`,否则会静默退回低精度操作。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:单文件技能;WKT 来源优先交给 `proj` 技能生成(正文用 `projinfo EPSG:4547 -o WKT2:2019`),几何转换流程可以直接复用正文的 CSV 工作流。需要 NTS 侧接口时转 `nettopologysuite`,老项目渲染转 `sharpmap`。
4
- - **执行环境**:`dotnet add package`、`dotnet run` 走 `ops_bash`,首次 restore 需要访问 NuGet。正文的 `Install-Package` 只适用于 Visual Studio 的 Package Manager Console,命令行会话里用 `dotnet add package ProjNet --version 2.1.0`。WKT 文件用工作区相对路径,示例里的占位路径不要改成用户真实数据目录。
5
- - **先探测版本**:`dotnet list package` 区分 `ProjNet` 2.1.0 与 `ProjNet4GeoAPI` 1.4.1——两者命名空间与接口完全不同,写代码前必须确认,不要凭 `using ProjNet.CoordinateSystems` 猜。两个包的程序集都叫 `ProjNET.dll` 且不能同时引用,SharpMap 1.2 这类要 GeoAPI 接口的老项目只能用 1.4.1。
6
- - **验证产物**:跑正文那条最小断言,`116.397, 39.908` 转 Web Mercator 应约 `(12957254.80, 4852582.10)`;高斯投影东坐标是 6 位数(含带号 8 位),若结果还是 116/39 量级,说明坐标系取错或 WKT 解析失败被静默跳过。
7
- - **风险与权限**:ProjNet 不做轴序交换,输入一律按 `[x, y]`(经度在前),WKT 里的 `AXIS` 声明要自己判断;它也不自带 EPSG 数据库,`CoordinateSystemServices` 默认只有 4326 与 3857,其余必须自行注册 WKT。缺网格文件时偏差固定在几十米量级,高精度场景换 SharpProj 或 GDAL,不要硬调参数。新建工程、装包前征得用户同意。
8
- - **常见失败**:`GetCoordinateSystem(4490)` 返回 `null` 是没注册;"注册了但查不到"优先怀疑 WKT 不受支持,因为 `CreateCoordinateSystem` 会吞掉解析异常,先用 `new CoordinateSystemFactory().CreateFromWkt(wkt)` 单独验证;`CreateFromCoordinateSystems` 返回 `null` 或抛异常是源/目标组合不受支持,改成"地理 → 投影"或先转 WGS84;经纬度结果反了就是把 `[lat, lon]` 当成了 `[x, y]`。
3
+ - **加载与引用**:单文件技能,无 reference;正文「环境准备」教装包、「核心 API」给坐标系与转换接口、「典型工作流」给 CSV 批量转换、「常见问题」给报错对照。坐标转换的标准起手式是正文的「WKT 由专业工具生成」:先用 PROJ 导出 WKT 再写代码,不手写 `PROJCS`。需要坐标系定义与命令行核对时可 `skill` 加载 `proj`,几何运算加载 `nettopologysuite`,老项目兼容 1.4.1 时参考 `sharpmap`。
4
+ - **执行环境**:`dotnet add package`、`dotnet build`、`dotnet run` 走 `ops_bash`(Windows 下是 MSYS bash,C# 工程路径写 `/d/work/proj-demo`);PowerShell 专有写法(`Install-Package`、`$env:` 变量)走 `pwsh`。首次 restore 必须能访问 NuGet,离线时先确认本地缓存或私有源再动工。临时工程建在会话工作区,不要写进 `assets/`。
5
+ - **先探测版本**:正文按 `ProjNet` 2.1.0 编写(netstandard2.0/2.1),1.x 侧是 `ProjNet4GeoAPI` 1.4.1。先跑 `dotnet list package` 看实际装的是哪个:2.x 用 `ProjNet.CoordinateSystems` 自带类型,1.x 实现 GeoAPI 接口,两者程序集同名 `ProjNET.dll`,`using` 与接口名完全不同,项目里只应出现一个,混装会报「找到多个同名类型」。`MathTransform.TransformList` 与 `Transform(Span<double>, Span<double>, int strideX = 1, int strideY = 1)` 这批批量重载只出现在正文的 2.x 清单里,1.x 上照抄前先编译确认;数组有交错间隔时直接传 `strideX`/`strideY`,不要先手工拆成两份数组。
6
+ - **验证产物**:编译后先跑正文的最小判据:`CreateFromCoordinateSystems(GeographicCoordinateSystem.WGS84, ProjectedCoordinateSystem.WebMercator)` 转换 `{116.397, 39.908}`,输出应约为 `12957254.80, 4852582.10`;批量转换后用高斯投影量级判断——东坐标 6 位(含带号 8 位)、北坐标 0–5000000,若仍是 116/39 量级说明坐标系取错或 WKT 解析失败被静默跳过。再拿 `projinfo EPSG:4547 -o WKT2:2019` 的 WKT 用 `CreateFromWkt` 单独解析一次,返回 `null` 就是这份 WKT 不被支持。与 QGIS/GDAL 差几十米属正文已知精度限制,不是代码错误。
7
+ - **风险与权限**:新建工程、`dotnet add package`、在 1.x/2.x 之间换包都会改 `*.csproj` 与 `obj/`,动手前先 `read` 现有工程文件确认引用;两个包互斥且替换会自动卸载旧包,改动别人的工程依赖前用 `ask_user_question` 让用户在「只加 2.x / 保留 1.x / 先备份 csproj」之间选。`CoordinateSystemServices` 只认识传入的 SRID 与默认 4326/3857,不要当 EPSG 库用;示例里的 WKT 与数据路径用占位符,不要写进用户真实路径或凭据。
8
+ - **常见失败**:`CreateFromCoordinateSystems` 返回 `null` 或抛异常,多半是「两个地理坐标系只差基准面而缺转换参数」,改成地理→投影两段式;`GetCoordinateSystem(4490)` 返回 `null` 是默认只注册 4326/3857,用 `KeyValuePair<int, string>` 构造函数注册;整列结果反号是输入按 `[x, y]` 解释,把 `[lat, lon]` 改成 `[lon, lat]`;转换极慢是工厂与 `MathTransform` 建在循环里,提到循环外并改用批量重载。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:`reference/vector-raster-layers.md` 收录图层加载、遍历、编辑、`QgsSpatialIndex`、几何运算与格式导出;`reference/processing-rendering.md` 收录 `processing.run()`、渲染与布局导出以及 6 个完整工作流。按需用 `read` 取对应小节,多数任务只读主文件即可。
4
- - **执行环境**:必须用 QGIS 自带解释器(Windows 为 `C:\Program Files\QGIS 4.2\apps\Python312\python.exe`,LTR 在 `QGIS 3.44` 下),路径含空格,`ops_bash` 里要加引号,或改用 `pwsh` 写 `& "C:\...\python.exe" script.py`。多行脚本先用 `write` 落盘成 `.py` 再执行,别在命令行里拼 heredoc;无显示器时 bash 里 `export QT_QPA_PLATFORM=offscreen`,pwsh 里写 `$env:QT_QPA_PLATFORM = "offscreen"`。
5
- - **先探测版本**:`python -c "from qgis.core import Qgis; print(Qgis.QGIS_VERSION)"` 确认是 4.2.3 还是 3.44.15;两个大版本存在 API 差异,回答里要写明按哪个版本写、低版本哪些类不可用。`import qgis.core` 失败先查是不是误用了系统 Python 而不是发行包解释器。
6
- - **验证产物**:独立脚本按 `QgsApplication([], False)` → `setPrefixPath(...)` → `initQgis()` → `Processing.initialize()` → 处理 → `exitQgis()` 的次序写;写出的文件要重新 `QgsVectorLayer(...)` 打开核对 `isValid()`、`featureCount()`、`crs().authid()`,渲染或布局导出的 PNG 用 `read_image` 实际看一眼是否空白。
7
- - **风险与权限**:`startEditing()`/`commitChanges()` 直接改源数据(Shapefile、PostGIS),先备份或把中间结果写 `memory:`;批量循环不要复用同一个 `QgsProject.instance()`;覆盖已有输出、安装 QGIS、写系统目录前先征得用户同意,批量脚本放后台作业跑。
8
- - **常见失败**:图层 `isValid()` 为 false 时打印 `layer.error().message()` 并核对 provider 拼写(`ogr`/`gdal`/`postgres`);`processing.run()` 报算法不存在多半是漏了 `Processing.initialize()`;3D 模块是 `qgis._3d` 而非 `qgis.3d`;出图空白查 `QgsMapSettings` 的 extent、CRS 与输出尺寸。
3
+ - **加载与引用**:正文主文件给高频类与方法表,完整参数与示例在 `reference/vector-raster-layers.md`(矢量/栅格图层、要素读写、数据提供者 URI)和 `reference/processing-rendering.md`(`processing.run` 参数、地图渲染、`QgsLayoutExporter` 导出、典型工作流)。先用 `read` 读文件开头的目录定位小节,再按 `offset`/`limit` 跳读,或用 `grep` 搜类名,不要把两份参考整份读进上下文。要命令行跑算法时用 `skill` 加载 `qgis-process`,纯几何计算加载 `shapely`。
4
+ - **执行环境**:必须用 QGIS 发行包自带的解释器(4.2 在 `C:/Program Files/QGIS 4.2/apps/Python312/python.exe`,LTR 在 `QGIS 3.44` 下同构),系统 Python `pip install qgis` 装不上绑定。命令走 `ops_bash`(Windows 是 MSYS bash,解释器路径写成带引号的 `/c/Program\ Files/...` 形式);只在 PowerShell 能表达的写法(`$env:QT_QPA_PLATFORM = "offscreen"`)走 `pwsh`,正文的 `export QT_QPA_PLATFORM=offscreen` 在 bash 里只能作单条命令前缀。批量渲染与长脚本用后台作业起,再 `job_output` 收进度、`job_kill` 收尾。
5
+ - **先探测版本**:正文按 QGIS 4.2.3(最新)与 LTR 3.44.15 双版本编写。先跑 `python -c "from qgis.core import Qgis; print(Qgis.QGIS_VERSION)"` 确认版本,再确认 prefix 指向哪套安装;4.x 与 3.x 的类与方法有出入,低版本没有的 API 不要照抄,拿不准先查 `qgis.org/pyqgis/4.2/` 的签名。3D 模块是 `qgis._3d`(下划线),写成 `qgis.3d` 会 ImportError。
6
+ - **验证产物**:独立脚本按 `QgsApplication` → `initQgis()` → 处理 → `exitQgis()` 收尾,中途抛异常也要保证退出,否则残留进程占着文件锁。写出后重新 `QgsVectorLayer(path, name, "ogr")` 打开,核对 `isValid()`、`featureCount()`、`crs().authid()` 三项;`processing.run()` 只返回路径,不等于算法成功,必须二次打开。渲染或布局导出的 PNG/PDF 用 `read_image` 真看一眼是否空白、范围对不对,成品用 `present` 交付。建议先跑正文的最小闭环(`native:buffer` + `assert layer.isValid()`)再往上叠逻辑。
7
+ - **风险与权限**:`startEditing()`/`commitChanges()`、`QgsVectorFileWriter` 覆盖已有路径、`QgsProject.write()` 都会就地改写源数据或工程文件,动手前先备份或把中间结果写 `memory:`;覆盖已有输出、安装 QGIS、连 PostGIS 生产库之前用 `ask_user_question` 给「换名输出 / 覆盖 / 先备份」三个选项。`postgres` provider 的 URI 可能带明文口令,命令、日志与回复里都不要回显;`QgsApplication.messageLog()` 与 stderr 重定向到 `run.log` 后再分段看。
8
+ - **常见失败**:`import qgis.core` 失败先查解释器与 `PYTHONPATH`(Windows 指向 `apps/qgis` 下的 `python` 目录);图层 `isValid()` 为 false 时打印 `layer.error().message()` 并核对 provider 拼写(`ogr`/`gdal`/`postgres`);`processing.run()` 报算法不存在是漏了 `Processing.initialize()` 或插件未启用;无显示环境崩溃设 offscreen 平台;渲染空白先查 `QgsMapSettings` 的 extent、CRS 与输出尺寸。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:主文件给高频用法,算法 ID、参数类型与工作流示例在 `reference/algorithm-cheatsheet.md`,路径按加载结果的 Base directory 解析,用 `read` 分段取需要的段落,不要整份读入。
4
- - **执行环境**:`qgis_process` 走 `ops_bash`;Windows 上它只在 `C:\Program Files\QGIS 4.2\bin`(LTR 为 `C:\Program Files\QGIS 3.44\bin`)或 OSGeo4W Shell 的 PATH 里,bash 找不到时改用 `pwsh` 调带引号的绝对路径。无本地安装时按正文用容器 `docker run --rm -v "$PWD:/data" qgis/qgis:ltr qgis_process --version`,宿主路径与容器内 `/data` 要一一对应。
5
- - **先探测版本**:先 `qgis_process --version`(正文基准 4.2.3 与 LTR 3.44.15;`qgis_process` 自 3.16 才存在,更老的安装只能退回 PyQGIS),再 `qgis_process list` 确认要用的 provider 前缀在列表里;每次 `run` 之前先用 `qgis_process help <id> --json` 拿参数名与默认值,别凭记忆拼参数。
6
- - **验证产物**:从 `run ... --json` 的 `results.OUTPUT` 取实际绝对路径(不要自己拼),再 `ogrinfo -so out.gpkg 图层名` 或 `gdalinfo -json out.tif` 核对要素数、CRS、范围;`log` 数组里出现 `returned non-zero` 时进程退出码仍是 0,必须按失败处理。
7
- - **风险与权限**:`OUTPUT=` 指向已存在文件会被直接覆盖,先换名或备份;`DISTANCE` 的单位跟图层 CRS 走,地理坐标系下 50 表示 50 度而不是 50 米,必要时先跑 `native:reprojectlayer`;`--project_path` 会加载项目里的数据源与凭证,不要把含密码的 `.qgs` 交给外部环境;装 QGIS、拉镜像前先问用户。
8
- - **常见失败**:`Algorithm <id> not found!` 查 provider 前缀(`native:`、`gdal:`、`grass:`)与 `qgis_process list`;枚举参数报错是没传数字索引,回看 `help --json` 的 `available_options`;`File ... is not a valid Processing model!` 或 `not available for use outside of the QGIS desktop application` 说明该模型或脚本无法脱离桌面,改走 PyQGIS。
3
+ - **加载与引用**:正文给命令行语法、`help --json` 的结构、`run` 的 JSON 结果与常见报错;内置算法 ID、参数类型与枚举索引查 `reference/algorithm-cheatsheet.md`。先 `read` 文件开头的目录定位到目标算法小节,再用 `grep` 搜算法 ID(如 `native:buffer`),不要整份读。需要 Python 里循环调用时用 `skill` 加载 `pyqgis`,栅格导出后的检查加载 `gdal`。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 是 MSYS bash,可执行文件写 `/c/Program\ Files/QGIS\ 4.2/bin/qgis_process.exe`,路径含空格必须整体加引号);`$env:QT_QPA_PLATFORM = "offscreen"` 这类环境变量赋值走 `pwsh`,正文的 `export QT_QPA_PLATFORM=offscreen` 在 bash 里只能写成单条命令前缀 `QT_QPA_PLATFORM=offscreen qgis_process ...`。Linux 的 `sudo apt install qgis` 不可用,Windows 上装 OSGeo4W 组件或直接跑容器 `docker run --rm -v "$PWD:/data" qgis/qgis:ltr qgis_process --version`(容器内写 `/data/...`,别把宿主 `D:\...` 路径传进去)。批量循环与全量处理用后台作业起,`job_output` 看进度,`job_kill` 停掉跑偏的任务;三次以上步骤先 `todo_write` 列「探测 → help 取参 → 跑单个 → 批量 → 校验」。
5
+ - **先探测版本**:正文按 QGIS 4.2.3(stable)与 LTR 3.44.15 编写,`qgis_process` 自 3.16 起才有。先跑 `qgis_process --version`,低于 3.16 只能退回 `pyqgis` 的 `processing.run()`;用容器时用镜像 tag(`stable` / `ltr`)确认,不要假设本机 PATH 里的就是 4.2。启动慢时加 `--no-python`、`--skip-loading-plugins`,但依赖 Python 插件 provider(`saga` 等)的算法就别加。
6
+ - **验证产物**:`run ... --json` 的 `results.OUTPUT` 是实际写出的绝对路径,用它的值去校验,不要自己拼路径。矢量跑 `ogrinfo -so out.gpkg 图层名` 核对要素数、CRS、几何类型;栅格跑 `gdalinfo -json out.tif` 核对尺寸、CRS、NoData;切片或渲染出图用 `read_image` 真看一眼。正文明确:日志里出现 `returned non-zero` 时即使进程退出码为 0 也算失败,所以要 `grep -n "returned non-zero" run.log` 再下结论,别只看 `$?`。
7
+ - **风险与权限**:`OUTPUT=` 指向已有文件会被直接覆盖,`--project_path=` 会加载项目里的数据源与数据库凭证;覆盖已有图层、启动 Docker、安装 QGIS、把含密码的工程传给外部环境前用 `ask_user_question` 让用户在「换名输出 / 覆盖 / 先备份」之间选。`qgis_process run` 每次新起一个 QGIS 进程(数秒开销),千级文件别用 shell 循环硬扛,改单进程 PyQGIS。日志先重定向到 `run.log` 再 `grep`,不要把整段 JSON 日志刷进上下文。
8
+ - **常见失败**:`Algorithm <id> not found!` 先用 `qgis_process list` 核对 provider 前缀(`native:`/`gdal:`/`grass:`),插件 provider 还要求 `metadata.txt` 里 `hasProcessingProvider=yes`;`The following mandatory parameters were not specified` 回看 `help --json`;枚举参数传数字索引而不是文本;多值参数在 `--` 之后重复同一键(`LAYERS=a.shp LAYERS=b.shp`);路径含空格或中文加引号并用绝对路径。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能只有主文件,`MAP` 参数、`QGIS_SERVER_*` 变量表、Apache/Nginx 片段与排障表都在其中,按小节用 `read` 定位即可;请求 URL 直接按正文示例替换 `MAP` 与 `LAYERS`。
4
- - **执行环境**:验证请求走 `ops_bash`,Windows 上要写 `curl.exe`(`curl` 是别名,参数不同)。本会话改不了远端 Apache/Nginx,只能在本机或容器里验证:正文的容器写法是 `docker run -d --rm --name qgis-server --net=qgis -v $(pwd)/data:/data:ro -e QGIS_PROJECT_FILE=/data/osm.qgs qgis-server:latest`,用后台作业跑,再另起 `curl` 打 FastCGI 端口。
5
- - **先探测版本**:用同一安装的 `qgis --version` / `qgis_process --version`,或 `dpkg -l qgis-server`、容器镜像 tag 确认服务端版本;正文基准是 4.2.3 与 LTR 3.44.15,生成项目的 QGIS Desktop 必须与服务端大版本一致。直接执行 `/usr/lib/cgi-bin/qgis_mapserv.fcgi` 返回 `ServiceExceptionReport` 只说明二进制可用,不代表部署正确。
6
- - **验证产物**:先 `curl "http://localhost/cgi-bin/qgis_mapserv.fcgi?MAP=/data/world.qgz&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities"` 存盘后 `grep` 图层名核对,再取 `GetMap` 的 `FORMAT=image/png` 用 `read_image` 看是否空白,最后才测 `GetFeature` 与 WMTS `GetTile`。
7
- - **风险与权限**:`QGIS_SERVER_*` 改完要重启 FCGI 进程或容器才生效,`QGIS_SERVER_LOG_FILE` 已废弃,日志统一用 `QGIS_SERVER_LOG_STDERR=1`;项目文件可能内嵌数据库凭证,命令与报告里不要回显;开端口、改 Web 服务器配置、起容器前先向用户确认。
8
- - **常见失败**:`GetMap` 空白先查 `MAP` 路径可读性与 `OWS Server` 页的 `published` 勾选,再查 CRS 与 `BBOX`;`GetCapabilities` 里图层名是长 ID 说明开了 Use layer ids as names;`GetPrint` 在无 X 的 Linux 上要 `Xvfb` 加 `DISPLAY=:99`;OAPIF 在 `/wfs3`,按正文不要用 `MAP`,改 `QGIS_PROJECT_FILE`。
3
+ - **加载与引用**:单文件技能,无 reference;部署方式看「环境准备」(Debian 包 / OSGeo4W / Docker),请求示例看「核心 API / 命令」,变量与排查看「服务端环境变量」「常见问题」。服务端插件逻辑与项目自动化用 `skill` 加载 `pyqgis`,另一套 OGC 方案加载 `geoserver`,数据源侧加载 `postgis`。
4
+ - **执行环境**:`docker`、`curl.exe` 走 `ops_bash`(Windows 是 MSYS bash),原生 Windows 写法与 `$env:` 变量走 `pwsh`,多步编排可用 `run_code` 串起来。服务端部署在 Linux/容器,本机是 Windows 会话,所以默认路径是 Docker:`docker run -d --name qgis-server ... qgis/qgis:ltr` 起容器再用 `curl`(Windows 下必须写 `curl.exe`)打请求,容器与端口用 `ops_bash` 的 `run_in_background` 起、`job_output` 收日志、`job_kill` 停容器。正文的 `sudo apt install qgis-server`、`/usr/lib/cgi-bin/qgis_mapserv.fcgi`、Apache/Nginx 片段都是目标服务器写法,本机会话改不了远端主机,要么在主机上执行,要么全部在容器里验证;OSGeo4W 路线在本机装 `QGIS Desktop + QGIS Server + apache + mod_fcgid` 后才可用。`SetEnv`/`fastcgi_param` 属于服务器配置,别当本地命令跑。
5
+ - **先探测版本**:正文按 QGIS Server 4.2.3(最新)与 LTR 3.44.15 编写。先确认服务端版本:`qgis --version`、`qgis_process --version`、`dpkg -l qgis-server` 或看镜像 tag;生成项目的 QGIS Desktop 与服务端应同一主版本,否则旧项目可能打不开。直接执行 `qgis_mapserv.fcgi`(无参数)在 Linux 上应返回含 `ServiceExceptionReport` 的 XML,这是「装上且能跑」的最低判据,Windows/Docker 下用功能更全的 `GetCapabilities` 代替。
6
+ - **验证产物**:`curl.exe -sS "http://localhost/cgi-bin/qgis_mapserv.fcgi?MAP=/data/world.qgz&SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities" -o caps.xml` 存盘后 `grep -n "<Layer>" caps.xml` 核对图层清单(名字、CRS、样式),确认不是空文档或异常报告;再发 `GetMap` 拿 PNG 用 `read_image` 真看一眼是否空白、范围是否正确,`GetFeature` 取 GeoJSON 检查要素字段。只看到 HTTP 200 不算通过,正文明确 `GetMap` 的 500/空白要回查 `MAP` 路径可读性、图层 `published` 勾选与 CRS/`BBOX`。
7
+ - **风险与权限**:启动容器、映射 80 端口、改 Web 服务器配置、把服务暴露到非回环地址之前必须用 `ask_user_question` 让用户确认(尤其本机已有 Apache/Nginx 占用端口时);工程文件可能含数据库连接串与口令,命令行、日志与回复里不要回显,二进制用 `QGIS_PROJECT_FILE` 环境变量引用而不是把密码拼进 URL。`GetPrint` 在无 X 的 Linux 上要 `Xvfb`(`DISPLAY=:99`),别指望它直接出图;`QGIS_SERVER_LOG_FILE` 已废弃,统一 `QGIS_SERVER_LOG_STDERR=1` 交给日志系统。
8
+ - **常见失败**:`Service unknown or unsupported` 不是服务坏了,而是缺 `SERVICE`/`MAP` 参数;`GetCapabilities` 里图层名是长 ID 说明项目开着「Use layer ids as names」;中文乱码设 `QGIS_SERVER_OVERRIDE_SYSTEM_LOCALE=en_US.UTF-8`;WFS `Transaction` 必须 POST 且数据源可写;`QGIS_SERVER_*` 改动要重启 FCGI 进程或容器才生效,改了没反应先确认进程真的重启过。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:完整 API 在 `reference/operations-reference.md`,按小节取用(Constructive Operations、Spatial Predicates、Set-Theoretic Operations、Measurements、STRtree、Geometry Accessors、Affine/Coordinate Transforms、Linear Referencing);主文件示例够用时不必展开。
4
- - **执行环境**:纯 Python 库、无外部二进制,命令走 `ops_bash` 的解释器;wheel 自带 GEOS,conda 版可能与之版本不同,同一会话别混用两个环境。WKT/坐标输出很长时写文件再 `read` 分段看,或只打 `geom_type`、`get_num_geometries()` 摘要。
5
- - **先探测版本**:`python -c "import shapely; print(shapely.__version__, shapely.geos_version)"`;`geos_version` 是元组,用它做版本门控比 try/except 清楚——`concave_hull`、`remove_repeated_points` 需 GEOS >= 3.11,`coverage_simplify`、`has_m` 需 >= 3.12,`coverage_clean` 需 >= 3.14,顶层 `split` 需 >= 3.15(低版本回退 `shapely.ops.split`)。本技能按 2.2.0、wheel 内含 GEOS 3.14 编写,探测低于门槛就直接说明该算子不可用。
6
- - **验证产物**:`is_valid` 与 `is_valid_reason` 一起看;往返 `shapely.from_wkt(shapely.to_wkt(g, rounding_precision=-1)).equals(g)`;面积/长度做量级断言,改过几何再核 `geom_type` 与 `get_num_geometries()`;写出的 GeoJSON 用 `shapely.from_geojson()` 读回。
7
- - **风险与权限**:`set_coordinates()`、`shapely.prepare()` 都是原地修改,保留原件先 `.copy()`,且任何产生新几何的运算后预处理状态失效;无效几何不要用 `buffer(0)` 兜底,先 `make_valid()`(可 `method="structure"`);`shapely.ops.transform` 2.2 起弃用,换 `shapely.transform` 或 `transform_coordseq`。装库前征得用户同意,精确坐标可能反推位置,输出前确认敏感性。
8
- - **常见失败**:`TopologyException: side location conflict` 基本是输入自相交,`is_valid_reason` 定位后 `make_valid()`;`contains` 对边界点返回 False 是语义如此,改用 `covers()`/`intersects()`;OOP 与函数式结果不一致是 `buffer` 默认 `quad_segs` 不同(`Point.buffer` 16、`shapely.buffer` 8),比较前显式传参;`to_geojson` 丢 Z、WKB 丢 LinearRing 是格式限制而非 bug。
3
+ - **加载与引用**:正文主文件给类型、双 API、创建与常见问题,完整构造操作、谓词、集合运算、度量、STRtree、仿射与线性参考在 `reference/operations-reference.md`。先用 `read` 读该文件开头的小节目录定位,再 `offset`/`limit` 分段取用,或 `grep` 搜函数名(如 `coverage_clean`),不要整份读进上下文。矢量表读写用 `skill` 加载 `geopandas`,坐标投影按正文「坐标投影」一节用 pyproj,QGIS 内几何计算加载 `pyqgis`。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 是 MSYS bash),Python 解释器要用装了 shapely 的那一个,先 `python -c "import sys; print(sys.executable, sys.version)"` 确认不是 QGIS/GDAL 自带环境,否则可能装到别的 site-packages。正文的 `pip install shapely` 在 Windows 上同样可用(wheel 自带 GEOS),但装包前需用户同意;纯命令行的 Windows 专有操作(`Get-ChildItem`、`$env:PATH`)走 `pwsh`。批量处理十万级几何用后台作业跑,`job_output` 收进度、`job_kill` 收尾。
5
+ - **先探测版本**:正文按 Shapely 2.2.0 编写(Python 3.11+、NumPy >= 1.26、GEOS >= 3.10,PyPI wheel 内嵌 GEOS 3.14.1;2.1.2 的 wheel 才是 3.13.1)。先跑 `python -c "import shapely; print(shapely.__version__, shapely.geos_version)"` 拿到两个版本:GEOS 低于门槛的函数会直接报错或缺失——`concave_hull`/`remove_repeated_points` 要 3.11,`coverage_simplify`/`has_m`/`get_m` 要 3.12,`coverage_clean` 要 3.14,顶层 `shapely.split` 要 3.15(低版本自动回退 `shapely.ops.split`)。`minimum_width`、`get_segments`、`transform_coordseq` 是 2.2 才有的顶层函数,缺失说明装的是旧版。`shapely.ops.transform` 与 `multithreading_enabled` 在 2.2 已弃用,改 `shapely.transform`/`shapely.transform_coordseq`。
6
+ - **验证产物**:先用 `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()`。正文的端到端验收标准可直接照用:`clipped.geojson` 每个 Feature 能被 `shapely.from_geojson()` 读回、`is_valid()` 全为 True、面积与输入同阶。产出的图(`shapely.plotting` 或后续渲染)用 `read_image` 真看一眼,成品用 `present` 交付。
7
+ - **风险与权限**:`pip install shapely`、升级 GEOS 环境、改共享 conda 环境前用 `ask_user_question` 确认;`set_coordinates()`/`shapely.prepare()` 是原地修改,动手前先 `.copy()`,覆盖用户数据文件前先备份或换输出名。WKT/坐标导出前确认数据敏感度(精确坐标可反推位置),大几何别 dump 到终端刷屏,写到文件再 `read` 分段看。
8
+ - **常见失败**:`TopologyException: side location conflict` 基本是输入自相交,先 `make_valid()` 再算,不要用 `buffer(0)` 糊过去;`UnsupportedGEOSVersionError` 是底层 GEOS 太旧,核对 `shapely.geos_version`,升级 wheel(自带 GEOS)而不是只升级系统 GEOS;面积/距离为 0 或极小是地理坐标系按度算,先投影到米制;`contains` 对边界点返回 False,改用 `covers()`;OOP 与函数式结果不同是 `buffer` 默认 `quad_segs` 不同(16 vs 8),比较前显式传参;`STRtree` 查空先排除 `None`/`Empty` 与 CRS 不一致。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能无 `reference/` 分册,正文 344 行;渲染、PostGIS、瓦片三条路径按「典型工作流」定位,样式与主题细节看「主题样式」与「常见问题」两节。
4
- - **执行环境**:`dotnet` 走 `pwsh`;WinForms 控件 `SharpMap.UI` 只有 .NET Framework 4.7.2,工程 `TargetFramework` 必须写 `net472`,不能套 net8.0。`dotnet add package SharpMap --version 1.2.0` 前先确认工程目录,别在技能目录里执行。
5
- - **先探测版本**:`dotnet --version` 与 `dotnet restore`;`restore` 伴随 NU1902 / NU1903 / NU1904 漏洞告警是 1.2.0 的已知状态,不要当安装失败,但要向用户说明。坐标变换用 `ProjNet4GeoAPI` 1.4.1,ProjNet 2.x 与 SharpMap 1.2 类型不兼容。
6
- - **验证产物**:`dotnet build` 通过不算完成;跑出 `map.GetMap()` 保存的 PNG,再用 `read_image` 看按人口分色的面、标注文字和底图瓦片是否都在,空白或整体偏移都要继续查。
7
- - **风险与权限**:GDI+ 的 `Brush` / `Pen` / `Bitmap` 必须 `using` 或 `Dispose`,否则长时间运行内存持续上涨;连接 PostGIS、装包、新建工程前先问用户,连接串里的密码不要写进代码或回答。
8
- - **常见失败**:无图先查 `map.SRID` 与图层 SRID 是否一致、有没有 `ZoomToExtents()`;Shapefile 中文乱码要 `shp.Encoding = Encoding.GetEncoding("GBK")`(构造函数没有 Encoding 重载);`TileAsyncLayer` 在 `SharpMap.Layers.BruTile` 包;`SharpMap.UI.WinForms` 这个包名不存在,控件在 `SharpMap.UI`。
3
+ - **加载与引用**:单文件技能,无 reference;装包与目标框架看「安装」,图层与样式看「核心 API」及 WinForms/PostGIS/瓦片示例,「常见问题」给无图、乱码、类型冲突的对照。坐标变换细节用 `skill` 加载 `projnet4geoapi`,几何运算加载 `nettopologysuite`,新项目迁移到 `mapsui`。
4
+ - **执行环境**:`dotnet add package`、`dotnet restore`、`dotnet build` 走 `ops_bash`(Windows 是 MSYS bash,工程路径写 `/d/work/maptest`);`dotnet --list-sdks`、`Get-Command dotnet`、`$env:` 变量等 Windows 原生命令走 `pwsh`。关键约束:`SharpMap.UI` 只支持 .NET Framework 4.7.2,csproj 目标框架必须写 `net472`,不能写成 `net8.0`;只有核心包 `SharpMap`(netstandard2.0)能被新框架引用。渲染与批量出图用后台作业,`job_output` 收日志,`job_kill` 停掉卡住的任务。
5
+ - **先探测版本**:正文按 SharpMap 1.2.0 编写(2021-03 发布,仓库未归档但维护低频),坐标变换一侧必须用 `ProjNet4GeoAPI` 1.4.1。先跑 `dotnet --version` 与 `dotnet list package` 确认目标框架与包版本:`dotnet restore` 输出 NU1902/NU1903/NU1904 漏洞告警是已知状态(传递依赖 `NetTopologySuite.Core` 1.15.3、`System.Drawing.Common` 4.6.0 等),不是装失败,但要在回复里说明而不是静默忽略。正文只覆盖 1.2.0,没有 2.x,别照抄别的技能里的 ProjNet 2.x 写法。
6
+ - **验证产物**:最终判据是图不是编译:`map.GetMap()` 取 `System.Drawing.Image` 后 `Save("output.png")`,再按正文的验收——能看到按人口分档的面、标注文字、底图瓦片齐全才算渲染正确。构建只算前置:`dotnet build` 通过后必须打开 PNG 核对,会看图就用 `read_image` 真看一眼是否空白或整片偏移。SRID 一致性要单独查:`map.SRID` 与图层坐标系不一致时图能出但位置全错(例如 OSM 底图必须 3857),这属于正文「无图」以外更隐蔽的失败。
7
+ - **风险与权限**:新建工程、装包、连 PostGIS、把 SharpMap 1.2.0 引入既有解决方案前用 `ask_user_question` 让用户确认(该包维护低频且带已知漏洞告警);PostGIS 连接串的密码不要写进代码、日志或回复,示例里用占位符。`ShapeFile` 构造函数没有 `Encoding` 重载,中文乱码要单独设 `shp.Encoding = Encoding.GetEncoding("GBK")`;`Brush`/`Pen`/`Bitmap` 必须 `using`/`Dispose`,否则 GDI+ 句柄泄漏会拖垮长驻进程。
8
+ - **常见失败**:无图先查 `SRID` 与有没有调 `ZoomToExtents()`;找不到 `SharpMap.UI.WinForms` 是因为包名不存在,控件在 `SharpMap.UI` 里;`CoordinateTransformation` 赋值编译失败是引了 ProjNet 2.x,换回 `ProjNet4GeoAPI` 1.4.1;`TileAsyncLayer` 找不到要装 `SharpMap.Layers.BruTile`;文字模糊设 DPI Aware 并调 `MapTransform`。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:单文件技能,加载方式、`AddGeometryColumn`、RTree 索引与常见问题都在正文;导入导出细节转 `gdal`,读成 GeoDataFrame 转 `geopandas`,别在本技能重写。
4
- - **执行环境**:`spatialite`、`sqlite3`、`ogr2ogr` 走 `ops_bash`。正文的 `spatialite> .load mod_spatialite` 是交互式 shell 写法,会话里改成一次性调用:`spatialite mydb.sqlite -cmd ".load mod_spatialite" "SELECT spatialite_version();"`。Python 侧必须先 `enable_load_extension(True)` 再 `load_extension("mod_spatialite")`,找不到模块就传绝对路径:Windows 把 `mod_spatialite.dll` 放到 `sqlite3.exe` 同级目录或加入 PATH,conda-forge 安装则无需手工放置 DLL。
5
- - **先探测版本**:`spatialite :memory: "SELECT spatialite_version();"` 一步验证库可加载并报版本(本技能按 libspatialite 5.1.0、spatialite-tools 5.1.0a 编写)。没有 CLI 时用正文那条 Python 探测代替,库加载不了时任何 SQL 报错都没有诊断价值。
6
- - **验证产物**:写库后回读 `SELECT f_table_name, f_geometry_column, geometry_type, srid, spatial_index_enabled FROM geometry_columns;`,再跑 `SELECT CheckSpatialIndex('poi','geom');` 确认 RTree 与主表同步;导出后用正文那条 `ogrinfo -so out/road_city.gpkg road_city` 核对要素数与 SRID,别只凭 `fetchone()` 有值就算成功。
7
- - **风险与权限**:`DROP TABLE`、`DisableSpatialIndex`、批量 `DELETE` 在 SQLite 里不会保留旧版本,执行前整库复制一份 `.sqlite`。`InitSpatialMetaData` 每个库只跑一次(重复调用返回 0),`'NONE'` 模式不插入 EPSG 定义,SRID 要自己管;写操作后要 `con.commit()`,否则索引与数据都不落盘。
8
- - **常见失败**:`no such module: mod_spatialite` 是动态库不在搜索路径,先绝对路径加载;`no such function: InitSpatialMetaData` 基本是扩展没加载成功,回到上面的探测;`CreateSpatialIndex` 返回 -1 是表里已有名为 `rowid` 的物理列;`geometry has invalid SRID` 是混进 SRID 为 -1/0 的几何,用 `GeomFromText(wkt, 4326)` 或 `ST_Transform` 补上;GDAL 打开看不到图层多半是库不是 SpatiaLite 格式,导入时补 `-dsco SPATIALITE=YES`。
3
+ - **加载与引用**:单文件技能,无 reference;加载方式见「环境准备」与「核心 API → 加载扩展」,DDL 与函数表见「核心 API」,端到端导入查询导出见「典型工作流」,报错对照见「常见问题」。GDAL 侧的导入导出用 `skill` 加载 `gdal`,Python 侧读写用 `skill` 加载 `geopandas`,坐标转换细节加载 `proj`。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 是 MSYS bash);Linux 的 `sudo apt install libsqlite3-mod-spatialite` 在 Windows 不可用,改用 conda-forge:`conda install -c conda-forge libspatialite`(会同时给出 `mod_spatialite.dll` 与 `sqlite3`),或解压官方 Windows 包后把 DLL 目录加进 PATH。`.load mod_spatialite` 是 sqlite shell 的内置命令而不是 SQL,Windows 下要写成 `.load mod_spatialite.dll` 并注意 shell 与 DLL 位数一致。一次性执行按正文写法把选项放库文件之前:`spatialite -cmd ".load mod_spatialite" mydb.sqlite "SELECT spatialite_version();"`;多条语句用 heredoc 从 stdin 送 `.load` + SQL,比转义引号稳。批量导入与大表建索引放后台作业,`job_output` 收进度、`job_kill` 收尾。
5
+ - **先探测版本**:正文按 libspatialite 5.1.0(2023-08-04)与 spatialite-tools 5.1.0a 编写,截至 2026-11 仍为最新。先按正文三条验证依次过:库文件是否存在(Windows 是 `mod_spatialite.dll`)、CLI 能否加载并报版本 `spatialite -cmd ".load mod_spatialite" :memory: "SELECT spatialite_version();"`(Windows 上把库名写成 `mod_spatialite.dll`)、Python 侧 `python -c "import sqlite3; c=sqlite3.connect(':memory:'); c.enable_load_extension(True); c.load_extension('mod_spatialite'); print(c.execute('SELECT spatialite_version()').fetchone())"`;三条任一失败先解决加载问题,再动 SQL。发行版包常落后(如 bookworm 是 5.0.1),4.x 与 5.x 函数集不同(`GeosMakeValid`、`InitSpatialMetaData` 重载 5.x 才齐全),拿到版本号再决定用哪个函数名。
6
+ - **验证产物**:导入或建索引后回读 `geometry_columns`:`SELECT f_table_name, f_geometry_column, geometry_type, srid, spatial_index_enabled FROM geometry_columns;` 确认几何列、SRID 与索引开关;再跑 `SELECT CheckSpatialIndex('表','geom');` 确认 RTree 与主表同步,返回 -1 就是没建好。导出的 GPKG 用 `ogrinfo -so out.gpkg 图层名` 核对要素数与 CRS。查询结果先 `SELECT count(*)` 再抽样几行,确认单位没有混用(4326 下 `ST_Distance` 返回度,米制要 `ST_Transform` 到 3857)。成品库文件用 `present` 交付。
7
+ - **风险与权限**:`DROP TABLE`、`DisableSpatialIndex`、批量 `DELETE`/`UPDATE` 都改不回旧状态(事务只保护单次会话),执行前先备份 `.sqlite` 文件或复制成新路径,并用 `ask_user_question` 给「先备份 / 换新库 / 直接改」三个选项。GDAL 的 `-dsco SPATIALITE=YES` 会重建库结构,覆盖已有输出前先确认;`InitSpatialMetaData` 对已初始化库重复调用返回 0、不破坏数据,但仍应只跑一次。
8
+ - **常见失败**:`no such function: InitSpatialMetaData` 是扩展没加载或加载的是空壳库,先 `.load` 再用 `spatialite_version()` 验证;`no such module: mod_spatialite` 给绝对路径加载;CLI 里 `.load` 报失败先查 shell 与库位数/构建是否匹配,再改用 Python 或 `ogrinfo` 路径;`CreateSpatialIndex` 返回 -1 是表里有名为 `rowid` 的物理列遮蔽了真 ROWID,重命名后再建;`geometry has invalid SRID` 是混入 SRID -1/0 的几何,用 `GeomFromText(wkt, 4326)` 赋回;查询慢是只用 `ST_Distance` 没加 `MbrWithin` 粗筛。
@@ -0,0 +1,8 @@
1
+ ## DeepSeek Harness 使用建议
2
+
3
+ - **加载与引用**:单文件技能,没有 reference 目录;正文「核心概念与命令」的 COG/STAC/TiTiler 三段与「典型工作流」三条链路是主线,「常见问题」按症状查。COG 侧命令与校验的通用细节用 `skill` 加载 `gdal`,pgstac 的库侧知识用 `postgis`,前端消费 TileJSON 用 `maplibre-gl-js`;不要 `read` 兄弟目录的 SKILL.md。
4
+ - **执行环境**:Python 依赖装进会话工作区的 venv(`python -m venv .venv` 后 `.venv/Scripts/python -m pip install ...`,MSYS bash 里路径写 `/d/work/.venv/Scripts/python.exe`)。不要拿 `load_workspace_dependencies` 返回的随包 Python 试 `import rasterio`:那套解释器有 numpy/Pillow,但没有 GDAL/rasterio 绑定,`rio cogeo` 直接起不来。Windows 没有系统 GDAL 时装 conda-forge(`conda install -c conda-forge gdal rio-cogeo`)或跑官方镜像。`uvicorn` 与 docker 起的 TiTiler 都是常驻服务,必须 `run_in_background`,`job_output` 读到 `Uvicorn running on http://127.0.0.1:8000` 再发请求,收尾 `job_kill`;起服务前先 `curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:8000/` 探端口。
5
+ - **先探测版本**:`rio cogeo --version` 应为 7.0.4,`python -c "import rasterio; print(rasterio.__version__, rasterio.__gdal_version__)"` 一次确认绑定与底层 GDAL 都在,`python -c "import titiler.core, stac_fastapi.api as m; print(titiler.core.__version__, m.__version__)"` 对 2.4.0 与 7.1.1。`pip install titiler` 装出来是停在 0.25.0 的旧元包、入口完全不同,看到这个版本号就卸掉改装 `titiler.application==2.4.0`;正文要求 Python >= 3.11,`python -V` 低于就先换解释器。
6
+ - **验证产物**:COG 以 `rio cogeo validate output_cog.tif` 的返回内容为准(要 valid),再 `rio cogeo info output_cog.tif` 看 overviews 与 blocksize。服务用 `curl -s -o tile.png -w '%{http_code} %{content_type} %{size_download}\n'` 打 `/cog/tiles/WebMercatorQuad/8/210/98.png?url=...`,必须 200 + `image/png` + 非零字节,再用 `read_image` 看瓦片不是全黑或全透明(bidx 与 rescale 错位就长这样)。对象存储的 Range 能力单独验:`curl -s -r 0-1023 -o /dev/null -w '%{http_code}' <cog-url>` 要 206,回 200 说明 CDN 忽略了 Range,后续 416 与出图慢都从这里来。
7
+ - **风险与权限**:对象存储凭据只放环境变量(`AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY` 由外部注入,命令里只引用变量名),不写进脚本、不贴进汇报;pgstac 迁移要超级用户且会改库结构,连生产库前用 `ask_user_question` 确认。对外暴露 8000/8080、把 COG 传到第三方桶、发布别人的影像之前确认许可,STAC 只描述数据、不改变版权;`cogeo-mosaic create` 会覆盖同名 `mosaic.json`,先换名输出。
8
+ - **常见失败**:416 是文件没按 tile 组织或被截断,回 `rio cogeo validate` 重转;瓦片全黑先查 `bidx` 顺序与 `rescale`,单波段没拉伸也会全白;403 是服务进程没拿到桶凭据,改用预签名 URL 或配 IAM;`/stac/tiles` 400 多为 `url` 没做 URL 编码或 `assets` 键名与 Item 不符,先 `curl` 打开 Item JSON 核对。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能只有 SKILL.md,没有 reference 子目录;工具名与参数不要凭记忆写,先 `whitebox_tools --listtools <关键词>` 找 CamelCase 名称,再 `whitebox_tools --toolparameters=<Tool>` 取 JSON 参数定义,最后才拼 `--run=` 命令行。`--listtools` 输出很长,重定向到工作区文件后再 `grep` 取需要的行。
4
- - **执行环境**:`whitebox_tools`(Windows 为 `whitebox_tools.exe`)走 `ops_bash`,路径含空格要加引号;正文的 `cd /opt/WBT` 在 Windows 换成解压目录,用 `./whitebox_tools.exe --version`(`pwsh` 里是 `.\whitebox_tools.exe --version`)。源码编译 `python build.py` 要跑几分钟,放后台作业,用 `job_output` 看进度。
5
- - **先探测版本**:`whitebox_tools --version` 输出核心库版本(本技能基准 2.4.0),`python -c "import whitebox; print(whitebox.__version__)"` 输出 Python 封装版本(2.3.6);两者不一致是设计如此,能力以二进制为准,汇报时要说明用的是哪一个。`pip install whitebox` 首次调用会联网下载二进制,离线环境必须提前备好 WBT 目录。
6
- - **验证产物**:先用 `glob` 或 `ls -l` 确认输出文件真的生成,再用 GDAL 读数值——`gdalinfo -json slope.tif` 看范围与 NoData,必要时读数组断言坡度量级;只看退出码判断不了分析对错。水文链路要额外检查 `accum.tif` 的极值是否与流域面积量级相符,全为 1 通常意味着上游没决口或单位不一致。
7
- - **风险与权限**:编译、`pip install`、下载二进制前征得用户同意,批量处理前确认磁盘占用;显式设定 `--wd` 或全部用绝对路径,否则相对路径会落到意外目录;DEM 水平与垂直单位不同时显式传 `--zfactor`,不要假设两者一致。
8
- - **常见失败**:跑完既无输出也无报错,几乎都是 `--wd` 与相对路径不匹配;`--run` 报工具不存在是名字大小写错,用 `--listtools` 核对;参数被忽略多是照抄了别的工具的参数名,用 `--toolparameters` 复核;平坦区大片无流向给 `FillDepressions` 打开 `--fix_flats=true`,或改用 `BreachDepressions`;LiDAR 工具只吃 LAS/LAZ,其它点云格式先用 PDAL 转换。
3
+ - **加载与引用**:单文件技能,无 reference;命令骨架与常用工具参数看「核心命令」,DEM→河网→流域的完整流程看「典型工作流」,报错对照看「常见问题」,完整工具清单按正文给的「工具索引」链接查。前后处理(重投影、栅格裁剪、格式转换)用 `skill` 加载 `gdal`,点云格式转换加载 `pdal`,交叉验证结果加载 `grass-gis`。
4
+ - **执行环境**:`whitebox_tools` 二进制命令走 `ops_bash`(Windows 是 MSYS bash,写 `/d/tools/WBT/whitebox_tools.exe` 并整体加引号);正文里的 `cd /opt/WBT` 是 Linux 路径,Windows 下先 `pwsh` 里确认解压目录(`Get-ChildItem C:\Tools\WBT`)再用绝对路径调用。`python build.py` 源码编译要 Rust 工具链且耗时数分钟,必须用后台作业跑(`run_in_background` + `job_output` 看进度);`pip install whitebox` 首次调用会联网下载二进制,离线环境要手动放置 WBT 目录。
5
+ - **先探测版本**:核心库正文按 2.4.0 编写(conda-forge 的 `whitebox_tools` 同为 2.4.0),PyPI 前端 `whitebox` 是 2.3.6,两者版本号不一致属正常。先跑 `whitebox_tools --version` 拿二进制版本,再跑 `python -c "import whitebox; print(whitebox.__version__)"` 拿封装版本;工具能力以二进制为准,回答里要说明按哪个版本写。查工具与参数用正文那组封装方法,不要猜:`wbt.list_tools()`(可按关键词过滤)、`wbt.tool_help("Slope")`、`wbt.tool_parameters("Slope")`、`wbt.version()`;CLI 侧对应 `--listtools`、`--toolhelp`、`--toolparameters`、`--toolbox`、`--viewcode`(在浏览器打开该工具源码页,远程会话里慎用)。
6
+ - **验证产物**:退出码 0 不算完成。先 `gdalinfo -json accum.tif` 看极值:流量累积的最大值应与流域面积/像元数同量级,若全是 1 说明 DEM 未决口或单位不一致;坡度在 0–90 度、坡向在 0–360;再 `ogrinfo -so streams.shp` 核对河网要素数与 CRS。渲染或阴影产物(`Hillshade`、`LidarHillshade`)用 `read_image` 真看一眼是否通体灰或空白。多步水文流水线用 `todo_write` 列「探测 → 决口 → 流向/累积 → 提河网 → 流域」并逐项核对中间文件。
7
+ - **风险与权限**:`--wd` 之后的相对路径与 `--output=` 指向已有文件会直接覆盖,跑批量前先备份或换输出名,并用 `ask_user_question` 让用户在「换名输出 / 覆盖 / 先备份」之间选;下载二进制、源码编译装 Rust、改动 PATH 前也要先征得同意。大 DEM 内存占用高,先 `Clip` 到研究区或分块处理;`--toolparameters` 或 `wbt.tool_parameters()` 的 JSON 先写文件再 `read`/`grep`,不要整段刷进上下文。
8
+ - **常见失败**:`whitebox_tools: command not found` 是目录没进 PATH,`cd` 到 WBT 目录或写绝对路径(Windows 记得 `.exe`);跑完既无输出也无报错,几乎都是相对路径没对上 `--wd`,改用绝对路径重跑一次;CLI 的 `--run` 与 Python 便捷方法命名不同:CLI 用 CamelCase(`FillDepressions`),`wbt` 便捷方法是 snake_case(`wbt.fill_depressions()`),`wbt.run_tool` 两种都接受但参数仍是 `--flag=value` 列表;工具名不存在先用 `wbt.list_tools()` 或 `--listtools` 确认真名;参数被忽略是照抄了别的工具的参数名,用 `wbt.tool_parameters()` / `--toolparameters` 取真实定义。
@@ -1,21 +1,15 @@
1
1
  ---
2
2
  name: brutile
3
3
  description: "Use when fetching or enumerating map tiles in .NET with BruTile 6.0.0 — HttpTileSource over HttpClient, KnownTileSources.Create, ITileSchema.GetTileInfos for a viewport and resolution, MbTilesTileSource for offline MBTiles, or wiring tiles into Mapsui/SharpMap. Also for missing 'BruTile.Desktop' packages, CS0246 on KnownTileSources, MBTiles SQLite native load failures, and 404s from inverted TMS/OSM y-axis."
4
- tags:
5
- - dotnet
6
- - csharp
7
- - tiles
8
- - tms
9
- - wmts
10
- - mbtiles
11
- - openstreetmap
12
- - webmapping
13
- - http
4
+ license: MIT
5
+ metadata:
6
+ category: gis
7
+ tags: "dotnet, csharp, tiles, tms, wmts, mbtiles, openstreetmap, webmapping, http"
14
8
  ---
15
9
 
16
10
  > **项目地址:** <https://github.com/BruTile/BruTile>
17
11
  >
18
- > **NuGet:** `BruTile` 6.0.0 / `BruTile.MbTiles` 6.0.0(net8.0 / net9.0,截至 2026-10)
12
+ > **最新版本:** 6.0.0(2025-10-27 发布,截至 2026-11,[GitHub Releases](https://github.com/BruTile/BruTile/releases) / NuGet `BruTile`、`BruTile.MbTiles`;目标框架 net8.0 / net9.0)
19
13
  >
20
14
  > **官方文档:** <https://github.com/BruTile/BruTile>
21
15
  >
@@ -239,7 +233,7 @@ Console.WriteLine($"cache={fromCache} web={fromWeb}");
239
233
  ## 最佳实践
240
234
 
241
235
  1. **复用 HttpClient 与 TileSource**:瓦片源与 HttpClient 都是无状态可复用的对象,放在字段或 DI 单例里
242
- 2. **明确 y 轴约定**:OSM 原点在左上、TMS 在左下;瓦片行列错位错位一整屏,先把 `YAxis` 对齐再排查网络
236
+ 2. **明确 y 轴约定**:OSM 原点在左上、TMS 在左下;瓦片行列整体错位一整屏,先把 `YAxis` 对齐再排查网络
243
237
  3. **缓存分两层**:内存缓存应对快速平移缩放,MBTiles 或文件系统缓存应对离线与省钱;构造 `HttpTileSource` 时传 `persistentCache`
244
238
  4. **限制缩放级别**:`GlobalSphericalMercator(min, max)` 与服务实际级别一致,超出范围只会拿到 404
245
239
  5. **尊重版权与速率限制**:OSM 等公共服务有使用政策,生产环境用商业或自建瓦片服务,`Attribution` 要显示出来