JSON修复工具免费版

轻量级JSON修复工具，自动修复尾随逗号、单引号、未引号键名等常见语法错误。Use when 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于需要100%确定性的关键决策。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。

天轰穿@thcjp

Install

openclaw skills install @thcjp/json-repair-tool-free

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

JSON修复工具（免费版）

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

概述

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

核心能力

支持的修复类型

错误类型	示例	修复后	说明
尾随逗号	`{"a":1,}`	`{"a":1}`	移除对象/数组末尾多余逗号
单引号	`{'a':'b'}`	`{"a":"b"}`	单引号替换为双引号
未引号键名	`{key:"v"}`	`{"key":"v"}`	键名补全双引号
JS注释	`//注释` 或 `/注释/`	（移除）	移除JS风格注释
十六进制数字	`0xFF`	`255`	十六进制转十进制

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

安全机制

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

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

修复报告

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

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

使用场景

场景	角色	价值
配置文件修复	运维工程师	修复手写配置的语法错误
日志数据修复	数据分析师	修复日志中的格式问题
手写JSON整理	开发者	将宽松写法转为标准JSON
第三方数据清洗	数据工程师	修复外部数据源的格式问题
教学示例纠错	教师/学生	修复练习中的语法错误
迁移数据修复	数据库管理员	修复迁移过程中的格式损坏

使用流程

场景1：修复单个文件

向Agent发送指令：

text

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

Agent将：

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

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

bash

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

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

场景3：查看修复报告

json

{
  "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
}

示例

命令行参数

参数	类型	默认值	说明
`--file`	string	-	输入文件路径
`--out`	string	-	输出文件路径（不指定则覆盖原文件）
`--no-backup`	boolean	false	不创建备份
`--repair-level`	string	safe	safe/aggressive

修复级别说明

级别	行为	适用场景
`safe`	仅修复明确的语法错误，保留语义	生产环境
`aggressive`	尝试修复更多问题，可能改变语义	测试环境

错误类型识别

类型	正则模式	说明
`trailing_comma`	`,\s*[}\]]`	对象/数组末尾逗号
`single_quote`	`'[^']*'`	单引号字符串
`unquoted_key`	`\{([^"]+)\s*:`	未引号键名
`js_comment`	`//.` 或 `/...*/`	JS风格注释
`hex_number`	`0x[0-9a-fA-F]+`	十六进制数字

优选实践

修复前备份

始终保留默认的备份机制（不使用--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沙箱）

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent平台内置LLM提供
JSON解析器	运行时	必需	Node.js内置JSON.parse
vm模块	运行时	必需	Node.js内置vm（沙箱）
文件系统	运行时	必需	Node.js内置fs

API Key 配置

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

可用性分类

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

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

安全注意事项

风险类型	防范措施
API密钥泄露	通过环境变量配置，禁止硬编码到代码或配置文件中
命令执行风险	仅执行白名单命令，避免拼接用户输入到命令行参数中
网络通信安全	使用HTTPS协议，验证SSL证书有效性
敏感数据暴露	输出结果中不包含密钥、令牌等敏感信息

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

效率量化分析

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

差异化对比

对比维度	本技能	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	核心功能	通用场景	通用场景

核心功能

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