Workspace Zip Backup

#!/bin/bash
# workspace-backup - Backup all markdown files from OpenClaw workspace keeping directory structure
# workspace-backup - 备份 OpenClaw workspace 中所有 markdown 文件，保持目录结构

set -euo pipefail

# Default configuration | 默认配置
SOURCE_DIR="${1:-$HOME/.openclaw/workspace}"  # Source directory | 源文件夹，默认: ~/.openclaw/workspace
OUTPUT_ZIP="${2:-workspace-backup-$(date +%Y%m%d).zip}"  # Output zip file | 输出zip文件，默认按日期命名

show_help() {
    echo "Usage | 用法: ./backup-workspace.sh [source_dir] [output_zip]"
    echo ""
    echo "Parameters | 参数:"
    echo "  source_dir    Directory to backup (default: ~/.openclaw/workspace)"
    echo "               要备份的文件夹 (默认: ~/.openclaw/workspace)"
    echo "  output_zip    Output zip file path (default: workspace-backup-YYYYMMDD.zip)"
    echo "               输出压缩包路径 (默认: workspace-backup-YYYYMMDD.zip)"
    echo ""
    echo "Examples | 示例:"
    echo "  ./backup-workspace.sh"
    echo "                          Backup default workspace to date-named zip"
    echo "                          备份默认workspace到当前日期压缩包"
    echo "  ./backup-workspace.sh ~/my-notes my-notes-backup.zip"
    echo "                          Backup specified directory"
    echo "                          备份指定文件夹"
    exit 1
}

