From dbb80fdb6174bc96ff9183556e72c153cb58f072 Mon Sep 17 00:00:00 2001
From: Hanjie Deng <87105391+floatDreamWithSong@users.noreply.github.com>
Date: Wed, 26 Aug 2026 10:46:28 +0800
Subject: [PATCH 1/4] feat: add context-aware lecture profiles

---
 .../configuration/SettingsPage.test.tsx       |  14 ++
 src/features/configuration/SettingsPage.tsx   | 131 +++++++++++++++++-
 src/features/i18n/UiPreferencesProvider.tsx   |  29 ++++
 .../interpretation/context-policy.test.ts     |  81 +++++++++++
 src/features/interpretation/context-policy.ts |  72 ++++++++++
 src/features/profile/ProfileProvider.tsx      |   5 +-
 src/features/profile/domain.test.ts           |   7 +
 src/features/profile/domain.ts                |  46 +++++-
 8 files changed, 377 insertions(+), 8 deletions(-)
 create mode 100644 src/features/interpretation/context-policy.test.ts
 create mode 100644 src/features/interpretation/context-policy.ts

diff --git a/src/features/configuration/SettingsPage.test.tsx b/src/features/configuration/SettingsPage.test.tsx
index edd0c2a..9f0549a 100644
--- a/src/features/configuration/SettingsPage.test.tsx
+++ b/src/features/configuration/SettingsPage.test.tsx
@@ -36,6 +36,20 @@ describe("SettingsPage", () => {
     expect(inputValue("托盘点击行为")).toBe("toggle-runtime")
   })
 
+  test("configures natural EU treaty reform lecture context", () => {
+    renderSettingsPage()
+
+    expect(inputValue("语境模式")).toBe("lecture")
+    expect(inputValue("课程主题")).toBe("eu-treaty-reform")
+    fireEvent.change(screen.getByLabelText("自定义术语（每行一个）"), {
+      target: { value: "constitutional convention\nacquis communautaire" },
+    })
+
+    expect(
+      screen.getByLabelText<HTMLTextAreaElement>("自定义术语（每行一个）").value
+    ).toContain("acquis communautaire")
+  })
+
   test("switches UI language independently from AST API key settings", () => {
     renderSettingsPage()
 
diff --git a/src/features/configuration/SettingsPage.tsx b/src/features/configuration/SettingsPage.tsx
index 59f92b6..87295f9 100644
--- a/src/features/configuration/SettingsPage.tsx
+++ b/src/features/configuration/SettingsPage.tsx
@@ -163,9 +163,7 @@ export function SettingsPage() {
                       app: {
                         ...profile.app,
                         closeBehavior: event.target.value as
-                          | "exit"
-                          | "minimize"
-                          | "minimize-to-tray",
+                          "exit" | "minimize" | "minimize-to-tray",
                       },
                     }))
                   }
@@ -193,8 +191,7 @@ export function SettingsPage() {
                       app: {
                         ...profile.app,
                         trayClickBehavior: event.target.value as
-                          | "open-main-window"
-                          | "toggle-runtime",
+                          "open-main-window" | "toggle-runtime",
                       },
                     }))
                   }
