Repeto 說明文件
開啟 Repeto
瀏覽說明文件

管理

匯入與匯出

將 Anki 套件移至 Repeto、選擇保留內容，並保存牌組的可攜副本。

狀態：目前支援範圍與已知缺口

Repeto 可匯入及匯出 Anki .apkg 牌組套件。請將轉移視為可檢查的操作：依賴匯入收藏前，先檢視摘要、警告、範本及媒體。

匯入 Anki 套件

開啟 匯入，拖放或選擇 .apkg。Repeto 將它上傳為可續傳的背景工作，寫入收藏前先準備預覽。

預覽列出：

  • 牌組及筆記／卡片數；
  • 套件中的筆記模型；
  • 媒體數量；
  • 是否含排程資料；
  • 套件特定警告。

你可以選擇取代套件頂層牌組名稱。包含多個牌組的套件會保留階層，除非提供包住它們的目標名稱。

選擇保留內容

有排程資料時，保留排程與複習歷史 預設開啟。若只要材料並刻意從全新學習狀態開始，請關閉。

使用 Repeto 樣式 也預設開啟。它讓 Repeto 主題控制色彩，同時保留匯入內容與範本結構。原始視覺設計若不可或缺，請關閉並檢查明暗模式。

媒體會透過套件資訊清單配對，並永久保存為收藏媒體。即使相關卡片已存在，日後匯入也能補回缺少的媒體。

長時間匯入

大型套件會以工作持續處理。Repeto 在本機保存目前匯入 ID，導覽或重新載入後恢復預覽或結果。處理時不要重複上傳同一檔案，先開啟既有工作頁面。

瀏覽器回報錯誤時，從來源應用程式重新匯出，再以新檔重試。損壞 SQLite、不支援的壓縮或缺少媒體項目應產生警告或失敗，而非建立僅部分可信的卡片。

匯出牌組

開啟牌組並選擇 匯出 .apkg。Repeto 會下載階層名稱、筆記、卡片、類型、範本、媒體及支援的排程資料。

使用下載套件來：

  • 在結構變更前保留獨立快照；
  • 將牌組移至其他相容應用程式；
  • 私下分享牌組；
  • 測試完整匯入／匯出往返。

並非所有 Anki Desktop 功能都有 Repeto 對應項目。篩選牌組成員、隱藏狀態、附加元件、自訂範本指令碼及不支援的排程中繼資料可能無法完全往返。刪除來源前，先在目的地檢查套件。

匯入結構化文字

開啟 匯入、選擇 CSV 或 TSV，再選取或拖入 UTF-8 的 .csv、.tsv 或 .txt。網頁畫面最多接受 5 MiB 與 10,000 筆資料列。預覽會偵測常見分隔符號、BOM、引號內多行欄位、跳脫引號及列寬問題。

預覽前請選擇筆記類型與牌組、選用標籤、分隔符號、HTML 處理、重複政策和比對範圍。第一筆資料前的 #separator、#html、#notetype、#deck、#tags 皆可辨識；畫面上的明確選項會覆寫檔案指示。

接著把每欄對應到筆記欄位、空格分隔標籤或 忽略欄位。第一個筆記欄位必須對應，因為它識別重複內容。Repeto 會顯示診斷與每列的建立、更新、略過或無效計畫。請明確選擇 更新相符筆記、略過匯入列 或 新增另一則筆記。

變更檔案、對應或設定會使計畫失效。只有確認檢查過精確列計畫後才能提交；綁定使用者的預覽權杖只接受該檔案和選項，重建計畫並以原子方式套用。更新會保留卡片 ID、排程、到期日、間隔、排程器狀態與複習歷史；相同重試具冪等性。瀏覽器會在本機保存檔案、選項與預覽以供復原；若顯示無法復原，請保持頁面開啟。

目前不匯入引用媒體、GUID、#columns、逐列牌組／類型指示或欄名列；第一個非指示列就是資料。也尚未提供結構化文字匯出。

備份完整 Repeto 收藏

Repeto 原生封存檔是精確復原格式。GET /v1/collection/backup 會建立版本化 ZIP64，內含收藏關係、牌組樹與設定、筆記類型／範本／CSS、筆記、卡片、排程、歷史、具校驗碼的媒體，以及篩選牌組定義與成員。POST /v1/collection/restore 在原子提交前會驗證擁有者、路徑、校驗碼、關係與同步時鐘。這仍是 API，不是定時自動備份瀏覽器或完整帳戶復原介面。

匯出或檢查 Anki 收藏套件

GET /v1/collection/export.colpkg 會建立真正的舊式 schema-11 .colpkg，包含 Anki 可表達的收藏與已驗證媒體；它是互通格式，不是 Repeto 精確備份。匯出 JSON manifest 或舊式 .colpkg 前，請清空或刪除運作中的篩選牌組；這些格式會拒絕有效執行狀態，以免產生誤導快照。POST /v1/collection/import.colpkg/preview 可安全檢查 legacy、anki21 和 anki21b，但不會取代收藏；破壞性匯入仍停用。

檢查媒體完整性

收藏 API 會掃描欄位與範本中的圖片、音訊、來源及 [sound:…] 引用，回報遺失、未使用、格式錯誤與舊檔名歧義；不擷取遠端網址也不刪除任何內容。引導式修復與垃圾桶介面仍在規劃中。

其他匯出

統計頁面可將顯示內容匯出為 CSV。API 也提供決定性的 Repeto 收藏資訊清單，供復原及工程流程使用，但第一級帳戶備份／還原介面仍在完成中。

市集發布不同於備份匯出：發布牌組是可分享的內容套件，不是完整私人複習歷史的副本。

安全移轉檢查清單

  1. 驗證完成前保留原始套件。
  2. 需要延續時保留排程匯入。
  3. 開啟每個筆記類型的代表卡片。
  4. 檢查圖片與音訊。
  5. 比較到期數量與部分間隔。
  6. 從 Repeto 匯出已匯入牌組，並獨立測試該套件。

剩餘的備份、衝突與完整收藏可攜性工作列在功能對等路線圖。