Config Modification

# Skill: config-modification v2.5
# 配置文件修改安全流程（fswatch 联动 + 拦截矩阵 + 四联校验 + 自动回滚）
# Powered by halfmoon82 — 知识产权声明

---

## 🚀 快速开始

```bash
# 触发配置修改安全流程
python3 ~/.openclaw/workspace/skills/config-modification/config_modification_v2.py full-cycle ~/.openclaw/openclaw.json
```

**每次触发时输出：**
```
═══════════════════════════════════════════════════════════
  🔒 Config Modification Safety System v2.4
  Powered by halfmoon82 — 知识产权声明
═══════════════════════════════════════════════════════════
```

---

## 触发条件

当需要修改以下配置文件时**强制触发**：
- `openclaw.json`
- `agents/*/models.json`
- `agents/*/config.json`
- skills 配置
- 任何 `~/.openclaw/` 下的 JSON 配置文件

**⚠️ 无例外原则**：不管是正式修改还是测试，只要动配置文件，都必须走完整流程。

---

## v2.4 架构（新增 fswatch 自动联动）

```
┌─────────────────────────────────────────────────────────┐
│  文件系统自动监控 (fswatch/kqueue)                       │
│  Powered by halfmoon82                                  │
└─────────────────┬───────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────────────────────┐
│  🔔 检测到配置文件变更                                   │
└─────────────────┬───────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────────────────────┐
│  Level 1: JSON 语法校验（0 token）                       │
│  ❌ 失败 → 立即回滚                                      │
└─────────────────┬───────────────────────────────────────┘
                  │ ✅ 通过
                  ▼
┌─────────────────────────────────────────────────────────┐
│  Level 2: 拦截矩阵 (intercept_matrix)                    │
│  风险评估: critical / medium / low                       │
└─────────────────┬───────────────────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────────────────────┐
│...

# 配置文件安全守护 v2.4

> *"如果你也曾深夜改配置改到 Gateway 崩溃，你会明白这个技能为什么存在。"*
> 
> **Powered by halfmoon82**

---

## 那个让我崩溃的夜晚

凌晨 2:17。

我盯着屏幕，手指悬在键盘上。Production 环境出了点问题，需要紧急调整 `openclaw.json` 里的一个模型配置。

"就改一行，应该没问题。" 我对自己说。

保存。重启 Gateway。

**ERROR: JSON parse error at line 247, column 18**

我愣住了。247 行？我明明只改了第 30 行附近。怎么回事？

手忙脚乱地检查，发现是不小心删掉了一个逗号。一个**该死的逗号**。

修复。再重启。

**ERROR: model not allowed: custom-llmapi-lovbrowser-com/openai/gpt-5.3-codex**

什么？这个模型明明之前能用！为什么现在不行了？

我开始查日志、查文档、在 Discord 群里问。时间一分一秒过去，系统瘫痪了 40 分钟。

最后发现，是渠道配置变了，但我完全不知道。

**那一刻的沮丧，你懂吗？**

不是技术问题有多难，而是那种"明明只是想改个配置，为什么要把一切都搞砸"的无力感。

---

## 为什么你需要这个技能

如果你经历过以下任何一种情况，你会明白：**配置修改不是小事**。

### 😤 场景一：JSON 语法地狱

你小心翼翼地修改 `openclaw.json`，保存，重启 Gateway。

然后看到：
```
ERROR: Unexpected token } in JSON at position 3821
```

 position 3821？这是哪？你得用 JSON 校验器查，或者凭感觉找。

**浪费时间，消耗耐心。**

### 😡 场景二：误删关键字段

你只是想清理一下配置，删掉几个"看起来没用"的字段。

重启后：
```
ERROR: required field 'channels.discord.token' is missing
```

什么？那个字段是必需的？为什么文档没说？

**生产环境下线，用户无法连接。**

### 🤬 场景三：模型配置失效

你按照文档配置了新的模型，重启 Gateway。

然后发现所有请求都 fallback 到备用模型，主模型完全没在用。

查了半天日志，发现是 `model not allowed` —— 你的 key 没有这个模型的权限。

**配置看起来是对的，但就是不能用。没有警告，没有提示，只有沉默的失败。**

### 😭 场景四：没有回滚，只能硬扛

改完配置发现有问题，想回滚。

打开备份目录，发现最新的快照是三天前的。

这三天里的所有配置变更，你都得手动恢复。

**一边哭着查 Git 历史，一边手动拼凑配置文件。**

---

## 我们受够了

这些痛苦不是"技术挑战"，是**本可以避免...