@@ -210,6 +207,130 @@ export function SettingsPage() {
             </div>
           </section>
 
+          <section className="rounded-md border border-zinc-200 bg-white p-4 lg:col-span-2">
+            <h2 className="text-base font-semibold">{t("settings.context")}</h2>
+            <p className="mt-1 text-sm text-zinc-500">
+              {t("settings.context.description")}
+            </p>
+            <div className="mt-4 grid gap-4 md:grid-cols-2">
+              <label className="block">
+                <span className="text-sm font-medium">
+                  {t("settings.context.mode")}
+                </span>
+                <select
+                  className="mt-2 h-10 w-full rounded-md border border-zinc-300 px-3 text-sm"
+                  value={activeProfile.interpretationContext.mode}
+                  onChange={(event) =>
+                    updateActiveProfile((profile) => ({
+                      ...profile,
+                      interpretationContext: {
+                        ...profile.interpretationContext,
+                        mode: event.target.value as "general" | "lecture",
+                      },
+                    }))
+                  }
+                >
+                  <option value="lecture">
+                    {t("settings.context.mode.lecture")}
+                  </option>
+                  <option value="general">
+                    {t("settings.context.mode.general")}
+                  </option>
+                </select>
+              </label>
+
+              <label className="block">
+                <span className="text-sm font-medium">
+                  {t("settings.context.topic")}
+                </span>
+                <select
+                  className="mt-2 h-10 w-full rounded-md border border-zinc-300 px-3 text-sm"
+                  value={activeProfile.interpretationContext.topicPreset}
+                  onChange={(event) =>
+                    updateActiveProfile((profile) => ({
+                      ...profile,
+                      interpretationContext: {
+                        ...profile.interpretationContext,
+                        topicPreset: event.target.value as
+                          "none" | "eu-treaty-reform",
+                      },
+                    }))
+                  }
+                >
+                  <option value="eu-treaty-reform">
+                    {t("settings.context.topic.euTreatyReform")}
+                  </option>
+                  <option value="none">
+                    {t("settings.context.topic.none")}
+                  </option>
+                </select>
+              </label>
+
+              <label className="block">
+                <span className="text-sm font-medium">
+                  {t("settings.context.depth")}
+                </span>
+                <input
+                  className="mt-2 h-10 w-full rounded-md border border-zinc-300 px-3 text-sm"
+                  type="number"
+                  min={1}
+                  max={8}
+                  value={activeProfile.interpretationContext.contextDepth}
+                  onChange={(event) =>
+                    updateActiveProfile((profile) => ({
+                      ...profile,
+                      interpretationContext: {
+                        ...profile.interpretationContext,
+                        contextDepth: Number(event.target.value),
+                      },
+                    }))
+                  }
+                />
+              </label>
+
+              <label className="flex items-center gap-3 self-end pb-2 text-sm font-medium">
+                <input
+                  type="checkbox"
+                  checked={
+                    activeProfile.interpretationContext.automaticCorrection
+                  }
+                  onChange={(event) =>
+                    updateActiveProfile((profile) => ({
+                      ...profile,
+                      interpretationContext: {
+                        ...profile.interpretationContext,
+                        automaticCorrection: event.target.checked,
+                      },
+                    }))
+                  }
+                />
+                {t("settings.context.automaticCorrection")}
+              </label>
+
+              <label className="block md:col-span-2">
+                <span className="text-sm font-medium">
+                  {t("settings.context.customTerms")}
+                </span>
+                <textarea
+                  className="mt-2 min-h-24 w-full rounded-md border border-zinc-300 p-3 text-sm"
+                  placeholder={t("settings.context.customTermsPlaceholder")}
+                  value={activeProfile.interpretationContext.customTerms.join(
+                    "\n"
+                  )}
+                  onChange={(event) =>
+                    updateActiveProfile((profile) => ({
+                      ...profile,
+                      interpretationContext: {
+                        ...profile.interpretationContext,
+                        customTerms: event.target.value.split(/\r?\n/),
+                      },
+                    }))
+                  }
+                />
+              </label>
+            </div>
+          </section>
+
           <section className="rounded-md border border-zinc-200 bg-white p-4 lg:col-span-2">
             <h2 className="text-base font-semibold">{t("settings.ast")}</h2>
             <div className="mt-4">
diff --git a/src/features/i18n/UiPreferencesProvider.tsx b/src/features/i18n/UiPreferencesProvider.tsx
index 8125fc4..0de58b2 100644
--- a/src/features/i18n/UiPreferencesProvider.tsx
+++ b/src/features/i18n/UiPreferencesProvider.tsx
@@ -133,6 +133,20 @@ const translations = {
     "settings.tray.openMain": "打开主窗口",
     "settings.tray.toggleRuntime": "启动或停止运行",
     "settings.ast": "Volcengine AST",
+    "settings.context": "课堂语境",
+    "settings.context.description":
+      "让识别贴近真实课堂表达，只修正高置信度术语，不强制改写普通句子。",
+    "settings.context.mode": "语境模式",
+    "settings.context.mode.lecture": "自然课堂",
+    "settings.context.mode.general": "通用",
+    "settings.context.topic": "课程主题",
+    "settings.context.topic.euTreatyReform": "Treaty Reform in the EU",
+    "settings.context.topic.none": "无预设",
+    "settings.context.depth": "上下文句数（1–8）",
+    "settings.context.automaticCorrection": "自动修正稳定字幕中的课程术语",
+    "settings.context.customTerms": "自定义术语（每行一个）",
+    "settings.context.customTermsPlaceholder":
+      "例如：constitutional convention",
     "settings.ast.apiKey": "AST API Key",
     "settings.language": "界面语言",
     "settings.language.zh-CN": "中文",
@@ -262,6 +276,21 @@ const translations = {
     "settings.tray.openMain": "Open main window",
     "settings.tray.toggleRuntime": "Start or stop runtime",
     "settings.ast": "Volcengine AST",
+    "settings.context": "Lecture context",
+    "settings.context.description":
+      "Follow natural classroom speech and correct only high-confidence terminology without rewriting ordinary sentences.",
+    "settings.context.mode": "Context mode",
+    "settings.context.mode.lecture": "Natural lecture",
+    "settings.context.mode.general": "General",
+    "settings.context.topic": "Course topic",
+    "settings.context.topic.euTreatyReform": "Treaty Reform in the EU",
+    "settings.context.topic.none": "No preset",
+    "settings.context.depth": "Context utterances (1–8)",
+    "settings.context.automaticCorrection":
+      "Correct course terms in stable subtitles",
+    "settings.context.customTerms": "Custom terms (one per line)",
+    "settings.context.customTermsPlaceholder":
+      "For example: constitutional convention",
     "settings.ast.apiKey": "AST API key",
     "settings.language": "Interface language",
     "settings.language.zh-CN": "中文",
diff --git a/src/features/interpretation/context-policy.test.ts b/src/features/interpretation/context-policy.test.ts
new file mode 100644
index 0000000..e83f621
--- /dev/null
+++ b/src/features/interpretation/context-policy.test.ts
@@ -0,0 +1,81 @@
+import { describe, expect, test } from "vitest"
+
+import { createDefaultActiveProfile } from "@/features/profile/domain"
+
+import {
+  applyInterpretationContext,
+  buildInterpretationContext,
+} from "./context-policy"
+
+describe("interpretation context policy", () => {
+  const settings = createDefaultActiveProfile().interpretationContext
+
+  test("combines the EU treaty reform preset with custom lecture terms", () => {
+    const context = buildInterpretationContext({
+      ...settings,
+      customTerms: ["constitutional convention"],
+    })
+
+    expect(context.terms).toContain("Treaty of Lisbon")
+    expect(context.terms).toContain("constitutional convention")
+    expect(context.contextDepth).toBe(3)
+  })
+
+  test("corrects high-confidence terminology only after an utterance stabilizes", () => {
+    const update = {
+      segmentId: "segment-1",
+      channel: "source" as const,
+      text: "the principle of subsidiary shaped treaty reformation",
+      final: true,
+      revised: false,
+      providerSequence: 1,
+      receivedAtMs: 1_000,
+    }
+
+    expect(applyInterpretationContext(update, settings).text).toBe(
+      "the principle of subsidiarity shaped treaty reform"
+    )
+    expect(
+      applyInterpretationContext(
+        { ...update, final: false, text: "principle of subsidiary" },
+        settings
+      ).text
+    ).toBe("principle of subsidiary")
+  })
+
+  test("leaves general mode text untouched", () => {
+    const update = {
+      segmentId: "segment-1",
+      channel: "source" as const,
+      text: "treaty reformation",
+      final: true,
+      revised: false,
+      providerSequence: 1,
+      receivedAtMs: 1_000,
+    }
+
+    expect(
+      applyInterpretationContext(update, { ...settings, topicPreset: "none" })
+    ).toBe(update)
+  })
+
+  test("normalizes custom terms without enabling the course preset", () => {
+    const update = {
+      segmentId: "segment-2",
+      channel: "source" as const,
+      text: "the acquis communautaire remains relevant",
+      final: true,
+      revised: false,
+      providerSequence: 2,
+      receivedAtMs: 2_000,
+    }
+
+    expect(
+      applyInterpretationContext(update, {
+        ...settings,
+        topicPreset: "none",
+        customTerms: ["Acquis Communautaire"],
+      }).text
+    ).toBe("the Acquis Communautaire remains relevant")
+  })
+})
diff --git a/src/features/interpretation/context-policy.ts b/src/features/interpretation/context-policy.ts
new file mode 100644
index 0000000..75f3e49
--- /dev/null
+++ b/src/features/interpretation/context-policy.ts
@@ -0,0 +1,72 @@
+import type {
+  InterpretationContextSettings,
+  SubtitleUpdate,
+} from "@/features/profile/domain"
+
+const euTreatyReformTerms = [
+  "treaty reform",
+  "European Union",
+  "Treaty of Lisbon",
+  "Treaty on European Union",
+  "Treaty on the Functioning of the European Union",
+  "subsidiarity",
+  "proportionality",
+  "qualified majority voting",
+  "ordinary legislative procedure",
+  "European Council",
+  "European Commission",
+] as const
+
+const euTreatyReformCorrections: Array<[RegExp, string]> = [
+  [/\btreaty reformation\b/gi, "treaty reform"],
+  [/\bprinciple of subsidiary\b/gi, "principle of subsidiarity"],
+  [/\bqualified majority vote\b/gi, "qualified majority voting"],
+  [/\bLisbon treaty\b/gi, "Treaty of Lisbon"],
+]
+
+/** Produces provider-neutral hints without coupling Profile state to one ASR API. */
+export function buildInterpretationContext(
+  settings: InterpretationContextSettings
+) {
+  const presetTerms =
+    settings.topicPreset === "eu-treaty-reform" ? [...euTreatyReformTerms] : []
+
+  return {
+    mode: settings.mode,
+    contextDepth: settings.contextDepth,
+    terms: [...new Set([...presetTerms, ...settings.customTerms])],
+  }
+}
+
+/** Applies only high-confidence terminology fixes to stable subtitle updates. */
+export function applyInterpretationContext(
+  update: SubtitleUpdate,
+  settings: InterpretationContextSettings
+): SubtitleUpdate {
+  if (!settings.automaticCorrection || (!update.final && !update.revised)) {
+    return update
+  }
+
+  const presetCorrections =
+    settings.topicPreset === "eu-treaty-reform" ? euTreatyReformCorrections : []
+  const text = presetCorrections.reduce(
+    (current, [pattern, replacement]) => current.replace(pattern, replacement),
+    update.text
+  )
+  const normalizedText = settings.customTerms.reduce(
+    (current, term) =>
+      current.replace(
+        new RegExp(`\\b${escapeRegExp(term.trim())}\\b`, "gi"),
+        term.trim()
+      ),
+    text
+  )
+
+  return normalizedText === update.text
+    ? update
+    : { ...update, text: normalizedText }
+}
+
+function escapeRegExp(value: string) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+}
diff --git a/src/features/profile/ProfileProvider.tsx b/src/features/profile/ProfileProvider.tsx
index d2245a8..d3414fc 100644
--- a/src/features/profile/ProfileProvider.tsx
+++ b/src/features/profile/ProfileProvider.tsx
@@ -14,6 +14,7 @@ import {
   astProviderEventToSubtitleUpdate,
   runtimeErrorFromASTEvent,
 } from "@/features/interpretation/ast-events"
+import { applyInterpretationContext } from "@/features/interpretation/context-policy"
 import { NativeVolcengineASTStartSessionProbeBridge } from "@/features/interpretation/ast-provider"
 import type { VolcengineASTProvider } from "@/features/interpretation/ast-provider"
 import {
@@ -413,7 +414,9 @@ export function ProfileProvider({
         return
       }
 
-      const subtitles = subtitleBuffer.apply(update)
+      const subtitles = subtitleBuffer.apply(
+        applyInterpretationContext(update, activeProfile.interpretationContext)
+      )
       setRuntime((current) => ({
         ...current,
         subtitles,
diff --git a/src/features/profile/domain.test.ts b/src/features/profile/domain.test.ts
index 8c2bb2a..80a2f5c 100644
--- a/src/features/profile/domain.test.ts
+++ b/src/features/profile/domain.test.ts
@@ -34,6 +34,13 @@ describe("Profile domain contracts", () => {
     expect(profile.voice).not.toHaveProperty("outputChannelId")
     expect(profile.app.closeBehavior).toBe("minimize-to-tray")
     expect(profile.app.trayClickBehavior).toBe("open-main-window")
+    expect(profile.interpretationContext).toEqual({
+      mode: "lecture",
+      topicPreset: "eu-treaty-reform",
+      contextDepth: 3,
+      automaticCorrection: true,
+      customTerms: [],
+    })
     expect(profile.volcengineAST).toMatchObject({
       endpoint: "wss://openspeech.bytedance.com/api/v4/ast/v2/translate",
       resourceId: "volc.service_type.10053",
diff --git a/src/features/profile/domain.ts b/src/features/profile/domain.ts
index 3d93381..0096378 100644
--- a/src/features/profile/domain.ts
+++ b/src/features/profile/domain.ts
@@ -45,8 +45,7 @@ export type BasicAudioInputTarget = {
 
 /** Structured target saved with a Profile audio source. */
 export type AudioInputTarget =
-  | BasicAudioInputTarget
-  | WindowsApplicationAudioTarget
+  BasicAudioInputTarget | WindowsApplicationAudioTarget
 
 /** A user-selectable system, app, window, device, file, or mock audio source. */
 export type AudioInputSource = {
@@ -132,6 +131,15 @@ export type AppSettings = {
   trayClickBehavior: "open-main-window" | "toggle-runtime"
 }
 
+/** Context hints used to keep lecture recognition natural and terminology stable. */
+export type InterpretationContextSettings = {
+  mode: "general" | "lecture"
+  topicPreset: "none" | "eu-treaty-reform"
+  contextDepth: number
+  automaticCorrection: boolean
+  customTerms: Array<string>
+}
+
 /** Volcengine AST authentication and endpoint settings. */
 export type VolcengineASTSettings = {
   endpoint: string
@@ -150,6 +158,7 @@ export type ActiveProfile = {
   voice: VoiceSettings
   runtimeControl: RuntimeControlSettings
   app: AppSettings
+  interpretationContext: InterpretationContextSettings
   volcengineAST: VolcengineASTSettings
   createdAt: number
   updatedAt: number
@@ -381,6 +390,13 @@ export function createDefaultActiveProfile(
       closeBehavior: "minimize-to-tray",
       trayClickBehavior: "open-main-window",
     },
+    interpretationContext: {
+      mode: "lecture",
+      topicPreset: "eu-treaty-reform",
+      contextDepth: 3,
+      automaticCorrection: true,
+      customTerms: [],
+    },
     volcengineAST: {
       endpoint: VOLCENGINE_AST_ENDPOINT,
       apiKey: "",
@@ -427,10 +443,36 @@ export function normalizeActiveProfile(profile: ActiveProfile): ActiveProfile {
     audio: normalizeAudioSettings(profile.audio),
     subtitles: normalizeSubtitleSettings(profile.subtitles),
     voice: normalizeVoiceSettings(profile.voice),
+    interpretationContext: normalizeInterpretationContextSettings(
+      profile.interpretationContext
+    ),
     volcengineAST: normalizeVolcengineASTSettings(profile.volcengineAST),
   } satisfies ActiveProfile
 }
 
+/** Normalizes context settings saved by current and earlier Profile versions. */
+export function normalizeInterpretationContextSettings(
+  settings: Partial<InterpretationContextSettings> | undefined
+): InterpretationContextSettings {
+  const contextDepth = Number.isFinite(settings?.contextDepth)
+    ? Math.min(8, Math.max(1, Math.round(settings?.contextDepth ?? 3)))
+    : 3
+
+  return {
+    mode: settings?.mode === "general" ? "general" : "lecture",
+    topicPreset: settings?.topicPreset === "none" ? "none" : "eu-treaty-reform",
+    contextDepth,
+    automaticCorrection: settings?.automaticCorrection ?? true,
+    customTerms: [
+      ...new Set(
+        (settings?.customTerms ?? [])
+          .map((term) => term.trim())
+          .filter((term) => term.length > 0)
+      ),
+    ].slice(0, 100),
+  } satisfies InterpretationContextSettings
+}
+
 /** Normalizes current and legacy persisted audio settings into the active model. */
 export function normalizeAudioSettings(
   audio: Partial<AudioSettings> & { source?: Partial<AudioInputSource> }

From 9f72c60473b20753d95acfb51faf8d5c9f6777d5 Mon Sep 17 00:00:00 2001
From: Hanjie Deng <87105391+floatDreamWithSong@users.noreply.github.com>
Date: Wed, 26 Aug 2026 11:15:06 +0800
Subject: [PATCH 2/4] fix: connect lecture context controls

---
 src/features/i18n/UiPreferencesProvider.tsx   |  4 +--
 .../interpretation/context-policy.test.ts     | 19 +++++-------
 src/features/interpretation/context-policy.ts | 29 ++++---------------
 src/features/profile/ProfileProvider.tsx      |  9 ++++--
 4 files changed, 22 insertions(+), 39 deletions(-)

diff --git a/src/features/i18n/UiPreferencesProvider.tsx b/src/features/i18n/UiPreferencesProvider.tsx
index 0de58b2..fd18b58 100644
--- a/src/features/i18n/UiPreferencesProvider.tsx
+++ b/src/features/i18n/UiPreferencesProvider.tsx
@@ -142,7 +142,7 @@ const translations = {
     "settings.context.topic": "课程主题",
     "settings.context.topic.euTreatyReform": "Treaty Reform in the EU",
     "settings.context.topic.none": "无预设",
-    "settings.context.depth": "上下文句数（1–8）",
+    "settings.context.depth": "可回溯修订字幕段数（1–8）",
     "settings.context.automaticCorrection": "自动修正稳定字幕中的课程术语",
     "settings.context.customTerms": "自定义术语（每行一个）",
     "settings.context.customTermsPlaceholder":
@@ -285,7 +285,7 @@ const translations = {
     "settings.context.topic": "Course topic",
     "settings.context.topic.euTreatyReform": "Treaty Reform in the EU",
     "settings.context.topic.none": "No preset",
-    "settings.context.depth": "Context utterances (1–8)",
+    "settings.context.depth": "Revisable subtitle segments (1–8)",
     "settings.context.automaticCorrection":
       "Correct course terms in stable subtitles",
     "settings.context.customTerms": "Custom terms (one per line)",
diff --git a/src/features/interpretation/context-policy.test.ts b/src/features/interpretation/context-policy.test.ts
index e83f621..b396b72 100644
--- a/src/features/interpretation/context-policy.test.ts
+++ b/src/features/interpretation/context-policy.test.ts
@@ -4,21 +4,16 @@ import { createDefaultActiveProfile } from "@/features/profile/domain"
 
 import {
   applyInterpretationContext,
-  buildInterpretationContext,
+  subtitleBufferOptionsForContext,
 } from "./context-policy"
 
 describe("interpretation context policy", () => {
   const settings = createDefaultActiveProfile().interpretationContext
 
-  test("combines the EU treaty reform preset with custom lecture terms", () => {
-    const context = buildInterpretationContext({
-      ...settings,
-      customTerms: ["constitutional convention"],
-    })
-
-    expect(context.terms).toContain("Treaty of Lisbon")
-    expect(context.terms).toContain("constitutional convention")
-    expect(context.contextDepth).toBe(3)
+  test("uses context depth as the recent subtitle revision window", () => {
+    expect(
+      subtitleBufferOptionsForContext({ ...settings, contextDepth: 6 })
+    ).toEqual({ revisionWindow: 6 })
   })
 
   test("corrects high-confidence terminology only after an utterance stabilizes", () => {
@@ -43,7 +38,7 @@ describe("interpretation context policy", () => {
     ).toBe("principle of subsidiary")
   })
 
-  test("leaves general mode text untouched", () => {
+  test("leaves preset terminology untouched in general mode", () => {
     const update = {
       segmentId: "segment-1",
       channel: "source" as const,
@@ -55,7 +50,7 @@ describe("interpretation context policy", () => {
     }
 
     expect(
-      applyInterpretationContext(update, { ...settings, topicPreset: "none" })
+      applyInterpretationContext(update, { ...settings, mode: "general" })
     ).toBe(update)
   })
 
diff --git a/src/features/interpretation/context-policy.ts b/src/features/interpretation/context-policy.ts
index 75f3e49..0125989 100644
--- a/src/features/interpretation/context-policy.ts
+++ b/src/features/interpretation/context-policy.ts
@@ -3,20 +3,6 @@ import type {
   SubtitleUpdate,
 } from "@/features/profile/domain"
 
-const euTreatyReformTerms = [
-  "treaty reform",
-  "European Union",
-  "Treaty of Lisbon",
-  "Treaty on European Union",
-  "Treaty on the Functioning of the European Union",
-  "subsidiarity",
-  "proportionality",
-  "qualified majority voting",
-  "ordinary legislative procedure",
-  "European Council",
-  "European Commission",
-] as const
-
 const euTreatyReformCorrections: Array<[RegExp, string]> = [
   [/\btreaty reformation\b/gi, "treaty reform"],
   [/\bprinciple of subsidiary\b/gi, "principle of subsidiarity"],
@@ -24,17 +10,12 @@ const euTreatyReformCorrections: Array<[RegExp, string]> = [
   [/\bLisbon treaty\b/gi, "Treaty of Lisbon"],
 ]
 
-/** Produces provider-neutral hints without coupling Profile state to one ASR API. */
-export function buildInterpretationContext(
+/** Maps context depth to the existing recent-segment revision window. */
+export function subtitleBufferOptionsForContext(
   settings: InterpretationContextSettings
 ) {
-  const presetTerms =
-    settings.topicPreset === "eu-treaty-reform" ? [...euTreatyReformTerms] : []
-
   return {
-    mode: settings.mode,
-    contextDepth: settings.contextDepth,
-    terms: [...new Set([...presetTerms, ...settings.customTerms])],
+    revisionWindow: settings.contextDepth,
   }
 }
 
@@ -48,7 +29,9 @@ export function applyInterpretationContext(
   }
 
   const presetCorrections =
-    settings.topicPreset === "eu-treaty-reform" ? euTreatyReformCorrections : []
+    settings.mode === "lecture" && settings.topicPreset === "eu-treaty-reform"
+      ? euTreatyReformCorrections
+      : []
   const text = presetCorrections.reduce(
     (current, [pattern, replacement]) => current.replace(pattern, replacement),
     update.text
diff --git a/src/features/profile/ProfileProvider.tsx b/src/features/profile/ProfileProvider.tsx
index d3414fc..7750e07 100644
--- a/src/features/profile/ProfileProvider.tsx
+++ b/src/features/profile/ProfileProvider.tsx
@@ -14,7 +14,10 @@ import {
   astProviderEventToSubtitleUpdate,
   runtimeErrorFromASTEvent,
 } from "@/features/interpretation/ast-events"
-import { applyInterpretationContext } from "@/features/interpretation/context-policy"
+import {
+  applyInterpretationContext,
+  subtitleBufferOptionsForContext,
+} from "@/features/interpretation/context-policy"
 import { NativeVolcengineASTStartSessionProbeBridge } from "@/features/interpretation/ast-provider"
 import type { VolcengineASTProvider } from "@/features/interpretation/ast-provider"
 import {
@@ -335,7 +338,9 @@ export function ProfileProvider({
       updatedAt: startedAt,
     })
 
-    const subtitleBuffer = new SubtitleBuffer()
+    const subtitleBuffer = new SubtitleBuffer(
+      subtitleBufferOptionsForContext(activeProfile.interpretationContext)
+    )
     const astAudioPacketizer = new VolcengineASTAudioPacketizer()
     const playedTTSEventKeys = new Set<string>()
     activeASTAudioPacketizer.current = astAudioPacketizer

From 0b0fe6a7a077bf122fad11fbfe4d415c9832ff65 Mon Sep 17 00:00:00 2001
From: Hanjie Deng <87105391+floatDreamWithSong@users.noreply.github.com>
Date: Wed, 26 Aug 2026 11:44:48 +0800
Subject: [PATCH 3/4] docs: add MIT license and Chinese user guide

---
 LICENSE                  |  21 ++++++
 README.md                |   6 ++
 docs/USER_GUIDE.zh-CN.md | 156 +++++++++++++++++++++++++++++++++++++++
 3 files changed, 183 insertions(+)
 create mode 100644 LICENSE
 create mode 100644 docs/USER_GUIDE.zh-CN.md

diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..6949ec7
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanjie Deng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 4dd9fbd..ad9cab7 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,8 @@ curl https://obsidian.daydreamer.net.cn/videos/demo.mp4 --output demo.mp4
 
 VoxBridge 是一款面向 Windows 桌面的 AI 同声传译助手。它用于观看英语或中文演讲、技术分享、国际会议、网课和会议软件音频时，将单向音频流实时识别、翻译为中文字幕，并可在用户显式开启时播放中文语音。
 
+完整的安装、课堂语境配置和故障排查说明见 [中文使用教程](docs/USER_GUIDE.zh-CN.md)。
+
 本项目当前实现聚焦 Windows MVP：采集 Windows 系统音频或指定应用音频，接入火山引擎 AST 同声传译服务，使用浮动字幕窗口呈现实时译文，并通过可变字幕缓冲区支持流式 partial/final 替换与近期字幕修正。
 
 ## 核心交互功能
@@ -164,3 +166,7 @@ Rust 测试：
 ```bash
 cargo test --manifest-path src-tauri/Cargo.toml
 ```
+
+## 许可证
+
+本项目采用 [MIT License](LICENSE)。
diff --git a/docs/USER_GUIDE.zh-CN.md b/docs/USER_GUIDE.zh-CN.md
new file mode 100644
index 0000000..80d6132
--- /dev/null
+++ b/docs/USER_GUIDE.zh-CN.md
@@ -0,0 +1,156 @@
+# VoxBridge 中文使用教程
+
+本教程适用于 Windows 10/11。VoxBridge 是 Tauri 桌面应用；仅启动网页开发服务器时，Windows 音频采集、系统托盘和悬浮字幕等原生能力可能不可用。
+
+## 1. 准备运行环境
+
+安装以下软件：
+
+- Bun
+- Rust stable toolchain
+- Microsoft C++ Build Tools
+- Microsoft Edge WebView2 Runtime
+
+真实同传还需要可用的火山引擎 AST API Key。API 服务的价格、额度和可用区域由服务商决定，VoxBridge 本身不附带 API 额度。
+
+## 2. 下载与安装依赖
+
+```powershell
+git clone https://github.com/floatDreamWithSong/VoxBridge.git
+cd VoxBridge
+bun install
+```
+
+如需试用尚未合并的课堂语境功能，可从贡献者 fork 获取对应分支：
+
+```powershell
+git remote add lecture-fork https://github.com/879568078-commits/VoxBridge.git
+git fetch lecture-fork
+git switch --track lecture-fork/feature/context-aware-lecture-profile
+bun install
+```
+
+## 3. 启动桌面应用
+
+```powershell
+bun run tauri dev
+```
+
+首次启动需要编译 Rust 依赖，耗时会比后续启动更长。
+
+仅查看前端界面时可运行：
+
+```powershell
+bun run dev
+```
+
+然后访问 `http://localhost:1420`。此方式不代表完整桌面同传链路可用。
+
+## 4. 配置 AST 服务
+
+1. 打开 **Settings**。
+2. 在 **Volcengine AST** 中填写 API Key。
+3. 不要把 API Key 写入源码、提交到 GitHub 或发送给他人。
+
+配置保存在本机活动 Profile 中。
+
+## 5. 选择课堂音频
+
+打开 **Audio Source**：
+
+- **System audio**：识别 Windows 默认输出设备播放的全部声音。
+- **Application audio**：只采集指定应用，适合 Chrome、Edge、Teams 或 Zoom 中的课程。
+
+课堂使用推荐 **Application audio**，它能减少通知音和其他软件声音的干扰。英语课程建议将源语言固定为 **English**；只有确实存在中英文混合时再使用 **Auto**。
+
+## 6. 配置中文字幕
+
+打开 **Subtitles**：
+
+1. 字幕语言选择中文。
+2. 如需同时查看原文，开启双语字幕。
+3. 打开字幕预览窗口并拖到屏幕底部。
+4. 保存窗口位置。
+
+建议从以下参数开始调整：
+
+- 字体大小：28–34 px
+- 最大字幕块：2–3
+- 背景透明度：0.80–0.90
+- 行高：1.25–1.35
+
+## 7. 配置 EU 条约改革课堂语境
+
+打开 **Settings → 课堂语境**：
+
+- 语境模式：**自然课堂**
+- 课程主题：**Treaty Reform in the EU**
+- 可回溯修订字幕段数：建议 **3–5**
+- 自动术语修正：开启
+
+可在自定义术语中每行填写一个词组：
+
+```text
+Treaty of Lisbon
+Treaty on European Union
+Treaty on the Functioning of the European Union
+constitutional convention
+intergovernmental conference
+acquis communautaire
+subsidiarity
+proportionality
+qualified majority voting
+ordinary legislative procedure
+European Council
+European Commission
+```
+
+通用模式会关闭 EU 课程预设。自动术语修正只处理已经稳定的字幕，不会改写仍在生成的临时字幕。当前实现属于识别后的保守规范化，并不会把术语提示发送给 AST Provider。
+
+## 8. 开始同传
+
+1. 打开课程视频或会议并暂时暂停播放。
+2. 回到 VoxBridge 首页。
+3. 点击开始实时同传。
+4. 等待状态变为运行中。
+5. 继续播放课程并观察悬浮中文字幕。
+6. 结束后点击停止按钮。
+
+## 9. 常见问题
+
+### 没有字幕
+
+- 检查 AST API Key 和服务开通状态。
+- 确认课程正在播放声音。
+- 刷新应用列表并重新选择课程播放器。
+- Application audio 无结果时尝试 System audio。
+
+### 有英文但没有中文
+
+- 检查 AST 账号额度、目标语言和网络连接。
+- 查看首页显示的运行时错误。
+
+### 口音识别不准
+
+- 将源语言固定为 English。
+- 使用 Application audio 减少回声与环境噪声。
+- 将课程高频词加入自定义术语。
+- 避免多个应用同时播放声音。
+
+### 翻译过于法律化
+
+- 删除不必要的自定义术语。
+- 切换到通用模式以关闭 EU 课程预设。
+
+## 10. 验证开发环境
+
+```powershell
+bun run test
+bun run typecheck
+bun run lint
+bun run build
+```
+
+## 11. 许可证
+
+VoxBridge 使用 MIT License。允许使用、复制、修改、合并、发布、分发、再许可和销售软件副本，但必须在软件副本或重要部分中保留版权声明和许可声明。软件按“原样”提供，不附带保证。完整条款见仓库根目录 `LICENSE`。

From 039fc640b58cc4b78d882a27cb2e735b75b1e372 Mon Sep 17 00:00:00 2001
From: Hanjie Deng <87105391+floatDreamWithSong@users.noreply.github.com>
Date: Wed, 26 Aug 2026 14:44:11 +0800
Subject: [PATCH 4/4] fix: show main window on launch

---
 src-tauri/tauri.conf.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json
index 10ac091..6f2e4b3 100644
--- a/src-tauri/tauri.conf.json
+++ b/src-tauri/tauri.conf.json
@@ -18,7 +18,7 @@
         "width": 1400,
         "height": 918,
         "center": true,
-        "visible": false
+        "visible": true
       }
     ],
     "security": {