You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Consolidate documentation: merge RESUME_MODE.md into README.md
- Integrate detailed Resume Mode documentation into README.md
- Remove RESUME_MODE.md (content merged)
- Remove README_zh-TW.md (keep only English README.md)
- All resume mode information now in single README.md
Copy file name to clipboardExpand all lines: tools/ai-markmap-agent/README.md
+74Lines changed: 74 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -421,6 +421,80 @@ output:
421
421
422
422
**Reset mode** prompts for confirmation. Old versions are deleted only after the pipeline completes successfully (safe: if pipeline fails, old versions are preserved).
423
423
424
+
### Resume Mode
425
+
426
+
Resume mode allows you to continue execution from a previous pipeline run, supporting:
427
+
- Reusing completed stage outputs (saves tokens and time)
428
+
- Re-running from a specific stage (debug-friendly)
429
+
- Not overwriting original run data (generates new regen run)
430
+
431
+
#### Resume vs Reset
432
+
433
+
**Important distinction:**
434
+
- **`--resume`**: Reuses debug outputs from previous runs to save API calls. This is about **pipeline execution** (whether to run new API calls or reuse existing results).
435
+
- **`versioning.mode: reset`**: Deletes old version directories and starts fresh. This is about **version management** (how to organize final output versions).
436
+
437
+
These two features are **independent**:
438
+
- You can use `--resume` even when `versioning.mode: reset` is set
439
+
- Resume mode reuses debug outputs regardless of versioning mode
440
+
- Versioning reset only affects final output directories, not debug outputs
441
+
- When resuming, versioning reset prompts are skipped (reset applies to final output only)
442
+
443
+
#### Usage
444
+
445
+
**Method 1: Interactive Resume Mode**
446
+
447
+
```bash
448
+
python main.py --resume
449
+
```
450
+
451
+
After startup, it will:
452
+
1. Scan all previous runs under `outputs/debug/`
453
+
2. Display them sorted by time (newest first)
454
+
3. Let you select the run to resume
455
+
4. Ask whether to reuse each stage's output one by one
456
+
457
+
**Method 2: Start from a Specific Stage**
458
+
459
+
```bash
460
+
python main.py --resume --from-stage writer
461
+
```
462
+
463
+
This will automatically:
464
+
- Select the latest run
465
+
- Reuse outputs from `expert_review`, `full_discussion`, `consensus`
466
+
- Re-run from the `writer` stage
467
+
468
+
**Supported stages:**
469
+
- `expert_review`
470
+
- `full_discussion`
471
+
- `consensus`
472
+
- `writer`
473
+
- `translate`
474
+
- `post_process`
475
+
476
+
#### Run Naming Rules
477
+
478
+
- **Original run**: `run_YYYYMMDD_HHMMSS/`
479
+
- **Resume from original run**: `run_YYYYMMDD_HHMMSS_regen_1/`
0 commit comments