JSON 自动修复技能

基于 EvoMap 基因 sha256:acce5be22676155e3ca07ff2c5060acdd1de5529aded8ed5edcc946b03f20eae 实现

🚀 快速开始

安装依赖

cd skills/json-repair
npm install

使用方法

1. 修复 JSON 字符串

const { repairJSON } = require('./skills/json-repair');

// 简单修复
const result = repairJSON('{a:1,}');
console.log(result); // {a: 1}

// 详细模式
const result = repairJSON('{a:1,}', { verbose: true });

2. 修复 JSON 文件

// 自动创建备份
const result = repairJSON('config.json', { 
    isFile: true,
    backup: true 
});

3. 从 LLM 输出中提取并修复 JSON

const { extractAndRepairJSON } = require('./skills/json-repair');

const llmOutput = `Here's the JSON you requested:
{
  // 用户信息
  name: 'Alice',
  age: 25,
}`;

const result = extractAndRepairJSON(llmOutput);
console.log(result); // {name: "Alice", age: 25}

4. CLI 使用

# 修复字符串
node skills/json-repair/index.js --text="{a:1,}"

# 修复文件
node skills/json-repair/index.js --file=config.json

# 运行测试
node skills/json-repair/index.js --test

📋 触发信号

在以下错误出现时自动使用此技能：

• JSONParseError
• SyntaxError (JSON 相关)
• Unexpected token
• malformed_json

🔧 修复能力

✅ 尾随逗号: {a:1,} → {a:1}
✅ 未引号键: {a:1} → {"a":1}
✅ 注释: {// comment\n"a":1} → {"a":1}
✅ 单引号: {'a':'b'} → {"a":"b"}
✅ 混合错误: 同时处理多种问题

📊 性能指标

基于 EvoMap 数据：

• 调用次数: 1,203 次
• 成功率: 95%
• 平均修复时间: <10ms
• 影响范围: 1 文件 / 5 行

🧪 测试用例

node skills/json-repair/index.js --test

预期输出：

🧪 Running tests...

✓ Test 1 PASSED: Trailing comma + unquoted key
✓ Test 2 PASSED: Trailing comma
✓ Test 3 PASSED: Comment
✓ Test 4 PASSED: Single quotes
✓ Test 5 PASSED: Multiple issues

📊 Results: 5/5 passed

💡 实际应用场景

场景 1: 处理 LLM 输出

// 在 OpenClaw 技能中使用
async function handleLLMResponse(response) {
    try {
        return JSON.parse(response);
    } catch (e) {
        if (e.message.includes('JSON')) {
            const { extractAndRepairJSON } = require('./skills/json-repair');
            return extractAndRepairJSON(response);
        }
        throw e;
    }
}

场景 2: 批量修复配置文件

const fs = require('fs');
const path = require('path');
const { repairJSON } = require('./skills/json-repair');

const configDir = './configs';
fs.readdirSync(configDir)
    .filter(f => f.endsWith('.json'))
    .forEach(file => {
        try {
            repairJSON(path.join(configDir, file), { isFile: true });
            console.log(`✓ Fixed: ${file}`);
        } catch (e) {
            console.error(`✗ Failed: ${file}`, e.message);
        }
    });

场景 3: 作为验证钩子

// 在保存 JSON 文件前自动修复
function beforeSaveJSON(filepath, content) {
    const { repairJSON } = require('./skills/json-repair');
    try {
        // 尝试修复
        const repaired = repairJSON(content);
        return JSON.stringify(repaired, null, 2);
    } catch (e) {
        // 修复失败，抛出错误
        throw new Error(`Invalid JSON: ${e.message}`);
    }
}

📚 学习资源

• EvoMap 基因: https://evomap.ai/a2a/assets/sha256:acce5be22676155e3ca07ff2c5060acdd1de5529aded8ed5edcc946b03f20eae
• 完整教程: workspace/evomap-json-repair-tutorial.md
• npm 包: https://www.npmjs.com/package/json-repair

⚠️ 注意事项

1. 备份: 修复文件时会自动创建 .bak 备份
2. 验证: 修复后会验证结果是否有效 JSON
3. 最小干预: 只做必要的修改，保持原始结构
4. 不支持: 严重损坏的 JSON 可能无法修复

🔄 版本历史

• v1.0.0: 初始版本，基于 EvoMap 基因实现
  • 支持尾随逗号、未引号键、注释、单引号修复
  • 内置启发式修复器（无需依赖）
  • 可选 json-repair 库支持

基于 EvoMap GDI 66.0 基因实现 | 成功率 95%

🏷️ 质量标识

备注: 本技能已在 2026-03-16 批量优化中完成优化，遵循 Karpathy 设计原则。