json_repair
修復來自LLM、API、日誌和使用者輸入的格式錯誤JSON(Python)
json_repair 是什麼?
修復來自LLM、API、日誌和使用者輸入的格式錯誤JSON(Python)
json_repair 概覽
這是什麼
json_repair 是一個 Python 函式庫,用於修復來自大型語言模型、API、日誌和使用者輸入的格式錯誤 JSON 字串。它能修復缺少的引號、逗號、括號、註解、多餘文字以及被截斷的值。可作為 json.loads() 的備用方案,或作為基於結構的修復步驟。
主要功能
- 修復缺少的引號、錯置的逗號、未跳脫字元以及不完整的鍵值對。
- 修復不完整的陣列和物件,加入必要元素(如逗號、括號)或預設值(null、空字串)。
- 自動以合理的預設值(如空字串或 null)補齊 JSON 中遺漏的值。
- 辨識 Python 風格的元組:以逗號分隔的括號序列會轉為 JSON 陣列,單一括號值則維持為純量。
- 在陣列、物件和元組中,不區分大小寫地將
true/false/null和None辨識為 JSON 布林值或 null。 - 提供
loads()和load()作為json.loads()和json.load()的直接替代,並有from_file()方法從檔案讀取。 - 支援
skip_json_loads=True以跳過初始的嚴格 JSON 驗證,直接進入修復解析器。
使用情境
- 修復大型語言模型輸出中格式錯誤的 JSON,這些模型可能遺漏括號或加入多餘文字。
- 修復來自 API、日誌或使用者輸入、包含語法錯誤(如缺少引號、錯置逗號或未跳脫字元)的 JSON。
- 在不完整的資料結構中自動補齊遺漏的 JSON 值。
- 清理包含額外非 JSON 字元(如註解或錯置字元)的 JSON。
快速開始
pip install json-repair然後在程式碼中使用:pythonfrom json_repair import repair_jsongood_json_string = repair_json(bad_json_string)或作為 json.loads() 的直接替代:pythonimport json_repairdecoded_object = json_repair.loads(json_string)
授權與價格
此函式庫採用 MIT 授權條款,為開放原始碼。對所有人免費。
內容整理自該專案公開的 README 與儲存庫資訊。