@dsh-gis/dsh-opengis-skill 0.1.2 → 0.2.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.
- package/CHANGELOG.md +71 -0
- package/README.md +79 -43
- package/THIRD_PARTY_NOTICES.md +9 -0
- package/adaptations/brutile.md +8 -0
- package/adaptations/cesiumjs.md +8 -0
- package/adaptations/common.md +16 -0
- package/adaptations/deck-gl.md +8 -0
- package/adaptations/duckdb-spatial.md +8 -0
- package/adaptations/gdal-api.md +8 -0
- package/adaptations/gdal.md +8 -0
- package/adaptations/geolibre.md +8 -0
- package/adaptations/geometry-api-java.md +8 -0
- package/adaptations/geometry-api-net.md +8 -0
- package/adaptations/geonode.md +8 -0
- package/adaptations/geopandas.md +8 -0
- package/adaptations/geopipe-agent.md +8 -0
- package/adaptations/geoserver-cloud.md +8 -0
- package/adaptations/geoserver-rest-api.md +8 -0
- package/adaptations/geoserver.md +8 -0
- package/adaptations/geotools.md +8 -0
- package/adaptations/grass-gis.md +8 -0
- package/adaptations/jts.md +8 -0
- package/adaptations/kepler-gl.md +8 -0
- package/adaptations/leaflet.md +8 -0
- package/adaptations/mapbox-gl-js.md +8 -0
- package/adaptations/mapserver.md +8 -0
- package/adaptations/mapsui.md +8 -0
- package/adaptations/nettopologysuite.md +8 -0
- package/adaptations/opengis-all.md +8 -0
- package/adaptations/opengis-daf.md +8 -0
- package/adaptations/opengis-utils-for-java.md +8 -0
- package/adaptations/opengis-utils-for-net.md +8 -0
- package/adaptations/openlayers.md +8 -0
- package/adaptations/pdal.md +8 -0
- package/adaptations/postgis.md +8 -0
- package/adaptations/proj.md +8 -0
- package/adaptations/projnet4geoapi.md +8 -0
- package/adaptations/pyqgis.md +8 -0
- package/adaptations/qgis-process.md +8 -0
- package/adaptations/qgis-server.md +8 -0
- package/adaptations/shapely.md +8 -0
- package/adaptations/sharpmap.md +8 -0
- package/adaptations/spatialite.md +8 -0
- package/adaptations/whitebox-tools.md +8 -0
- package/assets/brutile/SKILL.md +289 -0
- package/assets/cesiumjs/SKILL.md +78 -29
- package/assets/deck-gl/SKILL.md +20 -20
- package/assets/duckdb-spatial/SKILL.md +370 -0
- package/assets/gdal/SKILL.md +50 -55
- package/assets/gdal-api/SKILL.md +12 -29
- package/assets/geolibre/SKILL.md +364 -0
- package/assets/geometry-api-java/SKILL.md +11 -19
- package/assets/geometry-api-net/SKILL.md +66 -29
- package/assets/geonode/SKILL.md +347 -0
- package/assets/geopandas/SKILL.md +22 -28
- package/assets/geopipe-agent/SKILL.md +25 -30
- package/assets/geoserver/SKILL.md +21 -24
- package/assets/geoserver-cloud/SKILL.md +23 -34
- package/assets/geoserver-rest-api/SKILL.md +18 -23
- package/assets/geotools/SKILL.md +13 -21
- package/assets/grass-gis/SKILL.md +19 -20
- package/assets/jts/SKILL.md +12 -17
- package/assets/kepler-gl/SKILL.md +313 -0
- package/assets/leaflet/SKILL.md +42 -17
- package/assets/mapbox-gl-js/SKILL.md +19 -18
- package/assets/mapserver/SKILL.md +18 -18
- package/assets/mapsui/SKILL.md +87 -58
- package/assets/nettopologysuite/SKILL.md +96 -27
- package/assets/opengis-all/SKILL.md +80 -292
- package/assets/opengis-all/reference/data-stages.md +262 -4
- package/assets/opengis-daf/SKILL.md +12 -14
- package/assets/opengis-utils-for-java/SKILL.md +52 -47
- package/assets/opengis-utils-for-java/reference/common-tasks.md +12 -12
- package/assets/opengis-utils-for-net/SKILL.md +106 -40
- package/assets/opengis-utils-for-net/reference/code-patterns.md +11 -11
- package/assets/opengis-utils-for-net/reference/util-classes.md +25 -26
- package/assets/openlayers/SKILL.md +71 -14
- package/assets/pdal/SKILL.md +21 -15
- package/assets/postgis/SKILL.md +66 -18
- package/assets/proj/SKILL.md +29 -42
- package/assets/projnet4geoapi/SKILL.md +299 -0
- package/assets/pyqgis/SKILL.md +28 -54
- package/assets/qgis-process/SKILL.md +67 -39
- package/assets/qgis-server/SKILL.md +21 -32
- package/assets/shapely/SKILL.md +133 -84
- package/assets/sharpmap/SKILL.md +96 -61
- package/assets/spatialite/SKILL.md +365 -0
- package/assets/whitebox-tools/SKILL.md +269 -0
- package/lib/adaptations.d.ts +47 -0
- package/lib/adaptations.js +268 -0
- package/lib/index.d.ts +1 -1
- package/lib/index.js +14 -2
- package/lib/skill-file.js +31 -7
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +12 -2
- package/upstream.json +56 -40
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:本技能只有主文件,部署方式、SLD 示例、GeoWebCache seed 与常见问题都在其中;要批量建 workspace/store/layer 时配合 `geoserver-rest-api` 技能,不要在本技能里手写 REST 流程。
|
|
4
|
+
- **执行环境**:`sh bin/startup.sh`、`unzip`、`wget` 都是 Linux 写法;Windows 下最省事的是 Docker 镜像 `docker.osgeo.org/geoserver:3.0.2`,`$PWD` 换成 `(Get-Location)`,下载用 `curl.exe -LO`、解压用 `Expand-Archive`。服务是长驻进程,起容器或 startup 脚本用后台作业,再轮询日志与端口。
|
|
5
|
+
- **先探测版本**:`java -version` 必须是 17 或 21,低于 17 启动 3.0.2 会直接报 `UnsupportedClassVersionError`;起来后 `curl -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json` 核对 GeoServer、GeoWebCache 与 JVM 版本。
|
|
6
|
+
- **验证产物**:发布图层后 `curl -s -o out.png -w "%{http_code} %{size_download}\n" "...request=GetMap&layers=my_ws:poi&..."` 要 200 且字节数大于 0,再用 `read_image` 看图不是空白;同时拉一次 `GetCapabilities` 确认图层已注册,不要只凭 Web UI 回显。
|
|
7
|
+
- **风险与权限**:`admin:geoserver` 与数据库口令不要进命令行回显或报告,用环境变量传入;seed 大范围瓦片会迅速吃满磁盘,先用小 zoom 范围试;删除 workspace、清 GWC 缓存、改 `-Xmx`、重启容器前先征得用户同意。
|
|
8
|
+
- **常见失败**:WMS 空白图先查 native bounds 与 SRS 是否对不上;改完 SLD 预览不变是被 GeoWebCache 缓存,Truncate 该图层或给 GetMap 加 `&tiled=false`;Shapefile 中文乱码改 Store 的 `charset`(`UTF-8` 或 `GBK`);扩展 jar 放进 `webapps/geoserver/WEB-INF/lib/` 后要重启。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:正文 417 行,先按章节标题定位再 `read` 行区间;读写矢量数据展开 `reference/vector-io.md`(Shapefile / GeoPackage / PostGIS 与 GeoJSON、WKT/WKB),GeoTIFF 与 `StreamingRenderer` 出图展开 `reference/raster-rendering.md`,一次任务通常只需其中一个。
|
|
4
|
+
- **执行环境**:`mvn` / `java` 走 `ops_bash`;`pom.xml` 里的 `<repository>` 必须指向 `https://repo.osgeo.org/repository/release/`,否则 `gt-*` 一律解析不到。Java 代码里的绝对路径要写 `D:/data/x.shp` 这种 Windows 形式,MSYS 的 `/d/data/x.shp` 传给 JVM 会找不到文件;查 `JAVA_HOME` 用 `pwsh` 的 `$env:JAVA_HOME`。
|
|
5
|
+
- **先探测版本**:`java -version` 与 `mvn -v` 都要是 JDK 17,`mvn -v` 显示的才是 Maven 实际用的 JDK;`mvn dependency:tree -Dincludes=org.geotools` 重定向到 `mvn-tree.log` 再 `grep`,确认解析到 35.2 且没被其他依赖压回旧版。
|
|
6
|
+
- **验证产物**:`mvn -q -DskipTests package` 只证明能编译;再跑最小 main(`FileDataStoreFinder` → `getFeatures()` → 打印 count 与 CRS)。渲染出的 PNG 直接 `read_image` 看,别只看文件大小。
|
|
7
|
+
- **风险与权限**:`store.dispose()` 与 `SimpleFeatureIterator` 必须关闭,否则 Shapefile / GeoPackage 被占用后重写失败;连接 PostGIS、`mvn install` 写 `~/.m2`、覆盖已有输出前先征得用户同意,连接串密码不要回显。
|
|
8
|
+
- **常见失败**:`getDataStore()` 返回 null 是 SPI 模块没进 classpath(`gt-shapefile` / `gt-geopkg` 缺失);`CRS.decode()` 抛异常缺 `gt-epsg-hsql`;出现 `com.vividsolutions.jts` 是包名未升级(GeoTools 20+ 用 `org.locationtech.jts`)。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:本技能只有 SKILL.md,没有 reference 子目录,模块清单与坑都在正文;分析链较长时不要往 `--exec` 后面堆 `sh -c '...'`,而是用 `write` 把模块序列写成工作区里的 `.py` 或 `.sh` 脚本再执行,既避开多层引号,也便于逐条改参数重跑。
|
|
4
|
+
- **执行环境**:`grass ... --exec` 走 `ops_bash`。Windows 上 `grass` 一般来自 OSGeo4W(在 OSGeo4W Shell 里才有)或 conda-forge,`pwsh` 中先 `Get-Command grass` 确认;临时目录用会话工作区而不是 `/tmp`。Docker 方式按镜像名追加 `grass` 子命令:`docker run --rm --user=$(id -u):$(id -g) --env HOME=/data/ -v "$PWD":/data -w /data osgeo/grass-gis grass --tmp-project EPSG:3857 --exec python3 analysis.py`。
|
|
5
|
+
- **先探测版本**:`grass --version`(本技能基准 8.5.0,LTR 为 8.4.2),再用 `grass --tmp-project XY --exec g.version -rge` 确认依赖库齐全;8.4 之前没有 `grass.tools`,Python 脚本退回 `gs.run_command`/`gs.parse_command` 写法,回答里要写清按哪个版本。
|
|
6
|
+
- **验证产物**:`--tmp-project`/`--tmp-mapset` 结束时会删掉整个目录,所以脚本里必须先 `r.out.gdal input=slope output=... format=GTiff` 或 `v.out.ogr` 导出到工作区,再用 `gdalinfo -json slope.tif` 核对 CRS 与范围;会话内核对区域与地图用 `g.region -p format=json`、`g.list type=raster`。
|
|
7
|
+
- **风险与权限**:`g.remove`、`--overwrite`、`t.connect` 会改或删地图集数据;重复运行不加 `--overwrite` 会因地图已存在而报错退出;临时项目里的结果不导出等于白跑;启动 Docker 或改输出属主前先确认写入路径。
|
|
8
|
+
- **常见失败**:`--exec` 报 `Exec format error` 是脚本缺 shebang,补 `#!/usr/bin/env python3` 或显式 `--exec python3 script.py`;`Raster map <x> not found` 用 `g.list` 确认地图名与当前地图集,跨地图集用 `map@mapset`;Python 报 `GISBASE not defined` 说明没在 `--exec` 会话里跑,先 `gs.setup.init(path)`;结果范围不对先看 `g.region -p`。GRASS 的失败以 `ERROR:` 开头并返回非零码,定位时看第一条而不是最后一行日志。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:主文件给核心类与工厂用法,谓词、集合运算、简化、WKT/WKB/GeoJSON、STRtree 与线性参考的完整签名在 `reference/geometry-operations.md`;改代码前按小节定位再 `read` 片段,不要整篇展开。
|
|
4
|
+
- **执行环境**:`mvn`、`gradle`、`javac`、`java` 走 `ops_bash`;classpath 分隔符在 Windows 是分号,写路径别照抄 Linux 的冒号。构建工具不可用时用 `javac -cp jts-core-1.20.0.jar Main.java && java -cp ".;jts-core-1.20.0.jar" Main`(PowerShell 里引号规则更严);`org.locationtech.jts:jts-core:1.20.0` 在 Maven Central 直接可解析,不需要额外仓库。
|
|
5
|
+
- **先探测版本**:`mvn -v` 与 `java -version`(JDK 8+ 即可),有工程时 `mvn dependency:tree -Dincludes=org.locationtech.jts` 确认解析到 1.20.0;同时确认 classpath 里没有遗留的 `com.vividsolutions.jts` 旧包——1.15+ 已迁到 `org.locationtech.jts`,两套包名并存会编译或加载冲突。GeoJSON 需要额外引 `org.locationtech.jts.io:jts-io-common:1.20.0`(`groupId` 是 `org.locationtech.jts.io`,与主库不同),它运行期依赖 `json-simple`。
|
|
6
|
+
- **验证产物**:`mvn -q test`,或最小 `main` 做 WKT 往返 + `geom.isValid()` + `buffer(0)` 断言;导出 GeoJSON 后用 `GeoJsonReader` 读回比对坐标数,构建成功不等于结果正确。
|
|
7
|
+
- **风险与权限**:`WKTReader`/`WKTWriter`、`GeoJsonWriter` 不是线程安全,别多线程共享,每线程独立创建;`GeometryFactory` 与 `Geometry` 才是线程安全的。SRID 在 JTS 里只是元数据、所有运算在笛卡尔平面进行,跨投影要先自己转换再计算。新建工程、装依赖、写用户目录前征得同意,示例里别写真实数据路径。
|
|
8
|
+
- **常见失败**:`TopologyException` 换 `OverlayNGRobust.overlay()`;`isValid()` 为 false 先 `GeometryFixer.fix()`;结果为空或与预期偏差大,多半把坐标写成了 `(lat, lon)`(JTS 是 `(x, y)` = 经纬度);手拼 classpath 写 GeoJSON 抛 `NoClassDefFoundError: org/json/simple/JSONAware` 是漏了 `json-simple`,用 Maven/Gradle 引入让传递依赖生效。批量判断用 `PreparedGeometry` 前后各计时一次,用 `System.nanoTime()` 的数据证明优化有效。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:React 侧看「Redux 接入」与「KeplerGl 组件」,Python 侧看「Python 小组件」,两套 API 不同:React 的 `theme` 是对象,`theme="dark"` 这种字符串只属于 Python 小组件。需要下钻渲染层时用 `read` 打开 `../deck-gl/SKILL.md`。
|
|
4
|
+
- **执行环境**:前端 `npm install`、`npm run build` 与 Python 侧 `pip install keplergl==0.4.0` 都走 `ops_bash`,安装输出重定向到文件再读;Notebook 里的内嵌地图依赖 Jupyter 内核(JupyterLab >= 4.0 或 Notebook >= 7.0),DSH 会话本身不渲染 anywidget,能验证到的是导出的 HTML 与配置文件。
|
|
5
|
+
- **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions`,三者必须同为 3.3.0-alpha.16,安装时把版本写死(npm `latest` 是 alpha.16,不要拿 GitHub Release 的 alpha.18 当已发布);Python 侧 `python -c "import keplergl; print(keplergl.__version__)"` 应为 0.4.0,且要求 Python >= 3.9。
|
|
6
|
+
- **验证产物**:前端构建后 `npx serve dist` 加 `curl.exe -I` 只证明资源可达;Python 侧跑 `m.save_to_html(file_name="roads_map.html")` 后用 `glob` 确认文件生成、`read` 抽查是否内含数据,再交浏览器确认渲染,有截图用 `read_image` 核对。
|
|
7
|
+
- **风险与权限**:`addDataToMap` 一次传几十万行以上会把主线程卡住数秒,先抽样或聚合;Mapbox 官方样式要 token 且计费,默认 CARTO/MapLibre 样式免 token;装包、把工程配置写进 HTML 前先问用户,配置里不要硬编码 token。
|
|
8
|
+
- **常见失败**:组件空白并提示 `Could not find ... in the context of Connect(...)` 是 reducer 没挂载或 `getState` 键名不对;有数据没图层查 `datasets.info.id` 与 `config` 里的 `dataId`;`Cannot find module '@kepler.gl/components'` 是整包与子包混用;时间过滤器失效是字段没标 `timestamp` 或缺 `format`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:本技能没有 `reference/` 目录,正文的「插件生态」「与 Vue / React 集成」「常见问题」三段覆盖了多数真实需求;要对照其他库时用 `read` 打开 `../openlayers/SKILL.md`、`../cesiumjs/SKILL.md`(即 `assets/openlayers/SKILL.md` 这类路径)。
|
|
4
|
+
- **执行环境**:`npm install leaflet` 走 `ops_bash`;纯静态页用 `python -m http.server 5173`(没有 `python` 时用 `py -3 -m http.server 5173`)起在后台作业,`curl.exe -I http://localhost:5173/` 通过后 `job_kill` 收尾,不要把静态服务器当前台命令跑。正文里的 `curl.exe` 保持原样,MSYS bash 下也能直接调。
|
|
5
|
+
- **先探测版本**:`npm ls leaflet`,未装再 `npm view leaflet version`;正文按 1.9.4,CDN 的 `integrity` SRI 哈希只对应 1.9.4,换版本必须同步换哈希,否则浏览器直接拒绝加载脚本。
|
|
6
|
+
- **验证产物**:`npm run build` 后用 `curl.exe -I` 探入口与产物 JS 是否 200,再用 `grep` 确认 `leaflet.css` 被打进产物;地图是否真渲染在 DSH 里看不到,把 URL 和预期(底图、圆点、点击弹窗)交给用户,请其截图后再用 `read_image` 看。
|
|
7
|
+
- **风险与权限**:容器高度、`map.invalidateSize()`、`map.remove()` 决定「看不到地图」和「内存增长」两类问题,改代码前先核对;`L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl` 要在打包器里显式指向,否则生产环境图标 404;天地图等服务的 `tk` 不要硬编码进提交的前端代码。
|
|
8
|
+
- **常见失败**:地图空白先查 `#map` 高度与 `invalidateSize()`;`L is not defined` 是脚本顺序或 CDN 失败;点位跑到别处是 `[lat, lng]` 与 GeoJSON 的 `[lng, lat]` 弄反,用 `coordsToLatLng` 转换;组件卸载不调 `map.remove()` 会持续泄漏。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:先读正文「获取 access token」与「常见问题」两段,401、`Style is not done loading`、feature-state 不生效都有对应格;要与 MapLibre 底座配合时用 `read` 打开 `../deck-gl/SKILL.md` 看 `MapboxOverlay` 的用法。
|
|
4
|
+
- **执行环境**:`npm install mapbox-gl`、`npm run build` 走 `ops_bash`;token 用环境变量注入——bash 里 `VITE_MAPBOX_TOKEN=... npm run build`,`pwsh` 里先 `$env:VITE_MAPBOX_TOKEN = "..."` 再构建。token 值只从用户环境取,命令、日志、回答里都不要再回显。
|
|
5
|
+
- **先探测版本**:`npm ls mapbox-gl`,未装再 `npm view mapbox-gl version`;正文按 3.33.0,CDN 的 `mapbox-gl.js` 与 `mapbox-gl.css` 必须同为 `v3.33.0`;联网时 `curl.exe -I https://api.mapbox.com/mapbox-gl-js/v3.33.0/mapbox-gl.js` 应为 200,可顺带确认该版本仍可取到。
|
|
6
|
+
- **验证产物**:构建后先 `grep` 产物里有没有 `sk.` 开头的字符串——有就是 secret token 泄进了前端,必须停下来修;再 `curl.exe -I` 确认入口 200。地图是否真加载、有没有 401 只能看浏览器 Network 的 `api.mapbox.com`,DSH 里没有浏览器画面,请用户确认或截图后用 `read_image` 看。
|
|
7
|
+
- **风险与权限**:v2+ 是 Mapbox 专有许可,免费层每月 50,000 次 map loads,任何会真实加载地图的验证都可能产生费用,跑之前先告知用户;`sk.` token 只能留在服务端;用户要求开源或免 token 时改 MapLibre(`maplibregl` 替换 `mapboxgl`、`mapbox://` 样式换自建瓦片),这属于方案变更,先确认再动手。
|
|
8
|
+
- **常见失败**:401 或 `A valid Mapbox access token is required` 查 `mapboxgl.accessToken` 是否 `pk.` 开头、是否失效或超配额;`Style is not done loading` 是把 `addSource`/`addLayer` 写在了 `load` 之前;空白先查容器高度与 `map.resize()`;`e.features` 只在回调内有效,需要留存就拷贝 `properties`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:本技能只有主文件,`MAP`/`LAYER`/`CLASS`/`STYLE` 层次、`WEB.METADATA` 关键字与排障表都在其中;写 mapfile 前先 `read` 最小示例那一段,按它的缩进、引号与 `END` 闭合方式照做。
|
|
4
|
+
- **执行环境**:`mapserv`、`map2img`、`shp2img` 来自 `mapserver-bin`,Windows 用 OSGeo4W 的 `mapserv.exe`,命令统一走 `ops_bash`。mapfile 用 `write` 写成 UTF-8、LF;正文的 `sudo apt install cgi-mapserver mapserver-bin` 在 Windows 无效,装包前先问用户。
|
|
5
|
+
- **先探测版本**:`mapserv -v` 要出现 `MapServer version 8.6.6`,并检查 `SUPPORTS=` 里有没有需要的 `WMS_SERVER`/`WFS_SERVER`;缺项说明该构建没把对应库编进去,此时改 mapfile 无用,只能换构建。
|
|
6
|
+
- **验证产物**:不必先有 Web 服务器,先离线 `map2img -m demo.map -o out.png -s 600 400` 看渲染,再用 `mapserv -nh "QUERY_STRING=map=/abs/demo.map&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities"` 抓能力文档并 `grep` 图层名,最后才 `curl` 打 CGI 确认 `Content-Type: image/png`;出图用 `read_image` 判断空白。
|
|
7
|
+
- **风险与权限**:`map=` 能读任意路径是 MapServer 最典型的误配置,生产必须设 `MS_MAP_PATTERN` 或 `MS_MAP_NO_PATH`;改 Apache 配置、`chmod o+x mapserv`、重启服务前先向用户确认。
|
|
8
|
+
- **常见失败**:返回 `No query information to decode` 属正常提示,说明 CGI 可用、只是缺 `SERVICE`/`REQUEST`;空白图查 `EXTENT`、`BBOX`、`PROJECTION` 与 `STATUS ON` 是否自洽;能力文档缺图层查 `wms_enable_request`、`wfs_enable_request` 与 `NAME` 是否字母开头;WFS 结果没有属性字段是 8.x 默认行为,补 `gml_include_items`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
2
|
+
|
|
3
|
+
- **加载与引用**:本技能无 `reference/` 分册,正文按「安装」「核心概念」「典型工作流」「常见问题」定位即可;`Mapsui.Rendering.Skia.MapRenderer` 的参数正文没有完整签名,写渲染脚本前以 IntelliSense 或官方文档核对,不要凭记忆填。
|
|
4
|
+
- **执行环境**:`dotnet` 走 `pwsh`;工程目标框架必须 net8.0 / net9.0(`Mapsui.Wpf` 为 net8.0-windows / net9.0-windows),`Mapsui.*` 子包版本全部写 5.1.0,混版会在运行时抛类型加载异常。
|
|
5
|
+
- **先探测版本**:`dotnet --list-sdks` 确认有 .NET 8/9 SDK,`dotnet restore` 能解析 5.1.0,`dotnet build` 通过后才进入渲染验证;`dotnet add package Mapsui.Wpf --version 5.1.0` 这类命令要先确认工程目录,别在技能目录里执行。
|
|
6
|
+
- **验证产物**:`dotnet build` 不等于出图;无头环境用 `MapRenderer` 把 `map` 渲成 PNG 落盘,再用 `read_image` 直接看有没有底图、要素和标注;WPF / WinForms 窗口本会话看不到,需要用户运行后提供截图。
|
|
7
|
+
- **风险与权限**:新建工程、装 NuGet 包、运行桌面程序前先征得用户同意;PostGIS 连接串与瓦片服务 token 不要写进代码或回显。
|
|
8
|
+
- **常见失败**:`MapControl` 空白先查是否赋值 `MapControl.Map`;MAUI 空白查 `MauiProgram` 里 `UseSkiaSharp()` 与 `UseMapsui()`;坐标没用 `SphericalMercator.FromLonLat` 会画到南太平洋;Shapefile 中文乱码要 `new ShapeFile(path, true) { Encoding = Encoding.GetEncoding("GBK") }`(属性赋值,不是构造参数);`GeometryFeature` 找不到装 `Mapsui.Nts`,瓦片类型找不到装 `Mapsui.Tiling`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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` 之外的包或命名空间。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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` 同进程宿主。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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 字符会被截断。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`)。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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` 而不是异常栈。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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` 反转输出。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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]`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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 与输出尺寸。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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`。
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
## DeepSeek Harness 使用建议
|
|
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 转换。
|