NeuraCache 閃卡 — 使用說明

三十秒摘要

  1. 手機裝 NeuraCache(App Store / Google Play,免註冊)
  2. App 內選 Import Markdown File → 從 Google Drive 挑 10-NeuraCache閃卡-ITS Python.md
  3. 看到 95 張卡就成功了

⚠️ 妳的 vault 在 Google 雲端硬碟,只能用單檔匯入,不能用資料夾觀察(原因見下方)。

只匯入 10- 那一個檔,不要匯入本說明檔

本檔為了教學必須寫出真正的標籤字樣,若被 NeuraCache 掃到會產生 1~2 張「垃圾卡」。
用單檔匯入就不會發生。 萬一出現了,在 App 內刪掉即可,不影響其他 95 張。


📱 NeuraCache 是什麼

項目說明
類型手機 App(iOS / Android),不是 Obsidian 外掛
運作方式讀取 Markdown 檔案,把符合格式的段落轉成閃卡
隱私官方標榜 100% 離線,資料只存在裝置上,免註冊
演算法間隔重複(Spaced Repetition)
官網neuracache.com
格式規格GitHub: markdown-flashcards-spaced-repetition

💡 重點:NeuraCache 不會改動妳的 vault。它只是「讀」Markdown,複習進度存在手機裡。
這跟 Obsidian SR 外掛把 <!--SR:...--> 寫回筆記,是完全不同的做法。


🆚 跟原本的 Spaced Repetition 外掛差在哪

Obsidian SR 外掛NeuraCache
執行環境電腦上的 Obsidian手機 App
資料檔05-SR閃卡-ITS Python07-填空打字卡(自動比對)10-NeuraCache閃卡-ITS Python
標籤flashcards複數flashcard單數
卡片分隔問題 / ? / 答案問題行帶標籤,答案在下,- - - 結尾
複習進度存哪寫回 .md 檔<!--SR:...-->存在手機,不動筆記
打字作答✅ 填空可打字自動比對❌ 只能看答案自評
適合時機上課、在電腦前通勤、排隊、睡前

兩套可以同時用

標籤一個單數一個複數,Obsidian 認定為兩個不同標籤,彼此不會互相抓取。
我確認過 SR 外掛的比對邏輯是 tag === subTag || subTag.startsWith(tag + "/") ——
它只會抓 flashcardsflashcards/xxx不會抓單數的 flashcard


📥 匯入步驟

NeuraCache 有兩種取得 Markdown 的方式,差別很大,先選一種:

① 匯入單一檔案
Import Markdown File
② 觀察資料夾
Select Folder to Observe
自動更新❌ 一次性,改檔要重匯✅ 每 ~6 小時自動掃描
Google 雲端硬碟可用不支援
Dropbox✅ 可用❌ 不支援
手機本機資料夾/iCloud✅ 可用✅ 可用
會不會掃到說明檔❌ 不會(只讀選定的檔)⚠️ 會掃整個資料夾

妳的 vault 在 Google 雲端硬碟 → 只能用「方式 ①」

官方明確說明:Google Drive 與 Dropbox 目前只支援 Import Markdown File
「Select folder to Observe」無法使用
(雲端服務未實作 iOS 最新的雲端資料夾協定)。

但這對我們反而是好事 —— 這副牌組是靜態的,不會天天改;
而且只匯入單一檔案,就完全不會掃到說明檔,不會產生垃圾卡。


