Yomitan + Anki：一鍵製卡設定

透過 Yomitan，只需點選一下滑鼠，就能將滑鼠懸停查閱的單字一鍵製作成 Anki 卡片。在此之前，你只需完成一次簡單的準備工作：安裝 AnkiConnect 外掛程式、在 Yomitan 中指定目標牌組和筆記類型，並完成幾個欄位的對應設定。¹ 本文假設你已按照「Yomitan (Yomichan)：懸浮查詞字典工作流程」安裝了 Yomitan 並能正常查詞。如果尚未安裝，請先完成該部分設定。

概述

該工作流程包含三個程式，各自承擔一項職責：Yomitan 負責瀏覽器端查詞；Anki 負責儲存卡片並透過間隔重複系統安排複習；而名為 AnkiConnect 的輕量外掛程式則充當橋樑，讓兩者進行通訊。²

一旦橋樑架設完畢，之後的學習閉環每次都無比順暢：瀏覽母語文本、滑鼠懸停查詞、點選綠色加號。本文接下來的內容將詳細講解如何完成這一通車前的一次性設定。

各組件的連接關係與先決條件

Yomitan 從不直接向 Anki 寫入資料。它是透過 AnkiConnect 與 Anki 通訊的，該外掛程式「每次在 Anki 啟動時都會初始化一個運行在 8765 連接埠的輕量 HTTP 伺服器」。² 該伺服器僅在本機監聽，處於同一台電腦上：「預設情況下，AnkiConnect 僅將 HTTP 伺服器繫結到 127.0.0.1 IP 位址，因此你只能從運行它的同一台主機進行存取」。²

正是這種本機繫結機制，使得該橋樑無需註冊任何帳號，也不依賴外部網際網路。Yomitan 所在的瀏覽器與 Anki 運行在同一台裝置上，資料交接完全在電腦的本機回環位址（localhost）上完成。

整個通訊鏈路共有三個環節，任何一處中斷都會導致卡片無法儲存：

在開始製作第一張卡片之前，必須確保三項前提就緒：Yomitan 已經能夠正常查詞；Anki 桌面客戶端已安裝；在 Yomitan 中指定了存放卡片的牌組和筆記類型。牌組和筆記類型的選擇將在下文詳述。建立一個專用的擷取牌組是一項推薦實踐，而在 Yomitan 中選擇指定的牌組和模型（Model）則是必須完成的硬性要求。¹

為什麼要從閱讀素材中擷取製卡

從真實閱讀中擷取出的卡片自備上下文語境。單字是與你在閱讀中實際遇到的完整句子繫結在一起的，而非僅僅是一段抽象的字典解釋。這一語境正是 i+1 理念的核心支柱：每張新卡片只在你原本基本理解的素材上增加一個未知要素。

本文側重於該製卡交接流程的技術操作。至於如何篩選擷取內容以及背後的 i+1 理論邏輯，請參閱「例句擷取：從閱讀素材中建構專屬日語 Anki 牌組」及相關的閱讀策略專文。

安裝 AnkiConnect

在 Anki 中新增外掛程式

AnkiConnect 透過外掛程式代碼進行安裝。該代碼為 2055492159，這是其在 AnkiWeb 平台上的固定專屬識別碼。³²

安裝步驟引自 AnkiConnect 的 README 文件：「在 Anki 中依次選擇 工具 > 附加元件 > 取得附加元件 打開安裝對話框。在標有 代碼 的文字方塊中輸入 2055492159，然後點選 確定 繼續。根據系統提示重啟 Anki 以完成 AnkiConnect 的安裝」。²

功能表文字可能因 Anki 版本而異

README 中標記的路徑為「工具」 > 「附加元件」 > 「取得附加元件」（Tools > Add-ons > Browse & Install / Get Add-ons）。無論哪種路徑，都會打開要求輸入「代碼」的對話框；在此處貼上 2055492159 即可。²

