JSON修复工具(专业版)
本工具是企业级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
- 1mo ago
- Current version
- v1.0.0
- License
- MIT-0
