# 数字心理学AI智能体 · 需求规格说明书

> 版本：v1.0
> 更新日期：2026-05-27
> 状态：初稿
> 参考文档：`docs/1.0产品对齐方案.md`、`docs/presentation/comparison/index.html`

---

## 一、文档目标

本文档定义了"数字心理学AI智能体"1.0版本的产品需求规格，涵盖产品定位、用户角色、功能范围、业务流程、界面需求、数据需求及非功能性需求。本文档面向技术开发团队（后端1人 + 前端2人 + AI1人 + 产品1人），作为后续详细设计、开发排期和测试用例编写的依据。

---

## 二、产品概述

### 2.1 产品名称

**数字心理学·全生命周期AI赋能系统**（简称：数字心理学AI智能体）

### 2.2 产品定位

以数字能量学理论为核心，结合AI大模型能力，为数字心理学从业者（能量师）提供智能工具平台，同时通过能量师触达C端用户，实现"工具赋能→客户引流→培训转化"的商业闭环。

### 2.3 核心理念

1. **B端先行、C端引流** — 第一阶段从能量师（B端）付费订阅切入，C端用户通过能量师分享引流
2. **AI驱动交付** — 能量盘生成+AI解读全部自动化，能量师无需手动计算
3. **分销裂变** — 能量师推荐能量师（两级佣金）+ 能量师推荐C端客户（40%+5%分成）
4. **培训引流** — 工具使用深度 → 引导能量师参加培训认证，形成"工具→学习→认证"升级路径

### 2.4 收入模型

| 角色 | 收入来源 | 说明 |
|------|---------|------|
| **技术方** | 能量师 ¥998/人（固定）+ C端40%分成 | 不参与分销分润 |
| **运营方** | B端分润 + C端15% + 培训引流转化 | 负责支付 ¥500+¥100 佣金 |

---

## 三、用户角色

### 3.1 用户角色矩阵

| 角色 | 描述 | 终端 | 付费方 |
|------|------|------|--------|
| **普通用户（访客）** | 通过能量师分享进入的C端用户，免费体验 | 微信小程序 | 免费 |
| **C端付费用户** | 购买 ¥131/年 订阅的普通用户 | 微信小程序 | 自己 |
| **能量师（B端）** | 付费订阅 ¥1,314-1,986/年的从业者 | 微信小程序 + Web后台 | 自己 |
| **运营方管理员** | 推广运营团队，管理能量师和分销数据 | Web后台 | — |
| **系统管理员** | 技术方运维，管理系统配置和数据 | Web后台 | — |

### 3.2 能量师核心流程

```
能量师付费订阅（¥1,314-1,986/年）
  ├── 获得AI辅助工具
  │     → 输入客户姓名+生日 → 生成三角形能量盘
  │     → 获得AI完整解读（性格/天赋/职业/财富等维度）
  │     → 将解读结果用于线下服务或直接分享给客户
  ├── 获得推广工具（专属小程序码）
  │     → 分享给客户 → 客户扫码绑定到能量师名下
  │     → 查看客户与AI的互动记录
  │     → 补充客户信息，完善客户画像
  └── 获得分销佣金
        → 客户购买C端年费（¥131）→ 能量师获40%（¥52.40）
        → 推荐其他能量师订阅 → 一级佣金¥500
        → 被推荐人再推荐 → 原推荐人获二级佣金¥100
```

---

## 四、功能全景

### 4.1 1.0 六大模块

| 编号 | 模块 | 核心功能 | 估工 |
|------|------|---------|------|
| ① | 三角形能量盘引擎 | Canvas可视化，3秒出图，五区色块 | 3周 |
| ② | AI五区+职业+财富完整解读 | LLM自动生成多维度解读，Prompt调优迭代 | 5周 |
| ③ | 少儿板块完整版 | 性格+天赋+职业方向+学习判定（独立Prompt体系） | 4周 |
| ④ | 能量师CRM | 客户绑定/互动记录/信息补充/客户列表/活跃度 | 4周 |
| ⑤ | 分销支付体系 | 微信支付/C端裂变/分销面板/佣金提现/推广码 | 4周 |
| ⑥ | 分享导出+培训引流 | 图片/PDF导出、培训嵌入、认证标识、数据统计 | 3周 |

### 4.2 分阶段上线计划