🅰️ 方式 ①:匯入單一檔案(推薦,最簡單

第 1 步|確認檔案位置 — 妳的 vault 已在 Google 雲端硬碟,這步已完成 ✅

我的雲端硬碟 / Obsidian Vault / Python Vault / ITS Python 證照 /
    └── 10-NeuraCache閃卡-ITS Python.md   ← 只要這一個檔

第 2 步|手機安裝 App — App Store 或 Google Play 搜尋 NeuraCache。免註冊,開啟即用。

第 3 步|匯入 — App 內選 Import Markdown File → 從 Google Drive 挑選上面那個 .md 檔。

第 4 步|之後要更新 — 改過卡片內容後,重新匯入一次同一個檔即可。


🅱️ 方式 ②:觀察資料夾(需要自動同步才用)

只有在妳希望「改完 Obsidian,手機自動更新」時才需要這套,代價是要多裝同步工具。

手機做法
AndroidFolderSyncSyncthing 把檔案同步到手機本機資料夾
iPhone把檔案放進 iCloud 資料夾(Google Drive 不行)

然後在 App 內選 Select Folder to Observe 指向該資料夾。

建議把 10- 這個檔單獨放進一個乾淨的資料夾,否則 App 會連同 11-說明檔、甚至整個 vault 一起掃描。

同步時機:

  • 背景自動掃描:約每 6 小時一次
  • 手動立即同步:在卡片清單下拉,或按 Sync 按鈕
  • Single Source of Truth:開啟後,以資料夾為準,避免手機與電腦版本衝突

🍎 iPhone 匯入不了 Google 雲端硬碟?(已知問題

這不是妳操作錯誤,是 iOS 的限制

Google Drive、Dropbox、OneDrive 都沒有實作 iOS 最新的雲端資料夾協定。
在 iPhone 上,這些雲端服務在 NeuraCache 裡會出現以下任一症狀:

  • 選單裡看得到 Google Drive,但點進去無法選檔
  • 檔案顯示為灰色不可選
  • 選了之後沒有任何反應
  • 資料夾觀察模式裡根本點不進去

解法:先把檔案「落地」到 iPhone 本機,再從本機匯入。

✅ 方法 A:用 Google 雲端硬碟 App 存到「檔案」(最快,不用裝任何東西)

  1. iPhone 開啟 Google 雲端硬碟 App
  2. 找到 10-NeuraCache閃卡-ITS Python.md
  3. 點檔案右側的 (三個點)
  4. 「傳送副本」「開啟方式」「儲存到檔案」
  5. 位置選 「我的 iPhone」(可先新增一個資料夾叫 NeuraCache
  6. 回到 NeuraCache → Import Markdown File → 從**「我的 iPhone」**挑檔

💡 關鍵在第 4–5 步:「儲存到檔案」會產生一份真實的本機檔案
繞開雲端服務的協定問題,NeuraCache 就讀得到了。

✅ 方法 B:改用 iCloud 雲碟(想要自動更新才需要)

  1. Windows 安裝 「Windows 版 iCloud」(Microsoft Store 可下載)
  2. 10-NeuraCache閃卡-ITS Python.md 複製到 iCloud 雲碟的資料夾
  3. iPhone 的「檔案」App 就會出現該檔
  4. NeuraCache 可用 Import Markdown File也可以用 Select Folder to Observe(iCloud 支援資料夾觀察)

⚠️ 但 iCloud 也有人回報同步不穩定。若卡片沒更新,先在 iPhone「檔案」App 裡把該檔點開一次強制下載。

✅ 方法 C:直接傳給自己(一次性,最土法煉鋼)

LINE / Email.md 檔傳給自己 → iPhone 開啟附件 → 「儲存到檔案」 → 從 NeuraCache 匯入。

🔧 如果檔案還是灰色不能選

iOS 會依檔案類型過濾可選項目,.md 偶爾會被擋掉。依序試:

順序做法
1先用方法 A 存到本機再選(多數情況這樣就好了)
2把副檔名改成 .txt 再匯入
3把檔名改成純英文(例如 ITS-Python-cards.md),避免中文檔名造成的相容問題

✅ 驗收(兩種方式共通)

匯入成功應該會看到 95 張卡,並可依標籤篩選:

標籤張數內容
ITS-Python95全部
QA47問答卡
Cloze48填空卡
CH01-0223型態與運算子
CH0315字串與清單
CH0414輸入輸出與檔案
CH0515判斷式與迴圈
CH069函式
CH07-0819模組與例外

看到 95 張 = 匯入成功。


▶️ 匯入之後:怎麼開始複習

⚠️ 選單名稱會隨版本略有不同,以下為 NeuraCache 3.x 的通用流程。

先做這 3 個設定(只要設一次)

#設定建議值為什麼
1Front/Back 策略Always Front⚠️ 最重要,見下方警告
2Queue Daily Limit(每日上限)10 ~ 1595 張一次吃完,一週後會全部同時到期
3Review Order(複習順序)RandomLeast Remembered First後者會優先出最不熟的卡

Always Front 一定要設,否則會出現「反過來問」的卡片

NeuraCache 支援雙向卡(正反面互換)。但我們這 95 張是單向的:

正面:`type("True")` 的結果是 ______
背面:str

如果策略設成 RandomAlways Back,就會變成先給妳看 str,要妳反推題目 ——
這對填空題完全沒有意義,而且會讓妳誤以為自己答錯。

設定 → Review/Study → Front/Back Strategy → 選 Always Front


每天的複習流程

① 開 Today's Queue(今日佇列) — 這是核心。App 會自動排出今天該複習的卡,刷完就收工

② 看題 → 心裡想答案 → 翻面 → 評分

評分意思下次出現
🟢 綠(記得)想出來了隔更久
🔴 紅(忘了)答不出來或答錯很快再出現

評分介面可在設定裡切換 按鈕滑桿,另有音效與震動回饋可開關。

③ 刷完會累積 Streak(連續紀錄) — 每完成一次今日佇列 +1。累積 7 個 streak 可換 1 個 frost(凍結),哪天沒空刷可以用掉,不會斷紀錄。


只想練某一章?用 Study 分頁

Today's Queue 是系統排的,想自己挑章節就用 Study 分頁

  1. Study 分頁
  2. 點一下標籤選取、再點一下取消(可複選)
  3. 開始複習

可用的標籤組合:

想練什麼選哪些標籤
只練第 5 章CH05
只練問答卡QA
只練填空卡Cloze
第 5 章的填空卡CH05 + Cloze,並把篩選切成 AND

💡 NeuraCache 支援 AND / OR 兩種牌組篩選。
OR = 符合任一標籤;AND = 必須同時符合所有選取的標籤。


這副牌組的專屬提醒

#提醒
1填空卡(Cloze)在手機上不能打字比對 —— 看到 ______ 請在心裡填答再翻面。要練打字精確度請用電腦版 SR 外掛的 07-填空打字卡(自動比對)
2不要為了好看亂按綠色。 演算法靠妳的誠實回報排程,按錯只會害到自己。
3每天 10 張新卡以內,把今日佇列清成 0 就好,不用貪多。
4卡片上會顯示遺忘曲線,可以看到記憶衰退到哪、何時該複習。

💰 免費夠用嗎?

夠。 基本功能(匯入 Markdown、間隔重複複習、標籤篩選)都是免費的。

Premium(約 US35.99/年)解鎖的是進階功能。考證照用免費版就足夠,不必先付費。


📝 NeuraCache 的 Markdown 格式

一、單行卡(本檔沒有使用)

問題 : 答案 #flashcard #標籤1 #標籤2

為什麼我們的 Python 卡片 不能用單行格式

單行格式用冒號 : 分隔問題與答案,但 Python 語法到處都是冒號:

for x in range(10):        ← 冒號
{'一月': '正月'}            ← 冒號
s[1:3]                     ← 冒號

只要問題裡出現冒號,卡片就會從錯誤的位置被切開
所以本檔 95 張全部採用多行格式

二、多行卡(本檔採用)

問題寫在這一行 #flashcard #ITS-Python #CH01-02 #QA
 
答案寫在這裡,
可以多行、可以有程式碼與表格。
 
- - -

三個規則:

  1. 問題必須是一行,標籤跟在問題後面。
  2. 答案在下方,可以任意多行。
  3. 必須用水平線結尾,可用 - - ----**** * *

為什麼我選 - - - 而不是 ---

Markdown 有個規則:文字的下一行如果是 ---,會被當成「標題底線」,整段變成大標題。
- - -(中間有空格)永遠是水平線,不會誤判。
本檔 95 張全部用 - - -,在 Obsidian 裡預覽也不會跑版。

三、其他格式(本檔未使用,供延伸參考)

類型語法用途
微卡片⚡️🧠 取代標籤不想讓標籤出現在筆記裡
單面卡內容 #spaced名言、口訣這種「沒有問答」的記憶項目
標籤群組在區段開頭宣告標籤讓後續卡片自動套用同一組標籤

➕ 自己新增卡片

打開 10-NeuraCache閃卡-ITS Python,照下面的樣板貼在對應章節底下:

你的問題? #flashcard #ITS-Python #CH05 #QA
 
你的答案。
 
- - -

新增時最容易犯的 4 個錯

#錯誤後果
1忘記結尾的 - - -這張卡會把後面所有內容都吃進答案裡
2問題寫成兩行第二行會被當成答案的一部分
3標籤寫成複數變成 SR 外掛的卡,NeuraCache 抓不到
4答案裡出現 ---***卡片被提前截斷,後半段消失

改完存檔 → 手機 App 重新同步一次即可。


🔧 疑難排解

症狀原因解法
完全沒有卡片標籤寫成複數 flashcards改成單數 flashcard
卡片數量對,但答案是空的問題行後面沒有內容就接 - - -補上答案
某張卡的答案超長,混進別題上一張卡漏了 - - -補上結尾水平線
卡片被切成兩半答案裡有 ---***- - -改寫該行,或改用其他符號
中文變亂碼檔案編碼不是 UTF-8Obsidian 預設就是 UTF-8,通常不會發生
出現內容像說明文字的卡掃到了本說明檔在 App 內刪除;改用單檔匯入就不會再發生
改了檔案但 App 沒更新單檔匯入不會自動更新重新匯入一次;資料夾模式則下拉或按 Sync
找不到「Select Folder to Observe」Google Drive / Dropbox 不支援此模式改用 Import Markdown File,或把檔案同步到手機本機/iCloud
等很久卡片才更新背景掃描約 6 小時一次在卡片清單下拉強制同步,或按 Sync
Obsidian SR 的卡不見了不會發生兩者標籤不同,互不影響。SR 請按左側 🗂️ 圖示

🎯 建議用法:兩套分工

情境用哪一套理由
上課、在電腦前Obsidian SR填空可打字自動比對,練拼字精確度
通勤、排隊、睡前NeuraCache手機隨手就能刷,離線也能用
考前一兩天總複習Obsidian SR 的 Cram Mode出全部卡片且不寫入排程,怎麼刷都不會弄壞進度

給同學的一句話

不必兩套都用。 挑一套用到底,比兩套都用三天有效得多。
習慣手機的用 NeuraCache,習慣電腦的用 Obsidian SR。


📎 相關文件

文件內容
10-NeuraCache閃卡-ITS Python本說明對應的資料檔(95 張)
06-閃卡使用說明Obsidian SR 外掛的使用說明
05-SR閃卡-ITS PythonSR 問答卡(47 張)
07-填空打字卡(自動比對)SR 填空打字卡(48 張)
04-易錯題自我測驗卡用眼睛讀的摺疊式問答版
00-ITS Python 考照重點總整理主講義

🔗 參考來源