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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +33 -19
  3. package/adaptations/brutile.md +6 -6
  4. package/adaptations/cesiumjs.md +6 -6
  5. package/adaptations/common.md +16 -13
  6. package/adaptations/deck-gl.md +6 -6
  7. package/adaptations/duckdb-spatial.md +6 -6
  8. package/adaptations/gdal-api.md +6 -6
  9. package/adaptations/gdal.md +6 -6
  10. package/adaptations/geolibre.md +6 -6
  11. package/adaptations/geometry-api-java.md +6 -6
  12. package/adaptations/geometry-api-net.md +6 -6
  13. package/adaptations/geonode.md +6 -6
  14. package/adaptations/geopandas.md +6 -6
  15. package/adaptations/geopipe-agent.md +6 -6
  16. package/adaptations/geoserver-cloud.md +6 -6
  17. package/adaptations/geoserver-rest-api.md +6 -6
  18. package/adaptations/geoserver.md +6 -6
  19. package/adaptations/geotools.md +6 -6
  20. package/adaptations/grass-gis.md +6 -6
  21. package/adaptations/jts.md +6 -6
  22. package/adaptations/kepler-gl.md +6 -6
  23. package/adaptations/leaflet.md +6 -6
  24. package/adaptations/mapbox-gl-js.md +6 -6
  25. package/adaptations/mapserver.md +6 -6
  26. package/adaptations/mapsui.md +6 -6
  27. package/adaptations/nettopologysuite.md +6 -6
  28. package/adaptations/opengis-all.md +7 -6
  29. package/adaptations/opengis-daf.md +7 -6
  30. package/adaptations/opengis-utils-for-java.md +6 -6
  31. package/adaptations/opengis-utils-for-net.md +6 -6
  32. package/adaptations/openlayers.md +6 -6
  33. package/adaptations/pdal.md +6 -6
  34. package/adaptations/postgis.md +6 -6
  35. package/adaptations/proj.md +6 -6
  36. package/adaptations/projnet4geoapi.md +6 -6
  37. package/adaptations/pyqgis.md +6 -6
  38. package/adaptations/qgis-process.md +6 -6
  39. package/adaptations/qgis-server.md +6 -6
  40. package/adaptations/shapely.md +6 -6
  41. package/adaptations/sharpmap.md +6 -6
  42. package/adaptations/spatialite.md +6 -6
  43. package/adaptations/whitebox-tools.md +6 -6
  44. package/assets/brutile/SKILL.md +6 -12
  45. package/assets/cesiumjs/SKILL.md +14 -18
  46. package/assets/deck-gl/SKILL.md +8 -15
  47. package/assets/duckdb-spatial/SKILL.md +5 -12
  48. package/assets/gdal/SKILL.md +5 -12
  49. package/assets/gdal/reference/raster-tools.md +14 -0
  50. package/assets/gdal/reference/vector-tools.md +5 -0
  51. package/assets/gdal-api/SKILL.md +6 -14
  52. package/assets/gdal-api/reference/raster-api.md +7 -0
  53. package/assets/gdal-api/reference/vector-api.md +9 -0
  54. package/assets/geolibre/SKILL.md +10 -17
  55. package/assets/geometry-api-java/SKILL.md +5 -10
  56. package/assets/geometry-api-net/SKILL.md +5 -11
  57. package/assets/geometry-api-net/reference/geometry-types.md +5 -0
  58. package/assets/geonode/SKILL.md +5 -12
  59. package/assets/geopandas/SKILL.md +5 -10
  60. package/assets/geopandas/reference/core-api.md +4 -0
  61. package/assets/geopipe-agent/SKILL.md +7 -14
  62. package/assets/geopipe-agent/reference/steps-reference.md +12 -0
  63. package/assets/geopipe-agent/reference/workflows.md +8 -0
  64. package/assets/geoserver/SKILL.md +5 -12
  65. package/assets/geoserver-cloud/SKILL.md +12 -19
  66. package/assets/geoserver-rest-api/SKILL.md +5 -12
  67. package/assets/geoserver-rest-api/reference/endpoints.md +16 -0
  68. package/assets/geotools/SKILL.md +5 -12
  69. package/assets/geotools/reference/raster-rendering.md +5 -0
  70. package/assets/geotools/reference/vector-io.md +7 -0
  71. package/assets/grass-gis/SKILL.md +8 -14
  72. package/assets/jts/SKILL.md +5 -12
  73. package/assets/jts/reference/geometry-operations.md +13 -0
  74. package/assets/kepler-gl/SKILL.md +9 -16
  75. package/assets/leaflet/SKILL.md +18 -22
  76. package/assets/mapbox-gl-js/SKILL.md +10 -16
  77. package/assets/mapserver/SKILL.md +5 -11
  78. package/assets/mapsui/SKILL.md +25 -16
  79. package/assets/nettopologysuite/SKILL.md +5 -11
  80. package/assets/opengis-all/SKILL.md +13 -19
  81. package/assets/opengis-all/reference/data-stages.md +7 -0
  82. package/assets/opengis-all/reference/workflow-cheatsheets.md +7 -0
  83. package/assets/opengis-daf/SKILL.md +5 -13
  84. package/assets/opengis-utils-for-java/SKILL.md +7 -11
  85. package/assets/opengis-utils-for-java/reference/common-tasks.md +4 -0
  86. package/assets/opengis-utils-for-net/SKILL.md +5 -10
  87. package/assets/opengis-utils-for-net/reference/code-patterns.md +4 -0
  88. package/assets/opengis-utils-for-net/reference/util-classes.md +10 -0
  89. package/assets/openlayers/SKILL.md +16 -20
  90. package/assets/pdal/SKILL.md +6 -12
  91. package/assets/postgis/SKILL.md +21 -26
  92. package/assets/proj/SKILL.md +5 -12
  93. package/assets/projnet4geoapi/SKILL.md +5 -11
  94. package/assets/pyqgis/SKILL.md +5 -10
  95. package/assets/pyqgis/reference/processing-rendering.md +6 -0
  96. package/assets/pyqgis/reference/vector-raster-layers.md +6 -0
  97. package/assets/qgis-process/SKILL.md +5 -12
  98. package/assets/qgis-process/reference/algorithm-cheatsheet.md +6 -0
  99. package/assets/qgis-server/SKILL.md +7 -13
  100. package/assets/shapely/SKILL.md +5 -10
  101. package/assets/shapely/reference/operations-reference.md +12 -0
  102. package/assets/sharpmap/SKILL.md +5 -11
  103. package/assets/spatialite/SKILL.md +7 -14
  104. package/assets/whitebox-tools/SKILL.md +9 -16
  105. package/lib/adaptations.d.ts +6 -0
  106. package/lib/adaptations.js +79 -4
  107. package/lib/catalog.d.ts +7 -1
  108. package/lib/catalog.js +9 -1
  109. package/lib/index.d.ts +9 -0
  110. package/lib/index.js +20 -1
  111. package/lib/skill-file.d.ts +12 -0
  112. package/lib/skill-file.js +107 -16
  113. package/locale/en.json +1 -1
  114. package/locale/zh.json +1 -1
  115. package/package.json +2 -2
  116. package/upstream.json +63 -63
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:主文件给高频用法,完整参数表与高级示例在 `reference/core-api.md`(含 GeoDataFrame、GeoSeries、共享几何属性、SpatialIndex 四节);先按 `###` 小节标题 `grep` 再 `read` 对应片段,不要整篇展开。底层几何报错转 `shapely`,命令行转换转 `gdal`。
4
- - **执行环境**:示例都走 `ops_bash` 里的解释器,不要假设 `python` 就是装了 geopandas 的那个——先 `python -c "import sys; print(sys.executable, sys.version)"`,conda、miniforge 等发行版自带的解释器常常不在 PATH 首位。长脚本写进工作区的 `.py` 文件再执行,比把几十行塞进 `-c` 稳定;写图产物用 `savefig` 落盘,再用 `read_image` 看。
5
- - **先探测版本**:`python -c "import geopandas as gpd; print(gpd.__version__, gpd.options.io_engine)"`,再查依赖后端 `python -c "import pyogrio, pyproj; print(pyogrio.__version__, pyproj.datadir.get_data_dir())"`。本技能按 1.2.0、Python >= 3.11 编写;低于 1.2 会缺 `to_arrow`、`to_parquet(geometry_encoding=...)`、`tiles=` 与 `legend_kwds={"colorbar": True}`,答问时说明差异,别硬写 1.2 语法。
6
- - **验证产物**:写完立即重开核对,`gdf = gpd.read_file("out.gpkg", layer="result"); print(gdf.crs, len(gdf), gdf.is_valid.all(), gdf.total_bounds)`;面积/长度必须是在投影坐标系下算的(`to_crs(gdf.estimate_utm_crs())` 之后再算),并确认量级与输入同阶,否则说明还在用度。
7
- - **风险与权限**:`set_crs()` 只标记不转换、`to_crs()` 才重算坐标,混淆会静默出错;`to_file()` 默认整表覆盖同名文件,`to_postgis(if_exists="replace")` 会删表重建,执行前确认目标路径与表名;Shapefile 字段名超 10 字符会被截断,需要长字段名就换 `.gpkg`。`pip install` 装依赖、写系统目录或覆盖生产库前先征得用户同意,连接串里的口令不要回显。
8
- - **常见失败**:`CRSError: Invalid projection` 先看 `pyproj.datadir.get_data_dir()` 是否为空或不存在(PROJ 数据目录缺失/多套 PROJ 混用);`ValueError: GeoDataFrame does not support multiple columns using the geometry column name 'geometry'` 是读入或合并时重名,用 `set_geometry()` 或给列改名;`sjoin` 一条不出先比对两边 `crs` 是否一致;`GeoSeries.buffer` 报 `resolution` 弃用改传 `quad_segs`。
3
+ - **加载与引用**:正文按 GeoPandas 1.2.0 编写,主文件覆盖 IO、`sjoin`/`overlay`/`clip`、绘图与常见问题;`GeoSeries`/`GeoDataFrame` 的完整签名在 `reference/core-api.md`——先 `read` 开头的 `## Contents` 定位小节,再按 `offset`/`limit` 分段,或用 `grep` 搜 `to_file(`、`buffer(` 之类签名,不要整文件硬读。底层几何用 `skill` 加载 `shapely`,命令行转换用 `skill` 加载 `gdal`。
4
+ - **执行环境**:`python`/`pip` 命令走 `ops_bash`,Windows 上用 `pwsh` 设 `$env:` 更稳;先 `python -c "import sys; print(sys.executable, sys.version)"` 确认解释器不是 QGIS/GDAL 自带的那个。装 `geopandas[all]` 属环境改动,先 `ask_user_question` 征得同意;批量读几百个文件或跑大面 `overlay` 时用后台作业,`job_output` 看进度,不要再串行空等。
5
+ - **先探测版本**:`python -c "import geopandas as gpd; print(gpd.__version__, gpd.options.io_engine)"`;正文按 1.2.0 / Python >= 3.11 编写,低版本缺 `to_arrow`、`to_parquet(geometry_encoding=...)` 与 1.2 的绘图参数(`tiles=`、`legend_kwds={"colorbar": True}`),1.2 里 `buffer(resolution=...)` 已弃用改 `quad_segs`。再查后端:`python -c "import pyogrio, pyproj; print(pyogrio.__version__, pyproj.__version__, pyproj.datadir.get_data_dir())"`,PROJ 目录为空正是后面 `CRSError` 的根因。
6
+ - **验证产物**:写完立刻重开核对:`gdf = gpd.read_file("out.gpkg", layer="result"); print(gdf.crs, len(gdf), gdf.is_valid.all(), gdf.total_bounds)`,并确认面积与长度是在投影坐标系下算的(经纬度下 `.area` 的单位是平方度)。制图产物落成 PNG 后必须用 `read_image` 看一眼范围、图例与空几何,成品用 `present` 交付;`to_parquet` 输出要回读列名与 CRS 元数据。
7
+ - **风险与权限**:`to_file()` 默认整表覆盖、`to_postgis(if_exists="replace")` 会删表重建,执行前用 `ask_user_question` 确认路径与表名;连接串里的密码不要出现在命令、日志或回答里。Shapefile 字段名超 10 字符会被截断且不支持空值与日期时间,要保真就换 `.gpkg` 或 GeoParquet。
8
+ - **常见失败**:`ValueError: GeoDataFrame does not support multiple columns using the geometry column name` 是存在重名列,用 `set_geometry()` 或先改名;`sjoin` 无结果先比两个 GDF 的 `.crs`;`to_crs("EPSG:3857")` 抛 `CRSError` 是 PROJ 数据目录缺失,不是坐标写错;`DriverError` 写入失败先查驱动名与文件是否被占用。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:主文件的步骤表足以定位 `use:` 的 ID,只有需要完整参数时才 `read` `reference/steps-reference.md` 的对应类别小节(共八百多行,不要整篇读入);现成 YAML 看 `reference/workflows.md`,后端可用性看 `reference/backends.md`,能力缺口走 `reference/self-extension.md`。
4
- - **执行环境**:`geopipe-agent` 走 `ops_bash`。正文提醒 `python` 可能指向 QGIS/GDAL 自带解释器,所以在工作区建独立 venv 再 `pip install -e ".[analysis,network]"`;该包未发布到 PyPI,写 `pip install geopipe-agent` 一定 404,只能 `git clone https://github.com/znlgis/GeoPipeAgent.git` 后源码安装。确认装好用 `pip show geopipe-agent`。
5
- - **先探测版本**:`geopipe-agent --help`、`geopipe-agent backends`(当前环境可用的后端,默认 `native_python`)、`geopipe-agent list-steps --format json`(拿真实步骤 ID;本技能基准 0.1.0,36 个步骤)。`qgis_process`/`pyqgis` 后端通常只在 OSGeo4W、QGIS 自带 Python 或 conda 环境可用,没装就不要在 YAML 里指定。
6
- - **验证产物**:先 `geopipe-agent validate pipeline.yaml` 再 `run pipeline.yaml`,然后看 JSON 报告里的 `qc_summary` 与各步骤统计,最后重开输出核对——`geopipe-agent info output/result.geojson`,有 GDAL 时也可 `ogrinfo -so output/result.geojson result`,确认要素数与 CRS。
7
- - **风险与权限**:`network.geocode`、`http.request`、`curl_api` 会把数据发到外部服务,执行前确认是否允许出网并检查 `user_agent` 与凭据;`gdal.cli` 直通步骤的 `output_path` 必须落在 workspace 内,`args` 里的相对路径以进程工作目录为基准,建议写绝对路径;`scaffold step` 默认 dry-run,加 `--allow-author` 才写盘。
8
- - **常见失败**:`validate` 报 `not registered` 是能力缺口而非参数错,先用 `geopipe-agent resolve "<需求>"` 与 `knowledge search` 走五步闭环,不要猜参数;`when` 引用了不存在的 `$step.attr` 会按 false 静默跳过,条件步骤不执行先查这一条;步骤 ID 不能含点号,`$step_id` 必须由更早步骤提供;`backend:` 只有声明了 backends 的 6 个矢量步骤会读取;QC 步骤是“检查即透传”,`output` 就是输入,结论在 `$step.issues`;`analysis.*`/`network.*` 报 ImportError 是缺可选依赖,补 `pip install -e ".[analysis,network]"`。
3
+ - **加载与引用**:正文主文件给步骤目录、引用语法、`when`/`on_error` 与能力缺口闭环;细节分散在 `reference/steps-reference.md`(36 个步骤的完整参数)、`reference/pipeline-schema.md`(YAML 全字段)、`reference/workflows.md`(可直接套用的五个 YAML)、`reference/backends.md`(7 种后端可用性)、`reference/self-extension.md`(探测→检索→取得能力→验证→沉淀)、`reference/knowledge.md`。先看主文件的步骤表判断要不要展开,再用 `read` 的 `offset`/`limit` 或 `grep` 取单节,不要一次读完六个文件。
4
+ - **执行环境**:`geopipe-agent` 是源码安装的 Python CLI(未上 PyPI),在工作区建独立 venv 后 `pip install -e ".[analysis,network]"`,不要往 QGIS/GDAL 自带解释器里装。命令走 `ops_bash`(Windows 是 MSYS bash,venv 解释器写 `/d/work/venv/Scripts/python.exe`);`pip show geopipe-agent | Select-String Version` 这类 PowerShell 写法与 `$env:` 变量走 `pwsh`。全量 YAML 流水线与大范围栅格处理用后台作业起,`job_output` 收 JSON 报告,`job_kill` 收尾;三步以上先 `todo_write` 列出「建 venv → validate → run → 核对产物」。
5
+ - **先探测版本**:正文按 0.1.0 编写,且明确未发布到 PyPI——`pip install geopipe-agent` 会 404,必须先 clone 再 `-e` 安装。先跑 `geopipe-agent --help` 确认装的是源码版,再 `geopipe-agent backends` 看当前环境有哪些后端可用(默认 `native_python`,`qgis_process`/`gdal_cli` 需要对应命令在 PATH),最后 `geopipe-agent list-steps --format json` 拿真实步骤 ID;版本与能力不符时以 `list-steps` 的实际输出为准。
6
+ - **验证产物**:`geopipe-agent validate pipeline.yaml` 先过校验,再 `run pipeline.yaml`,不要跳过 validate 直接跑。跑完读 JSON 报告的 `qc_summary` 与各步骤统计(重定向到 `run.json` 再 `read` 分段看),随后重开输出文件核对:`geopipe-agent info output/result.geojson`,装了 GDAL 时用 `ogrinfo -so output/result.geojson 图层名` 确认要素数与 CRS。栅格或热力图产物用 `read_image` 真看一眼;最终成果用 `present` 交付。注意 QC 步骤是「检查即透传」,`output` 就是输入,问题在 `$step.issues`,不看 issues 会误判通过。
7
+ - **风险与权限**:`network.geocode`、`http.request`、`curl_api` 会把数据发到外部服务,执行前用 `ask_user_question` 确认是否允许出网,并检查 `user_agent` 与凭据不要写进 YAML 提交;`io.write_vector`/`io.write_raster` 指向已有文件是覆盖,批量改写前先备份或换输出名。建 venv、装包、`pip install -e .` 前也先征得同意;网络请求与流水线日志里不要回显 API key。
8
+ - **常见失败**:`validate` 报 `not registered` 不要猜参数,先用 `geopipe-agent resolve "<需求>"` 与 `geopipe-agent knowledge search` 查候选能力,再走直通步骤 `gdal.cli`/`qgis.algorithm`;步骤引用解析失败常见于 ID 含点号或引用了更晚定义的步骤;`when` 引用不存在的属性会按 false **静默跳过**,条件步骤没触发先查引用链;`analysis.*`/`network.*` 报 ImportError 是没装可选依赖,补 `".[analysis,network]"` 后重装;新增 `@step` 后要重新 `pip install -e .` 才会被 `pkgutil` 发现。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:本技能只有主文件,服务拆分表、PgConfig 变量、网关路由前缀与排障顺序都在其中,按小节 `read` 即可;compose 与 Helm 两套流程不要混用,先确定目标是本地 compose 还是 K8s。
4
- - **执行环境**:`docker compose up -d`、`helm dependency update`、`kubectl` 都是长跑命令,放后台作业再轮询;下载 compose 文件用 `curl.exe -LO` 而不是 `wget`。先 `docker version`、`helm version`、`kubectl version --client` 确认工具在 PATH,缺工具就如实告诉用户,别假设已装。
5
- - **先探测版本**:`curl.exe -s -u admin:geoserver http://localhost:9090/geoserver/cloud/rest/about/version.json` 读服务版本,`curl.exe -s http://localhost:9090/actuator/health` 要拿到 `{"status":"UP"}`;镜像标签、compose 文件与 Helm chart 保持同一版本号(3.0.2),避免网关与下游服务错配。
6
- - **验证产物**:`docker compose ps` 显示 Up 不等于 OGC 服务可用,要经网关走通 `/geoserver/cloud/rest/workspaces.json` 与一次 WMS `GetMap`,出图用 `read_image` 看;K8s 上逐服务 `kubectl -n gis get pods` 加端口转发再验证。
7
- - **风险与权限**:`docker compose down -v`、`helm uninstall`、删 PVC 或 PgConfig schema 会丢全部配置,执行前必须确认并备份;`admin:geoserver`、`PGCONFIG_PASSWORD`、RabbitMQ 口令不要回显;3.x 已不发布 discovery 镜像,服务发现用 `hashicorp/consul`。
8
- - **常见失败**:网关 502 查 Consul 注册与目标服务健康(`kubectl -n gis logs deploy/<wms>`);配置改了 WMS 没生效查 RabbitMQ 可达性与 `GEOSERVER_BUS_ENABLED`;瓦片 404 查 gwc 是否部署、`GEOSERVER_BASE_PATH` 前缀是否与请求路径一致;走 config server 时环境变量要加 `SPRING_CLOUD_CONFIG_SERVER_OVERRIDES_` 前缀。
3
+ - **加载与引用**:单文件技能,无 reference;正文按 GeoServer Cloud 3.0.2.1、配套 Helm chart 3.0.3 编写,部署看「环境准备与快速启动(docker-compose)」「Kubernetes(Helm)」,排障看「常见问题」,路径对照「核心 API:网关路由与端点」。数据准备与发布自动化用 `skill` 加载 `gdal`、`postgis`、`geoserver-rest-api`,不要用 `read` 去读兄弟目录的 SKILL.md。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 下是 MSYS bash)。正文的 `wget` 在 Windows 不存在,改用 `curl.exe -LO`(`pwsh` 里用 `Invoke-WebRequest`);`/tmp`、`export`、heredoc 一律换成会话工作区与单行命令。`docker compose pull/up -d` 要拉十几个镜像、启动十个服务,属长任务:用 `ops_bash` 的 `run_in_background`,再用 `job_output` 分段收日志、失败用 `job_kill` 收尾。三步以上(拉取 → 起服务 → 探活 → GetMap)先 `todo_write`。
5
+ - **先探测版本**:正文按 3.0.2.1 编写,先跑 `docker compose version`、`docker version`、`kubectl version --client`、`helm version`,再用 `curl.exe -s -u admin:geoserver http://localhost:9090/geoserver/cloud/rest/about/version.json` 确认网关后面的 GeoServer 版本。低版本差异:3.x 起不再发布 `geoservercloud/geoserver-cloud-discovery` 镜像(Docker Hub 已 404),服务发现改用 `hashicorp/consul`;旧资料的 `jdbcconfig` 后端已被 `pgconfig` 取代。同一套部署里所有 `geoserver-cloud-*` 镜像必须同标签,chart 版本(3.0.3)与镜像标签不必一致,升级前先查 chart 默认镜像标签。
6
+ - **验证产物**:分层验证——`docker compose ps` 全 Up 只是第一层,再取 `http://localhost:9090/actuator/health` 的 `{"status":"UP"}`、`http://localhost:8500/v1/catalog/services` 里 wms/wfs 已注册、网关 `.../rest/workspaces.json` 返回合法 JSON,最后发一次 WMS `GetMap` 存成 png 并用 `read_image` 真看一眼非空、坐标没错。actuator 被 profile 关掉时改用 `kubectl -n gis get pods` 判活。
7
+ - **风险与权限**:`docker compose down -v`、`helm uninstall`、删 PVC、重置 `PGCONFIG_SCHEMA` 都会连数据目录与配置一起丢;扩容到生产、`--scale wms=3` 会改资源占用。执行前用 `ask_user_question` 给「先备份快照 / 只扩容 / 重建并丢数据」三个选项。`admin:geoserver`、`PGCONFIG_PASSWORD` 与 RabbitMQ 口令写进 `.env` 且不得回显到报告或日志。
8
+ - **常见失败**:502 先查 Consul 注册与目标服务健康(`kubectl -n gis logs deploy/<wms>` 或 `docker compose logs wms > run.log 2>&1` 后 `grep -n "^ERROR" run.log`);配置改了不同步查 RabbitMQ 可达与 `GEOSERVER_BUS_ENABLED=true`;瓦片 404 查 gwc 是否部署、`GEOSERVER_BASE_PATH` 前缀是否与请求一致(网关先 StripBasePath 再转发)。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
2
 
