导出、栅格与凭据（生成文件）
由
cargo run -p sqs-script --bin script_contract -- docs/lang/generated docs/API/script/reference生成，契约版本 0.5-session。修改 registry 后重新生成，不要手改本文件。使用方法见 脚本 API 指南。
gis.raster
gis.raster.buildOverviews
在隔离副本构建影像概览，预演后确认提交旁文件。
- 权限：
export.write - 平台：桌面、移动
- 签名：
raster.buildOverviews(arg0: RasterRef): ChangePlan<OverviewResult>
gis.raster.elevationInfo
读取高程波段、单位和基准说明，不加载整幅影像。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.elevationInfo(arg0: RasterRef, arg1?: ElevationOptions): Operation<ElevationInfo>
gis.raster.sampleElevation
按 WGS84 经纬度查询实际高程，区分范围外和无效像元。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.sampleElevation(arg0: RasterRef, arg1: [number,number], arg2?: ElevationOptions): Operation<ElevationSampleResult>
gis.raster.profileElevation
沿线按米制间距取高程剖面，空洞保留断段，最多返回 64 个明细点。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.profileElevation(arg0: RasterRef, arg1: [number,number][], arg2: ElevationProfileOptions): Operation<ElevationProfileResult>
gis.secrets
gis.secrets.request
由宿主安全输入凭据，仅返回不透明引用。
- 权限：
project.read - 平台：桌面、移动
- 签名：
secrets.request(arg0: {purpose:string;label:string}): Operation<SecretRef>
gis.secrets.get
读取当前任务已授权的具名凭据引用，不返回明文。
- 权限：
project.read - 平台：桌面、移动
- 签名：
secrets.get(arg0: string): Operation<SecretRef | null>
gis.export
gis.export.dataset
为新 GeoJSON 或 GPKG 文件预演数据集导出；提交需宿主确认。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.dataset(arg0: DatasetRef | MapLayerRef | FeatureSetRef, arg1: DatasetExportOptions): ChangePlan<FileRef>
gis.export.saveToSource
仅对完整且可验证的单文件成果预演回源保存。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.saveToSource(arg0: MapLayerRef, arg1?: {password?:SecretRef}): ChangePlan<FileRef>
gis.export.feature
预演单要素成果导出，复用字段检查和宿主确认。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.feature(arg0: FeatureRef, arg1: DatasetExportOptions): ChangePlan<FileRef>
gis.export.map
冻结当前地图并预演 PNG 或固定 A4 横向 PDF；平面三维可选 1～4 倍离屏分辨率，不完整内容明确拒绝。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.map(arg0: MapExportOptions): ChangePlan<FileRef>
gis.export.validate
预检格式的字段、几何及类型限制，不写文件。
- 权限：
project.read - 平台：桌面、移动
- 签名：
export.validate(arg0: DatasetRef | MapLayerRef | FeatureSetRef, arg1: ExportValidationOptions): Operation<ExportValidationSummary>
gis.raster
gis.raster.zonalStats
按原始像元中心统计二维面分区；边界计入，重叠独立，排除无效像元；分区编号须唯一非空，返回表格。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.zonalStats(arg0: RasterRef, arg1: DatasetRef | FeatureSetRef, arg2: ZonalStatsOptions): Operation<TableRef>
gis.raster.warp
按输出坐标系和显式网格转换全部波段；分类仅最近邻，原始数值及比例参数保留；结果为临时影像引用。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.warp(arg0: RasterRef, arg1: RasterWarpOptions): Operation<RasterRef>
gis.raster.readPixels
按源网格读取有限窗口：波段从1、偏移从0开始，不裁短越界窗口；raw原值或physical比例转换，无效值为null，最多4096像元及60KiB。
- 权限：
project.read - 平台：桌面、移动
- 签名：
raster.readPixels(arg0: RasterRef, arg1: ReadPixelsOptions): Operation<PixelBlock>
gis.raster.hillshade
由投影米制 DEM 生成晕渲影像临时成果，不改写源文件。
- 权限：
analysis.execute - 平台：桌面、移动
- 签名：
raster.hillshade(arg0: RasterRef, arg1?: HillshadeAnalysisOptions): Operation<RasterRef>
gis.raster.slope
由投影米制 DEM 生成坡度影像（度）临时成果。
- 权限：
analysis.execute - 平台：桌面、移动
- 签名：
raster.slope(arg0: RasterRef, arg1?: DemAnalysisOptions): Operation<RasterRef>
gis.raster.aspect
由投影米制 DEM 生成坡向影像（度，正北顺时针，平坦为无效值）临时成果。
- 权限：
analysis.execute - 平台：桌面、移动
- 签名：
raster.aspect(arg0: RasterRef, arg1?: DemAnalysisOptions): Operation<RasterRef>
gis.raster.contours
按米制等高距由 DEM 生成等高线矢量临时成果，高程字段为 ELEV_M。
- 权限：
analysis.execute - 平台：桌面、移动
- 签名：
raster.contours(arg0: RasterRef, arg1: ContourAnalysisOptions): Operation<DatasetRef>
gis.export
gis.export.raster
预演把栅格成果写出为 GeoTIFF，需宿主确认；单个文件不超过 64 MiB。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.raster(arg0: RasterRef, arg1: RasterExportOptions): ChangePlan<FileRef>
gis.export.pointCloudClassification
预演把地面分类结果写出为 CSV，需宿主确认；原点云不改写。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.pointCloudClassification(arg0: ClassificationRef, arg1: FileExportOptions): ChangePlan<FileRef>
gis.export.splatPreview
预演把当前视角下的高斯资产单独渲染为 PNG（1～4 倍），需宿主确认；不含地图其他内容。
- 权限：
export.write - 平台：桌面、移动
- 签名：
export.splatPreview(arg0: MapLayerRef, arg1: SplatPreviewOptions): ChangePlan<FileRef>