# 五维全景 · 五行哲学体系

**日期:** 2026-06-08（最后更新：2026-07-12）
**状态:** 已确认
**版本:** v2.0

**关联文档:**
- [五相克完整设计](./2026-07-12-wuxing-ke-full-design.md) — 每个克关系的四层解读 + 杠杆算法 + 前端展示
- [首页与能量转化算法设计](./2026-07-12-wuxing-homepage-and-conversion-algorithm.md) — 生克一体算法 + 首页重构方案

---

## 概述

浠艾福五维全景幸福矩阵以**五行（金木水火土）**为哲学基础，建立五维之间的相生与相克关系。五维并非各自孤立，而是像一个有机生态系统——**相生让系统前进，相克让系统不翻车**。

**v2.0 更新核心：** 将"克"从"制约/惩罚"层面升级为"平衡信号/引导"层面——克不是封路，是敲钟。生与克共同构成一套制动与驱动系统：生是油门（驱动、滋养、赋能），克是刹车（校准、平衡、警报）。两者缺一不可。

> 详细生克一体化算法见 [首页与能量转化算法设计](./2026-07-12-wuxing-homepage-and-conversion-algorithm.md)

---

## 1. 五维 ↔ 五行对应关系

| 五维 | 五行 | 五行特性 | 相生关系 |
|:----:|:----:|----------|----------|
| **智**（赋能未来） | **金** | 金主义，刚健、锐利、珍贵。智慧如金石，能开凿财富之门。 | 金生水 → **智生富** |
| **富**（利他创富） | **水** | 水主智，亦主流动、滋养、生财。财富如水，顺势而为，利他而丰。 | 水生木 → **富生行** |
| **行**（人际和谐） | **木** | 木主生发、舒展、连接。有财富支撑，社交更自由；人际关系如草木生长，滋养家庭。 | 木生火 → **行生心** |
| **心**（大爱相随） | **火** | 火主礼，光明、温暖、传递。家族大爱如火焰，以心传心，生生不息。 | 火生土 → **心生身** |
| **身**（主动健康） | **土** | 土主承载，脾胃之本，健康之基。身心安定，方能孕育智慧。 | 土生金 → **身生智** |

### 维度定义更新（v2.0）

| 维度 | 核心 | 子维度（孩子） | 子维度（成人） |
|:----:|:----:|:--------------|:--------------|
| **身** | 主动健康——体质、精力、睡眠 | 健康报告overallScore、运动任务 | 任务完成率、健康报告 |
| **智** | 赋能未来——认知能力、逻辑、知识 | DAN COG六子分加权 | 学习/培训任务完成率 |
| **富** | 利他创富——金钱、成就、资源 | 学业成绩(30%)+社交筹码(20%)+规则博弈(50%) | 金钱/收入(50%)+社会成就(30%)+资源网络(20%) |
| **行** | 人际和谐——陪伴在场、关系密度、利他行为 | 家庭共同任务+活动参与+分享行为 | 家人互动任务+社交活跃+推荐行为 |
| **心** | 大爱相随——情绪稳定、理解包容、传承传递 | 情绪打卡+DAN EMI+家庭天盘+传承 | (暂无数据源，回0) |