| 阶段 | 时间 | 上线功能 | 板块标签 |
|------|------|---------|---------|
| **P1** | M1-2（8周） | ①能量盘引擎 + ②成人主性格+成长财富量级 + ③少儿天赋解码+职业方向 + ④CRM基础 + ⑤分销基础+支付 + 免费访客 | — |
| **P2** | M3（4周） | ⑤分销面板+C端支付+裂变完整版 + ④互动查看 | **⑤分销支付体系** |
| **P3** | M4（4周） | ②成人五区完整（父源+母源+左中右区）+ ④CRM完善 + ⑥分享导出 | **②成人完整解读** |
| **P4** | M5（4周） | ③少儿完整板块（性格+学习判定）+ ⑥培训引流+认证+数据 | **③少儿完整板块** |
| **P5** | M6（4周） | 性能优化+推荐体系完善+系统优化 | — |
| **P6** | M7（4周） | ⑥分享导出完善+全功能收尾发布 | — |

---

## 五、Phase 1 详细需求（核心开发阶段）

Phase 1 为8周MVP阶段，是最关键的交付节点。以下按功能模块逐一说明。

### 5.1 三角形能量盘引擎（①）

#### 功能描述

输入姓名和出生日期，3秒内生成数字能量学三角形能量盘图，包含五区色块区分。

#### 输入

| 字段 | 类型 | 校验规则 |
|------|------|---------|
| 姓名 | string（2-20字符） | 必填，支持中文 |
| 出生日期 | date（yyyy-mm-dd） | 必填，范围 1900-01-01 ~ 今日 |
| 性别 | enum（男/女） | 可选 |

#### 输出

- **三角形能量盘图**：Canvas 渲染，包含五区色块（不同颜色区分主性格区、父源区、母源区、左区、中区/右区）
- **数字标注**：在能量盘图中标注每个位置的计算结果数字
- **响应时间**：≤ 3秒（含AI解读请求时间）

#### 交互要求

- 支持在移动端（微信小程序）和 Web 端渲染
- Canvas 适配不同屏幕尺寸（320px ~ 1920px）
- 生成后支持图片长按保存（移动端）

### 5.2 AI 解读系统（② + ③ 子集）

#### 总体说明

AI解读是平台的核心价值。Phase 1 首发 4 个解读维度，后续阶段扩展完整模块。

#### Phase 1 AI 解读维度（4个）

| 解读维度 | 适用对象 | 说明 | 对应模块 |
|---------|---------|------|---------|
| **主性格解读** | 成人 | 基于主性格数字，分析核心性格特质、优势、挑战 | ②子集 |
| **成长财富量级** | 成人 | 基于能量盘数字组合，分析财富潜力、赚钱模式、财富增长阶段 | ②子集 |
| **少儿天赋解码** | 少儿 | 基于生日数字，分析天赋潜能、天生优势领域 | ③子集 |
| **少儿职业方向** | 少儿 | 基于能量盘数字，分析适合的职业发展方向、职业性格匹配 | ③子集 |

#### 解读交互

- 能量盘生成后，解读内容自动展示在能量盘下方
- 以卡片式分区展示，每个解读维度一张独立卡片，可横向滑动切换
- 解读内容应包含：**数字依据 + AI生成解读正文 + 建议/提示**
- 支持保存为图片分享（Phase 1 可先做截图分享，完整导出功能在 P3 上线）

#### AI Prompt 要求

| 维度 | Prompt 设计要点 |
|------|---------------|
| 主性格 | 基于主性格数字1-9，输出性格特质、优势、挑战、适合领域 |
| 成长财富量级 | 基于能量盘数字组合（先天数+后天数+主性格+外心等），分析财富格局、赚钱模式（稳定型/爆发型/积累型等）、当前所处财富阶段 |
| 少儿天赋解码 | 基于生日数字，分析天赋潜能（沟通/创造/逻辑/领导/艺术等维度） |
| 少儿职业方向 | 基于能量盘数字，分析职业倾向（技术型/创意型/社交型/管理型/研究型等），推荐1-3个适合方向 |

#### 免费 vs 付费限制

