Alibaba Cloud Linux:ws-ckpt の使用

1. インストール

ws-ckpt --version

sudo yum install ws-ckpt

# OpenClaw 用のプラグインをインストール
ws-ckpt plugin install --runtime openclaw
# OpenClaw 用のプラグインをアンインストール
ws-ckpt plugin uninstall --runtime openclaw

"workspace": "/path/to/workspace"

"autoCheckpoint": true

# Hermes 用のプラグインをインストール
ws-ckpt plugin install --runtime hermes
# Hermes 用のプラグインをアンインストール
ws-ckpt plugin uninstall --runtime hermes

# 設定ファイルを更新してワークスペースを設定
hermes config set plugins.ws-ckpt.workspace /path/to/workspace

# 設定ファイルを更新して自動スナップショットを有効化
hermes config set plugins.ws-ckpt.autoCheckpoint true

2. 自然言語コマンドの使用

# ユーザー入力
Set the snapshot workspace directory to /path/to/workspace

# ユーザー入力
Create a snapshot named test1 with the message "test snapshot"

# ユーザー入力
Enable automatic snapshots for each conversation round

# ユーザー入力
Schedule a snapshot for 12:00 PM every day

# ユーザー入力
List all snapshots

# ユーザー入力
Roll back to snapshot test1

# ユーザー入力
Delete snapshot test1

# ユーザー入力
Enable automatic snapshot cleanup and keep only snapshots from the last 7 days

1. スナップショットの作成

ws-ckpt checkpoint -w <workspace> [-s <snapshot id>] [-m <message>] [--metadata <json>]

例：

# 基本的な使用法
ws-ckpt checkpoint -w ./my-project -s test

# メッセージ付き
ws-ckpt checkpoint -w ./my-project -s test -m "initial state"

# メタデータ付き
ws-ckpt checkpoint -w ws-6d5aaa -s test --metadata '{"tool":"write","file":"main.py"}'

2. 特定のスナップショットへのロールバック

ws-ckpt rollback -w <workspace> {-s <snapshot> | -n <num_ancestors>} [--preview]

--snapshot パラメーター (エイリアス -s) には、test のようなスナップショット ID を指定します。

--workspace (エイリアス -w) は、ワークスペースのパスまたは ID を指定します。

例：

# ID でスナップショットにロールバック
ws-ckpt rollback -w ./my-project -s test
# 3 つのスナップショットをロールバック
ws-ckpt rollback -w ./my-project -n 3
# 'test' スナップショットと現在のワークスペースとの差分をプレビュー
ws-ckpt rollback -w ./my-project -s test --preview

3. スナップショットの一覧表示

ws-ckpt list [-w <workspace>] [--format <table|json>]

例：

# すべてのワークスペースのスナップショットを一覧表示
ws-ckpt list

# 特定のワークスペースのスナップショットを一覧表示
ws-ckpt list -w ./my-project

# JSON 形式で出力
ws-ckpt list -w workspace-6d5aaa --format json

4. スナップショットの差分の表示

ws-ckpt diff -w <workspace> -f <snapshot> [-t <snapshot>]

例：

# 2 つのスナップショットを比較
ws-ckpt diff -w ./my-project -f v1 -t v2

# スナップショットと現在のワークスペースの状態を比較
ws-ckpt diff -w ./my-project -f v1

5. スナップショットの削除

ws-ckpt delete [-w <workspace>] -s <snapshot> [--force]

例：

# 1 つのスナップショットを削除
ws-ckpt delete -w ./my-project -s test

# スナップショット ID でグローバルに削除 (-w は ID が一意であれば不要)
ws-ckpt delete -s test

6. ステータスの確認

ws-ckpt status [-w <workspace>] [--format <table|json>]

例：

# グローバルステータス
ws-ckpt status

# 特定のワークスペースのステータス
ws-ckpt status -w ./my-project

7. 自動スナップショットクリーンアップの設定

ws-ckpt config 
      [-g | -w <workspace>]
      [--enable-auto-cleanup]
      [--disable-auto-cleanup]
      [--auto-cleanup-keep <AUTO_CLEANUP_KEEP>]
      [--auto-cleanup-interval <AUTO_CLEANUP_INTERVAL>]

例：

# 設定の表示
# 現在の設定の概要を表示
ws-ckpt config
# グローバル設定の表示
ws-ckpt config -g
# 特定のワークスペースの設定を表示
ws-ckpt config -w ~/proj

# 設定の変更
# === グローバル設定 ===
# 自動スナップショットクリーンアップを有効にし、最新 10 件のスナップショットを保持
ws-ckpt config -g --enable-auto-cleanup --auto-cleanup-keep 10
# 自動スナップショットクリーンアップを有効にし、過去 7 日間のスナップショットを保持
ws-ckpt config -g --enable-auto-cleanup --auto-cleanup-keep 7d
# グローバルな自動スナップショットクリーンアップを無効化
ws-ckpt config -g --disable-auto-cleanup

# === ワークスペースごとの設定 (グローバルを上書き) ===
# 特定のワークスペースのクリーンアップを有効にし、最新 10 件のスナップショットを保持
ws-ckpt config -w ~/proj --enable-auto-cleanup --auto-cleanup-keep 10
# 特定のワークスペースのクリーンアップを有効にし、過去 7 日間のスナップショットを保持
ws-ckpt config -w ~/proj --enable-auto-cleanup --auto-cleanup-keep 7d
# 特定のワークスペースのクリーンアップを無効化
ws-ckpt config -w ~/proj --disable-auto-cleanup