3
- - **加载与引用**:完整端点分组清单在 `reference/endpoints.md`(系统管理、工作空间、datastores、coveragestores、styles、security、`/gwc/rest/*`),路径按加载结果的 Base directory 解析;主文件的 10 个示例够用时不必展开参考文件。
4
- - **执行环境**:一律用 `curl.exe`(pwsh 里 `curl` 是别名、参数不同);正文的 `\` 续行在 PowerShell 无效,请求体先用 `write` 落成 `body.json`,再 `curl.exe --data "@body.json"`,绕开不同 shell 的引号差异;`.zip`/`.tif` 上传用 `--data-binary @文件`,路径写正斜杠。
5
- - **先探测版本**:`curl.exe -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json` 确认是 3.0.2 并顺带看组件版本;这一条同时充当连通性与凭据探测,返回 401 属认证或安全规则问题,不是版本问题。
6
- - **验证产物**:每个写操作后立刻 GET 回读同一资源(`.../rest/workspaces/myws.json`、`.../rest/layers/myws:roads.json`),再发一次 WMS `GetMap` 取 `image/png` 用 `read_image` 确认非空;`?recurse=true` 删除后再 GET 应得 404;201 与退出码 0 都不构成成功。
7
- - **风险与权限**:凭据用环境变量传(`$env:GS_USER`、`$env:GS_PASS`),不要硬编码进脚本文本或回显;`?recurse=true` 删除、`POST /rest/reset`、清 GeoWebCache 缓存不可逆,执行前向用户确认。
8
- - **常见失败**:GET 正常但 POST/PUT 返回 401 是缺认证或 REST 访问规则被安全设置禁用;POST 400 先查单层包装 `{"workspace":{...}}` 与 `Content-Type`;Shapefile 必须打成含 `.shp`/`.shx`/`.dbf`/`.prj` 的 ZIP;改完 SLD 不生效要先 Truncate 该图层缓存。
3
+ - **加载与引用**:正文按 GeoServer 3.0.2(2026-10-19 安全修复版)编写,端点全表在 `reference/endpoints.md`:先用 `read` 读该文件的 `## Contents` 定位小节,再按 `offset`/`limit` 取用,或 `grep` 搜 `/rest/security`、`coveragestores` 这类关键词,不要整文件硬读。正文的 10 个示例只覆盖高频操作;C# 客户端用法看「C# 客户端」一节,不打算用 .NET 就整段跳过。
4
+ - **执行环境**:请求走 `ops_bash`(MSYS bash)里的 `curl.exe`——Windows 上 `curl` 是 PowerShell 别名、参数语义不同,脚本里一律写全名。正文的 `\` 续行在 `pwsh` 里无效,压缩成单行;JSON 请求体现在 bash 单引号里可用,但更稳的是写成 `body.json` 再用 `curl.exe --data-binary "@body.json"`,绕开各 shell 的引号与转义差异。批量发布(建 workspace → 传数据 → 绑样式)三步以上,先 `todo_write` 列步骤。
5
+ - **先探测版本**:先 `curl.exe -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json` 拿到实际版本与组件清单,再决定用哪套端点。正文按 3.0.2 编写:本机若是 2.x,`/rest/services/{wms|wfs}/settings` 这类较新的服务设置端点可能不存在;3.x 的安全规则模型与 2.x 教程有差异,端点返回 404/405 时以 `reference/endpoints.md` 与官方 stable 文档为准,不要照抄正文示例。注意 cloud 版前缀是 `/geoserver/cloud/rest`,单体版是 `/geoserver/rest`。
6
+ - **验证产物**:写操作后立刻 GET 回读同一资源(`.../rest/workspaces/myws.json`、`.../rest/layers/myws:roads.json`),再用 `curl.exe -o getmap.png -w "%{http_code}"` 发一次 WMS `GetMap`,用 `read_image` 看 png 非空、图例与范围合理;只凭 201 或退出码不算验证。改样式后要清 GWC 缓存(`/gwc/rest/seed/...` 的 truncate 请求),再用同一图层不同 `styles=` 对比出图。只取状态码、把响应体落盘,可避免上万行 XML 灌进上下文。
7
+ - **风险与权限**:`?recurse=true` 删 workspace/store、`POST /rest/reset`、`PUT /rest/security/*` 改访问规则、改 admin 密码、清 GWC 缓存都不可逆或会断服务;连生产 GeoServer 前用 `ask_user_question` 给「先备份 / 只在测试实例跑 / 直接执行」选项。凭据用环境变量 `curl -u "$GS_USER:$GS_PASS"`,不写进脚本、不回显到报告;写操作先对测试实例演一遍。
8
+ - **常见失败**:GET 200 但 POST/PUT 401 是认证或安全规则问题,不是版本问题;POST 400 且资源没建多半是漏了单层包装 `{"workspace":{...}}` 或 `Content-Type`;上传 Shapefile 失败检查 ZIP 内含 `.shp/.shx/.dbf/.prj` 且 PUT 到 `.../file.shp`;改配置没生效用 `POST /rest/reload`;循环建资源时逐条检查 HTTP 码,一失败即停,半套配置留在服务端比报错更难查。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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/` 后要重启。
3
+ - **加载与引用**:单文件技能,无 reference;正文按 GeoServer 3.0.2 编写,发布流程看「发布矢量图层(PostGIS)」与「典型工作流」,WMS/WFS/WMTS/MVT 的 URL 模板、SLD 示例、GWC seed 请求都可在正文直接取;「常见问题」按症状分条,先对表再深挖。REST 自动化用 `skill` 加载 `geoserver-rest-api`,数据源侧用 `skill` 加载 `postgis`,不要在技能之间 `read` 兄弟目录。
4
+ - **执行环境**:`curl`、`unzip`、`java -version` 走 `ops_bash`,原生 Windows 路径与 `Expand-Archive`、`$env:` 走 `pwsh`。正文的 `sh bin/startup.sh` 在 Windows 不可用,改用 `bin` 下的 `startup.bat`(`pwsh -File .\bin\startup.bat`),或直接用镜像 `docker.osgeo.org/geoserver:3.0.2`;GeoServer 是常驻服务,必须用后台作业起,`job_output` 读到启动完成行再验证,收尾 `job_kill`,不要让 8080 端口一直挂着。发布、改样式、seed 三步以上先 `todo_write`。
5
+ - **先探测版本**:`java -version` 必须是 17 或 21,低于 17 启动即报 `UnsupportedClassVersionError`,3.0.x 分发包无法运行;服务起来后 `curl -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json` 核对 GeoServer 3.0.2、GeoTools 35.2、GeoWebCache 2.0.2。升级前先备份数据目录,正文强调 3.0.2 是安全修复版,生产应优先升级。
6
+ - **验证产物**:发布图层的判据是「200 + 非空字节 + 画面正确」:用 `curl -s -o out.png -w "%{http_code} %{size_download}"` 请求 `request=GetMap`,再用 `read_image` 看 `out.png` 是不是真画出了要素,空白图与 0 字节一样算失败;再拉 `GetCapabilities` 确认图层已注册。改了 SLD 预览不变,先在 Tile Caching 里 truncate 该图层或给 GetMap 加 `&tiled=false`;REST 建完 workspace/store 用同路径 GET 回读,删除后应得 404。
7
+ - **风险与权限**:`admin:geoserver` 默认凭据不要写进脚本、日志或报告,用环境变量传入;删 workspace(`?recurse=true`)、truncate GWC 缓存、改 `-Xmx`、重启容器前用 `ask_user_question` 让用户拍板;seed 大范围瓦片会撑爆磁盘,先小 zoom 单图层试。
8
+ - **常见失败**:WMS 返回空白图先查图层 native bounds 与 SRS 是否对不上;Shapefile 中文乱码改 Store 的 `charset`(UTF-8 或 GBK);WFS-T 403 是 Data 规则没给 `w` 权限;忘记管理员密码去数据目录 `security/users.properties` 恢复后重启。日志里的报错用 `grep` 定位第一条真实错误,不要从头逐行读。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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`)。
3
+ - **加载与引用**:正文按 GeoTools 35.2(JDK 17)编写。读文件顺序:先看「环境准备与快速集成」的仓库配置与模块表,再按任务跳「CRS 与坐标转换」「CQL / ECQL」「几何操作」。矢量读写完整示例在 `reference/vector-io.md`、栅格与 StreamingRenderer 出图在 `reference/raster-rendering.md`:先用 `read` 读文件开头的小节清单,再按 `offset`/`limit` 取用,或 `grep` 搜 `FileDataStore`、`StreamingRenderer` 定位,不要整篇读。几何算法细节用 `skill` 加载 `jts`,发布链路用 `skill` 加载 `geoserver`。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 下是 MSYS bash)。正文的 `mvn`/`java` 要先探测:`java -version` 必须是 17(35.x 用 JDK 8/11 编译直接失败),`mvn -v` 不存在时用 Maven wrapper 或官方 zip 解压后把 `bin` 加进 PATH;正文里的 `sudo apt-get install openjdk-17-jdk` 在 Windows 改用 Temurin 官方安装包或 `conda install -c conda-forge openjdk=17`,装不了本机 JDK 就退回 Docker(`docker run --rm -v "$PWD:/w" -w /w maven:3.9-eclipse-temurin-17 mvn ...`)。首次 `mvn` 要下载 OSGeo 仓库里几百 MB 依赖:用 `ops_bash` 的 `run_in_background` 跑,`job_output` 收日志,卡住用 `job_kill` 收尾。
5
+ - **先探测版本**:`mvn dependency:tree -Dincludes=org.geotools` 确认真的解析到 35.2 且没被别的依赖压回旧版(GeoTools 不在 Maven Central,仓库里没 `repo.osgeo.org` 就直接失败)。正文按 35.2 编写,对应 JDK 17、JTS 包名 `org.locationtech.jts`;低版本差异:≤33 分支是 JDK 11、34 起才要 17,老教程里的 `com.vividsolutions.jts` 在 20+ 已废弃。JDK 21 是 35.x 的可选支持,别用 8/11 硬跑。`pom.xml` 里 `<geotools.version>` 统一成一个属性,别混版本。
6
+ - **验证产物**:`mvn -q -DskipTests package` 只说明编译过,必须再跑一个最小 main:`FileDataStoreFinder` 打开 shapefile → `getFeatures()` 打印 count、schema 与 CRS → `JTS.transform` 重投影后打印首点坐标。写出的 GeoPackage/PNG 用独立命令回读,渲染图用 `read_image` 真看一眼不是空白、图例与范围对。`CRS.decode("EPSG:4326")` 抛异常说明缺 `gt-epsg-hsql`;`getDataStore()` 返回 null 说明对应 SPI 模块没进 classpath。`DataStore`/`SimpleFeatureIterator`/`MapContent` 没 dispose 会导致文件锁与不写盘,验证前先确认进程已退出。
7
+ - **风险与权限**:写 PostGIS/Oracle 生产库、`SimpleFeatureStore` 批量覆盖、跳过测试打包上线都不可逆,动手前用 `ask_user_question` 给「只读实例 / 写到新表 / 直接写正式库」三选项;连接串、用户名、密码只放环境变量且不得回显到报告。`mvn clean` 会删本地产物,确认目录再跑。
8
+ - **常见失败**:出现 `com.vividsolutions.jts` 是包名没升级;`CRS.decode` 报 `No such authority code` 多半缺 EPSG 模块;文件句柄泄漏或数据未写盘是漏了 `dispose()`/`try-with-resources`;多线程共享 `SimpleFeatureIterator` 会抛异常,每线程各开一个。把 `mvn -X` 日志重定向到 `run.log` 再 `grep -n "BUILD FAILURE" run.log`,不要全文读。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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:` 开头并返回非零码,定位时看第一条而不是最后一行日志。
3
+ - **加载与引用**:单文件技能,无 reference;正文按 GRASS GIS 8.5.0(8.4 LTR 最新补丁 8.4.2)编写,按任务跳「grass 启动器与无头执行」「g.region 计算区域管理」「数据导入导出」,Python 脚本化看「Python 脚本化」一节。本技能几乎不需要 `read` 参考文件,但和 `gdal`(`r.out.gdal` 后的格式与元数据核对)、`qgis-process` 经常连用,用 `skill` 按名加载,别去读兄弟目录的 SKILL.md。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 下是 MSYS bash)。正文的 `sudo apt install grass` 在 Windows 不存在:先探测 `grass --version`,没有就走 OSGeo4W 安装器(装好后在 OSGeo4W Shell 里用),或 `conda install -c conda-forge grass`,再不行 `docker run --rm -v "$PWD:/data" -w /data osgeo/grass-gis:latest grass ...`(容器内路径写 `/data`,别把 `D:\\...` 传进去)。`$HOME/grassdata` 换成会话工作区里的固定目录,避免每次换路径。正文 `--exec sh -c '...'` 的多行引用在 Windows 上不可靠,改写成单个 `.py` 脚本再用 `grass --tmp-project EPSG:3857 --exec python3 analysis.py`。整条地形分析链(import → slope → 导出)是长任务,用 `ops_bash` 的 `run_in_background` 跑,`job_output` 看日志。
5
+ - **先探测版本**:`grass --version` 拿到实际版本,再跑 `grass --tmp-project EPSG:3857 --exec g.version -rge` 确认能起无头会话。正文按 8.5.0 编写:`grass.tools` 面向对象接口是 **8.5 新增**,8.4.x/LTR 上只能用 `grass.script` 的 `run_command`/`parse_command`;`--tmp-project` 在老 7.x 叫 `--tmp-location`,命令名不同。Docker 镜像标签形如 `8.5.0-ubuntu`,与本机版本不一致时先对齐再抄命令。
6
+ - **验证产物**:`--tmp-project` 内的地图结束时随目录删除,必须先在脚本里 `r.out.gdal input=slope output=/work/slope.tif format=GTiff --overwrite` 导出,再用 `gdalinfo -json slope.tif` 核对 CRS、行列数、NoData 与范围;会话内核对用 `g.region -p format=json`(确认 rows/cols/res 符合预期)和 `g.list type=raster`。出图类结果(`d.rast` 转 PNG 或 gdal 渲染)用 `read_image` 真看一眼不是空白。判定依据是数值对得上,不是「模块没报错」。
7
+ - **风险与权限**:`--overwrite`、`g.remove`、`g.rename`、`t.connect` 会改或删地图集数据,`t.rast.aggregate` 覆盖已有 strds 同理;这些操作先 `ask_user_question` 给「换新名字 / 先备份地图集 / 直接覆盖」三选项。Docker 里结果文件属主是 root,`--user=$(id -u):$(id -g)` 加 `--env HOME=/data/` 之前确认写入路径。时空数据库按地图集独立,连错地图集会看到空数据集而不是报错。
8
+ - **常见失败**:`Exec format error` 是 `--exec` 脚本缺 shebang 或没有可执行权限;`GISBASE not defined` 说明 Python 在 GRASS 会话外跑,改用 `grass --exec python3` 或先 `gs.setup.init(...)`;`Raster map <x> not found` 先用 `g.list type=raster` 确认地图名与地图集;结果范围或分辨率不对几乎总是 `g.region` 没设对。模块错误以 `ERROR:` 或 `WARNING:` 开头并回非零码,按第一条真实错误定位。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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()` 的数据证明优化有效。
3
+ - **加载与引用**:正文按 jts-core 1.20.0 编写,空间关系、集合运算、格式读写、空间索引的完整示例在 `reference/geometry-operations.md`:先 `read` 开头的小节清单再按 `offset`/`limit` 分段取,或 `grep` 搜 `STRtree`、`OverlayNGRobust` 定位,不要整读。主文件只需要「几何对象创建」「典型工作流」两节;要 GeoJSON 写出才需要 `jts-io-common`,别为跑通一个 buffer 就把两个模块都引进来。.NET 侧对应实现用 `skill` 加载 `nettopologysuite`,几何与地图结合用 `skill` 加载 `geotools`。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 下是 MSYS bash)。`jts-core` 在 Maven Central,不依赖 OSGeo 仓库,JDK 8+ 就能编译;先用 `java -version`、`mvn -v` 探测,没装 Maven 用 Maven wrapper 或官方 zip,Java 用 Temurin 安装包或 `conda install -c conda-forge openjdk`,都没有则 `docker run --rm -v "$PWD:/w" -w /w maven:3.9-eclipse-temurin-17 mvn ...`。首次解析依赖会下载几十 MB,用 `ops_bash` 的 `run_in_background` 跑、`job_output` 收日志;大几何批量运算(百万级要素 union)写在 main 里限时分批,别让一次调用超时。
5
+ - **先探测版本**:`mvn dependency:tree -Dincludes=org.locationtech.jts` 确认解析到 1.20.0,同时 `grep -rn "vividsolutions" pom.xml src` 确认没有遗留旧包名——JTS 1.15+ 已从 `com.vividsolutions.jts` 迁到 `org.locationtech.jts`。1.20.0 的叠加引擎以 `OverlayNGRobust` 为推荐入口,低版本(1.16/1.17 早期)只有旧叠加引擎、更容易抛拓扑异常;`GeometryFixer` 也需要较新版本,老版本没有这个类。
6
+ - **验证产物**:`mvn -q test` 之外必须跑最小 main 并断言:WKT 读入 → `isValid()` → `buffer(0)` → 坐标数比对;写 GeoJSON 后用 `GeoJsonReader` 读回、比对 geometry 数量与首点坐标(用 `System.out` 打一行摘要,别打整段坐标串)。测面积/长度这类结果时给两个已知几何写死期望值做断言,只打印「跑完了」不算验证。
7
+ - **风险与权限**:JTS 的 SRID 只是元数据、全部运算在笛卡尔平面,把经纬度当平面算缓冲区出来的距离是「度」不是米——涉及真实距离先用 `skill` 加载 `proj` 投影再算,或用 `ask_user_question` 跟用户确认单位与坐标系。读外部几何前先 `IsValidOp` 校验,非法几何参与叠加会污染结果;覆盖已有数据、批量写库前先确认。
8
+ - **常见失败**:`TopologyException` 换 `OverlayNGRobust.overlay()`;`isValid()` 为 false 先 `GeometryFixer.fix()`;点不进面多半是坐标写成了 `(lat, lon)`(JTS 是 `(x, y)` 即经度、纬度);写 GeoJSON 抛 `NoClassDefFoundError: org/json/simple/JSONAware` 是手工 classpath 丢了 `json-simple` 传递依赖;`WKTReader`/`WKTWriter` 线程不安全,多线程共享会出随机错误,每线程各建一个。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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`。
3
+ - **加载与引用**:单文件技能,无 reference。正文按 Kepler.gl **3.3.0-alpha.20**(npm `latest` 与 GitHub Release 一致,仍是 3.3 预发布线、4.0 无稳定版)与 Python 侧 `keplergl` **0.4.0** 编写。按任务读:「环境准备」区分 npm 整包/子包、UMD、Jupyter 三条路;「核心 API」四节讲 dataset 结构、Redux 接入、`addDataToMap`、配置导出;「常见问题」表的报错原文可直接对照。定位性细节(Redux 接线、config 还原)要先读完全节再写代码,组件 prop 表在「KeplerGl 组件」。自定义图层底座用 `skill` 加载 `deck-gl`,数据预处理用 `skill` 加载 `geopandas`。
4
+ - **执行环境**:npm/pip 命令走 `ops_bash`(Windows 下是 MSYS bash),`chrome`、`Get-Command` 这类走 `pwsh`。安装依赖(`npm install kepler.gl` 会拉 deck.gl、maplibre 等上百个包)和 `npm run build` 都是长任务:用 `ops_bash` 的 `run_in_background` 跑,`job_output` 分段收日志,失败用 `job_kill` 收尾;输出重定向到 `build.log` 再 `grep -n "ERR\|error" build.log`,别把整段 webpack 输出打进上下文。没有浏览器可用的环境无法验证 WebGL 渲染,不要假装渲染成功。三步以上(装包 → 建工程 → build → 起静态服务)先 `todo_write`。
5
+ - **先探测版本**:`npm ls kepler.gl @kepler.gl/components @kepler.gl/actions` 一次确认主包与子包版本是否一致(正文明确要求子包与主包同为 3.3.0-alpha.20,混版会出现难定位的运行时错误);Python 侧 `python -c "import keplergl; print(keplergl.__version__)"` 应为 0.4.0。差异点:3.3 线是预发布,写 `^3.3.0` 可能解析不到 alpha 版本,要精确锁定;`keplergl` 0.4.0 依赖 Python >= 3.9、JupyterLab >= 4 或 Notebook >= 7,conda-forge 尚停在 0.3.2,要 0.4.0 只能用 pip。不看版本直接抄正文示例是这类项目最常见的返工来源。
6
+ - **验证产物**:`npm run build` 通过只说明 TypeScript/打包没问题。再 `npx serve dist` 起静态服务(后台作业),用浏览器或无头浏览器打开页面截图,再用 `read_image` 真看一眼:底图有没有出来、有没有图层、侧栏数据条数对不对;同时看控制台第一条报错。Python 侧验证 `save_to_html` 的输出时,检查 HTML 文件确实含内嵌数据、浏览器打开后图层可见,成品用 `present` 交给用户。判据是「图上看得见正确图层」,不是「build 退出码 0」。
7
+ - **风险与权限**:装 npm/pip 包、把用户数据写进可分享的 HTML、把含 token 的工程提交进仓库都要先确认——用 `ask_user_question` 给「只装本地 / 用 Docker node 镜像跑 / 先不装」这类选项。Mapbox token 有计费与泄露风险:只用 CARTO/MapLibre 样式时 `mapboxApiAccessToken` 传空串,绝不硬编码进配置或 HTML。
8
+ - **常见失败**:组件空白且控制台报 `Could not find ... in the context of Connect(...)`,是 reducer 没挂 `keplerGl` 键或 `getState` 指错;有数据没图层查 `datasets.info.id` 与 `config` 的 `dataId` 是否一致、字段类型是否为数值;时间轴不生效是缺少 `{type: 'timestamp', format: ...}`;点位全堆 (0,0) 是坐标系没转 EPSG:4326;`Cannot find module '@kepler.gl/components'` 是装了整包却按子包路径 import。一次 `addDataToMap` 塞几十万行会卡死主线程,先聚合或用 Arrow。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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()` 会持续泄漏。
3
+ - **加载与引用**:单文件技能,无 reference。正文按 Leaflet **1.9.4** 编写(2023-05 发布,至今仍是稳定版;npm 与 GitHub Release 一致)。按任务读三节:「核心 API」查 `L.map`/`L.tileLayer`/`L.geoJSON` 的选项表;「与 Vue / React 集成」拿生命周期写法;「常见问题」表的报错原文可直接对照定位。CSS 与 SRI 哈希只对 1.9.4 有效,改版本要连哈希一起换。数据源是 WMS/WFS 时用 `skill` 加载 `geoserver`,要更强投影与 MVT 能力用 `skill` 加载 `openlayers`。
4
+ - **执行环境**:`npm install`、`npm run build` 走 `ops_bash`(Windows 下是 MSYS bash),`Get-Command`、`Invoke-WebRequest` 这类 Windows 原生命令走 `pwsh`。正文用 `python -m http.server 5173` 起静态服务,Windows 上 `python` 不在 PATH 时改用 `py -3 -m http.server 5173`;起服务、`npm install` 都是长任务,用 `ops_bash` 的 `run_in_background` 跑,`job_output` 收日志、`job_kill` 收尾。三步以上(装包 → build → 起服务 → 截图核对)先 `todo_write`。没有 node 时用 `docker run --rm -v "$PWD:/w" -w /w node:22 bash -lc "npm i && npm run build"`。
5
+ - **先探测版本**:`npm ls leaflet` 看实际装到哪版,没装则 `npm view leaflet version`;页面里 `console.log(L.version)` 应为 `"1.9.4"`。差异点:正文明确 1.9.4 仍是当前稳定版(2.x 尚无稳定版),网上大量 1.7/1.8 教程;CDN 的 `integrity` 哈希与版本强绑定,把 1.9.4 的哈希贴到别的版本上会直接白屏。正文按 1.9.4 写的 API(如 `coordsToLatLng`、`L.Draw.Event`)在 1.6 前的插件里可能不同名。
6
+ - **验证产物**:正文给了明确验收:页面先出 OSM 底图 → 数据加载后视野收到点位范围 → 点圆点弹名称 → 右上角能切 POI。先在 `ops_bash` 里 `curl.exe -I http://localhost:5173/` 与入口 js 确认 200,再让浏览器打开页面,环境允许时截图并用 `read_image` 真看一眼瓦片、标记、控件都在位。判据是「图上看得见正确图层与弹窗」,不是构建退出码 0;SPA 里还要检查切路由后没有重复实例与内存增长。
7
+ - **风险与权限**:`npm install` 改依赖树、`npm run build` 覆盖 `dist/`、起服务占端口,都先 `ask_user_question` 给「只本地跑 / 用 Docker 沙箱跑 / 先不装」选项,别默认占 80 端口。天地图等瓦片服务的 `tk`、含 token 的底图 URL 不要硬编码进提交的前端代码;使用 OSM 必须保留 `attribution`,别把版权信息抹掉。
8
+ - **常见失败**:`Uncaught Error: Map container is already initialized.` 是同一容器 `L.map()` 两次(React StrictMode、热更新最常见),先 `map.remove()` 并把引用置空;`Map container not found.` 是 DOM 还没挂载;`L is not defined` 是脚本顺序或 CDN 失败;区域空白基本是容器没设 `height`;`invalidateSize()` 只在容器尺寸变化后调用;npm + 打包器下默认 marker 图标 404,要显式设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl`。坐标一律 `[lat, lng]`,GeoJSON 是 `[lng, lat]`,别混。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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`。
3
+ - **加载与引用**:单文件技能,无 reference。正文按 mapbox-gl **3.34.2** 编写,按任务读:「环境准备」讲 token 获取与 npm/CDN 两路;「核心 API」的 Map 初始化、addSource、addLayer 表达式、3D 地形、交互事件是最常改的几节;「常见问题」表里的报错原文可直接对号入座。v2 起是 Mapbox 专有许可(v1.x 才是 BSD-3),用户要开源或零成本时正文给了 MapLibre 迁移路径,别默认用 Mapbox 托管的 `mapbox://` 样式。开源替代方案的深度问题用 `skill` 加载 `leaflet` 或 `openlayers` 对比,瓦片源用 `skill` 加载 `geoserver` 自建。
4
+ - **执行环境**:`npm install`、`npm run build` 走 `ops_bash`(MSYS bash),Windows 原生命令走 `pwsh`;正文提到 Windows 下用 `npm.cmd`。`npm install mapbox-gl` 与打包都是长任务,用 `ops_bash` 的 `run_in_background` 跑、`job_output` 收日志、`job_kill` 收尾;静态预览用 `npx serve dist` 也是常驻进程,同样走后台作业。没有 node 时用 `docker run --rm -v "$PWD:/w" -w /w node:22 bash -lc "npm ci && npm run build"`。三步以上(装包 → 建图 → build → 浏览器核对)先 `todo_write`。
5
+ - **先探测版本**:`npm ls mapbox-gl`(没装则 `npm view mapbox-gl version`),CDN 的 JS 与 CSS 必须同为 `v3.34.2`——正文要求固定版本号,混版本会样式失效;控制台里 `map.isStyleLoaded()` 与 `load` 事件可确认运行时真的起来了。差异点:v3 提供 `mapbox-gl/esm` 小体积入口,v2 没有;v2+ 才需要 access token 并受 TOS 约束,v1 是 BSD。写 `^3.34` 会拉到更新的 3.x,行为可能与正文示例不一致,生产要锁精确版本。
6
+ - **验证产物**:`npm run build` 通过不是验证。`npx serve dist` 起服务后 `curl.exe -I http://localhost:5173/` 与入口 js 应为 200,再在浏览器打开看底图是否渲染、有没有 `api.mapbox.com` 的 401、图层与地形是否出现;环境允许时截图并用 `read_image` 真看一眼。无浏览器环境下如实说明「未做渲染验证」,不要用构建成功冒充地图可用。若用到 `setTerrain`,看图确认地形起伏与 DEM `encoding` 对得上。
7
+ - **风险与权限**:v2+ 受 Mapbox TOS 约束按量计费(免费额度以官方 pricing 页为准),调用前用 `ask_user_question` 说明可能产生费用并给「改用 MapLibre / 用测试 token 小流量验证 / 直接上生产」选项。前端只能放 `pk.` 公开 token,`sk.` 绝不能进构建产物:提交前用 `grep` 搜 `sk.` 与硬编码 `pk.`,日志与回答里不要回显 token;装包、起 dev server 前先确认。
8
+ - **常见失败**:401 / `A valid Mapbox access token is required` 查 token 前缀、撤销状态、URL restrictions 与配额;`Style is not done loading` 是在 `load` 前调了 `addSource`/`addLayer`,移进回调;空白先查容器 `height` 与 `map.resize()`;`mapboxgl is not defined` 是 CDN 顺序或 JS/CSS 版本不一致;点击无反应查图层 id 与 `source-layer` 名;feature-state 悬停不生效是要素缺 id(矢量源设 `promoteId`);SPA 卸载别忘 `map.remove()`。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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`。
3
+ - **加载与引用**:单文件技能,无 reference。正文按 MapServer **8.6.6** 编写,按任务读:「核心 API / 命令」的 mapfile 对象层次与最小示例、「mapserv CGI 请求参数」「WMS / WFS 请求示例」;样式问题看「SLD 绑定」;「常见问题」表里 `No query information to decode`、空白 GetMap 等原文可直接对号。数据准备用 `skill` 加载 `gdal`(`ogr2ogr`),PostGIS 源用 `skill` 加载 `postgis`,需要 WFS-T 写入时正文已指出 MapServer 只读,应改用 GeoServer。
4
+ - **执行环境**:命令走 `ops_bash`(Windows 下是 MSYS bash),Windows 原生命令与 OSGeo4W 的 `mapserv.exe` 走 `pwsh`。正文的 `sudo apt install cgi-mapserver` 在 Windows 不存在:先探测 OSGeo4W 安装目录下有没有 `bin/mapserv.exe`,没有就用 OSGeo4W 安装器勾选 `mapserver` 组件(官方给的就是这条路),或 `docker run --rm -v "$PWD:/data" -w /data ghcr.io/osgeo/mapserver:latest mapserv -v`。源码编译那段的 `tar -zxvf` 在 `pwsh` 里换成 `Expand-Archive`,`make install` 为目标目录时先确认写权限。启动 FastCGI/Apache 常驻服务是长任务,用 `ops_bash` 的 `run_in_background`,`job_output` 收日志、`job_kill` 收尾。
5
+ - **先探测版本**:`mapserv -v` 一次拿到版本与 `SUPPORTS=` 列表——正文按 8.6.6 编写,输出里要有 `MapServer version 8.6.6` 且 `SUPPORTS` 含所需的 `WMS_SERVER`/`WFS_SERVER`,缺项说明这份构建根本没编进该库,改 mapfile 无用。差异点:8.x 默认不输出要素属性(要配 `gml_include_items`),老 6.x/7.x 教程里 WFS 直接有属性的写法在 8.x 会「字段全空」;`wms_enable_request` 不设则不启用任何请求,也是 8.x 起更严格的行为。
6
+ - **验证产物**:三级验证,缺一不可。先离线渲染 `map2img -m demo.map -o out.png -s 600 400`,用 `read_image` 真看一眼 out.png 有图、范围与配色对;再 `mapserv -nh "QUERY_STRING=map=/abs/demo.map&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities"` 抓能力文档,确认图层名、`wms_srs` 与格式都在;最后 `curl.exe -s -o get.png -w "%{http_code} %{content_type}"` 发一次 `GetMap` 确认 200 和 `image/png`。判据是能力文档与实际出图一致,不是 `mapserv` 进程起来了。
7
+ - **风险与权限**:`map=` 参数可读服务器任意路径,是 MapServer 最典型的误配置——上线前必须设 `MS_MAP_PATTERN`/`MS_MAP_NO_PATH` 或用包装脚本;把 `wms_enable_request` 设为 `*` 等于对全网开放包括 `GetFeatureInfo`。重启 Apache/nginx、改 CGI 目录权限(`chmod o+x` 在 Windows 无对应语义,改用 IIS/FastCGI 配置)、覆盖生产 mapfile 前,用 `ask_user_question` 给「先备份 mapfile / 只改测试环境 / 直接生效」选项。
8
+ - **常见失败**:`No query information to decode` 只说明 CGI 能执行,缺的是 `SERVICE`/`REQUEST` 参数;GetMap 空白图查 `EXTENT` 与请求 `BBOX` 是否重合、`PROJECTION` 与数据是否一致、图层 `STATUS ON`;WFS 缺属性补 `gml_include_items "all"`;SLD 不生效是 `NamedLayer/Name` 与图层 `NAME` 不匹配或 `CLASSITEM` 字段名错;中文注记方框查 mapfile 是否 UTF-8 与 `FONT` 中文字体。改一处只验一处(改 METADATA 只跑能力文档,改样式只跑 `map2img`)。
@@ -1,8 +1,8 @@
1
1
  ## DeepSeek Harness 使用建议
2
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`。
3
+ - **加载与引用**:单文件技能,无 reference。正文按 Mapsui **5.1.0**(net8.0 / net9.0,上游 5.2.0-beta.1 为预发布不计入)编写。按任务读:「安装」确认 UI 包与数据源包的组合、「WPF 入门」拿最小可运行工程、「核心概念」区分 Map/Layer/Provider、「WMS」一节的 `WmsProvider.CreateAsync` 是 5.x 硬要求、「常见问题」表覆盖空白 MapControl 与中文乱码。几何细节用 `skill` 加载 `nettopologysuite`,服务端发布用 `skill` 加载 `geoserver`,别去读兄弟目录的 SKILL.md。
4
+ - **执行环境**:`dotnet` 命令走 `ops_bash`(Windows 下是 MSYS bash),需要看 Windows 原生产物时用 `pwsh`。先探测 `dotnet --list-sdks`:5.1.0 只支持 net8.0/net9.0(`Mapsui.Wpf` 是 net8.0-windows/net9.0-windows),只有 .NET 6/7 的机器必须先装 SDK,不能指望改个 target framework 就编译过。`dotnet add package` 与首次 `dotnet restore` 会拉 NuGet 包,属长任务,用 `ops_bash` 的 `run_in_background` 跑、`job_output` 收日志;本机没有 SDK 时退回 `docker run --rm -v "$PWD:/w" -w /w mcr.microsoft.com/dotnet/sdk:9.0 dotnet build`。新建工程 → 加包 → 编译 → 无头渲染是三步以上,先 `todo_write`。
5
+ - **先探测版本**:`dotnet --list-sdks` 与 `dotnet list package` 确认 `Mapsui.Wpf`/`Mapsui.Nts`/`Mapsui.Tiling` 是否都是 5.1.0——正文强调所有 `Mapsui.*` 子包版本必须一致,混版会在运行时抛类型加载异常,编译期看不出来。差异点:5.x 起 WMS 必须用异步工厂 `WmsProvider.CreateAsync`,正文工作流 2 里还留着一处同步 `new WmsProvider(...)` 的旧写法,5.1 上不可用,以「WMS」一节的 `CreateAsync` 为准;WPF 的 NuGet 包名是 `Mapsui.Wpf`,程序集/命名空间仍是 `Mapsui.UI.Wpf`,网上 v2 教程的包名会装不上。
6
+ - **验证产物**:`dotnet restore`/`dotnet build` 通过只说明编译过,正文已明确要求用 `Mapsui.Rendering.Skia.MapRenderer` 把 `map` 渲染成 PNG(参数以 IntelliSense 为准,常见做法是 `RenderToBitmapStream` 写 MemoryStream 再落盘),然后用 `read_image` 真看一眼:底图瓦片有没有、点位是否在预期位置、WMS 层是否出现。桌面窗口本身 AI 看不到,需请用户运行后截图。空白的地图 PNG 与「渲染成功」是两件事,只凭 build 退出码 0 报告成功属于假验证。
7
+ - **风险与权限**:新建 .NET 工程、装 NuGet 包、运行桌面程序都会改用户机器状态,先 `ask_user_question` 给「只新建到指定目录 / 用 Docker 构建 / 先不建」选项。连接 PostGIS 或私有 WMS 的密码、token 不要写进代码或回答,改用环境变量或用户机密存储;`Map.ZoomToExtents()` 在无数据图层上会让视图缩到无效范围,别对空 map 调用。
8
+ - **常见失败**:窗口空白先查有没有执行 `MapControl.Map = map`,再查 NuGet 里是否缺 `Mapsui.Wpf`;MAUI 空白查 `MauiProgram` 里 `UseSkiaSharp()` 与 `UseMapsui()` 是否注册;点跑到南太平洋是漏了 `SphericalMercator.FromLonLat(lon, lat)`(视图坐标系是 EPSG:3857);Shapefile 中文乱码是 DBF 缺 `.cpg`,用 `new ShapeFile(path, true) { Encoding = ... }` 属性赋值而非构造参数;找不到 `GeometryFeature` 装 `Mapsui.Nts`,找不到瓦片类型装 `Mapsui.Tiling`。
@@ -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`。
@@ -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`),别指望本文给全参数。两份参考要分段取:`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` 管线写法;低版本可能没有 `filters.expression`,`filters.range` 虽在但自 2.5 起推荐 `filters.expression`、将在 3.0 弃用。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"` 会输出多波段,要单波段必须显式写 `idw`/`mean`。管线先 `pdal pipeline --validate` 再实跑,退出码 0 不能证明结果正确;DEM 或点云渲染图用 `read_image` 看一眼,成品用 `present` 交付。
7
+ - **风险与权限**:`pdal translate` 与各 writer 按 `filename` 覆盖同名输出,先确认目标文件名、换名或备份;`filters.outlier`、`filters.smrf` 需要全局统计、不能流式,大点云先按 tile 拆分,别一次把整片读进内存。拉取 Docker 镜像、下载大点云、安装 PDAL、写用户目录外的路径前用 `ask_user_question` 让用户选方案;SMRF 参数(`window`、`slope`、`threshold`)改动会影响地面分类结果,交付前说明用了哪组参数。
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`。