# D-InSAR 去重源数据包恢复工具

这个工具用于把“去重源数据包”恢复成传统 D-InSAR `Task_*` 目录结构。

适合接收方在本地运行：选择一个 `BundleRoot` 输入目录，工具会按 `pairs.json` 中的配对关系，在输出目录中恢复每个 `Task_*`。

## 产物

当前提供两个 Windows 可执行文件：

- `dinsar-restore.exe`：图形界面版，推荐普通用户双击使用。
- `dinsar-restore-console.exe`：命令行版，适合脚本、批处理或自动化调用。

Go 编译后的 exe 是单文件程序，不需要安装 Python，也不需要额外运行环境。

## 输入目录格式

输入目录应类似：

```text
BundleRoot/
  data/
    scene_<hash>_<source_name>/
    ...
  orbit/
    orbit_<hash>_<orbit_name>.txt
    ...
  pairs.json
  manifest.json
```

其中：

- `pairs.json` 必须存在。
- `data/` 必须存在。
- `orbit/` 可以不存在；轨道文件缺失只会记录 warning，不会阻断恢复。

## 输出目录格式

恢复后输出目录类似：

```text
OutputRoot/
  Task_YYYYMMDD_YYYYMMDD/
    master/
    slave/
    orbit/
    .dinsar_pair.json
  restore_report.json
  restore.log
```

恢复时会尽量去掉去重打包时增加的名称前缀：

- `data/scene_<hash>_<原始数据名>/` 只作为 bundle 内部存储目录，恢复后不会在 `master/` 或 `slave/` 下额外保留这一层目录。
- `master/` 和 `slave/` 下直接放数据文件；如果数据文件名为 `scene_<hash>_<原始文件名>`，会恢复为 `<原始文件名>`。
- `orbit/orbit_<hash>_<原始轨道文件名>` 会恢复为 `Task_*/orbit/<原始轨道文件名>`。
- 如果 `pairs.json` 中提供了 `master_orbit_source_path` / `slave_orbit_source_path`，轨道文件会优先使用这些原始路径的文件名部分。

Task 目录名优先使用：

1. `task_alias`
2. `task_name`
3. `pair_id`

## 图形界面用法

双击运行：

```text
dinsar-restore.exe
```

操作流程：

1. 点击输入目录的“选择...”按钮，选择 `BundleRoot`。
2. 建议先点击“数据自检”。
3. 点击输出目录的“选择...”按钮，选择 `OutputRoot`。
4. 根据需要设置 `Dry run`、`覆盖已有 Task`、`Limit`。
5. 点击“开始恢复”。
6. 在运行日志区域查看进度、warning 和错误。

### 数据自检

“数据自检”只检查输入数据，不复制文件，也不会生成 `Task_*`。

自检内容包括：

- `pairs.json` 是否存在、是否能解析。
- `data/` 是否存在。
- 每个 pair 的 Task 目录名是否合法。
- `master_data` 是否存在、是否为非空目录。
- `slave_data` 是否存在、是否为非空目录。
- 是否存在重复 Task 目录名。
- `master_orbit` / `slave_orbit` 是否存在。

注意：轨道文件缺失只记为 warning，不算失败。

### 分批恢复

如果数据量很大，可以用 `Limit` 分批执行。

例如共有 1000 个 Task：

1. 第一次设置 `Limit=200`，恢复 200 个。
2. 第二次仍设置 `Limit=200`，工具会跳过已完成的 200 个，再恢复新的 200 个。
3. 重复执行，直到全部完成。

已完成 Task 的判断标准是：

- `Task/master/` 存在且非空。
- `Task/slave/` 存在且非空。

已跳过的 Task 不会占用 `Limit` 数量。

### 覆盖已有 Task

默认情况下，已经完整恢复的 Task 会被跳过。

如果勾选“覆盖已有 Task”，工具会删除并重建已有 Task 目录。这个选项适合重新生成结果，但使用前应确认输出目录中没有需要保留的手工文件。

### Dry run

勾选 `Dry run` 后，工具只打印计划，不复制文件。

可以用它先确认将要恢复哪些 Task。

## 命令行用法

命令行版文件：

```powershell
.\dinsar-restore-console.exe
```

数据自检：

```powershell
.\dinsar-restore-console.exe --input D:\BundleRoot --check-only
```

正式恢复：

```powershell
.\dinsar-restore-console.exe --input D:\BundleRoot --output D:\OutputRoot
```

Dry run：

```powershell
.\dinsar-restore-console.exe --input D:\BundleRoot --output D:\OutputRoot --dry-run
```

覆盖已有 Task：

```powershell
.\dinsar-restore-console.exe --input D:\BundleRoot --output D:\OutputRoot --overwrite
```

分批恢复，每次最多恢复 200 个新 Task：

```powershell
.\dinsar-restore-console.exe --input D:\BundleRoot --output D:\OutputRoot --limit 200
```

## 参数说明

| 参数 | 说明 |
| --- | --- |
| `--input` | 输入目录，即 `BundleRoot`。 |
| `--output` | 输出目录，即 `OutputRoot`。`--check-only` 时可以不填。 |
| `--check-only` | 只做数据自检，不恢复文件。 |
| `--dry-run` | 只打印恢复计划，不复制文件。 |
| `--limit N` | 本次最多恢复 N 个新 Task。已跳过的 Task 不计入数量。 |
| `--overwrite` | 删除并重建已有 Task。 |
| `--skip-existing` | 跳过已完成 Task，默认开启。通常不需要手动设置。 |

`--overwrite` 和显式设置的 `--skip-existing` 不能同时使用。

## 输出文件

正式恢复后，输出目录会生成：

- `restore.log`：人类可读日志。
- `restore_report.json`：机器可读恢复报告。
- 每个 `Task_*` 内的 `.dinsar_pair.json`：该 Task 对应的 pair 元信息。

`restore_report.json` 示例：

```json
{
  "started_at": "2026-05-11T00:00:00Z",
  "finished_at": "2026-05-11T00:10:00Z",
  "input_root": "D:\\BundleRoot",
  "output_root": "D:\\OutputRoot",
  "total_pairs": 1000,
  "restored": 200,
  "skipped": 0,
  "failed": 0,
  "warnings": []
}
```

## 重新编译

需要 Go 1.22 或更高版本。

图形界面版：

```powershell
go build -ldflags "-H=windowsgui" -o dinsar-restore.exe .
```

命令行版：

```powershell
go build -o dinsar-restore-console.exe .
```

运行测试：

```powershell
go test ./...
```

## 发布建议

建议 GitHub Release 附带以下文件：

- `dinsar-restore.exe`
- `dinsar-restore-console.exe`
- `README.md`

Release 标题示例：

```text
D-InSAR Restore Tool v0.1.0
```

Release 说明可写：

```text
Initial release.

- Add Windows GUI restore tool.
- Add console restore tool.
- Add data self-check before restore.
- Support batch continuation with Limit.
- Generate restore_report.json and restore.log.
```