gee-helper

GEE 鉴权、批量导出、Code Editor 风格 JS 本地运行与 GEE 脚本包管理。 CLI 入口：bin/ee（ee）。

安装

npm install && npm run build

Auth

~/.config/earthengine/.private-key.json
earthengine authenticate（OAuth）
OAuth access token 缓存于 ${XDG_CACHE_HOME:-~/.cache}/gee-helper/access-token.json（权限 600）
算法注册表缓存于同目录；仅 @google/earthengine 版本变化或缓存失效时更新

CLI

ee help

导出

# 本地 GeoTIFF
ee submit --destination local \
  --collection NASA/SMAP/SPL4SMGP/008 --band sm_surface --scale 9000 \
  --temporal daily_mean --bounds 108.5,29.0,116.2,33.3 \
  --start 2024-07-01 --end 2024-07-02 --outdir ./cache/gee-batches

# Drive / GCS
ee submit --destination drive --folder gee-exports \
  --collection ... --band ... --scale 9000 --temporal daily_mean \
  --bounds ... --start ... --end ...
ee status --job job_<id>
ee cancel --job job_<id>
ee list --limit 20
ee jobs

必填：--collection --band --scale --temporal --bounds --start --end
可选：--bucket auto|day|week|month|range、--reduction、--step-hours、--dry-run 等。

时间区间为闭区间；temporal=native 时须正 --step-hours。

本地运行

ee script.js [more.js ...]       # 多脚本只鉴权一次
ee --repl
ee --package-path ./packages script.js

注入 ee / print / Map / Export / Chart / ui.Chart，以及 Code Editor 风格 require（路径须带 .js）。本地 Map.addLayer 通过 MapLibre GL JS 输出交互式 maps/<脚本名>.html，支持图层显隐、透明度、centerObject、setCenter、setZoom 和 setOptions；GEE 临时瓦片失效后重新运行脚本即可。本地脚本通过 _host.getDownloadUrl(image, params) 获取下载地址，通过 _host.gdalWarp(args) 调用 GDAL。逐景并行下载复用 src/export/export.js，默认按 indexProperty 筛选数据源，也可通过 groups 直接下载已选分组。质量筛选由 src/export/qualityFilter.ts 独立完成并生成 CSV；sceneRecord: { filename, properties } 可同步写出通用影像记录；maxGroups=-1 下载全部、0 不下载，且影像记录始终覆盖完整集合。tiling 可启用切片下载并自动用 GDAL 合并；输出名由 prefix + 时段键 生成；可用 suffixPattern 从 system:index 保留卫星等标识。period 支持 8d、1m、1y 等周期（默认 1d，日周期自每年 1 月 1 日起算），concurrency 默认为 4。

终端运行脚本时，内置 TypeScript HTTP 服务会自动启动并打开浏览器；按 Ctrl+C 关闭。设置 GEE_MAP_OPEN=0 可仅输出本地网址，GEE_MAP_SERVER=0 可禁用服务。

GDAL 环境写入用户级 ~/.config/gee-helper/config.json，由宿主注入子进程：

{
  "gdal": {
    "projData": "/usr/share/proj",
    "gtiffSrsSource": "EPSG"
  }
}

网页端与本地可共用同一入口：

var pkg = require('users/kongdd/pkg:pkg.js');

pkg_main、pkg_extract、pkg_export、pkg_index、pkg_CMRSET 可直接共用；src/ 为旧 Node 宿主，untest/ 依赖已迁移仓库，不纳入兼容层。

包管理

ee add user/pkg                  # → packages/users/user/pkg
ee config show
ee config set packages ./packages

包路径优先级：--package-path > $GEE_JS_PATH > config > ./packages
require('users/x/y:mod.js') → packages/users/x/y/mod.js

本地数据（注册 tif/nc + 筛选 + Julia apply）

格式	后端	形态
GeoTIFF	SpatialRasterLite（ArchGDAL）	单景 2D / 目录多时相
NetCDF	NCDatasets → `SpatRaster`	三维时空 `(lon,lat,time)`

# 首次：julia --project=julia -e 'using Pkg; Pkg.instantiate()'

# 注册
ee data register --id smap_tif --path ./cache/examples/smap
ee data register --id sm_nc --path ./data/sm.nc --band sm --format nc
ee data ls
ee data unregister --id sm_nc

# 筛选（--catalog 默认 catalog/local.json；--root 仍可扫 export sidecar）
ee data query --start 2024-07-01 --end 2024-07-31 --bounds 110,30,115,32
ee data crop --id smap_tif --bounds 110,30,115,32 --outdir ./cache/local-crop

# 用户函数统一签名（2D/3D 同一入口）
# apply(ra::SpatRaster; params...)  # ra.A :: (nx,ny)|(nx,ny,nt)
ee data apply --id sm_nc --fn julia/ops/mean_time.jl \
  --start 2024-07-01 --end 2024-07-10 --outdir ./cache/local-apply

库 API：registerLocal / queryLocal / cropLocal / applyLocal。

库 API

import {
  ensureReady, getInfo, ee,
  exportBatches, submitExportTasks,
  runScript, setupLocalHost,
  addPackage, loadMergedConfig,
  queryLocal, cropLocal, applyLocal, registerLocalOp,
  SurfaceWater_HLS,
} from 'gee-helper';

OPERA DSWx-HLS 水体比例：

const col = ee.ImageCollection('OPERA/DSWX/L3_V1/HLS')
  .filterBounds(region)
  .filterDate('2023-01-01', '2027-01-01');
const options = {
  bounds: [110.67, 32.42, 111.73, 33.07],
  outdir: './data/surface-water',
};
const groups = await SurfaceWater_HLS.frac_valid(col, options);
await SurfaceWater_HLS.download(col, { ...options, groups });

frac_valid 写出 all.csv、selected.csv；download 下载全部或指定 groups。处理 Landsat、Sentinel 等数据时，传入自定义 buildWater(images)（输出带掩膜的 0/1 水体影像）及 sourceCellsize 即可复用同一流程。

子路径：gee-helper/auth、gee-helper/export。

示例

见 examples/。

ee examples/hello.js
ee examples/with-require.js examples/require-smap.js
node examples/export.js          # 库 API 本地下载
./examples/RunALL.sh             # DRY_RUN=1 可只 dry-run

测试

npm test
npm run test:coverage   # text + coverage/lcov.info

src/
  ee.js auth.js       唯一 EE 实例；鉴权
  export/             批量导出（local / Drive / GCS）
  data/               本地 catalog / 筛选 / Julia worker
  local/              本地宿主、require、config、add
  cli/                CLI（按命令懒加载，help 不拉 EE）
  index.ts            公共 API
julia/                SpatialRasterLite worker
packages/             GEE JS 包根
examples/ test/

gee-helper

安装

CLI

导出

本地运行

包管理

本地数据（注册 tif/nc + 筛选 + Julia apply）

库 API

示例

测试

目录