⚡

检查点管理器 checkpoint-manager

检查点管理器是一个会话状态快照管理工具，用于保存、恢复、列出和清除Ralph编排系统的状态检查点。该工具支持模型无关的配置，通过JSON文件存储检查点，提供灵活的状态回滚和版本控制功能，适用于软件开发、AI工作流和自动化任务中的状态管理需求。关键词：检查点管理、状态快照、会话恢复、Ralph编排、模型无关、状态回滚、版本控制、自动化工作流、开发工具、AI智能体

DevOps 0 次安装 0 次浏览 更新于 3/4/2026

版本: 2.88.0

名称: 检查点管理器 描述: “会话检查点管理：保存、恢复、列出、清除状态快照” 用户可调用: true 允许工具:

  • 读取
  • 写入
  • Bash

v2.88 关键变更 (模型无关)

  • 模型无关: 使用在 ~/.claude/settings.json 或 CLI/环境变量中配置的模型
  • 无需标志: 与配置的默认模型配合使用
  • 灵活: 适用于 GLM-5、Claude、Minimax 或任何已配置的模型
  • 设置驱动: 通过 ANTHROPIC_DEFAULT_*_MODEL 环境变量选择模型

检查点管理器

管理 Ralph 编排系统的会话状态检查点。

子命令

save - 创建检查点

/checkpoint save "重构前"
@cp save "部署前状态"

restore - 恢复检查点

/checkpoint restore "重构前"
@cp restore cp_20260107_143015

list - 列出所有检查点

/checkpoint list
@cp list

clear - 移除检查点

/checkpoint clear "旧检查点"
@cp clear --all

存储

检查点以 JSON 文件形式存储在 ~/.ralph/checkpoints/ 目录中。

输出示例

保存输出

✅ 检查点已保存: cp_20260214_143015_重构前
📁 位置: ~/.ralph/checkpoints/cp_20260214_143015.json
⏱️  过期时间: 24 小时 (2026-02-15 14:30:15)

列表输出

╭───────────────────────────────────────────────────────╮
│                  检查点 (3)                           │
├───────────────────────────────────────────────────────┤
│ cp_20260214_143015  │ 重构前              │ 2小时前 │
│ cp_20260214_120000  │ 部署前              │ 5小时前 │
│ cp_20260213_180000  │ 功能完成            │ 1天前  │
╰───────────────────────────────────────────────────────╯

工作流集成

/checkpoint save "进行风险变更前"
  ↓ (进行变更)
/checkpoint restore "进行风险变更前"  # 如果需要
  ↓ (或继续)
/checkpoint clear "进行风险变更前"   # 清理

相关技能

  • /orchestrator - 完整编排工作流
  • /loop - 带检查点的迭代执行
  • /gates - 检查点前的质量验证