darkeril
Project lingjing

灵镜 - 技术架构文档

🔮 灵镜 · 技术架构文档

版本:v0.1 · 2026-02-23


一、整体架构

用户


微信小程序 / H5


灵镜后端 API(Node.js)
 ├── 对话管理服务
 ├── 报告生成服务
 └── 支付服务

      ├── DeepSeek API(普通版对话)
      ├── GPT API(大师版)
      └── Claude API(大师版)

二、前端

技术选型

技术栈说明
微信小程序原生小程序 或 Taro主战场
H5验证版Vue 3 + Vite早期快速验证
抖音小程序Taro多端编译后期扩展

核心页面

  1. 首页 — 产品介绍 + 开始测试按钮
  2. 对话页 — AI逐步提问,用户输入回答
  3. 等待页 — 报告生成中(动画)
  4. 报告页 — 分模块展示结果
  5. 支付页 — ¥2.99/¥29.9解锁完整报告

报告卡片设计要求

  • 精美可截图,有分享欲
  • 包含:特点/局限/潜能/天赋/发展路线五个模块
  • 底部带灵镜logo水印(传播)

三、后端

技术选型

  • 运行时:Node.js 20+
  • 框架:Express 或 Hono(轻量)
  • 数据库:SQLite(早期)→ MySQL(规模后)
  • 部署:PM2 + 现有服务器(103.201.130.54)

核心接口

POST /api/session/start        # 创建对话session
POST /api/session/message      # 发送用户回答,获取下一问
POST /api/session/complete      # 对话完成,触发报告生成
GET  /api/report/:sessionId    # 获取报告
POST /api/pay/create           # 创建支付订单
POST /api/pay/callback         # 微信支付回调

对话状态机

START → 问题1 → 问题2 → ... → 问题N → 分析中 → 报告完成
  • 每个session存储:问题列表、用户回答、当前进度、报告结果
  • 最多40轮对话,AI根据上下文动态调整问题深度

四、AI模型策略

普通版(免费/¥2.99)

System Prompt(问题框架)


   DeepSeek API

   逐轮对话(30-40题)


   结构化报告生成
  • 成本:约¥0.05-0.1/次(DeepSeek极便宜)
  • ¥2.99付费版边际利润极高

大师版(¥29.9)

用户对话记录

   ┌────┴────┐
   ▼         ▼
Claude API  GPT API
(侧重人格) (侧重路径)
   │         │
   └────┬────┘

   两份分析汇总


   最终大师报告(Claude综合)
  • 成本:约¥2-5/次
  • 售价¥29.9,利润率500%+

五、System Prompt框架(核心)

对话阶段设计

阶段题数方向
热身1-5题轻松日常,建立信任
深挖6-15题价值观、决策模式
压力测试16-25题挑战性场景,暴露盲区
潜能探索26-35题梦想、激情、天赋
未来定向36-40题方向、行动意愿

报告输出格式(结构化JSON)

{
  "character": "性格特点描述",
  "limitations": ["局限1", "局限2", "局限3"],
  "potential": "潜能描述",
  "talents": ["天赋1", "天赋2"],
  "career_paths": [
    {"path": "路线1", "reason": "原因", "match": "85%"},
    {"path": "路线2", "reason": "原因", "match": "72%"}
  ],
  "summary": "一段有共鸣感的总结"
}

六、数据库设计

sessions 表

字段类型说明
idVARCHARsession唯一ID
created_atDATETIME创建时间
statusENUMpending/completed/paid
versionENUMfree/basic/master
messagesJSON对话历史
reportJSON生成的报告
paid_atDATETIME付费时间

七、支付集成

  • 微信支付:JSAPI支付(小程序内)
  • 金额:¥2.99(普通版)/ ¥29.9(大师版)
  • 付费后解锁完整报告,生成PDF

八、部署方案

早期(H5验证阶段)

  • 服务器:103.201.130.54(现有)
  • 端口:3200(新进程)
  • PM2进程名:lingjing-api
  • 域名:lingjing.darkerilclaw.com 或独立域名

正式版(小程序上线后)

  • 考虑独立域名(配合微信小程序备案要求)
  • 数据库升级MySQL
  • Redis缓存热门session

九、开发里程碑

Phase内容预计时间
P1System Prompt设计+测试1-2天
P2H5验证版(对话+简单报告)3-5天
P3支付接入+报告卡片设计3-5天
P4微信小程序版1-2周
P5大师版双模型1周

十、风险与应对

风险应对
API成本超支DeepSeek兜底,限制普通版每日请求量
报告质量不稳定A/B测试多套Prompt,人工评审样本
微信小程序审核避免"算命"等敏感词,定位为"AI自我探索工具"
用户数据隐私不存储姓名/手机等个人信息,session匿名化

技术架构 v0.1 · 灵镜项目 · 2026-02-23

On this page