Install
openclaw skills install @thcjp/json-repair-tool-proJSON修复工具（专业版）
本工具是企业级JSON修复方案，在免费版基础上扩展批量目录修复、流式处理、自定义规则、修复预览与历史回滚能力，适用于大规模数据治理与自动化流水线场景.
概述
专业版面向JSON修复规模超过1000文件、需要自定义规则、或需要集成到自动化流水线的企业场景。相比免费版，专业版引入并行修复引擎、流式修复器、规则引擎、预览模块、历史管理模块，显著提升大规模场景下的修复能力与可控性.
核心能力
批量目录修复
- 递归扫描指定目录的所有JSON文件
- 并行修复（默认8线程，可配置）
- 修复报告：成功/失败/跳过计数与明细
- 增量模式：仅修复修改时间变化的文件
处理: 解析批量目录修复的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回批量目录修复的响应数据,包含状态码、结果和日志.
流式修复
- GB级JSON文件流式修复，内存稳定10MB
- 分块识别错误并修复，避免全量加载
- 断点续传：修复中断后可恢复
- 适用于大型日志与数据导出文件
处理: 解析流式修复的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回流式修复的响应数据,包含状态码、结果和日志.
自定义修复规则
| 规则类型 | 配置方式 | 适用场景 |
|---|---|---|
| 正则规则 | {"pattern": "...", "replacement": "..."} | 简单文本替换 |
| 脚本规则 | JavaScript/Python函数 | 复杂逻辑处理 |
| 预设规则 | 内置规则名 | 常见错误快速修复 |
| 组合规则 | 多规则顺序执行 | 多种错误共存 |
处理: 解析自定义修复规则的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回自定义修复规则的响应数据,包含状态码、结果和日志.
修复预览
- 修复前后差异对比（diff格式）
- 按错误类型分组的修复清单
- 修复置信度评分
- 一键应用或逐项确认
处理: 解析修复预览的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回修复预览的响应数据,包含状态码、结果和日志.
增量修复
- 基于文件哈希判断变更
- 仅修复变更的文件
- 修复结果缓存，避免重复处理
- 增量日志记录修复历史
处理: 解析增量修复的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回增量修复的响应数据,包含状态码、结果和日志.
历史回滚
- 修复前自动创建快照
- 支持回滚到任意历史版本
- 快照增量存储，节省空间
- 审计日志记录所有修复操作
处理: 解析历史回滚的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回历史回滚的响应数据,包含状态码、结果和日志. 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：企业级、JSON、修复工具、支持批量目录修复、流式处理、自定义规则、修复预览与历史回、修复工具专业版面、向企业级场景、在免费版基础上扩、展批量目录修复、自定义修复规则、修复预览、增量修复与历史回、滚等高级能力、核心能力、目录级批量修复、级文件流式修复、自定义正则规则、修复前后差异预览、修复规则市场与共、Use、when、需要提升效率、自动化流程、批量处理、工作流优化时使用、不适用于需要人工、创意判断的任务等.
快速开始
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
使用场景
| 场景 | 角色 | 价值 | 推荐能力 |
|---|---|---|---|
| 企业配置批量治理 | 运维主管 | 目录级配置文件修复 | 批量修复+增量 |
| 大规模日志修复 | 数据工程师 | GB级日志JSON修复 | 流式修复+断点 |
| 数据迁移清洗 | 数据库管理员 | 迁移前修复语法错误 | 批量修复+预览 |
| CI/CD质量门禁 | DevOps工程师 | 提交前自动修复 | 批量+历史回滚 |
| 跨团队规范统一 | 架构师 | 统一JSON格式 | 自定义规则+批量 |
| 历史数据审计 | 合规专员 | 修复历史追溯 | 历史回滚+审计 |
使用流程
场景1：批量修复目录
向Agent发送指令：
用户可通过自然语言指令触发此场景，工具将自动执行相应操作并返回结构化结果.
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | JSON修复工具专业版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
扫描./config目录下所有.json文件，自动修复语法错误，修复前创建备份，输出修复报告.
Agent将：
- 递归扫描目录，收集所有JSON文件
- 8线程并行修复（修复前各创建备份）
- 汇总修复结果
- 输出结构化报告
场景2：流式修复大文件
{
"input": "large-log.json",
"output": "fixed-log.json",
"mode": "stream",
"checkpoint_interval": "100MB",
"rules": ["trailing_comma", "single_quote", "unquoted_key"]
}
场景3：自定义规则修复
{
"rules": [
{
"name": "修复日期格式",
"type": "regex",
"pattern": "(\\d{4})/(\\d{2})/(\\d{2})",
"replacement": "$1-$2-$3"
},
{
"name": "移除BOM",
"type": "preset",
"preset": "remove_bom"
}
]
}
场景4：修复预览
node repair.js --file broken.json --preview
输出修复前后差异：
- {"a":1, "b":'hello',}
+ {"a":1, "b":"hello"}
示例
批量修复参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
dir | string | - | 扫描目录 |
recursive | boolean | true | 是否递归 |
parallel | integer | 8 | 并行线程数 |
incremental | boolean | false | 增量模式 |
exclude | array | [] | 排除模式 |
backup | boolean | true | 是否创建备份 |
流式修复参数
| 参数(续) | 类型 | 默认值 | 说明 |
|---|---|---|---|
mode | string | stream | stream/batch |
checkpoint_interval | string | 100MB | 检查点间隔 |
max_memory | string | 10MB | 内存上限 |
buffer_size | string | 64KB | 读写缓冲区 |
规则引擎参数
| 参数(续)(续) | 类型 | 默认值 | 说明 |
|---|---|---|---|
rules | array | [] | 规则列表 |
rules_file | string | - | 规则文件路径 |
stop_on_error | boolean | false | 规则失败是否停止 |
rule_order | string | sequential | sequential/parallel |
预览参数
| 参数(续)(续) | 类型 | 默认值 | 说明 |
|---|---|---|---|
preview | boolean | false | 是否预览模式 |
diff_format | string | unified | unified/side-by-side |
max_diff_lines | integer | 100 | 最大差异行数 |
历史回滚参数
| 参数(续)(续) | 类型 | 默认值 | 说明 |
|---|---|---|---|
snapshot_dir | string | .repair-snapshots | 快照目录 |
snapshot_interval | string | each | each/hourly/daily |
max_snapshots | integer | 30 | 最大快照数 |
retention_days | integer | 90 | 保留天数 |
优选实践
批量修复优化
- 增量模式优先，避免重复修复
- 并行线程数按CPU核数调整（建议核数×1.5）
- 排除
node_modules/.git等无关目录 - 修复报告持久化，便于审计
流式修复优化
- 大文件（>100MB）启用流式模式
- 检查点间隔按内存上限调整
- 修复前预估文件大小，选择缓冲区
- 修复后校验输出完整性
自定义规则策略
- 简单替换用正则规则
- 复杂逻辑用脚本规则（注意安全）
- 多规则共存时按顺序执行
- 规则文件纳入版本管理，便于团队协作
修复预览策略
- 生产环境必须先预览再应用
- 关注高置信度（>0.95）的修复项
- 低置信度修复项人工确认
- 预览差异过大时拆分为多次修复
历史回滚策略
- 修复前必须创建快照
- 快照保留策略：日快照7天，周快照4周
- 回滚前先创建当前状态快照
- 审计日志定期归档
常见问题
Q1：批量修复中途失败如何恢复？
A：专业版内置检查点机制，从最近检查点恢复。检查点文件位于.repair-checkpoints/目录。增量模式下，已修复文件不会重复处理.
Q2：流式修复内存仍超10MB？
A：检查缓冲区大小（buffer_size），过大可能突破内存上限。若JSON单行过长，需要专用的大行解析器。规则数量过多也会增加内存，建议分批应用规则.
Q3：自定义规则误修改了有效内容？
A：规则应用前必须预览（preview=true）。正则规则的误伤风险较高，建议先用小样本测试。脚本规则在沙箱中执行，不访问文件系统与网络.
Q4：修复预览差异太多看不过来？
A：设置max_diff_lines限制差异行数。按错误类型分组查看，逐类型确认。高置信度修复可批量应用，低置信度逐项确认.
Q5：历史快照占用空间过大？
A：快照采用增量存储，仅记录与上一版本的差异。可配置max_snapshots与retention_days控制保留数量。过期快照自动清理.
Q6：如何回滚到特定版本？
A：通过--rollback参数指定快照ID或时间戳。回滚前自动创建当前状态快照，避免误操作。回滚后建议重新校验所有文件.
Q7：规则如何共享给团队？
A：规则文件纳入版本管理（Git），团队通过拉取获取最新规则。专业版支持规则市场，可发布与订阅规则包。规则包版本化，便于升级与回滚.
Q8：如何集成到CI/CD？
A：专业版提供命令行接口，支持--scan/--repair/--validate/--preview等参数。在CI/CD中调用命令行接口，修复失败时返回非零退出码。报告可导出为JSON供下游分析.
Q9：脚本规则的安全如何保障？
A：脚本规则在vm沙箱中执行，不访问全局作用域、文件系统、网络。脚本可用的API白名单包括字符串/数组/对象操作，禁止require/import/eval等危险函数.
Q10：增量修复如何判断文件变更？
A：基于文件哈希判断。哈希存储在缓存目录，文件变更后哈希变化，触发修复。缓存目录被清理后，首次运行会全量修复。建议缓存目录纳入备份策略.
错误处理
| 错误场景(现象) | 可能原因 | 解决步骤 | 优先级 |
|---|---|---|---|
| 批量修复卡住 | 目录过大/IO瓶颈 | 启用增量模式，增加并行线程 | 中 |
| 流式修复内存溢出 | 缓冲区过大/单行过长 | 降低buffer_size，使用大行解析器 | 高 |
| 自定义规则无效 | 正则错误/规则顺序 | 校验正则，调整规则顺序 | 高 |
| 预览差异为空 | 规则未匹配 | 检查规则模式，测试样本 | 中 |
| 快照恢复失败 | 快照损坏 | 从更早快照恢复，检查存储 | 高 |
| 规则执行超时 | 脚本复杂度高 | 优化脚本，设置超时时间 | 中 |
专业版特性
本专业版相比免费版新增以下能力：
- 批量目录修复：并行处理，增量模式，修复报告
- 流式修复：GB级文件，内存稳定10MB，断点续传
- 自定义修复规则：正则/脚本/预设/组合四类规则
- 修复预览：修复前后差异对比，置信度评分
- 增量修复：基于哈希判断变更，结果缓存
- 历史回滚：快照/增量存储/任意版本恢复
- 规则市场：发布与订阅规则包，版本化管理
- 优先支持：专属技术支持通道，SLA响应承诺
定价
| 版本 | 价格 | 功能 | 适用场景 |
|---|---|---|---|
| 免费体验版 | ¥0 | 核心功能+基础示例 | 个人试用 |
| 收费专业版 | ¥29.9/月 | 全功能+高级特性+优先支持 | 团队/企业 |
专业版通过SkillHub SkillPay发布.
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- 操作系统: Windows / macOS / Linux
- Node.js: 16+（用于修复引擎与vm沙箱）
- Python: 3.8+（用于历史管理与审计脚本）
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| JSON解析器 | 运行时 | 必需 | Node.js内置JSON.parse |
| vm模块 | 运行时 | 必需 | Node.js内置vm（沙箱） |
| 流式解析库 | npm包 | 必需 | stream-json |
| diff算法库 | npm包 | 必需 | diff |
API Key 配置
- 本skill基于Markdown指令规范，无需额外API Key
- 修复与规则执行为本地沙箱，不依赖外部API
- 规则市场若对接企业版仓库，按对应服务文档配置
可用性分类
- 分类: MD+EXEC（纯Markdown指令，修复与规则功能需要exec命令行执行能力）
- 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行企业级JSON修复任务，高级功能通过命令行工具实现
已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
安全注意事项
| 风险类型 | 防范措施 |
|---|---|
| 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 |
差异化对比
| 对比维度 | JSON修复工具专业版 | 传统手动方式 | 通用脚本工具 |
|---|---|---|---|
| 自动化程度 | 全流程自动 | 完全手动 | 部分自动 |
| 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch |
| 可复用性 | 参数化配置 | 一次性脚本 | 模板化 |
| 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 |
| 适用场景 | 企业级JSON修复工具，支持批量目录修复、流式处理、自定义规则、修复预览与历史回 | 通用场景 | 通用场景 |
核心功能
- 自动化执行: 企业级JSON修复工具，支持批量目录修复、流式处理、自定义规则、修复预览与历史回滚。。JSON修复工具专业版面向企业级场
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 2w ago
- Current version
- v1.0.0
- License
- MIT-0