> **富子维度（v2.1 落地）** — 详见 [五维能量系统设计 §6 富维度算法](./2026-06-05-five-dimension-energy-design.md#6-富维度算法v21)
>
> 孩子：学业成绩 = DAN测评最近3次综合分+进步趋势；社交筹码 = 活动参与次数（第一阶段回0）；规则博弈 = 一年内积分获取/可获取总量
>
> 成人：金钱/收入 = 积分总量/500（满分100）；社会成就 = `User.achievements` 扩展字段 JSON（第一阶段回0）；资源网络 = 推荐团队人数（第一阶段回0）
>
> 身克富杠杆（applied after `calcChildWealth`/`calcParentWealth`）：`身<40` → penalty（wealth *= 0.5 + 0.5×身/100，文案"健康正在稀释财富能量"）；`身<50 && 富>身+20` → overdraw（透支预警，不下调，文案"财富能量超出身体承受范围"）；否则 → normal（身≥70正向文案"身体底盘稳固"）。DTO 字段：`bodyWealthStatus` ∈ {normal, overdraw, penalty} + `bodyWealthMessage`。

> 详细子维度定义和权重见 [五相克完整设计](./2026-07-12-wuxing-ke-full-design.md#维度体系总览)

### 相生链

```
智(金) ──生──→ 富(水) ──生──→ 行(木) ──生──→ 心(火) ──生──→ 身(土) ──生──→ 智(金)
```

相生的核心价值：**循环促进，生生不息**。每个维度都在为下一个维度积蓄能量，形成正向螺旋上升。

**相生算法（v2.0）：**

每个生关系在上游>60且下游<80时，给予小幅增益：

```
心生身（火生土）：心>60 且 身<80 → gain = (心-50)/100×10，上限≤80-身
身生智（土生金）：身>60 且 智<80 → gain = (身-50)/100×10，上限≤80-智
智生富（金生水）：智>60 且 富<80 → gain = (智-50)/100×10，上限≤80-富
富生行（水生木）：富>60 且 行<80 → gain = (富-50)/100×10，上限≤80-行
行生心（木生火）：行>60 且 心<80 → gain = (行-50)/100×10，上限≤80-心
```

上游从50分起每多10分→+1分增益，最大单次+5分；同时被增益方不能突破80分（留成长空间）。

---

## 2. 相克关系（v2.0 更新）

### 核心理念：「克」是信号，不是惩罚

| 旧理解 | 新理解 |
|:-------|:-------|
| 克=制约/惩罚/扣分 | 克=平衡信号/引导/提醒 |
| 触发即扣分 | 先提醒，持续偏差才微调 |
| 单向负面 | 双向检查——克方太强或被克方太弱都要点 |
| 惩罚性文案 | 建设性文案，给出行动方向 |

### 克的核心表达

```
克 = 系统在看，在提醒的方向，不是系统在罚，在禁止的方向
```

### 相克关系总表

| 相克 | 对应五维互动 | 平衡意义 | 核心提醒 |
|:----:|-------------|----------|:---------|
| **木克土**（行克身） | 行动社交 对 身体健康 | 运动、社交、行动都在身体允许范围内，不过度透支 | "行动力很强，但身体在报警了" |
| **土克水**（身克富） | 健康 对 财富追求 | 健康是创富的底盘，身体不好财富没有意义 | "身体是赚钱的本钱" |
| **水克火**（富克心） | 物质财富 对 心理素养 | 财富与心理承受力要匹配，德要配位 | "财富涨了，心也得跟上" |
| **火克金**（心克智） | 情感关爱 对 智慧培养 | 情绪稳定、包容力够，智力潜能才能发挥 | "心平才能静智" |
| **金克木**（智克行） | 认知分析 对 人际关系 | 聪明不等于会相处，人际不是逻辑题 | "朋友不是用逻辑交来的" |

### 克的四层解读（v2.0 新增）

每个克关系包含四个角度，不局限于单向制约：

| 层 | 含义 | 作用 |
|:--:|------|:----:|
| **角度① 透支型** | 克方过度膨胀，被克方被压制 | **校准触发**——最痛的问题，系统需要警示 |
| **角度② 谨慎型** | 克方太弱，被克方盲目发展 | **引导触发**——不扣分但提示方向 |
| **角度③ 替代型** | 一方替代另一方的本质价值 | **检测触发**——检测行为层面的偏斜 |
| **角度④ 平衡态** | 双方相互制衡，共生 | **正向标记**——理想状态，鼓励维持 |

### 克环

```
行(木) ──克──→ 身(土) ──克──→ 富(水) ──克──→ 心(火) ──克──→ 智(金) ──克──→ 行(木)
```

### 五条平衡法则

| 法则 | 含义 | 应用场景 | 四层角度 |
|:----:|------|----------|:--------:|
| 行克身 | 不要为了活动透支体力 | 活动设计需考虑适龄适量 | 透支→谨慎→替代→平衡 |
| 身克富 | 不要用健康换金钱 | 产品推荐需平衡健康与商业 | 透支→稀释→替代→平衡 |
| 富克心 | 不要让财富吞噬亲情 | 创客生态需强调家庭陪伴优先 | 爆发→评判→替代→平衡 |
| 心克智 | 不要让感情遮蔽理性 | 家庭教育需平衡关爱与独立 | 过度保护→理性冷淡→替代→平衡 |
| 智克行 | 不要让计划杀死行动力 | 测评结果应导向行动建议 | 认知孤独→盲目社交→替代→平衡 |

> 每个克关系的完整四层解读、用户画像、杠杆算法见 [五相克完整设计](./2026-07-12-wuxing-ke-full-design.md)

---

## 3. 相生相克总图

```
              相生 → (促进)
              相克 → (制约)
               
                    心(火) 顶
                   ↙    ↘
                生       克
               ↙            ↘
      行(木) 左              右 身(土)
              ↘              ↙
                克         生
                  ↘      ↙
              富(水)      智(金)
              左下         右下
```

### 系统展示（v2.0）

在五维行星盘（WuxingSandbox）中，相生和相克通过两层粒子流可视化：

```
· 金色粒子 = 相生（沿 身→智→富→行→心→身 顺时针流动）
· 红色粒子 = 相克（沿 行→身→富→心→智→行 逆时针流动）

· 粒子密度反映生/克当前强度
· 所有维度分值均衡 → 金色粒子占主导
· 某个克关系激活 → 对应臂红色粒子增多
· 点击维度 → 进入该维度详情页
```

---

## 4. 核心哲学：动态平衡，过犹不及

五维幸福并非各自无限放大，而是像**一辆五轮马车**：

- **相生让车前进** — 各维度互相滋养，形成正向循环
- **相克让车不翻** — 每个维度都有其制约机制，防止任何一维过度膨胀

### 生与克的关系（v2.0 更新）

```
生 = 油门（驱动、滋养、赋能）
克 = 刹车（校准、平衡、警报）

只生不克 → 维度膨胀，系统崩盘
只克不生 → 维度萎缩，没有成长动力
有生有克 → 动态平衡，持续发展
```

### 能量转化算法原则（v2.0 具体化）

算法分三轮单遍执行，不迭代：

```
第1轮：原始分计算（独立算每个维度）
  ↓
第2轮：克校准（检测5个克关系，只触发最痛一层，直接微调权重）
  ↓
第3轮：生增益（检测5个生关系，上游好则下游小幅加值）
  ↓
最终分 = 原始分 × 克系数 + 生增益
```

**克系数公式：**

```
penalty = 0.5 + 0.5 × (被克方分 / 100.0)
· 被克方0分 → penalty=0.5（最多打对折）
· 被克方100分 → penalty=1.0（不打折）
· penalty只适用于最严重的透支型克关系
```

> 完整系数表和触发条件见 [首页与能量转化算法设计](./2026-07-12-wuxing-homepage-and-conversion-algorithm.md)

---

## 5. 对系统设计的指导

### 5.1 维度显示顺序

五维在系统中的**默认展示顺序**遵循五行相生的实际流向：

```
土 → 金 → 水 → 木 → 火
身 → 智 → 富 → 行 → 心
```

在五维行星盘（WuxingSandbox）中，维度按五行固定序绕圈排列，最低分维度放在最上方（顶部突出需要关注）：

```
// 五行固定序：body(土) → wisdom(金) → wealth(水) → action(木) → mind(火)
var order = ['body', 'wisdom', 'wealth', 'action', 'mind']
```

> 注：旧版曾在其他位置使用 `智→富→行→心→身` 顺序，现已统一为 `身→智→富→行→心`。

### 5.2 健康指数算法（v2.0 更新）

能量计算三步骤：

**第1步：各维度独立原始分**

当前已有实现（EnergyService），家长和孩子的数据源不同。

**第2步：克校准（按克环顺序）**

```
applyActionBodyRestraint(行分, 身分)    → 身←行克身校准
applyBodyWealthRestraint(身分, 富分)    → 富←身克富校准
applyWealthHeartRestraint(富分, 心分)  → 心←富克心校准
applyMindWisdomRestraint(心分, 智分)   → 智←心克智校准
applyWisdomActionRestraint(智分, 行分) → 行←智克行校准
```

**第3步：生增益（按相生环顺序）**

```
applyMindBodyBoost(心分, 身分)         → 身←心生身增益
applyBodyWisdomBoost(身分, 智分)       → 智←身生智增益
applyWisdomWealthBoost(智分, 富分)     → 富←智生富增益
applyWealthActionBoost(富分, 行分)     → 行←富生行增益
applyActionMindBoost(行分, 心分)       → 心←行生心增益
```

**最终分** = 克调整后分 + 生增益，综合分 = 五维平均

### 5.3 内容与服务推荐

推荐算法可参考相生相克关系做交叉推荐：

- 用户在"智"维度参与度高 → 推荐"富"维度相关内容（智生富）
- 用户在"行"维度活跃 → 提醒关注"身"维度状态（行克身，需平衡）
- 用户在"富"维度获得收益 → 引导参与"行"维度活动（富生行）
- 当某克关系激活 → 推送对应恢复性内容（如行克身→推荐休息类）

> 详细推荐映射表见 [五相克完整设计](./2026-07-12-wuxing-ke-full-design.md#产品推荐联动)

### 5.4 数据模型中的五行字段

`energy_dimension` 表的 `element` 字段直接使用五行值：

| code | element |
|------|---------|
| body | 土 |
| wisdom | 金 |
| wealth | 水 |
| action | 木 |
| mind | 火 |

### 5.5 DTO扩展（v2.0 新增）

`MemberEnergyDTO` 新增以下字段用于承载克关系状态和心的子维度：

```java
// ===== 克关系标记（5组 status + message） =====
String actionBodyStatus;   // 行克身：overdraw|penalty|cautious|balanced|normal
String actionBodyMessage;
String bodyWealthStatus;   // 身克富
String bodyWealthMessage;
String wisdomActionStatus; // 智克行
String wisdomActionMessage;
String wealthHeartStatus;  // 富克心
String wealthHeartMessage;
String mindWisdomStatus;   // 心克智
String mindWisdomMessage;

// ===== 心的子维度（仅孩子） =====
Integer heartEmotionStable;
Integer heartUnderstanding;
Integer heartLegacy;

// ===== 生增益明细（可选） =====
List<BoostDetail> boostDetails;
```

---

## 6. 与品牌理念的融合

```
浠艾福 = 浠（水润万物）艾（关爱）福（幸福）

五行之水对应"富"维度——利他创富，滋养家庭。
浠字本义即为水润万物，与品牌名天然契合。
```

五维五行体系不仅是系统设计的基础，也是品牌叙事的核心。对外传播时，可将五维与五行结合呈现，增强文化深度与记忆点。

---

## 附录：文档演变

| 版本 | 日期 | 变更内容 |
|:----:|:----:|----------|
| v1.0 | 2026-06-08 | 初稿，定义五维↔五行对应、相生相克原则 |
| v2.0 | 2026-07-12 | ①克从"惩罚"升级为"信号/平衡"；②维度定义细化（行→人际和谐、心三层拆分）③完整生克算法；④扩展DTO；⑤跨文档引用 |
| v2.1 | 2026-07-13 | 富子维度表补全（孩子3+成人3，去掉"待补"占位），补全身克富杠杆三态公式与 DTO 字段说明 |