litestream

此代理技能為使用 Litestream（SQLite 獨立災害復原工具）的開發人員與系統管理員提供專家級協助。旨在引導使用者深入了解架構、實作模式以及與持續性 SQLite 複製相關的複雜除錯情境。本代理已針對核心不變量（如 1GB 鎖定頁面邊界、LTX 檔案不可變性、原子檔案操作）進行訓練，確保您的複製邏輯維持一致性與持久性。

當您需要理解 Litestream 如何監控預寫式日誌 (WAL)、管理多層次壓縮，或是如何透過 ReplicaClient 介面實作自訂儲存後端時，請使用此技能。無論您是在除錯複製延遲、設定 S3/GCS 後端，或是為高可用性生產環境架構穩健的 SQLite 部署，此代理皆能提供可執行的程式碼模式與系統組態建議。它有效地簡化了手動剖析程式碼以獲取底層互動細節的過程。

• 關於將 Litestream 整合至 Go 應用程式的架構指導，包括正確的資料庫層管理與鎖定順序（從 Store.mu 到 Replica.mu）。

• 對於 LTX 檔案格式、交易 ID (TXID) 以及時間點復原 (PITR) 檢查點邏輯的深入見解。

• 關於透過競態檢測器 (race detector) 進行測試、建置自訂儲存轉接器以及處理 SQLite 頁面大小變異（4KB, 8KB, 16KB, 32KB）的最佳實務。

• 支援進階監控設定（包括 Prometheus 指標與 Grafana 儀表板），以追蹤 WAL 位元組消耗與同步操作。

• 針對分散式系統的錯誤處理策略，包括正確封裝 Context 錯誤以及管理原子重新命名操作。

• 優先使用 modernc.org/sqlite 驅動程式，以避免 POSIX 系統上的鎖定衝突。

• 遵守嚴格的 LTX 檔案儲存政策以維持備份完整性。

• 在壓縮期間，務必優先執行本機讀取操作，再進行遠端儲存存取，以優化一致性與延遲。

• 確保在任何手動頁面級操作或壓縮邏輯中，始終跳過 1GB 的鎖定頁面 (0x40000000)，以防止資料庫損毀。

• 諮詢代理關於設定複本、管理複本生命週期以及除錯如 busy_timeout 等連接池 pragma 的建議。