| 用户类型 | 主性格 | 成长财富量级 | 少儿天赋解码 | 少儿职业方向 |
|---------|--------|------------|------------|------------|
| 免费访客 | ✅ 文字概要（非完整版） | ❌ 仅标题预览 | ❌ 仅标题预览 | ❌ 仅标题预览 |
| C端付费 ¥131 | ✅ 完整 | ✅ 完整 | ✅ 完整 | ✅ 完整 |
| 能量师 ¥1,314+ | ✅ 完整 | ✅ 完整 | ✅ 完整 | ✅ 完整 |

### 5.3 分销基础 + 微信支付（⑤ 子集）

#### 功能列表

| 功能 | 说明 | Phase 1 范围 | 完整版在 |
|------|------|-------------|---------|
| 微信支付接入 | 能量师订阅 ¥1,314/年 支付 | ✅ 完整版 | — |
| 推广码生成 | 每个能量师生成唯一小程序码 | ✅ 基础版 | P2完善 |
| 佣金记录 | 记录推荐关系及佣金数据 | ✅ 基础版（数据记录） | P2面板展示 |
| 分销面板 | 收益统计+团队树+佣金明细 | ❌ | P2 |
| C端支付+裂变 | C端 ¥131 订阅 + 邀请奖励 | ❌ | P2 |

#### 微信支付需求

- 接入微信支付 JSAPI（小程序内支付）
- 支付成功后自动开通对应权限（能量师订阅 → 解锁全部功能）
- 支持退款处理（后台手动）
- 支付回调通知（notify_url）

### 5.4 CRM 基础（④ 子集）

#### 功能列表

| 功能 | Phase 1 | 完整版 |
|------|---------|--------|
| 客户绑定 | ✅ 通过扫能量师小程序码自动绑定 | — |
| 客户列表 | ✅ 展示已绑定客户基本信息 | — |
| 客户互动记录 | ❌ | P2 |
| 客户备注/标签 | ❌ | P3 |
| 客户活跃度 | ❌ | P3 |

#### 客户绑定流程

```
能量师在工具内获取专属小程序码
  → 分享给客户（微信聊天/朋友圈）
  → 客户扫码进入小程序
  → 系统自动将客户与该能量师绑定
  → 客户后续所有使用数据对该能量师可见（互动记录权限）
```

### 5.5 免费访客入口

#### 功能描述

- 未登录用户 / 未付费用户可通过能量师分享的链接进入小程序
- 免费体验内容：
  - 每日 3 次能量盘生成（含主性格概要文字版）
  - 成长财富量级、少儿天赋解码、少儿职业方向 仅展示标题和付费解锁提示
- 体验引导：
  - 体验后提示购买 C 端年费 ¥131 获得完整解读
  - 或联系能量师获得深度解读服务

---

## 六、业务规则

### 6.1 定价规则

| 项目 | 价格 | 有效期 | 说明 |
|------|------|--------|------|
| 能量师年费（种子价） | ¥1,314/年 | 首300人 | 首批种子能量师锁定优惠价 |
| 能量师年费（标准价） | ¥1,986/年 | — | 正常价格 |
| C端用户年费 | ¥131/年 | — | 普通用户订阅 |
| 免费试用 | ¥0 | 每日3次 | 能量盘+主性格概要 |

### 6.2 分销规则

| 场景 | 佣金/分成 | 说明 |
|------|----------|------|
| 能量师→能量师（一级） | ¥500 | 直接从运营方份额支出 |
| 能量师→能量师（二级） | ¥100 | 间接推荐，从运营方份额支出 |
| 能量师→C端（直接） | ¥52.40（40%） | C端消费 ¥131 的 40% |
| 能量师→C端（上级） | ¥6.55（5%） | 上级能量师获得 5% |

### 6.3 技术方-运营方分账

- B端：技术方固定 ¥998/人，运营方获得剩余（种子价¥1,314-¥998=¥316/人，标准价¥1,986-¥998=¥988/人），运营方从自身份额中支付 ¥500+¥100 佣金
- C端 ¥131：技术方 40%（¥52.40）+ 运营方 15%（¥19.65）+ 能量师 40%（¥52.40）+ 上级 5%（¥6.55）

### 6.4 三角形能量盘计算规则

**输入：** 出生年份（4位）、月份（2位）、日期（2位）

能量盘计算采用 **30位系统**（A-X），由后端 `CalculatorService` 计算，前端 `calculator.js` 作为降级兜底。

