當卡片出現 "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 可以執行,請聯繫客服協助。
開啟出現錯誤的卡片。
開啟 AI Chat,並切換到 Agent mode。
選擇 GPT 5.5 模型。我們建議用能力較強的模型來處理,但你也可以使用自己熟悉的模型。
確認出問題的卡片已開啟,並且在 AI 對話的 context 中,然後送出下方的修復請求。
範例:
這張卡片的 schema 出現問題,請你幫我調查,並嘗試修復這個問題,讓它符合目前的 schema 規範。
Agent 完成後,會改寫不符 schema 的欄位,卡片內容應該就會重新顯示。
如果錯誤再次出現
如果這個錯誤在某個特定操作後立刻再次出現,例如又透過 CLI、MCP 工具或再次貼上來編輯同一張卡片,請停止那個操作。它很可能正在從源頭重新寫入不符規範的格式。
如果 AI Agent mode 無法修復卡片,或修復後內容仍然遺失,請聯繫客服並提供卡片的相關資訊與截圖。


