fix(misc): 杂项修复与文档更新

- PomodoroPage: 番茄钟页面优化
- PlannerPanel: 规划面板调整
- SocraticDialogue/hooks: 苏格拉底对话体验优化
- Notes: AnalysisPreview/NoteTagFilter 修复
- 3D: OrbitalStore/SpatialNav/AuroraModuleEntity/MobileNavGrid 微调
- useAIFlashcards: AI 闪卡优化
- captureManager/types: 视觉模式注入 + audioTextRaw 保真字段
- docs: README 更新索引，临时收入方案标记已过时
- 其他: social/onboarding 模块微调

Author: Aparencia

client/src/features/feynman/components/SocraticDialogue.tsx

@@ -24,6 +24,8 @@ interface SocraticDialogueProps {
   loading: boolean;
   /** 当所有轮次完成时为 true */
   completed?: boolean;
+  /** A 组流式接入：追问打字机渐进文本（生成中逐字展示，完成前 loading 波浪让位） */
+  streamingQuestion?: string;
 }
 
 function RoundBubble({ round }: { round: SocraticRound }) {
@@ -144,8 +146,32 @@ function AIThinkingWave() {
   );
 }
 
+/** 追问打字机气泡：流式渐进文本 + 光标，替代思考波浪（首 chunk 到达后切换） */
+function StreamingQuestionBubble({ text }: { text: string }) {
+  return (
+    <div className="flex items-start gap-2.5 max-w-[88%]">
+      <div className="w-8 h-8 rounded-full bg-gradient-to-br from-brand-400 to-brand-600 flex items-center justify-center flex-shrink-0 mt-0.5 shadow-sm shadow-brand-500/20">
+        <Sparkles className="w-4 h-4 text-white" strokeWidth={1.5} />
+      </div>
+      <div className={cn(
+        'px-4 py-3 rounded-2xl rounded-tl-md',
+        'bg-brand-50/80 dark:bg-brand-950/40 border border-brand-200/30 dark:border-brand-700/30',
+        'text-b2 text-text-primary leading-relaxed',
+        'shadow-sm',
+      )}>
+        {text}
+        <motion.span
+          className="inline-block w-[2px] h-[1.1em] bg-brand-500 align-text-bottom ml-0.5"
+          animate={{ opacity: [1, 0, 1] }}
+          transition={{ duration: 0.8, repeat: Infinity }}
+        />
+      </div>
+    </div>
+  );
+}
+
 export default function SocraticDialogue({
-  rounds, currentRound, maxRounds, onSubmitAnswer, loading, completed,
+  rounds, currentRound, maxRounds, onSubmitAnswer, loading, completed, streamingQuestion,
 }: SocraticDialogueProps) {
   const [answer, setAnswer] = useState('');
 
@@ -187,8 +213,8 @@ export default function SocraticDialogue({
           <RoundBubble key={round.roundNumber} round={round} />
         ))}
 
-        {/* AI 思考波浪动画 */}
-        {loading && <AIThinkingWave />}
+        {/* AI 思考波浪动画（首 chunk 到达前）；之后切换为追问打字机气泡 */}
+        {loading && (streamingQuestion ? <StreamingQuestionBubble text={streamingQuestion} /> : <AIThinkingWave />)}
       </div>
 
       {/* 输入区（追问未完成时显示）— 底部固定风格 */}

client/src/features/feynman/hooks/useSocraticFlow.tsx

