How it works · 原理
What this app is doing, and why
Optional background. You don't need any of this to use the app, but if you want to know what's behind the numbers and the practice, it's here.
The goal

Why 900 hours

The US Foreign Service Institute puts full professional proficiency in Mandarin at around 2,200 hours of study, the most for any language they teach. Functional fluency is a lower bar: comfortable everyday conversation, about level 2 on the ILR scale. This app targets roughly 900 hours of focused practice to reach it.

The Cockpit counts toward that number using the hours you actually practice. The count moves only while you're drilling or reading, so it reflects time on task rather than time with the app open. There's no fluency percentage and no daily streak, because neither one tells you how much Mandarin you can use.

Memory

Spaced repetition

Every word you learn is tracked on a review schedule. When you get a word right, the time until its next review gets longer. When you miss it, the word comes back sooner. The aim is to see each word again just before you'd forget it, which builds long-term memory with far fewer reviews than going over everything on a fixed cycle. Today's run is assembled from the words that are due.

Practice

The four drills

Each run mixes short drills, one item at a time:

Recall. See a character, choose its meaning. This trains recognition, the skill you use when reading.
Tones. Hear a word and pick the tone you heard. Tones carry meaning in Mandarin, so they get their own practice.
Sentences. Put scrambled characters into the right order to match an English prompt. This builds a feel for word order.
Forge. Read an English prompt and type the Mandarin in pinyin. An AI checks it and explains what to fix. This is the one drill where you produce the language yourself.
Reading

Comprehensible input

The Reading tab shows real example sentences, ordered by how many of their characters you already know. Sentences you can fully read come first, then ones with a character or two that are new. The idea, from second-language research, is that you learn most from material you can nearly understand: familiar enough to follow, with a little that's new to stretch you. As your vocabulary grows, more sentences open up.

Personalization

How your goal shapes things

When you set a goal, every word and sentence is tagged by topic and situation, and the ones that fit your goal are weighted up. For You ranks words on three factors: how common the word is, how it fits your current level, and how well it matches your goal. Your goal also shifts the order of the Reading sentences.

The Balance setting decides how much of that ranking comes from your goal versus broad, high-frequency words that are useful no matter what you're learning for.

Reference

What each setting does

Theme & Accent color. Appearance only. Paper, Ink, or Jade, with an accent color in Ink mode.
Today's run layout. Whether the Cockpit shows the run as a single button, a quick-pick grid, or a list.
Word voice. Male or female voice for single-word audio. Sentences always use a separate, natural-sounding voice.
Your goal, Balance & Refine goal. Everything that personalizes For You and Reading, described above.
Number font & Engineering grid. Cosmetic. The font used for large numbers, and a faint graph-paper background.