重啟 Anki 後，無需操作 Yomitan 即可驗證橋樑是否處於啟用狀態。README 給出的檢驗方法是：「你可以在瀏覽器中造訪 localhost:8765，隨時驗證 AnkiConnect 是否正在運行。如果伺服器正常運作，瀏覽器視窗中應顯示 AnkiConnect v.5 類似的提示訊息」。² 只要看到「出現了 AnkiConnect 的提示橫幅」即代表成功。提示中的具體版本號字串會隨外掛程式建置版本而略有不同。

Anki 必須保持運行狀態

AnkiConnect 的服務僅在 Anki 處於打開狀態時才存在。README 明確指出了這一要求：「必須保持 Anki 在背景運行，其他應用程式才能使用 AnkiConnect」。²

這一機制源於其安裝原理：HTTP 伺服器「在每次 Anki 運行時啟動並監聽 8765 連接埠」。當 Anki 關閉後，Yomitan 便失去了通訊目標。² Yomitan 文件也給出了相同的疑難排解說明：當快顯視窗中沒有出現新增圖示時，請「確保 Anki 正在背景運行」。¹

只要 Anki 關閉，連接橋樑即告失效

Yomitan 無法將卡片儲存到未打開的 Anki 中。在整個閱讀學習期間，必須保持 Anki 桌面客戶端在背景持續運行，而不僅僅是在決定新增單字的那一刻才打開它。²

將 Yomitan 連接至 Anki

啟用 Anki 整合

在 AnkiConnect 安裝完畢且 Anki 正在運行的狀態下，進入 Yomitan 的設定頁面開啟整合。文件指導如下：「勾選標有 啟用 Anki 整合（Enable Anki integration） 的核取方塊」，該選項位於 Yomitan 設定頁面的 Anki 選項區域中。¹

Yomitan 對兩類卡片分別進行獨立設定：一類在 詞彙（Terms） 標籤頁下，另一類在 漢字（Kanji） 標籤頁下。每個標籤頁都可以指定各自獨立的牌組、模型與欄位對應，從而讓詞彙卡片和漢字卡片按不同的欄位格式存入不同的牌組。¹

選擇牌組與筆記類型（模型）

在對應任何欄位之前，Yomitan 會要求你「選擇用於為此類型建立新字卡（抽認卡）的 Anki 牌組和模型」。¹ 必須先選擇好牌組和模型，因為下一步的欄位對應是針對各個具體模型來定義的。¹

「Model」（模型）是 Anki 對「筆記類型」（Note Type）的技術稱謂。Yomitan 中標有 model 的下拉式選單對應的內容與 Anki 的筆記類型列表完全一致；其官方文件全程通用「model」一詞。¹

設立專門的例句擷取牌組，能將這些來自日常閱讀的卡片與現成的預設牌組清晰隔離開來，這也會讓下一步的欄位選擇思路更加明晰。

對應卡片欄位

欄位標記及其擷取內容

欄位對應在 Yomitan 的 Anki 設定中透過「設定 Anki 卡片格式...」控制項進行設定。在此處，你可以使用一個或多個標記填入所選模型的各個欄位。¹ 標記是由大括號包裹的名稱。建立卡片時，Yomitan 會自動將其替換為查詞結果中對應的組成部分。¹

下方列出的常用標記子集足以滿足製作例句擷取卡片的需求（即根據真實閱讀句子製作的卡片）。每條釋義均引自 Yomitan 官方文件：¹

標記	填入的內容
{expression}	「以漢字表示的詞條（若無漢字則顯示為假名）。」
{reading}	「詞條的假名讀音（對於表述即為讀音的詞條則為空）。」
{furigana}	「上方帶有振假名標註的漢字詞條。」
{sentence}	「來自原文中該詞條所在的句子、引語或片語。」
{sentence-furigana}	「來自原文中該詞條所在的句子、引語或片語，並帶有振假名標註。」
{glossary}	「詞條的釋義列表（輸出格式取決於是否以分組模式運行）。」
{audio}	「來自音訊來源之一的詞條發音音訊（若有）。」
{screenshot}	「新增詞條時擷取的網頁螢幕截圖。」