@@ -179,7 +179,8 @@ export function useSocraticFlow() {
       evaluateAI.evaluateAnswer(topic, currentQuestion, answer, history),
       currentRound >= MAX_ROUNDS
         ? Promise.resolve(null)
-        : questionAI.askQuestion(conversationIdRef.current, topic, history),
+        // A 组流式接入：苏格拉底追问打字机（失败自动降级非流式 askQuestion）
+        : questionAI.askQuestionStream(conversationIdRef.current, topic, history),
     ]);
 
     if (evalResult?.dimensions) {
@@ -305,6 +306,9 @@ export function useSocraticFlow() {
     brainstormLoading: brainstormAI.loading,
     brainstormError: brainstormAI.error,
     questionLoading: questionAI.loading,
+    // A 组流式接入：追问打字机渐进文本与状态（SocraticDialogue 消费）
+    streamingQuestion: questionAI.streamingQuestion,
+    isQuestionStreaming: questionAI.isQuestionStreaming,
     // handlers
     handleStartBrainstorm, handleSelectIdea, handleToDialogue,
     handleSubmitAnswer, handleToDeepening, handleDeepeningSubmit, handleGoBack,

client/src/features/feynman/pages/SocraticSessionPage.tsx

@@ -32,6 +32,7 @@ export default function SocraticSessionPage() {
     dialogueCompleted, savingNote, exiting,
     deepeningAngles, deepeningFallbackMsg, deepeningLoading,
     brainstormLoading, brainstormError, questionLoading,
+    streamingQuestion,
     handleStartBrainstorm, handleSelectIdea, handleToDialogue,
     handleSubmitAnswer, handleToDeepening, handleDeepeningSubmit, handleGoBack,
     maxRounds,
@@ -181,6 +182,7 @@ export default function SocraticSessionPage() {
                   onSubmitAnswer={handleSubmitAnswer}
                   loading={questionLoading}
                   completed={dialogueCompleted}
+                  streamingQuestion={streamingQuestion}
                 />
               </motion.div>
             )}

client/src/features/notes/components/AnalysisPreview.tsx

@@ -32,8 +32,8 @@ interface AnalysisPreviewProps {
   onInsert: (content: string) => void;
   onDismiss: () => void;
   onRetry?: () => void;
-  /** 可选：从笔记生成闪卡 */
-  onGenerateCards?: (content: string) => void;
+  /** 可选：从笔记生成闪卡（P2-3：支持全量/仅重点模式） */
+  onGenerateCards?: (content: string, mode?: 'full' | 'bookmarks') => void;
   /** 可选：错误态「打开设置」（P0-1；既有调用方不传则行为零变化） */
   onGoSettings?: () => void;
 }
@@ -253,16 +253,29 @@ export function AnalysisPreview({
       {/* 底部操作栏 */}
       <div className="flex items-center justify-end gap-2 px-4 py-2.5 border-t border-border/20 bg-bg-secondary/50">
         {onGenerateCards && (
-          <button
-            onClick={() => onGenerateCards(result.content)}
-            className={cn(
-              'inline-flex items-center gap-1.5 px-3 py-1.5 rounded-kb-md text-b3 font-medium mr-auto',
-              'bg-flashcard-50 text-flashcard-600 hover:bg-flashcard-100 active:scale-95 transition-all duration-kb-fast',
-            )}
-          >
-            <Layers className="w-3.5 h-3.5" strokeWidth={1.5} />
-            生成闪卡
-          </button>
+          <>
+            <button
+              onClick={() => onGenerateCards(result.content)}
+              className={cn(
+                'inline-flex items-center gap-1.5 px-3 py-1.5 rounded-kb-md text-b3 font-medium mr-auto',
+                'bg-flashcard-50 text-flashcard-600 hover:bg-flashcard-100 active:scale-95 transition-all duration-kb-fast',
+              )}
+            >
+              <Layers className="w-3.5 h-3.5" strokeWidth={1.5} />
+              生成闪卡
+            </button>
+            <button
+              onClick={() => onGenerateCards(result.content, 'bookmarks')}
+              className={cn(
+                'inline-flex items-center gap-1.5 px-3 py-1.5 rounded-kb-md text-b3 font-medium',
+                'bg-flashcard-50/50 text-flashcard-600 hover:bg-flashcard-100 active:scale-95 transition-all duration-kb-fast',
+              )}
+              title="仅从课中标记的重点生成闪卡"
+            >
+              <Layers className="w-3.5 h-3.5" strokeWidth={1.5} />
+              仅重点
+            </button>
+          </>
         )}
         <button
           onClick={onDismiss}

client/src/features/notes/components/NoteTagFilter.tsx

@@ -4,6 +4,7 @@
 import { motion, AnimatePresence } from 'framer-motion';
 import { X } from 'lucide-react';
 import { cn } from '@/lib/utils';
+import { useShallow } from 'zustand/react/shallow';
 import { useNoteStore } from '../store/useNoteStore';
 import { useReducedMotion } from '@/hooks/useReducedMotion';
 
@@ -12,7 +13,7 @@ import { useReducedMotion } from '@/hooks/useReducedMotion';
  * v0.9.0: chip 样式多选标签筛选
  */
 export function NoteTagFilter() {
-  const allTags = useNoteStore((s) => s.getAllTags());
+  const allTags = useNoteStore(useShallow((s) => s.getAllTags()));
   const selectedTags = useNoteStore((s) => s.selectedTags);
   const toggleTag = useNoteStore((s) => s.toggleTag);
   const clearTagFilter = useNoteStore((s) => s.clearTagFilter);

client/src/features/onboarding/firstDive/moduleSubtitles.ts

@@ -12,6 +12,7 @@ export const MODULE_SUBTITLES: Record<string, string> = {
   feynman: '费曼讲解',
   inspiration: '灵感收集',
   classroom: '课堂采集',
+  constellation: '知识可视化',
 };
 
 /** 取模块副标题；无副标题（如首页）返回 undefined */

client/src/features/planner/components/PlannerPanel.tsx

@@ -10,15 +10,26 @@
  * differently from local-rule fallback plans.
  */
 import { useNavigate } from 'react-router-dom';
+import { useState } from 'react';
 import { motion } from 'framer-motion';
-import { RefreshCw, Sparkles, Compass, Check } from 'lucide-react';
+import { RefreshCw, Sparkles, Compass, Check, CalendarRange } from 'lucide-react';
 import { cn } from '@/lib/utils';
 import { useLearningPlan } from '../hooks/useLearningPlan';
 import { PLAN_MODULE_META } from '../types';
+import { Modal, Button } from '@/components/ui';
+import CoachPlanView from './CoachPlanView';
+import { useAILearningCoach } from '@/lib/ai/hooks/useAILearningCoach';
 
 export default function PlannerPanel() {
   const navigate = useNavigate();
   const { plan, loading, regenerate, toggleDone } = useLearningPlan();
+  // P6 学习教练：AI 生成周学习计划（懒加载，失败 isFallback 展示降级文案）
+  const { plan: coachPlan, loading: coachLoading, isFallback: coachFallback, generatePlan } = useAILearningCoach();
+  const [coachOpen, setCoachOpen] = useState(false);
+  const handleOpenCoach = () => {
+    setCoachOpen(true);
+    if (!coachPlan) void generatePlan();
+  };
 
   // 加载中：骨架占位
   if (loading) {
@@ -73,6 +84,15 @@ export default function PlannerPanel() {
           <RefreshCw className="w-3.5 h-3.5" strokeWidth={1.5} />
           重排
         </button>
+        {/* P6 学习教练：AI 周计划入口 */}
+        <button
+          onClick={handleOpenCoach}
+          className="flex items-center gap-1 rounded-lg px-2 py-1 text-[11px] text-text-tertiary transition-colors hover:text-brand-500 hover:bg-brand-500/10"
+          aria-label="AI 教练周计划"
+        >
+          <CalendarRange className="w-3.5 h-3.5" strokeWidth={1.5} />
+          AI 教练
+        </button>
       </div>
 
       <ul className="space-y-2">
@@ -132,6 +152,31 @@ export default function PlannerPanel() {
           {plan.note}
         </p>
       )}
+
+      {/* P6 AI 教练周计划弹层 */}
+      <Modal
+        open={coachOpen}
+        onClose={() => setCoachOpen(false)}
+        title="🧭 AI 教练周计划"
+        description="基于本周学习数据生成下周安排"
+        size="lg"
+      >
+        {coachPlan ? (
+          <CoachPlanView plan={coachPlan} loading={coachLoading} isFallback={coachFallback} />
+        ) : (
+          <div className="py-10 text-center text-c1 text-text-tertiary animate-pulse">
+            {coachLoading ? 'AI 教练正在规划你的学习周…' : '暂无周计划，点击下方按钮生成'}
+          </div>
+        )}
+        {coachPlan && (
+          <div className="mt-4 flex justify-end">
+            <Button size="sm" variant="secondary" onClick={() => void generatePlan()}>
+              <RefreshCw className="w-3 h-3 mr-1" strokeWidth={1.5} />
+              重新生成
+            </Button>
+          </div>
+        )}
+      </Modal>
     </motion.div>
   );
 }

client/src/features/pomodoro/pages/PomodoroPage.tsx

@@ -5,8 +5,11 @@ import { useEffect, useState, useCallback, useRef } from 'react';
 import { createPortal } from 'react-dom';
 import { useNavigate } from 'react-router-dom';
 import { AnimatePresence, motion } from 'framer-motion';
-import { Clock } from 'lucide-react';
+import { Clock, Sparkles } from 'lucide-react';
 import { db } from '@/lib/storage';
+import { pomodoroSessionStore } from '@/lib/storage';
+import { aiPluginLoader } from '@/lib/ai/AIPluginLoader';
+import { useAIRecommendation } from '../hooks/useAIRecommendation';
 import TimerRing from '../components/TimerRing';
 import GoalInput from '../components/GoalInput';
 import ImmersiveTimer from '../components/ImmersiveTimer';
@@ -45,6 +48,29 @@ export default function PomodoroPage() {
   const [goalModalOpen, setGoalModalOpen] = useState(false);
   const [rememberGoal, setRememberGoal] = useState(false);
   const [presetEditorOpen, setPresetEditorOpen] = useState(false);
+  
+    // AI 时长推荐（T1：本地节律引擎即时结果，AI 增强可选且 3s 超时降级）
+    const { recommendation, loading: recLoading, error: recError, getRecommendation } = useAIRecommendation();
+    const [aiEnhance, setAiEnhance] = useState(false);
+    const handleGetRecommendation = useCallback(async () => {
+      try {
+        const since = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000);
+        const sessions = await pomodoroSessionStore.getTable()
+          .where('completedAt').aboveOrEqual(since)
+          .toArray();
+        const history = {
+          sessions: sessions.map((s) => ({
+            duration: Math.round(s.duration / 60),
+            completed: !s.interrupted && s.actualDuration >= s.duration * 0.8,
+            date: new Date(s.completedAt).toISOString(),
+            subject: s.subject || '',
+          })),
+        };
+        await getRecommendation(history, aiEnhance ? (data) => aiPluginLoader.recommendDuration(data) : undefined);
+      } catch {
+        // 静默失败（本地推荐失败也无妨，不打扰主界面）
+      }
+    }, [getRecommendation, aiEnhance]);
 
   // 设备降级级别推导（与萤火海沟/沉浸模式同源：L0 全量 / L1 低端 / L2 减弱动效）
   const { shouldDisableHeavyAnimations, prefersReducedMotion } = useDeviceCapability();
@@ -234,6 +260,53 @@ export default function PomodoroPage() {
           {!isRunning && !isPaused && (
             <div className="mt-2 w-full max-w-md">
               <EnergySuggestionBar />
+              {/* AI 时长推荐：本地节律即时计算，AI 增强可选（3s 超时自动降级） */}
+              <div className="mt-2 rounded-kb-lg border border-border/30 bg-bg-elevated/40 p-3">
+                <div className="flex items-center justify-between">
+                  <span className="text-c1 text-text-secondary flex items-center gap-1.5">
+                    <Sparkles className="w-3.5 h-3.5 text-brand-500" strokeWidth={1.5} />
+                    AI 时长推荐
+                  </span>
+                  <label className="flex items-center gap-1.5 text-c1 text-text-tertiary cursor-pointer">
+                    <input
+                      type="checkbox"
+                      checked={aiEnhance}
+                      onChange={(e) => setAiEnhance(e.target.checked)}
+                      className="accent-brand-500"
+                    />
+                    AI 增强
+                  </label>
+                </div>
+                {recommendation ? (
+                  <div className="mt-2 flex items-baseline gap-2">
+                    <span className="text-b2 font-semibold text-text-primary">
+                      {recommendation.recommendedDuration} 分钟
+                    </span>
+                    {recommendation.breakMinutes ? (
+                      <span className="text-c1 text-text-tertiary">· 休息 {recommendation.breakMinutes} 分钟</span>
+                    ) : null}
+                    <span className="ml-auto text-[10px] text-text-tertiary">
+                      {recommendation.source === 'ai' ? 'AI 增强' : '本地节律'}
+                      {recommendation.confidence === 'high' ? ' · 高置信' : recommendation.confidence === 'medium' ? ' · 中置信' : ''}
+                    </span>
+                  </div>
+                ) : null}
+                {recError && !recommendation ? (
+                  <p className="mt-1 text-c1 text-semantic-error">{recError}</p>
+                ) : null}
+                {!recommendation && (
+                  <p className="mt-1 text-c1 text-text-tertiary">
+                    基于近 30 天专注节律推荐时长（数据不足时回退加权平均）
+                  </p>
+                )}
+                <button
+                  onClick={() => void handleGetRecommendation()}
+                  disabled={recLoading}
+                  className="mt-2 px-3 py-1.5 rounded-kb-sm bg-brand-500/15 text-brand-600 dark:text-brand-400 text-c1 border border-brand-500/30 transition-all active:scale-95 disabled:opacity-50"
+                >
+                  {recLoading ? '计算中…' : recommendation ? '重新推荐' : '获取推荐'}
+                </button>
+              </div>
             </div>
           )}
 

client/src/features/social/components/DeepDiveRoomView.tsx

@@ -15,6 +15,7 @@ import { DoorOpen, Timer } from 'lucide-react';
 import { Card, CardContent, Button } from '@/components/ui';
 import { cn } from '@/lib/utils';
 import { useAuth } from '@/lib/auth/AuthContext';
+import { useShallow } from 'zustand/react/shallow';
 import { usePomodoroStore } from '@/features/pomodoro/store/usePomodoroStore';
 import { CHEER_EMOJIS, type RoomStateResult } from '../hooks/useRoomState';
 import type { PresenceStatus, RoomPresence } from '../types';
@@ -41,12 +42,12 @@ const STATUS_LABELS: Record<PresenceStatus, string> = {
 export default function DeepDiveRoomView({ roomId, state, onLeave }: DeepDiveRoomViewProps) {
   const { room, cheerFor } = state;
   const { user } = useAuth();
-  const pomodoro = usePomodoroStore((s) => ({
+  const pomodoro = usePomodoroStore(useShallow((s) => ({
     phase: s.phase,
     isRunning: s.isRunning,
     remainingSeconds: s.remainingSeconds,
     totalSeconds: s.totalSeconds,
-  }));
+  })));
 
   // 自己的番茄进度百分比（休息阶段显示 0，避免误导）
   const selfProgress = useMemo(() => {

client/src/features/social/components/RelayPanel.tsx

@@ -13,6 +13,7 @@ import { useCallback, useEffect, useRef, useState } from 'react';
 import { Handshake, Zap, Target } from 'lucide-react';
 import { Card, CardContent, Button, Input, useToast } from '@/components/ui';
 import { cn } from '@/lib/utils';
+import { useShallow } from 'zustand/react/shallow';
 import { usePomodoroStore } from '@/features/pomodoro/store/usePomodoroStore';
 import {
   acceptPair, getCachedPair, getIncomingPairs, getRelayState, getRelayStats,
@@ -47,11 +48,11 @@ export default function RelayPanel({ offlineReason }: RelayPanelProps) {
   // M5: accept/reject 防双击——ref 同步守卫（state 闭包在快速双击时可能未刷新）
   const actionRef = useRef<string | null>(null);
 
-  const pomodoro = usePomodoroStore((s) => ({
+  const pomodoro = usePomodoroStore(useShallow((s) => ({
     phase: s.phase,
     isRunning: s.isRunning,
     remainingSeconds: s.remainingSeconds,
-  }));
+  })));
 
   const refresh = useCallback(async () => {
     const [incomingPairs, relayStats, cached] = await Promise.all([