#### 6.4.1 输入层（A-H）—— 生日原始数字

| 字母 | 来源 | 示例 1990-01-15 |
|------|------|----------------|
| A | 年[0] 千位 | 1 |
| B | 年[1] 百位 | 9 |
| C | 年[2] 十位 | 9 |
| D | 年[3] 个位 | 0 |
| E | 月[0] 十位 | 0 |
| F | 月[1] 个位 | 1 |
| G | 日[0] 十位 | 1 |
| H | 日[1] 个位 | 5 |

#### 6.4.2 内部计算层（I-O）—— 7位

| 字母 | 公式 | 中文名 |
|------|------|-------|
| I | `reduce(E+F)` | 月能量 |
| J | `reduce(G+H)` | 日能量 |
| K | `reduce(A+B)` | 年前位 |
| L | `reduce(C+D)` | 年后位 |
| M | `reduce(I+J)` | 青年综合数 |
| N | `reduce(K+L)` | 晚年综合数 |
| O | `reduce(M+N)` | 主性格 |

#### 6.4.3 外部三组（P-X）—— 9位独立计算

| 字母 | 公式 | 中文名 | 年龄区间 | 所属组 |
|------|------|-------|---------|-------|
| P | `reduce(I+M)` | 左侧左子 | 21-40 | 左侧 |
| Q | `reduce(J+M)` | 左侧右子 | 21-40 | 左侧 |
| R | `reduce(P+Q)` | **左侧主数** | 21-40 | 左侧 |
| S | `reduce(K+N)` | 右侧左子 | 61+ | 右侧 |
| T | `reduce(L+N)` | 右侧右子 | 61+ | 右侧 |
| U | `reduce(S+T)` | **右侧主数** | 61+ | 右侧 |
| V | `reduce(M+O)` | 顶部左子 | 41-60 | 顶部 |
| W | `reduce(N+O)` | 顶部右子 | 41-60 | 顶部 |
| X | `reduce(V+W)` | **顶部主数** | 41-60 | 顶部 |

**注意：** 外部三组必须使用独立的归约计算，不得直接引用内部数字值。

#### 6.4.4 归约规则

- `reduce(N)` 定义：各位数字相加归约至个位，但 11/22/33 保留为卓越数
- 所有 `+` 操作符均先执行普通加法，再调用 `reduce()` 归约

#### 6.4.5 三角形布局

```
                X
              ↙   ↘
            V       W
          ↙           ↘
        M ───────────── N
      ↙   ↘          ↙   ↘
    P       Q      S       T
  ↙           ↘  ↙           ↘
I ─────────── J  K ─────────── L

 R (21-40)         U (61+)
```

#### 6.4.6 外部三组年龄映射

| 组 | 位置 | 年龄区间 | 关联内部位 |
|----|------|---------|----------|
| 左侧组 (R, P, Q) | 三角形左外侧 | 21-40岁 | 基于 I, J, M |
| 顶部组 (X, V, W) | 三角形顶外侧 | 41-60岁 | 基于 M, N, O |
| 右侧组 (U, S, T) | 三角形右外侧 | 61+岁 | 基于 K, L, N |

#### 6.4.7 五区定义

| 区域 | 包含位置 | 含义 |
|------|---------|------|
| 主性格区 | O | 核心人格特质 |
| 左区（月日能量） | I, J, M | 月日融合之力 |
| 右区（年份能量） | K, L, N | 年份能量凝聚 |
| 父源区 | I, M | 父亲遗传、先天能量 |
| 母源区 | L, N | 母亲遗传、后天能量 |

#### 6.4.8 数字配色

| 数字 | 颜色 |
|------|------|
| 1 | #D94A4A 赤红 |
| 2 | #4A90D9 冰蓝 |
| 3 | #E8A238 琥珀 |
| 4 | #2D8B67 翡翠 |
| 5 | #D4A017 金色 |
| 6 | #7B6FA0 紫灰 |
| 7 | #4A6FA5 靛蓝 |
| 8 | #C9A84C 暗金 |
| 9 | #B85C3A 铜橙 |

---

## 七、非功能性需求

### 7.1 性能需求

