JSON 助手

要解决的问题

调试接口返回、查看构建日志或读取配置文件时，经常遇到一大坨没有换行的 JSON：想确认某个字段到底有没有返回，得在终端里手动加缩进；或者从别处复制的配置里键名忘了加双引号，程序直接抛 JSONDecodeError。这类脏活不难，但重复、琐碎，而且错误往往藏在肉眼看不见的格式细节里。

核心能力

这个技能把 JSON 的日常处理拆成三步：

• 格式化：收到未排版的 JSON 后，调用 jq 或 Python 做美化输出，让嵌套结构一目了然。
• 验证：判断一段文本是否为合法 JSON，无效时直接指出问题所在。
• 提取字段：从 JSON 中取出指定字段，不用再手写一层层解析代码。

典型流程

以接口排查为例：

• 用户粘贴一行未格式化的 JSON，例如 {"name":"张三","age":25,"city":"北京"}，助手输出带缩进的结构。
• 用户丢来 {name: test} 问“这个对吗”，助手会直接给出结论：❌ 无效 JSON，键名需要用双引号包围，并给出修正后的 {"name": "test"}。

验证失败时，技能会结合常见报错定位原因。比如 JSONDecodeError: Expecting property name 通常意味着键名没有用双引号，修复方式就是把 {name: value} 改成 {"name": "value"}。

适用边界

• 只处理语法层面的格式化与校验，不会推断业务语义，比如某个字段该是字符串还是数字。
• 字段提取按用户逐步提出的要求写入 JSON，不是自动全量解析。
• 格式化依赖 jq 或 Python，运行环境需至少安装其一。
• 遇到超大 JSON（如整份索引导出）时，建议先过滤再格式化，否则输出会非常冗长。