feat(world): 潮汐节律与沉积地层（宪法P1第四批·叙事层C/D深海先行）

- computeCurrentStreakFromCorals：从珊瑚种植日期派生连击（与DashboardPage口径一致），useWorldSignals接线warmth真值，新增3单测（共10）
- TideBreath（叙事层C）：番茄钟运行=涨潮——荧光点光增亮脉动+潮线升起，停止=退潮回落；熵的呼吸，reduced-motion跳过脉动
- StrataField（叙事层D）：累计专注=海床沉积地层（珊瑚记录数→层数，上限8层），最新沉积带辉光，白化不减层（可逆原则），静态网格零帧耗
- DeepSeaWorld挂载叙事层C/D

Author: Aparencia

client/src/features/retention/hooks/useWorldSignals.ts

@@ -3,18 +3,19 @@
  * World signals subscription hook
  *
  * @ai-context: 订阅珊瑚生态/深海发现/留存设置 store，实时派生世界信号集，
- * 供 3D 场景层（SpatialNav 实体辉光、后续混沌雾/萤火/洋流）消费。
- * streak 尚未接入 store（StreakBubble 走 props 传递），潮汐批次接线时补真实值。
+ * 供 3D 场景层（SpatialNav 实体辉光、混沌雾/潮汐/沉积层）消费。
+ * streak 从珊瑚种植日期派生（与 DashboardPage 口径一致，无额外存储）。
  *
  * @ai-context: Subscribes to retention stores and derives live world signals
- * for the 3D scene layer. Streak wiring lands with the tide batch.
+ * for the 3D scene layer. Streak is derived from coral plant dates.
  */
 import { useMemo } from 'react';
 import { useShallow } from 'zustand/react/shallow';
 import { useEcosystemStore } from '../store/useEcosystemStore';
 import { useDiscoveryStore } from '../store/useDiscoveryStore';
 import { useRetentionSettings } from '../store/useRetentionSettings';
 import {
+  computeCurrentStreakFromCorals,
   deriveWorldSignals,
   vitalityToGlowScale,
   type WorldSignals,
@@ -35,8 +36,7 @@ export function useWorldSignals(): WorldSignalsWithGlow {
       corals,
       totalDepth,
       discoveriesCount,
-      // TODO(潮汐批次): streak store 接线后替换为真实连击值
-      currentStreak: 0,
+      currentStreak: computeCurrentStreakFromCorals(corals),
       enabled,
     });
     return { ...signals, glowScale: vitalityToGlowScale(signals.vitality) };

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

@@ -9,6 +9,7 @@ import { describe, it, expect } from 'vitest';
 import {
   deriveWorldSignals,
   vitalityToGlowScale,
+  computeCurrentStreakFromCorals,
   WORLD_ANCHORS,
 } from './worldState';
 import type { CoralRecord } from '../types';
@@ -24,6 +25,13 @@ function makeCoral(health: CoralRecord['health'], id = Math.random().toString(36
   };
 }
 
+/** 指定日期偏移的珊瑚（daysAgo=0 为今天） / Coral planted daysAgo days ago */
+function coralOnDay(daysAgo: number): CoralRecord {
+  const d = new Date();
+  d.setDate(d.getDate() - daysAgo);
+  return { ...makeCoral('healthy'), plantedAt: d };
+}
+
 const base = {
   corals: [] as CoralRecord[],
   totalDepth: 0,
@@ -124,3 +132,25 @@ describe('vitalityToGlowScale', () => {
     expect(vitalityToGlowScale(9)).toBeCloseTo(1.15);
   });
 });
+
+describe('computeCurrentStreakFromCorals', () => {
+  it('should return 0 for empty corals', () => {
+    expect(computeCurrentStreakFromCorals([])).toBe(0);
+  });
+
+  it('should count consecutive days and dedupe same-day plants', () => {
+    // Arrange：今天 2 次种植 + 前 2 天连续
+    const corals = [coralOnDay(0), coralOnDay(0), coralOnDay(1), coralOnDay(2)];
+
+    // Act & Assert
+    expect(computeCurrentStreakFromCorals(corals)).toBe(3);
+  });
+
+  it('should stop at the first gap (与 DashboardPage 口径一致)', () => {
+    // Arrange：今天、昨天，第三天断裂
+    const corals = [coralOnDay(0), coralOnDay(1), coralOnDay(3)];
+
+    // Act & Assert
+    expect(computeCurrentStreakFromCorals(corals)).toBe(2);
+  });
+});

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

