safe-edit

# 🛡️ safe-edit 安全配置修改技能

> 在修改重要配置文件前自动设置回滚机制，**防止 OpenClaw 自己把自己改崩溃**。

## 🎯 解决什么问题

日常操作中，我们经常需要修改系统或应用的配置文件，但有时可能会出现：

- ❌ 改错配置导致服务崩溃
- ❌ 忘记原来配置是什么，无法恢复
- ❌ 手抖按错键，配置被覆盖
- ❌ 改完后不记得改了什么

**safe-edit 就是为了解决这些问题！**

## 🔥 什么时候该用

> ⚠️ **这是防止 OpenClaw 自己把自己改崩溃的核心技能！** 每次修改关键配置文件前都必须使用。

当你要做以下操作时，**必须使用 safe-edit**：

| 场景 | 示例 |
|------|------|
| 修改 OpenClaw 核心配置 | `openclaw.json` |
| 修改系统级配置 | crontab、nginx.conf、docker-compose.yml |
| 修改定时任务 | 添加/删除 cron 任务 |
| 修改用户数据 | 用户画像、权限配置 |
| 任何可能让服务崩溃的操作 | 修改端口、认证信息 |

**简单判断**：只要是**修改配置文件**，且**不确定后果**，就用 safe-edit。

## ✅ 使用方法

### 1. 开始修改（必做！）

用户说"我要修改 xxx 配置"时：

```
请使用 safe-edit 开始修改配置文件: /path/to/config.json
```

或直接执行：
```bash
safe-edit start /root/.openclaw/openclaw.json
```

AI 会自动：
1. ✅ 备份当前配置文件
2. ✅ 设置 15 分钟后自动回滚
3. ✅ 提示用户确认操作

### 2. 执行修改

现在可以安全地进行配置修改了！

### 3. 确认成功（修改完成后必做！）

告诉 AI：
```
safe-edit 确认成功
```

这会**立即取消** 15 分钟后的自动回滚。

### 4. 取消回滚（可选）

如果发现改错了，想立即回滚：
```
safe-edit 取消回滚
```

### 5. 查看状态

```
safe-edit 状态
```

## 🔄 工作流程

```
用户: 我想修改 openclaw.json

AI: 好的，使用 safe-edit 开始修改

  1. safe-edit start /root/.openclaw/openclaw.json
     ↓
  2. [自动] 备份文件 + 设置 15 分钟回滚
     ↓
  3. AI 执行配置修改
     ↓
用户: 改完了，没问题

AI: 确认成功
  4. safe-edit confirm
     ↓
  5. 取消回滚任务 ✅ 完成！

如果出问题：
  - 15 分钟后自动恢复备份
  - 或手动执行 safe-edit 取消回滚
```

## 🎯 触发关键词

当用户说以下话时，AI 应该**自动推荐使用 safe-edit**：

- "我想修改配置"
- "我要改一下 xxx.json"
- "帮我改一下 crontab"
- "改一下定时任务"
- "修改系统配置"...

# 🛡️ safe-edit

> 安全配置修改辅助技能 for OpenClaw

在修改重要配置文件前自动设置回滚机制，支持多平台。

## ✨ 特性

- 🔄 自动备份 - 修改前自动备份原文件
- ⏱️ 延迟回滚 - 15 分钟后自动恢复备份
- ✅ 手动确认 - 确认成功后立即取消回滚
- 🌐 跨平台 - 支持 Linux / macOS / FreeBSD
- 🔒 安全优先 - 避免手误导致服务崩溃

## 📦 安装

```bash
# 方式1: 复制脚本到 OpenClaw 脚本目录
cp safe-edit.sh ~/.openclaw/scripts/
chmod +x ~/.openclaw/scripts/safe-edit.sh

# 方式2: 使用 ClawHub (如果有)
clawhub install safe-edit
```

## 🚀 使用方法

### 命令行

```bash
# 开始修改并设置回滚
safe-edit start /root/.openclaw/openclaw.json

# 确认成功，取消回滚
safe-edit confirm

# 取消回滚
safe-edit cancel

# 查看状态
safe-edit status
```

### 在 OpenClaw 中使用

```markdown
请使用 safe-edit 开始修改配置文件: /path/to/config.json
```

## 🔧 支持的系统

| 系统 | 回滚方式 | 依赖 |
|------|----------|------|
| Linux (Debian/Ubuntu) | at 命令 | at |
| Linux (RHEL/CentOS) | at 命令 | at |
| Linux (WSL) | at 命令 | at |
| macOS | at / sleep | at |
| FreeBSD | at 命令 | at |
| Windows (Git Bash) | schtasks / sleep | schtasks |
| Windows (MSYS/Cygwin) | sleep 后台进程 | - |

## 📁 文件结构

```
safe-edit/
├── SKILL.md           # OpenClaw Skill 定义
├── safe-edit.sh       # 主脚本
├── README.md          # 本文件
└── package.json       # npm 元数据
```

## 📜 许可证

MIT