Yomitan 支援的標記遠不止這些，還包括詞頻資料、音調標註，以及能夠擷取生詞前後句段的克漏字填空（Cloze）三件套等。¹ 上述八個標記已完全能夠支撐標準的「詞彙+語境」卡片。只有當你的筆記類型確實需要特殊欄位時，才需調用其他進階標記。

推薦的基礎對應方案

欄位對應的核心原則是：條目的每一項內容對應 Anki 的一個獨立欄位。「單字」欄位填入 {expression}，「讀音」欄位填入 {reading} 或 {furigana}，「釋義」欄位填入 {glossary}，「例句」欄位填入 {sentence} 或 {sentence-furigana}。可選的「音訊」與「圖像」欄位分別填入 {audio} 與 {screenshot}。¹

這是一種通用的對應架構，而非固化死板的筆記類型。具體的筆記類型視覺排版以及社群中流傳的範本屬於另一範疇。本文著眼於基礎原理，只要包含這些基礎欄位的模型均可正常運作。

首欄位檢查重複項陷阱

Anki 依靠一個關鍵欄位來判斷某張卡片是否屬於新卡。官方文件明確指出：「Anki 預設不允許向牌組中新增重複卡片；它會使用模型中的第一個欄位來偵測重複」。¹

這條規則主導了整個對應的設計：必須將能夠唯一識別卡片的標記對應到模型的第一欄位中——詞彙卡片為 {expression}，漢字卡片為 {character}。¹ 如果第一欄位填入了非唯一內容，或者誤填了整條例文，Anki 就可能將一個全新的單字誤判為重複條目，並靜默導致新增失敗。¹

務必在第一欄位中對應唯一標記

在筆記類型的第一欄位中填入 {expression}（或者漢字卡片的 {character}），因為該欄位是 Anki 的判重主鍵。當某個單字已經存在於牌組中時，Yomitan 只會提供「新增重複卡片」選項，或者在禁止重複時完全不顯示新增按鈕。¹

擷取製卡工作流程：瀏覽、懸浮、加號

瀏覽、懸浮、加號

在連接架設完畢後，例句擷取只需三步操作：在瀏覽器中閱讀日文原版文字；按住設定的修飾鍵懸停在單字上喚出 Yomitan 快顯視窗；點選新增圖示將卡片傳送到你指定的牌組中。¹

快顯視窗上的新增圖示正是一鍵製卡承諾的體現。文件結合範例詞描述道：「點選[圖示]會新增當前的表達（例如 食べる）」，而第二個圖示則用於新增該表達的讀音。¹

食たべる¹
「吃」（文件中展示透過加號按鈕新增的範例詞）

如果快顯視窗中完全沒有出現新增圖示，通常是上游通訊鏈路出了問題。官方文件給出的解決辦法是「確保 Anki 正在背景運行」，這直接對應了 AnkiConnect 必須處於運行狀態的要求。¹

單字卡 vs 語境例句卡

純單字卡與語境例句卡的區別完全取決於你對應了哪些標記。純單字卡只對應 {expression}、{reading} 和 {glossary}。而語境例句卡則額外增加了 {sentence} 或 {sentence-furigana}，用於擷取「原文中該詞條所在的句子、引語或片語」。¹

{sentence} 擷取的內容取決於頁面上生詞周邊的上下文文字，並非固定靜態值。¹ 克漏字填空標記則會將擷取出的句子以生詞為界進行切分，這也是從同一次查詞中產生填空題卡片樣式的技術原理。¹

音訊與螢幕截圖

{audio} 會插入「來自音訊來源之一的詞條發音音訊（若有）」。該表述包含兩層限制：它僅從已設定的音訊來源中拉取，且前提是該詞條確實存在對應音訊。¹ {screenshot} 會插入「新增詞條時所截取的網頁螢幕截圖」。¹