# Check for help | 检查帮助参数
if [ "$#" -ge 1 ] && [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
    show_help
fi

# Check source directory exists | 检查源文件夹是否存在
if [ ! -d "$SOURCE_DIR" ]; then
    echo "Error | 错误: Source directory '$SOURCE_DIR' does not exist or is not a directory"
    echo "        源文件夹 '$SOURCE_DIR' 不存在或不是目录"
    exit 1
fi

echo "====== Workspace Markdown Backup ======"
echo "Source Directory | 源文件夹: $SOURCE_DIR"
echo "Output File | 输出文件: $OUTPUT_ZIP"
echo ""
echo "Searching for all .md files... | 正在搜索所有 .md 文件..."

# Count markdown files | 统计markdown文件数量
MD_COUNT=$(find "$SOURCE_DIR" -type f -name "*.md" | wc -l)

if [ "$MD_COUNT" -eq 0 ]; then
    echo "No .md files found, exiting. | 未找到任何 .md 文件，退出"
    exit 0
fi

echo "Found $MD_COUNT .md files, starting compression... | 找到 $MD_COUNT 个 .md 文件，开始压缩..."
echo ""

# Compress using zip, keep directory structure | 使用zip压缩，保持目录结构
find "$SOURCE_DIR" -type f -name "*.md" | xargs zip -r "$OUTPUT_ZIP"

echo ""
echo "✅ Backup completed! | 备份完成!"
echo "Archive | 压缩包: $OUTPUT_ZIP"
echo "Contains $MD_COUNT .md files, original directory structure preserved. | 包含 $MD_COUNT 个 .md 文件，保持原始文件夹结构"

# Show compressed size | 显示压缩后大小
SIZE=$(du -h "$OUTPUT_ZIP" | cut -f1)
echo "Compressed size | 压缩后大小: $SIZE"

# Copy script code from this SKILL.md | 复制本文件中备份脚本代码块内容
cat > backup-workspace << 'EOF'
[paste script code here | 在这里粘贴脚本代码]
EOF
chmod +x backup-workspace
mv backup-workspace ~/.local/bin/

#!/bin/bash
# workspace-restore - Restore markdown files from backup zip
# workspace-restore - 从备份压缩包还原 markdown 文件

set -euo pipefail

# Default configuration | 默认配置
BACKUP_ZIP="${1:-}"  # Backup zip file | 备份zip文件，必填
TARGET_DIR="${2:-$HOME/.openclaw/workspace}"  # Target directory | 目标文件夹，默认: ~/.openclaw/workspace

show_help() {
    echo "Usage | 用法: ./restore-workspace.sh <backup_zip> [target_dir]"
    echo ""
    echo "Parameters | 参数:"
    echo "  backup_zip    Backup zip file to restore (required)"
    echo "               要还原的压缩包 (必填)"
    echo "  target_dir    Directory to restore to (default: ~/.openclaw/workspace)"
    echo "               还原到哪个文件夹 (默认: ~/.openclaw/workspace)"
    echo ""
    echo "Examples | 示例:"
    echo "  ./restore-workspace.sh workspace-backup-20260316.zip"
    echo "                          Restore to default workspace"
    echo "                          还原到默认workspace"
    echo "  ./restore-workspace.sh my-notes-backup.zip ~/new-workspace"
    echo "                          Restore to specified location"
    echo "                          还原到指定位置"
    exit 1
}

# Check for help | 检查帮助参数
if [ "$#" -eq 0 ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
    show_help
fi

# Check backup file exists | 检查备份文件是否存在
if [ ! -f "$BACKUP_ZIP" ]; then
    echo "Error | 错误: Backup file '$BACKUP_ZIP' does not exist"
    echo "        备份文件 '$BACKUP_ZIP' 不存在"
    exit 1
fi

# Check target directory | 检查目标文件夹
if [ ! -d "$TARGET_DIR" ]; then
    echo "Target directory '$TARGET_DIR' does not exist, creating... | 目标文件夹 '$TARGET_DIR' 不存在，创建它..."
    mkdir -p "$TARGET_DIR"
fi

echo "====== Workspace Markdown Restore ======"
echo "Backup File | 备份文件: $BACKUP_ZIP"
echo "Target Directory | 目标文件夹: $TARGET_DIR"
echo ""
echo "Listing archive contents... | 正在列出压缩包内容..."
echo ""

# List contents before restoring | 还原前列出内容供用户确认
unzip -l "$BACKUP_ZIP"

echo ""
echo "Continue restore? (y/N) | 是否继续还原? (y/N)"
read -r CONFIRM || CONFIRM="N"
if [ "$CONFIRM" != "y" ] && [ "$CONFIRM" != "Y" ]; then
    echo "Cancelled. | 已取消"
    exit 0
fi

echo ""
echo "Starting restore... | 开始还原..."
echo ""

# Restore with unzip - extracts to correct directory structure automatically
# 使用unzip还原 - 自动解压到正确的目录结构
unzip -o "$BACKUP_ZIP"

echo ""
echo "✅ Restore completed! | 还原完成!"
echo "All files restored with original directory structure. | 所有文件已还原，保持原始文件夹结构"

# Count restored files | 统计还原文件数量
RESTORED_COUNT=$(unzip -l "$BACKUP_ZIP" | grep -c "\.md$")
echo "Total $RESTORED_COUNT .md files restored. | 共还原 $RESTORED_COUNT 个 .md 文件"

# Copy script code from this SKILL.md | 复制本文件中还原脚本代码块内容
cat > restore-workspace << 'EOF'
[paste script code here | 在这里粘贴脚本代码]
EOF
chmod +x restore-workspace
mv restore-workspace ~/.local/bin/

backup-workspace

====== Workspace Markdown Backup ======
Source Directory | 源文件夹: /root/.openclaw/workspace
Output File | 输出文件: workspace-backup-20260316.zip

Searching for all .md files... | 正在搜索所有 .md 文件...
Found 42 .md files, starting compression... | 找到 42 个 .md 文件，开始压缩...

  adding: ... (stored 0%)
  ...

✅ Backup completed! | 备份完成!
Archive | 压缩包: workspace-backup-20260316.zip
Contains 42 .md files, original directory structure preserved. | 包含 42 个 .md 文件，保持原始文件夹结构
Compressed size | 压缩后大小: 1.2M

backup-workspace ~/my-notes my-notes-backup.zip

restore-workspace workspace-backup-20260316.zip

... (list of files)
Continue restore? (y/N) | 是否继续还原? (y/N)
y
Starting restore... | 开始还原...
✅ Restore completed! | 还原完成!

mkdir -p ~/new-workspace
unzip workspace-backup-20260316.zip -d ~/new-workspace