@@ -59,6 +59,29 @@ export interface WorldSignals {
 
 const clamp01 = (v: number): number => Math.min(1, Math.max(0, v));
 
+/**
+ * 从珊瑚种植日期派生当前连击天数 / Derive current streak from coral plant dates
+ *
+ * @ai-context 与 DashboardPage 的 StreakState 构建口径一致（复用珊瑚数据、
+ * 无额外存储）：按日期去重倒序，从最近日期向前逐日检查，遇间隔即止。
+ * 洋流休息日机制由 streakEngine 在展示层处理，此处只算原始连击。
+ */
+export function computeCurrentStreakFromCorals(corals: CoralRecord[]): number {
+  if (corals.length === 0) return 0;
+  const uniqueDays = [...new Set(
+    corals.map((c) => new Date(c.plantedAt).toISOString().split('T')[0]),
+  )].sort().reverse();
+
+  let streak = 1;
+  for (let i = 1; i < uniqueDays.length; i++) {
+    const prev = new Date(uniqueDays[i - 1]).getTime();
+    const curr = new Date(uniqueDays[i]).getTime();
+    if ((prev - curr) / 86_400_000 === 1) streak++;
+    else break;
+  }
+  return streak;
+}
+
 /**
  * 派生世界信号集 / Derive the world signal set
  *

client/src/lib/3d/objects/StrataField.tsx

@@ -0,0 +1,59 @@
+/**
+ * StrataField — 沉积地层（宪法第十条 · 叙事层 D：学习史即岩芯）
+ * StrataField — sediment strata (constitution §10 · layer D)
+ *
+ * @ai-context: 累计专注的地质层呈现：每次深潜种下的珊瑚即一程沉积，
+ * 海床上逐层堆叠（最多 8 层可视），最新的沉积层带微弱辉光——
+ * "你的学习史是一根岩芯"。白化不减少地层（可逆原则：暂停生长而非消亡）。
+ * 静态网格、无逐帧动画，性能开销近零。
+ *
+ * @ai-context: Stacked sediment bands on the seabed derived from coral count;
+ * latest stratum glows softly. Static meshes, near-zero frame cost.
+ */
+import { useMemo } from 'react';
+import * as THREE from 'three';
+import { useEcosystemStore } from '@/features/retention/store/useEcosystemStore';
+import { useWorldSignalsSelect } from '@/features/retention/hooks/useWorldSignals';
+
+/** 可视地层上限（性能预算 + 构图克制） / Visible stratum cap */
+const MAX_STRATA = 8;
+/** 海床基准高度 / Seabed baseline */
+const BASE_Y = -3.9;
+/** 单层厚度 / Stratum thickness */
+const BAND_HEIGHT = 0.22;
+
+export function StrataField() {
+  const corals = useEcosystemStore((s) => s.corals);
+  const { depthNorm } = useWorldSignalsSelect((s) => ({ depthNorm: s.depthNorm }));
+
+  // 地层数=沉积次数（珊瑚记录数），整体厚度随累计深度微缩放
+  const bands = Math.min(corals.length, MAX_STRATA);
+  const scaleY = useMemo(() => 0.7 + depthNorm * 0.5, [depthNorm]);
+
+  // 冷启动：未点亮的混沌世界没有沉积（宪法第七条）
+  if (bands === 0) return null;
+
+  return (
+    <group position={[0, 0, -2]} scale={[1, scaleY, 1]}>
+      {Array.from({ length: bands }, (_, i) => {
+        const isLatest = i === bands - 1;
+        // 越深越古老：宽度递减、色调趋暗；最新层最亮
+        const width = 7.5 - i * 0.55;
+        const brightness = 0.16 + (i / Math.max(1, bands - 1)) * 0.3;
+        return (
+          <mesh key={i} position={[0, BASE_Y + i * BAND_HEIGHT, 0]}>
+            <boxGeometry args={[width, BAND_HEIGHT * 0.92, 3.2]} />
+            <meshStandardMaterial
+              color={new THREE.Color(0.05 + brightness * 0.2, 0.09 + brightness * 0.3, 0.2 + brightness * 0.5)}
+              emissive={isLatest ? '#22D3EE' : '#12233F'}
+              emissiveIntensity={isLatest ? 0.28 : 0.06}
+              transparent
+              opacity={0.85}
+              roughness={0.8}
+            />
+          </mesh>
+        );
+      })}
+    </group>
+  );
+}

client/src/lib/3d/objects/TideBreath.tsx

@@ -0,0 +1,65 @@
+/**
+ * TideBreath — 潮汐节律（宪法第十条 · 叙事层 C：熵的呼吸）
+ * TideBreath — tidal rhythm (constitution §10 · layer C)
+ *
+ * @ai-context: 实时层的投递机制：番茄钟运行=涨潮（世界收拢变深——
+ * 荧光点光增亮脉动 + 底部潮线升起），停止/休息=退潮（光照回落、潮线沉降）。
+ * 呼吸节律与 pomodoro isRunning 联动，无新增数据依赖。
+ * reduced-motion：跳过脉动，只做强度缓动。
+ *
+ * @ai-context: Focus-running = flood tide (light swells, tide line rises);
+ * idle = ebb. Pulse skipped under prefers-reduced-motion.
+ */
+import { useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { useFrame } from '@react-three/fiber';
+import { usePomodoroStore } from '@/features/pomodoro/store/usePomodoroStore';
+
+/** 涨潮/退潮光照强度目标 / Flood & ebb light intensity targets */
+const FLOOD_INTENSITY = 0.85;
+const EBB_INTENSITY = 0.5;
+
+export function TideBreath() {
+  const isRunning = usePomodoroStore((s) => s.isRunning);
+  const lightRef = useRef<THREE.PointLight>(null);
+  const tideRef = useRef<THREE.Mesh>(null);
+  const elapsed = useRef(0);
+  const reduced = useMemo(
+    () => typeof window !== 'undefined' && window.matchMedia('(prefers-reduced-motion: reduce)').matches,
+    [],
+  );
+
+  useFrame((_, delta) => {
+    const safeDelta = Math.min(delta, 0.1);
+    elapsed.current += safeDelta;
+
+    // 涨潮脉动：呼吸式的强度起伏（reduced-motion 关闭）
+    const pulse = isRunning && !reduced ? Math.sin(elapsed.current * 0.9) * 0.12 : 0;
+    const target = (isRunning ? FLOOD_INTENSITY : EBB_INTENSITY) + pulse;
+    if (lightRef.current) {
+      lightRef.current.intensity = THREE.MathUtils.lerp(
+        lightRef.current.intensity, target, safeDelta * 2,
+      );
+    }
+
+    // 潮线：涨潮升起且波动更明显，退潮沉降趋平
+    if (tideRef.current) {
+      const mat = tideRef.current.material as THREE.MeshBasicMaterial;
+      mat.opacity = THREE.MathUtils.lerp(mat.opacity, isRunning ? 0.16 : 0.05, safeDelta * 2);
+      const swell = isRunning && !reduced ? Math.sin(elapsed.current * 0.5) * 0.12 : 0;
+      tideRef.current.position.y = -3.5 + (isRunning ? 0.25 : 0) + swell;
+    }
+  });
+
+  return (
+    <group>
+      {/* 潮汐光：与场景主光源（#00BFFF）同族但偏赛博青，涨潮时世界"变深变亮" */}
+      <pointLight ref={lightRef} position={[0, 4, 2]} intensity={EBB_INTENSITY} color="#22D3EE" distance={40} />
+      {/* 潮线：海床上的扁平光环，涨落可见 */}
+      <mesh ref={tideRef} rotation={[-Math.PI / 2, 0, 0]} position={[0, -3.5, 0]}>
+        <ringGeometry args={[3.4, 9, 48]} />
+        <meshBasicMaterial color="#22D3EE" transparent opacity={0.05} side={THREE.DoubleSide} depthWrite={false} />
+      </mesh>
+    </group>
+  );
+}

client/src/lib/3d/scenes/DeepSeaWorld.tsx

@@ -11,6 +11,8 @@ import { SafeEffectComposer } from '../core/SafeEffectComposer';
 import { useEffectiveTier } from '@/lib/performance/usePerformanceMode';
 import { ChaosMist } from '../objects/ChaosMist';
 import { OrderRipples } from '../objects/OrderRipples';
+import { TideBreath } from '../objects/TideBreath';
+import { StrataField } from '../objects/StrataField';
 
 export function DeepSeaWorld() {
   // 有效 tier（自动 tier 受用户性能模式上限约束）
@@ -29,6 +31,9 @@ export function DeepSeaWorld() {
       {/* 熵可视化层（宪法 P1）：混沌雾=遗忘，秩序波纹=复习 */}
       <ChaosMist />
       <OrderRipples />
+      {/* 叙事层叠加（宪法第十条）：潮汐=熵的呼吸，地层=累计专注的岩芯 */}
+      <TideBreath />
+      <StrataField />
 
       {/* 后处理：低档全关；中档关景深（DepthOfField 是最重的后处理 pass）；澎湃档全开。
           条件置于 composer 层级（group 接受 false），避免 EffectComposer 子元素严格类型报错 */}