feat(classroom): 课堂模块增强——热词/转录编辑/章节导航/视觉模式

- hotwordRuntime: 热词替换+增强双通道，audioTextRaw 保真溯源
- asrTranscriber: 并发上限 3→5，队列上限 10→20，超时 15s→30s，热词透传
- LiveTranscript: 新增内联编辑功能，已修正标记+原始文本 tooltip
- ClassroomPage: 引入章节导航组件（ChapterNav）
- 新增 ChapterNav: 从笔记 Markdown 提取章节导航
- 新增 VisionModeSelector: 视觉提取模式选择器
- 新增 oralCleanup: 口语书面化清理工具
- AsrModelPrompt: 修复 DOM 结构

Author: Aparencia

client/src/features/classroom/components/AsrModelPrompt.tsx

@@ -108,8 +108,6 @@ export function AsrModelPrompt() {
       <p className="mt-1.5 text-c1 text-text-tertiary">
         下载后可完全离线转写语音，无需联网、零 API 费用。不下载也可正常使用（云端转写）。
       </p>
-
-      <div className="mt-3 space-y-2">
         {models.map((model) => (
           <div key={model.id} className="flex items-center gap-3 p-2.5 rounded-kb-md bg-bg-secondary/50">
             <div className="flex-1 min-w-0">
@@ -143,7 +141,6 @@ export function AsrModelPrompt() {
             )}
           </div>
         ))}