這兩個欄位均為可選項，且受來源制約。音訊來源的設定需在 Yomitan 自身的「音訊」設定中完成，而非在 Anki 標籤頁中。該部分設定屬於先決基礎工作，本文預設已經就緒。

注意事項

保持牌組精簡，克制製卡數量

例句擷取牌組的膨脹速度非常驚人。一個充斥著似懂非懂詞彙的龐大牌組，其複習負擔遠重於一個只記錄真正阻礙理解的核心生詞的小牌組。只擷取那些切實阻礙你閱讀理解的生詞，切忌把捲動螢幕遇到的每一個未知詞彙統統製卡。

關於卡片價值的取捨標準以及多少新卡算過量，屬於「例句擷取：從閱讀素材中建構專屬日語 Anki 牌組」的方法論範疇。本文僅負責提供把卡片存入牌組的工具鏈路。

加號按鈕變灰或消失時的疑難排解步驟

當新增按鈕或圖示無法點選時，通常是由以下四種原因之一導致的。請按順序進行排查，因為第一種情況最為常見：

第一，Anki 尚未開啟。此時完全不顯示任何圖示，解決方法是啟動 Anki，因為「Anki 必須在背景保持運行」。²¹ 第二，AnkiConnect 未安裝或無法存取。在瀏覽器中打開 localhost:8765 確認是否能看到 AnkiConnect 橫幅。²

第三，Yomitan 中未選定牌組或筆記類型。這兩項均需明確指定，卡片才能被新增。¹ 第四，該單字與第一欄位產生重複。在這種情況下，Yomitan 只會顯示「新增重複卡片」或不顯示新增按鈕，因為 Anki「使用模型中的第一欄位來偵測重複」。¹

閱讀器、OCR 與字幕工具的共同歸宿

這套 Yomitan + Anki 管線是更廣泛的數位化閱讀工具鏈的最終卡片出口，並非孤立的小技巧。瀏覽器端電子書閱讀器、漫畫 OCR 文字層以及影片字幕擷取工具都能產生 Yomitan 在懸浮時可識別的文字。它們最終都將製作的卡片輸送給同一個橋接器。

只需完成一次欄位對應，所有這些語料來源都能透過相同的「瀏覽-懸浮-加號」閉環，匯入同一個 Anki 牌組之中。

參見

• Yomitan (Yomichan)：懸浮查詞字典工作流程
• 查詞還是推測：日語閱讀中的查詞時機
• 針對日語學習者的 Kindle 指南
• 當 SRS 適得其反：Anki 倦怠、難纏卡片與退出訊號
• 為何使用 Anki 變得痛苦（以及如何解決）：診斷與分流指南

References

Footnotes

1. Yomitan project. "Anki Integration." Yomitan Documentation (yomitan.wiki). https://yomitan.wiki/anki/ . UI labels and the complete field-marker reference; labels are app-version-dependent and may drift. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹ ↩¹⁰ ↩¹¹ ↩¹² ↩¹³ ↩¹⁴ ↩¹⁵ ↩¹⁶ ↩¹⁷ ↩¹⁸ ↩¹⁹ ↩²⁰ ↩²¹ ↩²² ↩²³ ↩²⁴ ↩²⁵ ↩²⁶ ↩²⁷ ↩²⁸ ↩²⁹

2. AnkiConnect (FooSoft / Alex Yatskov). AnkiConnect README ("Installation," "Requirements"). Canonical project home: https://foosoft.net/projects/anki-connect/ ; source repository: https://git.sr.ht/~foosoft/anki-connect . README text quoted here was read from the public mirror at https://raw.githubusercontent.com/amikey/anki-connect/master/README.md (identical to the FooSoft README). ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹ ↩¹⁰ ↩¹¹ ↩¹²

3. AnkiConnect. AnkiWeb shared add-on listing, add-on code 2055492159. https://ankiweb.net/shared/info/2055492159 — the canonical install listing; the numeric code is the install identifier. ↩