feat(world): 声景体系、疲劳共情与延时摄影开场（宪法P2收官）

- WorldSoundscape：双世界环境底噪（深海=雨声/穹顶=麦浪风声），音量0.12淡入淡出、后台自动静音、外观设置可开关（默认关）
- FatigueEmpathy：连续深潜未真休息达阈值时弹出觉察式上浮建议——休息时长口径判定真休息（skip不重置），零负向语言可忽略
- WorldRecap：每日首次打开展示6秒世界生长摘要（珊瑚/深度/发现日间增量），跨日基线结算，零增长温柔文案
- fatigue.ts纯函数规则层+单测（阈值/真休息比例/无效值守卫）
- App全局挂载三组件；宪法进度更新为P2完成

Author: Aparencia

client/src/App.tsx

@@ -26,8 +26,12 @@ import { assistantEventBus } from '@/features/assistant/lib/eventBus';
 import { RETURN_THRESHOLD_MS } from '@/features/assistant/constants';
 // 留存机制：初始化 hook（store 加载）+ 深海发现弹窗（全局 portal）
 import { useRetentionInit } from '@/features/retention/hooks/useRetentionInit';
+import { useWorldSnapshotSync } from '@/features/retention/hooks/useWorldSnapshotSync';
 import { DiscoveryReveal } from '@/features/retention/components/DiscoveryReveal';
 import { SignatureMoment } from '@/features/retention/components/SignatureMoment';
+import { FatigueEmpathy } from '@/features/retention/components/FatigueEmpathy';
+import { WorldRecap } from '@/features/retention/components/WorldRecap';
+import { WorldSoundscape } from '@/lib/audio/WorldSoundscape';
 import '@/stores/useSettingsStore'; // 导入以触发音效设置初始化
 import { startPomodoroScheduler } from '@/features/pomodoro/lib/pomodoroScheduler';
 
