功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

JSON修复工具（免费版）

本工具自动修复JSON文件中的常见语法错误，包括尾随逗号、单引号、未引号键名、注释、十六进制数字等，帮助开发者快速恢复JSON的可解析性。

概述

JSON标准较为严格，不支持尾随逗号、单引号、注释等宽松语法。然而实际开发中，手写JSON或从其他格式转换时常产生这些"宽松"错误，导致解析失败。本工具围绕"修复"场景，自动识别并修复5类常见错误，将宽松JSON转换为标准JSON。

核心能力

支持的修复类型

输出: 返回支持的修复类型的执行结果,包含操作状态和输出数据。

安全机制

• 备份机制：修复前自动创建.bak备份文件
• 沙箱解析：使用vm沙箱（runInNewContext），隔离全局作用域
• 修复后验证：修复完成后验证JSON合法性，不合法则回滚
• 不执行代码：仅解析结构，不执行任何函数调用

输出: 返回安全机制的执行结果,包含操作状态和输出数据。

修复报告

• 修复前文件大小
• 修复后文件大小
• 修复的错误类型与数量
• 是否成功（合法JSON）

输出: 返回修复报告的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量级、JSON、修复工具、自动修复尾随逗号、单引号、未引号键名等常见、语法错误、修复工具免费版提、供常见、语法错误的自动修、复能力、帮助开发者快速修、复因手写或编辑器、问题导致的格式问、核心能力、修复尾随逗号、单引号转双引号、未引号键名补全、风格注释移除、十六进制数字转十、修复前自动备份、修复后验证合法性、沙箱化解析确保安、Use、when、需要代码生成、编程辅助、调试测试、开发部署时使用、不适用于无明确技、术栈的模糊需求等。

使用场景

使用流程

场景1：修复单个文件

向Agent发送指令：

修复config/broken.json文件中的JSON语法错误。

Agent将：

1. 读取文件内容
2. 创建.bak备份
3. 识别并修复语法错误
4. 验证修复后的JSON合法性
5. 输出修复报告

场景2：修复并输出到新文件

node repair.js --file broken.json --out fixed.json

保留原文件，修复结果输出到fixed.json。

场景3：查看修复报告

{
  "input_file": "broken.json",
  "output_file": "broken.json",
  "backup_file": "broken.json.bak",
  "input_size": 256,
  "output_size": 248,
  "repairs": [
    {"type": "trailing_comma", "count": 3},
    {"type": "single_quote", "count": 5},
    {"type": "unquoted_key", "count": 2}
  ],
  "valid": true,
  "success": true
}

示例

命令行参数

修复级别说明

错误类型识别

优选实践

修复前备份

• 始终保留默认的备份机制（不使用--no-backup）
• 备份文件命名清晰（.bak后缀）
• 重要文件修复前额外创建版本快照
• 修复后校验备份完整性

修复策略选择

• 生产环境使用safe模式，仅修复明确错误
• 测试环境可使用aggressive模式，尝试更多修复
• 不确定时先safe修复，再人工检查剩余错误
• 修复后必须验证JSON合法性

批量修复流程

• 先扫描识别所有错误文件（配合json-lint-tool）
• 按错误类型分类，分批修复
• 修复后重新校验，确保全部通过
• 失败文件人工介入

已知限制

• 本工具使用沙箱解析，不执行任意代码
• 修复操作不引入新的安全风险
• 备份文件可能含敏感数据，注意访问控制
• 修复报告不记录具体数据内容，仅记录错误类型
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

常见问题

Q1：修复后JSON仍不合法？

A：可能存在本工具不支持的错误类型（如未闭合括号、字符串内换行）。查看修复报告的valid字段，若为false，说明剩余错误需人工处理。专业版支持更多错误类型。

Q2：备份文件在哪？

A：备份文件与原文件同目录，名称为原文件名.bak。若使用了--no-backup参数，则不创建备份。建议始终保留备份机制。

Q3：单引号修复误伤了字符串内容？

A：本工具的单引号修复针对键名与字符串边界，不修改字符串内部的单引号。若字符串内部含单引号（如"It's ok"），不会被误改。若仍出现误伤，检查JSON结构是否规范。

Q4：注释移除后格式混乱？

A：注释移除可能留下空行或多余空格。修复后建议配合格式化工具（json-beautifier）重新整理缩进。本工具的修复后验证仅检查语法合法性，不保证格式美观。

Q5：十六进制数字修复后值变了？

A：十六进制数字（如0xFF）会被转为十进制（255），值本身不变。若JSON中本意是字符串"0xFF"，应使用引号包裹。修复前检查数字字段是否需要保持字符串形式。

免费版限制

本免费体验版限制以下高级功能：

• 批量目录修复（递归扫描多个文件）
• 流式修复（大文件分块处理）
• 自定义修复规则与正则
• 修复预览（修复前对比）
• 增量修复（仅修复变更部分）
• 修复历史与回滚

解锁全部功能请使用专业版：json-repair-tool-pro

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Node.js: 14+（用于修复脚本与vm沙箱）

依赖详情

API Key 配置

• 本skill基于Markdown指令规范，无需额外API Key
• 所有修复在本地完成，不依赖外部服务
• 沙箱解析不执行网络请求，无数据外泄风险

可用性分类

• 分类: MD+EXEC（纯Markdown指令，修复功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行JSON语法错误修复任务，修复脚本通过命令行执行

错误处理

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果