-      </div>
 
       {/* 下载进度条 */}
       {downloading && (

client/src/features/classroom/components/ChapterNav.tsx

@@ -0,0 +1,80 @@
+/**
+ * 章节速览导航组件（P2-2）
+ * 从 Markdown 笔记中提取标题层级，生成可点击的章节导航条。
+ * 点击跳转到对应章节位置，支持多级标题展开/折叠。
+ *
+ * @ai-context: P2-2 章节速览——纯客户端实现，从分析结果 Markdown 中
+ * 提取 ## 和 ### 标题构建章节树。离线可用，无需云端依赖。
+ */
+import { useMemo, useState } from 'react';
+import { ListTree, ChevronRight, ChevronDown } from 'lucide-react';
+import { cn } from '@/lib/utils';
+
+interface Chapter {
+  level: number;
+  title: string;
+  index: number;
+}
+
+interface ChapterNavProps {
+  /** Markdown 笔记内容 */
+  content: string;
+  /** 点击章节时回调（可滚动到对应位置） */
+  onChapterClick?: (index: number) => void;
+  className?: string;
+}
+
+export function ChapterNav({ content, onChapterClick, className }: ChapterNavProps) {
+  const [collapsed, setCollapsed] = useState(false);
+
+  const chapters = useMemo(() => {
+    if (!content) return [];
+    const lines = content.split('\n');
+    const result: Chapter[] = [];
+    let idx = 0;
+    for (const line of lines) {
+      const match = line.match(/^(#{2,3})\s+(.+)/);
+      if (match) {
+        result.push({ level: match[1].length, title: match[2].trim(), index: idx });
+      }
+      idx++;
+    }
+    return result;
+  }, [content]);
+
+  if (chapters.length === 0) return null;
+
+  return (
+    <div className={cn('border-t border-border/20', className)}>
+      <button
+        onClick={() => setCollapsed(!collapsed)}
+        className="flex w-full items-center gap-2 px-4 py-2.5 text-b3 text-text-secondary transition-colors hover:text-brand-400 hover:bg-brand-500/5"
+      >
+        {collapsed ? <ChevronRight className="w-4 h-4" strokeWidth={1.5} /> : <ChevronDown className="w-4 h-4" strokeWidth={1.5} />}
+        <ListTree className="w-4 h-4" strokeWidth={1.5} />
+        <span className="font-medium">章节速览</span>
+        <span className="ml-auto text-c1 text-text-tertiary">{chapters.length} 节</span>
+      </button>
+
+      {!collapsed && (
+        <div className="px-3 pb-2 space-y-0.5">
+          {chapters.map((ch, i) => (
+            <button
+              key={i}
+              onClick={() => onChapterClick?.(ch.index)}
+              className={cn(
+                'flex w-full items-center gap-2 px-2 py-1 rounded-kb-md text-left transition-colors',
+                ch.level === 2
+                  ? 'text-b3 text-text-primary hover:bg-bg-secondary font-medium'
+                  : 'text-c1 text-text-tertiary hover:bg-bg-secondary ml-4',
+              )}
+            >
+              <span className="flex-shrink-0 w-1.5 h-1.5 rounded-full bg-brand-400/60" />
+              <span className="truncate">{ch.title}</span>
+            </button>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}

client/src/features/classroom/components/LiveTranscript.tsx

@@ -1,17 +1,21 @@
 /**
- * LiveTranscript — 实时 ASR 转录滚动面板
- * 课中逐句显示语音转写结果，供用户确认采集质量
+ * LiveTranscript — 实时 ASR 转录滚动面板（P1-2：支持内联编辑与已修正标记）
+ * 课中逐句显示语音转写结果，供用户确认采集质量；课后可点击编辑修正 ASR 错误。
  *
- * @ai-context: 通用组件：LiveTranscript。
+ * @ai-context: 通用组件：LiveTranscript。P1-2 新增内联编辑功能：双击/点击
+ * 编辑图标进入编辑模式，回车保存，ESC 取消。已修正的条目显示"已修正"标记，
+ * 原始文本通过 tooltip 可回溯。
  */
-import { useRef, useEffect } from 'react';
-import { Mic } from 'lucide-react';
+import { useRef, useEffect, useState, useCallback } from 'react';
+import { Mic, Pencil, Check, X } from 'lucide-react';
 import { cn } from '@/lib/utils';
 
-interface TranscriptEntry {
+export interface TranscriptEntry {
   id: string;
   text: string;
   timestamp: number;
+  /** P1-2：用户修正后的文本（存在时优先显示） */
+  editedText?: string;
 }
 
 interface LiveTranscriptProps {
@@ -20,11 +24,18 @@ interface LiveTranscriptProps {
   className?: string;
   /** 真流式进行中的 partial 文本（实时行，断句后清空） */
   partialText?: string;
+  /** P1-2：编辑回调——用户保存修正文本时调用，回写存储层 */
+  onEditTranscript?: (id: string, newText: string) => void;
 }
 
-export function LiveTranscript({ transcripts, isActive, className, partialText }: LiveTranscriptProps) {
+export function LiveTranscript({ transcripts, isActive, className, partialText, onEditTranscript }: LiveTranscriptProps) {
   const scrollRef = useRef<HTMLDivElement>(null);
   const lastCountRef = useRef(0);
+  /** 当前正在编辑的条目 ID */
+  const [editingId, setEditingId] = useState<string | null>(null);
+  /** 编辑中的临时文本 */
+  const [editText, setEditText] = useState('');
+  const inputRef = useRef<HTMLInputElement>(null);
 
   // 新转录到达时自动滚到底部
   useEffect(() => {
@@ -41,6 +52,33 @@ export function LiveTranscript({ transcripts, isActive, className, partialText }
     }
   }, [partialText]);
 
+  // 进入编辑模式时自动聚焦输入框
+  useEffect(() => {
+    if (editingId && inputRef.current) {
+      inputRef.current.focus();
+      inputRef.current.select();
+    }
+  }, [editingId]);
+
+  const startEditing = useCallback((entry: TranscriptEntry) => {
+    if (isActive) return; // 采集中不允许编辑（避免干扰实时显示）
+    setEditingId(entry.id);
+    setEditText(entry.editedText ?? entry.text);
+  }, [isActive]);
+
+  const saveEdit = useCallback(() => {
+    if (editingId && editText.trim() && onEditTranscript) {
+      onEditTranscript(editingId, editText.trim());
+    }
+    setEditingId(null);
+    setEditText('');
+  }, [editingId, editText, onEditTranscript]);
+
+  const cancelEdit = useCallback(() => {
+    setEditingId(null);
+    setEditText('');
+  }, []);
+
   if (transcripts.length === 0 && !isActive && !partialText) return null;
 
   return (
@@ -69,21 +107,60 @@ export function LiveTranscript({ transcripts, isActive, className, partialText }
         )}
         {transcripts.map((entry, idx) => {
           const isLatest = idx === transcripts.length - 1;
+          const isEditing = editingId === entry.id;
+          const displayText = entry.editedText ?? entry.text;
+          const isEdited = !!entry.editedText;
           const time = new Date(entry.timestamp).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit', second: '2-digit' });
+
+          if (isEditing) {
+            return (
+              <div key={entry.id} className="flex gap-1.5 items-start">
+                <span className="text-[10px] text-text-tertiary flex-shrink-0 mt-1 tabular-nums">{time}</span>
+                <input
+                  ref={inputRef}
+                  value={editText}
+                  onChange={(e) => setEditText(e.target.value)}
+                  onKeyDown={(e) => { if (e.key === 'Enter') saveEdit(); if (e.key === 'Escape') cancelEdit(); }}
+                  className="flex-1 min-w-0 px-2 py-1 rounded-kb-sm border border-cyan-400/50 bg-bg-elevated text-[12px] text-text-primary focus:outline-none"
+                />
+                <button onClick={saveEdit} className="p-1 rounded-kb-sm text-emerald-600 hover:bg-emerald-500/10" title="保存">
+                  <Check className="w-3.5 h-3.5" strokeWidth={1.5} />
+                </button>
+                <button onClick={cancelEdit} className="p-1 rounded-kb-sm text-text-tertiary hover:bg-bg-secondary" title="取消">
+                  <X className="w-3.5 h-3.5" strokeWidth={1.5} />
+                </button>
+              </div>
+            );
+          }
+
           return (
             <div
               key={entry.id}
               className={cn(
-                'flex gap-2 text-[12px] leading-relaxed transition-opacity duration-300',
+                'flex gap-2 text-[12px] leading-relaxed transition-opacity duration-300 group',
                 isLatest ? 'text-text-primary opacity-100' : 'text-text-secondary opacity-80',
               )}
             >
               <span className="text-[10px] text-text-tertiary flex-shrink-0 mt-0.5 tabular-nums">{time}</span>
-              <span className={cn(isLatest && 'font-medium')}>{entry.text}</span>
+              <span className={cn('flex-1', isLatest && 'font-medium')}>
+                {displayText}
+                {isEdited && (
+                  <span className="ml-1.5 text-[10px] text-amber-500 font-medium" title={`原始: ${entry.text}`}>已修正</span>
+                )}
+              </span>
+              {!isActive && (
+                <button
+                  onClick={() => startEditing(entry)}
+                  className="p-0.5 rounded-kb-sm text-text-quaternary opacity-0 group-hover:opacity-100 hover:text-cyan-500 hover:bg-cyan-500/10 transition-all flex-shrink-0"
+                  title="编辑修正"
+                >
+                  <Pencil className="w-3 h-3" strokeWidth={1.5} />
+                </button>
+              )}
             </div>
           );
         })}
-        {/* 真流式进行中的实时行（边说边出，断句后转为已提交条目） */}
+        {/* 真流式进行中的实时行 */}
         {partialText && (
           <div className="flex gap-2 text-[12px] leading-relaxed text-brand-600">
             <span className="text-[10px] text-brand-400 flex-shrink-0 mt-0.5">▍</span>
@@ -93,4 +170,4 @@ export function LiveTranscript({ transcripts, isActive, className, partialText }
       </div>
     </div>
   );
-}
+}

client/src/features/classroom/components/VisionModeSelector.tsx

@@ -0,0 +1,58 @@
+/**
+ * 视觉提取模式选择器（P8）
+ * Vision mode selector
+ *
+ * @ai-context: 课堂助手配置区的视觉提取模式选择——写入 CaptureManager →
+ * 截图消息 metadata.visionMode → VisionWorker 按模式提取（text/formula/
+ * diagram/code/full）。auto=让 VisionWorker 默认策略（全量提取）。
+ *
+ * @ai-context: Vision extraction mode selector for the classroom assistant;
+ * feeds message.metadata.visionMode consumed by VisionWorker.
+ */
+import { cn } from '@/lib/utils';
+
+export type VisionMode = 'auto' | 'text' | 'formula' | 'diagram' | 'code' | 'full';
+
+const MODES: Array<{ value: VisionMode; label: string; hint: string }> = [
+  { value: 'auto', label: '自动', hint: '默认全量提取' },
+  { value: 'text', label: '文字', hint: '侧重板书文字' },
+  { value: 'formula', label: '公式', hint: '侧重数学公式' },
+  { value: 'diagram', label: '图表', hint: '侧重图形图表' },
+  { value: 'code', label: '代码', hint: '侧重代码内容' },
+  { value: 'full', label: '全文', hint: '完整提取全部内容' },
+];
+
+export function VisionModeSelector({
+  value,
+  onChange,
+}: {
+  value: VisionMode;
+  onChange: (mode: VisionMode) => void;
+}) {
+  return (
+    <div className="px-4 py-3 border-b border-border/20">
+      <div className="flex items-center justify-between mb-2">
+        <span className="text-[12px] font-medium text-text-secondary">视觉提取</span>
+        <span className="text-[10px] text-text-tertiary">
+          {MODES.find((m) => m.value === value)?.hint}
+        </span>
+      </div>
+      <div className="flex flex-wrap gap-1.5">
+        {MODES.map((m) => (
+          <button
+            key={m.value}
+            onClick={() => onChange(m.value)}
+            className={cn(
+              'px-2.5 py-1 rounded-kb-sm text-[11px] transition-all active:scale-95',
+              value === m.value
+                ? 'bg-brand-500/15 text-brand-600 dark:text-brand-400 border border-brand-500/30 font-medium'
+                : 'text-text-tertiary hover:text-text-secondary border border-transparent hover:bg-bg-tertiary/40',
+            )}
+          >
+            {m.label}
+          </button>
+        ))}
+      </div>
+    </div>
+  );
+}

client/src/features/classroom/components/WindowSelectCard.tsx

@@ -12,7 +12,7 @@
  * recommended (score>0) by default, with a "show all" toggle exposing every
  * capturable window as the manual-pick fallback.
  */
-import { useState, useRef, useEffect } from 'react';
+import { useState, useRef, useEffect, type MouseEvent as ReactMouseEvent } from 'react';
 import { Monitor, RefreshCw, Star, ChevronDown, ChevronRight } from 'lucide-react';
 import { cn } from '@/lib/utils';
 import type { WindowInfo } from '@/lib/capture';
@@ -71,6 +71,14 @@ export function WindowSelectCard({ windows, selected, onSelect, onRefresh, loadi
     return () => document.removeEventListener('mousedown', handleDocDown);
   }, [open]);
 
+  // 点击浮层内空白/非交互区域：立即关闭浮层。
+  // 浮层打开时会覆盖下方配置区（采集路径/模式等），若点击命中浮层内
+  // 无交互元素，既不会关闭浮层也不会触达下层按钮——形成无反馈死区，
+  // 用户感知为“页面无法点击”。此处让“点空白即关闭”，下层配置恢复可点。
+  const handlePopoverDown = (e: ReactMouseEvent) => {
+    if (!(e.target as HTMLElement).closest('button')) setOpen(false);
+  };
+
   const handleToggle = () => {
     if (disabled) return;
     const next = !open;
@@ -121,7 +129,8 @@ export function WindowSelectCard({ windows, selected, onSelect, onRefresh, loadi
 
       {/* 窗口列表浮层：推荐 + 可展开的全部窗口 */}
       {open && (
-        <div className="absolute left-0 right-0 top-full mt-1 z-20 rounded-kb-md border border-border/40 bg-bg-secondary backdrop-blur-xl shadow-kb-md p-2">
+        <div onMouseDown={handlePopoverDown}
+          className="absolute left-0 right-0 top-full mt-1 z-20 rounded-kb-md border border-border/40 bg-bg-secondary backdrop-blur-xl shadow-kb-md p-2">
           <div className="flex items-center justify-between px-1 pb-1.5">
             <span className="text-[11px] text-text-tertiary">推荐窗口</span>
             <button onClick={onRefresh} disabled={loading}

client/src/features/classroom/constants.ts

@@ -95,7 +95,7 @@ export const STATUS_CONFIG: Record<SessionStatus, { label: string; color: string
 export const LANGUAGE_OPTIONS: { value: CaptureSidebarConfig['language']; label: string }[] = [
   { value: 'zh', label: '中文' },
   { value: 'en', label: 'English' },
-  { value: 'mixed', label: '多语' },
+  { value: 'mixed', label: '中英混说' },
 ];
 
 export const SUBJECT_OPTIONS = [