@@ -53,6 +57,8 @@ function App() {
   // 留存机制：在 Provider 内、路由外初始化所有留存 store
   // 放在此处确保无论用户从哪个路由进入，数据均已就绪
   useRetentionInit();
+  // 世界状态快照同步：retention 数据→sqlite→MCP 记忆服务器（单向桥，失败静默）
+  useWorldSnapshotSync();
 
   // ── 启动缓冲带：接管 HTML 内联 splash，首次渲染完成后淡出 ──
   useLayoutEffect(() => {
@@ -157,6 +163,11 @@ function App() {
               {/* 签名时刻（宪法第三条）：掌握一个概念时的三幕演出，
                   由世界事件总线驱动，仅事件发生时渲染 DOM */}
               <SignatureMoment />
+              {/* 宪法 P2：疲劳共情（觉察式建议）+ 延时摄影开场（每日生长摘要）
+                  + 世界声景（双世界环境底噪，默认关闭可开启） */}
+              <FatigueEmpathy />
+              <WorldRecap />
+              <WorldSoundscape />
             </ErrorBoundary>
           </SyncProvider>
         </AuthProvider>

client/src/features/retention/components/FatigueEmpathy.tsx

@@ -0,0 +1,52 @@
+/**
+ * FatigueEmpathy — 疲劳共情（宪法 P2 · 觉察而非管控）
+ * FatigueEmpathy — gentle surfacing suggestion (awareness, not control)
+ *
+ * @ai-context: 监听番茄相位迁移：连续完成 2 个工作会话而未经历真实休息
+ * （跳过休息不重置计数）时，弹一次可忽略的共情建议；真实休息即恢复。
+ * 无阻断、无负向语言、toast 天然可关闭。
+ *
+ * @ai-context: Watches pomodoro phase transitions; suggests surfacing after
+ * consecutive work sessions without a real break. Fully dismissible.
+ */
+import { useEffect, useRef } from 'react';
+import { usePomodoroStore } from '@/features/pomodoro/store/usePomodoroStore';
+import { useToast } from '@/components/ui/Toast';
+import { shouldSuggestSurfacing, wasRealBreak, SURFACE_SUGGESTION_TEXT } from '../lib/fatigue';
+
+export function FatigueEmpathy() {
+  const { toast } = useToast();
+  const workCount = useRef(0);
+  const breakEnteredAt = useRef<number | null>(null);
+
+  useEffect(() => {
+    let prevPhase = usePomodoroStore.getState().phase;
+    // 订阅相位迁移而非每帧状态，避免高频回调
+    const unsub = usePomodoroStore.subscribe((s) => {
+      if (s.phase === prevPhase) return;
+      const from = prevPhase;
+      prevPhase = s.phase;
+
+      // 工作→休息：累计一次连续深潜，记录休息入口时刻
+      if (from === 'work' && (s.phase === 'short_break' || s.phase === 'long_break')) {
+        workCount.current += 1;
+        breakEnteredAt.current = Date.now();
+        if (shouldSuggestSurfacing(workCount.current)) {
+          toast({ type: 'info', message: SURFACE_SUGGESTION_TEXT });
+          workCount.current = 0; // 建议后重新计数，避免唠叨
+        }
+        return;
+      }
+      // 休息→工作：停留时长达标=真休息（重置）；跳过/提前返回不重置
+      if ((from === 'short_break' || from === 'long_break') && s.phase === 'work') {
+        const planned = from === 'short_break' ? s.settings.shortBreakDuration : s.settings.longBreakDuration;
+        const elapsed = breakEnteredAt.current ? Date.now() - breakEnteredAt.current : 0;
+        if (wasRealBreak(elapsed, planned)) workCount.current = 0;
+        breakEnteredAt.current = null;
+      }
+    });
+    return unsub;
+  }, [toast]);
+
+  return null;
+}

client/src/features/retention/components/WorldRecap.tsx

@@ -0,0 +1,132 @@
+/**
+ * WorldRecap — 延时摄影开场（宪法 P2 · 每次打开看见生长）
+ * WorldRecap — daily "the world grew while you were away" recap
+ *
+ * @ai-context: 每日首次打开时展示 6 秒的世界生长摘要（珊瑚/深度/发现
+ * 的日间增量），把"变化"直接递到眼前——留存钩子 4（意外+生长）。
+ * 基线存 localStorage：日期变化才结算，同日多次打开不重复打扰。
+ * 零增长时只留一句温柔文案，无负向表达。
+ *
+ * @ai-context: Once per day, shows a 6-second growth recap (coral/depth/
+ * discovery deltas). Baseline settles only on date change.
+ */
+import { useEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
+import { AnimatePresence, motion } from 'framer-motion';
+import { useEcosystemStore } from '../store/useEcosystemStore';
+import { useDiscoveryStore } from '../store/useDiscoveryStore';
+
+const BASELINE_KEY = 'ed-recap-baseline';
+const RECAP_MS = 6000;
+
+interface RecapBaseline {
+  date: string;
+  corals: number;
+  totalDepth: number;
+  discoveries: number;
+}
+
+interface RecapDeltas {
+  corals: number;
+  depth: number;
+  discoveries: number;
+}
+
+function today(): string {
+  return new Date().toISOString().split('T')[0];
+}
+
+function readBaseline(): RecapBaseline | null {
+  try {
+    const raw = localStorage.getItem(BASELINE_KEY);
+    return raw ? (JSON.parse(raw) as RecapBaseline) : null;
+  } catch {
+    return null;
+  }
+}
+
+export function WorldRecap() {
+  const initialized = useEcosystemStore((s) => s.initialized);
+  const corals = useEcosystemStore((s) => s.corals);
+  const totalDepth = useEcosystemStore((s) => s.totalDepth);
+  const discoveriesCount = useDiscoveryStore((s) => s.totalCount);
+  const [deltas, setDeltas] = useState<RecapDeltas | null>(null);
+
+  // 结算逻辑：数据就绪后比较基线；跨日才展示，任何情况下都把今天写回基线
+  useEffect(() => {
+    if (!initialized) return;
+
+    const prev = readBaseline();
+    const now: RecapBaseline = {
+      date: today(),
+      corals: corals.length,
+      totalDepth,
+      discoveries: discoveriesCount,
+    };
+
+    if (prev && prev.date !== now.date) {
+      setDeltas({
+        corals: Math.max(0, now.corals - prev.corals),
+        depth: Math.max(0, now.totalDepth - prev.totalDepth),
+        discoveries: Math.max(0, now.discoveries - prev.discoveries),
+      });
+    }
+
+    try {
+      localStorage.setItem(BASELINE_KEY, JSON.stringify(now));
+    } catch { /* ignore */ }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [initialized]);
+
+  // 自动消散
+  useEffect(() => {
+    if (!deltas) return;
+    const t = setTimeout(() => setDeltas(null), RECAP_MS);
+    return () => clearTimeout(t);
+  }, [deltas]);
+
+  if (!deltas) return null;
+
+  const lines: string[] = [];
+  if (deltas.corals > 0) lines.push(`新种下 ${deltas.corals} 株珊瑚`);
+  if (deltas.depth > 0) lines.push(`潜航加深 ${deltas.depth} 米`);
+  if (deltas.discoveries > 0) lines.push(`新增 ${deltas.discoveries} 次深海发现`);
+
+  return createPortal(
+    <AnimatePresence>
+      <motion.div
+        key={`recap-${deltas.depth}-${deltas.corals}`}
+        initial={{ opacity: 0, y: 16 }}
+        animate={{ opacity: 1, y: 0 }}
+        exit={{ opacity: 0, transition: { duration: 0.3 } }}
+        transition={{ type: 'spring', stiffness: 200, damping: 26 }}
+        onClick={() => setDeltas(null)}
+        style={{
+          position: 'fixed', left: 24, bottom: 24, zIndex: 55, cursor: 'pointer',
+          maxWidth: 320, padding: '16px 20px', borderRadius: '16px 10px 14px 12px',
+          background: 'rgba(13,24,44,0.78)', border: '1px solid rgba(129,140,248,0.25)',
+          backdropFilter: 'blur(14px)', boxShadow: '0 8px 30px rgba(4,10,20,0.5)',
+        }}
+      >
+        <div style={{ fontFamily: "'LXGW WenKai Lite','Noto Serif SC',serif", fontSize: 15, fontWeight: 700, letterSpacing: 2, color: '#E0E6F0' }}>
+          你不在的时候，世界在生长
+        </div>
+        {lines.length > 0 ? (
+          <ul style={{ margin: '10px 0 0', padding: 0, listStyle: 'none', display: 'flex', flexDirection: 'column', gap: 5 }}>
+            {lines.map((l) => (
+              <li key={l} style={{ fontSize: 12.5, color: '#90A0B8', display: 'flex', alignItems: 'center', gap: 8 }}>
+                <span style={{ width: 5, height: 5, borderRadius: '50%', background: '#22D3EE', boxShadow: '0 0 6px #22D3EE' }} />
+                {l}
+              </li>
+            ))}
+          </ul>
+        ) : (
+          <div style={{ marginTop: 10, fontSize: 12.5, color: '#90A0B8' }}>
+            海面平静如昨——今天下去看看？
+          </div>
+        )}
+      </motion.div>
+    </AnimatePresence>,
+    document.body,
+  );
+}

client/src/features/retention/lib/fatigue.test.ts

@@ -0,0 +1,43 @@
+/**
+ * 疲劳共情规则单元测试
+ * Unit tests for fatigue empathy rules
+ */
+import { describe, it, expect } from 'vitest';
+import {
+  shouldSuggestSurfacing,
+  wasRealBreak,
+  SURFACE_SUGGESTION_THRESHOLD,
+  REAL_BREAK_RATIO,
+} from './fatigue';
+
+describe('shouldSuggestSurfacing', () => {
+  it('should suggest after threshold consecutive work sessions', () => {
+    expect(shouldSuggestSurfacing(SURFACE_SUGGESTION_THRESHOLD)).toBe(true);
+    expect(shouldSuggestSurfacing(SURFACE_SUGGESTION_THRESHOLD + 3)).toBe(true);
+  });
+
+  it('should stay silent below threshold (觉察不唠叨)', () => {
+    expect(shouldSuggestSurfacing(0)).toBe(false);
+    expect(shouldSuggestSurfacing(SURFACE_SUGGESTION_THRESHOLD - 1)).toBe(false);
+  });
+});
+
+describe('wasRealBreak', () => {
+  it('should accept rest reaching the ratio of planned duration', () => {
+    // 计划 5 分钟休息，停留 60% 即算真休息
+    const planned = 300;
+    expect(wasRealBreak(planned * 1000 * REAL_BREAK_RATIO, planned)).toBe(true);
+    expect(wasRealBreak(planned * 1000, planned)).toBe(true);
+  });
+
+  it('should reject skipped/shortened breaks', () => {
+    const planned = 300;
+    expect(wasRealBreak(planned * 1000 * (REAL_BREAK_RATIO - 0.1), planned)).toBe(false);
+    expect(wasRealBreak(0, planned)).toBe(false);
+  });
+
+  it('should guard invalid planned duration', () => {
+    expect(wasRealBreak(999999, 0)).toBe(false);
+    expect(wasRealBreak(999999, -5)).toBe(false);
+  });
+});

client/src/features/retention/lib/fatigue.ts

@@ -0,0 +1,33 @@
+/**
+ * 疲劳共情判定（宪法 P2 · 觉察原则）
+ * Fatigue empathy rules (constitution P2 · awareness principle)
+ *
+ * @ai-context: 纯函数规则层：连续深潜而不上浮休息达到阈值时建议一次呼吸。
+ * 觉察而非管控——建议永远可忽略、无惩罚、无阻断（宪法第二/四原则）。
+ *
+ * @ai-context: Pure rules: suggest surfacing after N consecutive work
+ * sessions without a real break. Suggestions are always dismissible.
+ */
+
+/** 连续完成的工作会话数阈值（未经历真实休息）→ 触发一次共情建议 */
+export const SURFACE_SUGGESTION_THRESHOLD = 2;
+
+/** 休息时长达到计划值的此比例即视为"真实休息"（跳过/提前返回不算） */
+export const REAL_BREAK_RATIO = 0.6;
+
+export function shouldSuggestSurfacing(workSessionsWithoutBreak: number): boolean {
+  return workSessionsWithoutBreak >= SURFACE_SUGGESTION_THRESHOLD;
+}
+
+/**
+ * 判定一次休息是否为真实休息（时长口径，不依赖动作标记）
+ * @ai-context skip 不写 lastAction，故用停留时长与计划时长比较判定
+ */
+export function wasRealBreak(elapsedMs: number, plannedSeconds: number): boolean {
+  if (plannedSeconds <= 0) return false;
+  return elapsedMs >= plannedSeconds * 1000 * REAL_BREAK_RATIO;
+}
+
+/** 共情文案（零负向语言：是邀请，不是警告） */
+export const SURFACE_SUGGESTION_TEXT =
+  '已连续深潜一段时间了，要不要上浮透口气？忽略也没关系，海一直在。';

client/src/lib/audio/WorldSoundscape.tsx

@@ -0,0 +1,57 @@
+/**
+ * WorldSoundscape — 世界声景（宪法 P2 · 声景体系第一步）
+ * WorldSoundscape — ambient world audio per theme (opt-in)
+ *
+ * @ai-context: 双世界的环境底噪：深海=雨声（隔绝感），穹顶=麦浪风声（通透感），
+ * 音量克制（0.12）淡入淡出；默认关闭，外观设置可开启（觉察原则：可关闭）。
+ * 页面隐藏时暂停，避免后台空放。
+ *
+ * @ai-context: Theme-bound ambient loop (rain for deep-sea, wind for aurora),
+ * low volume with fades, opt-in, paused when the window is hidden.
+ */
+import { useEffect, useState } from 'react';
+import { useSceneTheme } from '@/lib/3d/hooks/useSceneTheme';
+import { useAudioPlayer } from '@/lib/audio/useAudioPlayer';
+import {
+  getWorldSoundscapeEnabled,
+  WORLD_SOUNDSCAPE_CHANGE_EVENT,
+} from './worldSoundscapeConfig';
+
+/** 主题 → 环境音源映射 */
+const THEME_SOUND: Record<'deep-sea' | 'aurora-dome', string> = {
+  'deep-sea': '/audio/rain.mp3',
+  'aurora-dome': '/audio/wind-wheat.mp3',
+};
+
+export function WorldSoundscape() {
+  const theme = useSceneTheme();
+  const [enabled, setEnabled] = useState(getWorldSoundscapeEnabled);
+  const [visible, setVisible] = useState(() => document.visibilityState === 'visible');
+
+  // 设置页开关变更广播
+  useEffect(() => {
+    const onChange = (e: Event) => setEnabled((e as CustomEvent<boolean>).detail === true);
+    window.addEventListener(WORLD_SOUNDSCAPE_CHANGE_EVENT, onChange);
+    return () => window.removeEventListener(WORLD_SOUNDSCAPE_CHANGE_EVENT, onChange);
+  }, []);
+
+  // 后台静音
+  useEffect(() => {
+    const onVis = () => setVisible(document.visibilityState === 'visible');
+    document.addEventListener('visibilitychange', onVis);
+    return () => document.removeEventListener('visibilitychange', onVis);
+  }, []);
+
+  const src = THEME_SOUND[theme];
+  const { play, pause, isPlaying } = useAudioPlayer({
+    src, volume: 0.12, loop: true, fadeInMs: 1800, fadeOutMs: 1200,
+  });
+
+  const shouldPlay = enabled && visible;
+  useEffect(() => {
+    if (shouldPlay && !isPlaying) play();
+    else if (!shouldPlay && isPlaying) pause();
+  }, [shouldPlay, isPlaying, play, pause]);
+
+  return null;
+}

client/src/lib/audio/worldSoundscapeConfig.ts

@@ -0,0 +1,26 @@
+/**
+ * 世界声景开关配置（与组件分离，保证 fast-refresh 纯组件文件）
+ * World soundscape toggle helpers (separated from the component file)
+ *
+ * @ai-context: localStorage 持久化 + 跨组件变更广播事件。
+ */
+
+/** 声景开关 localStorage 键 */
+export const WORLD_SOUNDSCAPE_KEY = 'ed-world-soundscape';
+/** 开关变更广播事件名 */
+export const WORLD_SOUNDSCAPE_CHANGE_EVENT = 'ed-world-soundscape-change';
+
+export function getWorldSoundscapeEnabled(): boolean {
+  try {
+    return localStorage.getItem(WORLD_SOUNDSCAPE_KEY) === '1';
+  } catch {
+    return false;
+  }
+}
+
+export function setWorldSoundscapeEnabled(on: boolean): void {
+  try {
+    localStorage.setItem(WORLD_SOUNDSCAPE_KEY, on ? '1' : '0');
+  } catch { /* ignore */ }
+  window.dispatchEvent(new CustomEvent(WORLD_SOUNDSCAPE_CHANGE_EVENT, { detail: on }));
+}