跳至主要內容

解決卡片的「The content is corrupted」錯誤

當卡片出現 "The content is corrupted." 時,代表這張卡片底層的資料格式不再符合 Heptabase 的規範。內容通常還能救回,你可以自己透過 AI Agent mode 修復這張卡片。

為什麼卡片內容會出現損壞

這通常發生在卡片的部分資料以不符合 Heptabase schema 的格式寫入時。最常見的來源有:

  • 透過 Heptabase CLI 編輯這張卡片

  • 透過 MCP 整合編輯這張卡片

  • 直接複製貼上內容到卡片中

舉例來說,一個需要日期的欄位填入了具體時間,或是顏色欄位只接受 Heptabase 預設的數種值,卻收到範圍外的數值。如果你曾透過上述任一方式編輯過這張卡片,那很可能就是原因。

透過 AI Agent mode 修復卡片

AI Agent mode 可以讀取卡片的資料,並改寫不符規範的部分,讓卡片符合目前的 schema。

備註:Agent mode 會消耗 AI credits。如果你沒有足夠的 credits 可以執行,請聯繫客服協助。

  1. 開啟出現錯誤的卡片。

  2. 開啟 AI Chat,並切換到 Agent mode

  3. 選擇 GPT 5.5 模型。我們建議用能力較強的模型來處理,但你也可以使用自己熟悉的模型。

  4. 確認出問題的卡片已開啟,並且在 AI 對話的 context 中,然後送出下方的修復請求。

範例:

這張卡片的 schema 出現問題,請你幫我調查,並嘗試修復這個問題,讓它符合目前的 schema 規範。

Agent 完成後,會改寫不符 schema 的欄位,卡片內容應該就會重新顯示。


如果錯誤再次出現

如果這個錯誤在某個特定操作後立刻再次出現,例如又透過 CLI、MCP 工具或再次貼上來編輯同一張卡片,請停止那個操作。它很可能正在從源頭重新寫入不符規範的格式。

如果 AI Agent mode 無法修復卡片,或修復後內容仍然遺失,請聯繫客服並提供卡片的相關資訊與截圖。

是否回答了您的問題?