| 指标 | 要求 |
|------|------|
| 能量盘生成 + AI解读 | ≤ 3 秒 |
| 页面首屏加载 | ≤ 2 秒（小程序） |
| 能量盘图Canvas渲染 | ≤ 1 秒 |
| 并发用户 | 初期支持 100 人同时在线 |

### 7.2 安全性需求

- 用户密码/登录信息加密存储
- 能量盘数据（姓名+生日+AI解读）需做访问权限控制
- 能量师只能查看自己绑定的客户数据
- 支付相关签名使用微信支付 SDK 规范
- API 鉴权（JWT token 或 session）

### 7.3 兼容性需求

- 微信小程序（iOS + Android）
- Web 管理后台（Chrome / Edge / Safari 最新版本）
- Canvas 渲染适配：iPhone SE ~ iPhone Pro Max ~ Android 主流分辨率

### 7.4 数据存储需求

| 数据类型 | 存储说明 |
|---------|---------|
| 用户账号 | 微信 openId + 用户信息 |
| 能量师-客户绑定关系 | 关系表（能量师ID + 客户ID + 绑定时间） |
| 能量盘生成记录 | 每次能量盘生成保存结果（含姓名+生日+解读），可追溯 |
| 佣金/分销数据 | 推荐关系链 + 佣金记录 + 提现记录 |
| 支付流水 | 微信支付订单号 + 金额 + 状态 + 回调记录 |

---

## 八、团队与排期

### 8.1 团队配置

| 角色 | 人数 | 核心职责 |
|------|------|---------|
| 后端开发 | 1 | API + 数据库 + 支付对接 + 服务器部署 + 运维 |
| 前端开发 | 2 | 微信小程序 + 管理后台 + Canvas 能量盘渲染 |
| AI 工程师 | 1 | Prompt 设计调优 + 模型选型 + Token 成本控制 |
| 产品经理 | 1 | 需求定义 + 进度管理 + 跨团队协调 |

### 8.2 Phase 1 排期估算（8周）

| 周次 | 重点工作 |
|------|---------|
| W1-2 | 技术选型 + 架构设计 + 数据库设计 + 微信小程序框架搭建 |
| W3-4 | 能量盘引擎 Canvas 开发 + 后端 API 框架 + 用户系统 |
| W5-6 | AI Prompt 开发（4个解读维度）+ 后端解读API + 微信支付接入 |
| W7-8 | CRM 基础 + 分销基础 + 联调测试 + Bug 修复 + 上线准备 |

---

## 九、附录

### 9.1 Phase 1 交付清单

| 交付物 | 说明 |
|--------|------|
| 三角形能量盘引擎 | Canvas 可视化，3秒出图 |
| AI 主性格解读 | 成人性格分析（完整版） |
| AI 成长财富量级 | 成人财富潜力分析 |
| AI 少儿天赋解码 | 少儿天赋潜能分析 |
| AI 少儿职业方向 | 少儿职业倾向分析 |
| 微信支付 | 能量师 ¥1,314/¥1,986 订阅支付 |
| CRM 基础 | 客户绑定 + 客户列表 |
| 分销基础 | 推广码生成 + 佣金记录 |
| 免费访客 | 限次体验 + 付费引导 |

### 9.2 术语表

| 术语 | 说明 |
|------|------|
| 能量盘（三角形能量盘） | 基于数字能量学理论，通过姓名+生日计算生成的能量盘图 |
| 五区 | 数字能量学三角形的五个区域：主性格区、父源区、母源区、左区、中区/右区 |
| 能量师 | 数字心理学从业者，B端付费用户 |
| 主性格 | 能量盘中最核心的数字，代表人的基本性格特质 |
| 成长财富量级 | 基于能量盘数字分析财富潜力和模式的解读维度 |
| 少儿天赋解码 | 针对少儿的天赋潜能分析 |
| 少儿职业方向 | 针对少儿的职业发展方向推荐 |
| CRM | 能量师-客户关系管理 |
| 推广码 | 每个能量师专属的小程序码，用于客户绑定 |

### 9.3 文档变更记录

| 日期 | 版本 | 变更内容 |
|------|------|---------|
| 2026-05-27 | v1.0 | 初稿，含 Phase 1 四个AI解读维度 |
| 2026-05-29 | v1.1 | 定价统一（种子¥1,314/标准¥1,986/年费¥131）；补充§6.4计算规则与数字配色；C端分销金额同步更新 |