Morphowiki

入門設定指南

從零開始，預計十五分鐘內即可執行首次 /ingest 指令，見證英文單字被自動拆解並儲存至本機字典檔的完整過程。

Getting Started

From zero to your first /ingest in about fifteen minutes — watch one English word get broken into morphemes and saved as a dictionary file on your own computer.

專案核心理念

您可能已熟悉 ChatGPT、Claude 或 Gemini 等 LLM（大型語言模型，即對話式 AI）。Morphowiki 並非單純的對話工具，而是一套輔助您「建構」個人化字彙庫的自動化系統：您輸入的每個單字都會被拆解為字首、字根與字尾，並以 Markdown 格式儲存於本機。這方便您日後隨時複習，甚至能使用 Git 進行版本控管。

本頁面的主要目標是：引導您順利完成一次完整的工作流程。一旦看到第一個單字檔成功建立在硬碟中，後續進階細節即可舉一反三。

Why this exists

You've probably heard of ChatGPT, Claude, or Gemini — these are LLMs (Large Language Models, the AIs you can chat with). Morphowiki is not another chat site. It's a toolkit that uses an LLM to accumulate a personal word library for you: every English word you feed it gets broken into prefix / root / suffix and saved as Markdown files on your own computer. You can review them yourself, or version-control them with Git.

The only goal of this page is to get you through the loop once. Once you see your first dictionary file appear on disk, the deeper details can wait.

執行範例：單字收錄流程

稍後您將在 Claude Code 的輸入介面執行：

/ingest unbelievable

Claude Code 接收指令後，會自動執行以下四項步驟（無需手動作業）：

  1. 將 unbelievable 拆解為語素（Morpheme，即「具意義的最小組件」）：un-（否定字首）+ believe（字根：相信）+ -able（形容詞字尾：可…的）。
  2. 查詢各語素詞源、撰寫中文釋義，並生成記憶輔助說明。
  3. 將完整分析結果儲存為 dictionary/words/unbelievable.md。
  4. 同步更新 dictionary/prefix/un.md、dictionary/root/believe.md 與 dictionary/suffix/able.md，在其「Words containing this」區塊建立反向連結。

開啟 dictionary/words/unbelievable.md 後，您會看到如下內容： 

---
word: unbelievable
pos: adj.
ipa: /ˌʌn.bɪˈliː.və.bəl/
added: 2026-05-24
---

# unbelievable

**詞性**: adj.
**IPA**: /ˌʌn.bɪˈliː.və.bəl/
**中文釋義**: 難以置信的;極好的(口語)

## 拆解
- 字首: [[../prefix/un-]] `un-` — 否定字首
- 字根: [[../root/believe]] `believe` — 相信
- 字尾: [[../suffix/-able]] `-able` — 可以…的

## 詞源
un-(古英語否定字首)+ believe(古英語 belyfan,相信)
+ -able(拉丁語 -abilis,能夠承受…的)

## 記憶法
「無法相信的」字面直譯。和 incredible 是同義字,字面拆解
一樣是「不+相信」。

## 筆記區

從按下 Enter 到檔案產出，整個過程僅需約十秒。

請注意：區塊標題（## 拆解、## 詞源、## 記憶法、## 筆記區）採固定中文字串，係因複習系統的 server.js 需以此識別內容。內容本身（釋義、詞源說明、記憶文字）則會根據 CLAUDE.md 的語系設定而定；詳見 自訂與微調。

A concrete example: one word from keyboard to disk

In a moment, you'll type this into the Claude Code prompt:

/ingest unbelievable

Claude Code receives the command and does four things (no manual work from you):

  1. Splits unbelievable into morphemes (a morpheme is the smallest unit of meaning): un- (negative prefix) + believe (root: to believe) + -able (adjective suffix: capable of being…).
  2. Looks up each morpheme's etymology, writes a short definition, and invents a mnemonic.
  3. Saves the whole result as dictionary/words/unbelievable.md.
  4. Also updates dictionary/prefix/un.md, dictionary/root/believe.md, and dictionary/suffix/able.md — adding a back-link in their "Words containing this" section.

If you open dictionary/words/unbelievable.md in any text editor, you'll see something like: 

---
word: unbelievable
pos: adj.
ipa: /ˌʌn.bɪˈliː.və.bəl/
added: 2026-05-24
---

# unbelievable

**詞性**: adj.
**IPA**: /ˌʌn.bɪˈliː.və.bəl/
**中文釋義**: Impossible to believe; (informal) extraordinary, amazing.

## 拆解
- 字首: [[../prefix/un-]] `un-` — negative prefix
- 字根: [[../root/believe]] `believe` — to accept as true
- 字尾: [[../suffix/-able]] `-able` — capable of being

## 詞源
un- (Old English negative prefix) + believe (Old English
belyfan, to hold dear, trust) + -able (Latin -abilis, able
to undergo).

## 記憶法
Literally "not + believable". Same surface logic as
"incredible", which is "not + credible".

## 筆記區

From pressing Enter to the file appearing on disk takes about ten seconds.

Note: the section headings (## 拆解, ## 詞源, ## 記憶法, ## 筆記區) stay in Chinese because the review web app's server.js parses files by those exact names. Only the values inside (definitions, etymology prose, mnemonic text) follow the locale you set in CLAUDE.md — see Customize & tune.

逐步操作

  1. 安裝 Claude Code。 Claude Code 是 Anthropic 官方的命令列工具,讓你在終端機裡跟 Claude 對話。到 https://claude.com/claude-code 下載,跟著官網的安裝步驟做完。

    三大作業系統小提示:

    • Windows:用 winget install Anthropic.Claude,或從官網下載安裝包。
    • macOS:用 brew install --cask claude。
    • Linux:官網有 tarball,解壓後把執行檔放進 $PATH。

    裝完打開終端機(Windows 用 PowerShell 或 Windows Terminal,macOS / Linux 用內建的 Terminal),輸入 claude --version,有版本號就成功。

  2. (建議)安裝 Node.js v18 或更新。 之後的複習網頁(/review-word)需要它。現在沒裝也可以繼續,但晚點會被擋住。Windows 用 winget install OpenJS.NodeJS.LTS;macOS 用 brew install node;Linux 用各自的套件管理員(apt、dnf…)。

  3. 下載 Morphowiki 這個專案。 兩種方法擇一:

    • 會用 Git:git clone https://github.com/<owner>/Morphowiki.git
    • 不會用 Git:在 GitHub 專案頁面按綠色的 Code → Download ZIP,解壓到你喜歡的位置(例如 Documents/Morphowiki)。

  4. 用 Claude Code 打開這個資料夾。 在終端機裡 cd 到你剛剛解壓 / clone 出來的 Morphowiki 資料夾,然後輸入: 

    claude

    畫面會切換到 Claude Code 的對話模式。看到提示符號(像一個輸入框)就代表你進來了。

  5. 跑 /setup。 在 Claude Code 的輸入框裡打: 

    /setup

    按 Enter。它會幫你:檢查 Node.js、建立 dictionary/ 與 review/ 等資料夾、把約 150 個常見功能字(the / a / is …)寫進 dictionary/stopwords.md 當白名單、預先安裝複習網頁的相依套件。整個過程一兩分鐘,最後會印一份報告告訴你每一步成功或跳過。

  6. 跑你的第一個 /ingest。 在同一個 Claude Code 視窗,接著打: 

    /ingest unbelievable

    等十幾秒,Claude 會回報「已建立 dictionary/words/unbelievable.md,並更新了 un、believe、able 三個語素檔」。

  7. 打開檔案確認。 用你慣用的文字編輯器(VS Code、Sublime Text、記事本都可以)打開 dictionary/words/unbelievable.md。內容會長得像上面「具體範例」那塊。看到 frontmatter(檔案最上面被三條橫線夾起來的 YAML 區塊)、拆解、詞源、記憶法都齊全,就代表整條流程通了。

Step by step

  1. Install Claude Code. Claude Code is Anthropic's official command-line tool — the program you use to talk to Claude inside a terminal. Go to https://claude.com/claude-code and follow the installer instructions.

    Quick OS hints:

    • Windows: winget install Anthropic.Claude, or download the installer from the site.
    • macOS: brew install --cask claude.
    • Linux: download the tarball from the site, extract it, and put the binary on your $PATH.

    After installing, open a terminal (PowerShell or Windows Terminal on Windows; the built-in Terminal on macOS / Linux) and type claude --version. If you see a version number, you're good.

  2. (Recommended) Install Node.js v18 or newer. The review web app (/review-word) needs it. You can skip this for now, but you'll be blocked later. Windows: winget install OpenJS.NodeJS.LTS. macOS: brew install node. Linux: use your distro's package manager (apt, dnf, …).

  3. Download the Morphowiki project. Pick one:

    • If you use Git: git clone https://github.com/<owner>/Morphowiki.git
    • If you don't: on the GitHub project page, click the green Code → Download ZIP, then unzip into a folder you like (for example Documents/Morphowiki).

  4. Open the folder with Claude Code. In your terminal, cd into the Morphowiki folder you just unpacked or cloned, then type: 

    claude

    The terminal switches into Claude Code's chat mode. When you see the prompt box, you're inside.

  5. Run /setup. In the Claude Code prompt, type: 

    /setup

    Press Enter. It checks Node.js, creates the dictionary/ and review/ folders, seeds about 150 common function words (the / a / is …) into dictionary/stopwords.md as an allow-list, and pre-installs the review app's dependencies. The whole thing takes a minute or two and ends with a report telling you which steps succeeded or were skipped.

  6. Run your first /ingest. In the same Claude Code window, type: 

    /ingest unbelievable

    After ten or fifteen seconds, Claude will report something like "created dictionary/words/unbelievable.md and updated the three morpheme files un, believe, able."

  7. Open the file to confirm. Use any text editor (VS Code, Sublime Text, Notepad) and open dictionary/words/unbelievable.md. It will look like the sample in the "concrete example" section above. If you see the frontmatter (the YAML block at the top wrapped in three-dash lines), the breakdown, the etymology, and the mnemonic, you've just completed the full loop.

常見錯誤與下一步

常見錯誤:

  • 把 /setup 打成 /init。 /init 是 Claude Code 內建的指令,會幫你生成一份介紹專案的 CLAUDE.md,但不會建本專案要的資料夾結構。本專案永遠用 /setup。
  • 在錯的資料夾跑指令。 Claude Code 的 skill 會把檔案寫進「你啟動 claude 時所在的資料夾」。一定要先 cd 進 Morphowiki 再執行 claude,否則 dictionary/ 會出現在你不想要的位置。
  • Node.js 沒裝。 /setup 會繼續執行,但晚點 /review-word 想開複習網頁時會失敗。先裝好可以省事。完整的複習流程在 /review-word 頁面。
  • 把 wiki-link 路徑寫成絕對路徑。 字典檔內所有 [[../prefix/un]] 都是相對路徑,別手動改成 C:\Users\… 之類的絕對路徑,會讓 /lint 報錯。

下一步:

Common mistakes & next steps

Common mistakes:

  • Typing /init instead of /setup. /init is a Claude Code built-in that generates a CLAUDE.md describing your project. It will not create the folder structure this project needs. For Morphowiki, always use /setup.
  • Running commands from the wrong folder. Claude Code skills write files into whichever folder you were in when you launched claude. Always cd into Morphowiki first, then run claude, or your dictionary/ will end up somewhere unexpected.
  • Node.js not installed yet. /setup still finishes, but /review-word will fail later when you try to open the review site. Installing Node now saves a detour. Full review walkthrough on the /review-word page.
  • Hand-editing wiki-links into absolute paths. All [[../prefix/un]] links inside dictionary files are relative. Don't rewrite them as C:\Users\… style absolute paths — /lint will flag every one.

Next: