Project lingjing
灵镜报告需求文档 v2（待确认）
状态：待范总确认 更新时间：2026-02-23
一、报告定位
- 用户完成30题AI对话后生成
- 总字数：2000-3000字
- 含可视化图表（雷达图 + 强度条 + 行动卡片）
- 核心体验：越读越觉得说的是我，每个结论都引用用户原话作为证据
二、报告模块（最终9个，顺序固定）
模块①：灵魂标签
- 字数：80-120
- 内容：3-5个精准标签词，极度命中，开头制造强共鸣
- 可视化：标签胶囊（Tag Pills）
- 示例：「慢热型行动者」「边界感极强」「内驱力深藏」
模块②：当下处境
- 字数：220-320
- 内容：先钉住用户"现在在哪个状态层"，让用户感到被看见
- 可视化：状态强度条（0-100，表示当下状态波动/压迫感强度）
模块③：五维镜像
- 字数：320-420（含图解读文字）
- 内容：五个维度评分 + 解读，引用原话证据
- 五维名称：心力 / 行力 / 感知 / 洞见 / 定力
- 心力：情绪稳定与自我修复能力
- 行力：启动与推进能力
- 感知：理解他人和表达边界的能力
- 洞见：看清问题本质的能力
- 定力：长期方向感与选择定力
- 可视化：五维雷达图（Canvas/SVG渲染，0-100）
- 评分规则：AI直接输出5个整数，后端校验（35-92钳制，max-min≤40）
模块④：性格解读
- 字数：420-560
- 内容：用大白话描述用户思维方式和行为模式，每个结论引用原话
- 可视化：证据引用块（Quote Cards）
- 格式：结论 → 「用户说：……」→ 这说明……
模块⑤：潜能与盲区
- 字数：320-420
- 内容：点明可放大的优势（潜能）和当前卡点（盲区）
- 可视化：左右双栏（潜能 | 盲区）
模块⑥：MBTI人格
- 字数：220-320
- 内容：AI根据对话内容推算用户MBTI类型（16型），给出对应解读
- 重要：不做标准MBTI测试题，而是AI根据30题对话内容综合判断
- 可视化：MBTI类型标签（如 INFP / ENTJ）+ 核心描述段落
- 输出字段：type（4字母）+ typeName（中文名）+ description
模块⑦：星座共鸣
- 字数：220-320
- 内容：对话接近结尾时自然问生日（"最后一个小问题，你是几月的生日？"），AI推算星座后输出共鸣内容
- 实现：预置12星座模板（核心特质 / 隐藏盲区 / 灵镜专属句 / 支持键）+ AI叠加用户对话个性化
- 可视化：星座徽章 + 共鸣文案块
模块⑧：当下信号
- 字数：220-320
- 内容：替代"三条路线"，只给一个单点突破——"你现在释放了某种信号，当X出现时，是你该出手的时候"
- 包含：信号名 / 紧迫度（高/中/低）/ 触发条件 / 含义 / 错过的代价
- 可视化：信号卡（含紧迫度色标）
模块⑨：支点行动 + 收束金句
- 字数：220-320 + 40-80
- 支点行动：1个主行动（今天可以做）+ 3件现在可以开始的事
- 收束金句：1句话总结，适合截图分享
- 可视化：主行动卡 + 3件事卡 + 强调文本
三、生成规则
证据引用规则（核心，决定"越读越准"体验）
- 每个核心结论必须带至少1条用户原话证据
- 格式固定：
「用户说：……」 - 证据必须是用户原文，禁止改写
- 全报告至少8条原话证据（建议8-14条）
- 禁止空话结论（无证据、无动作）
生成流水线（5步）
- 主模型输出严格JSON（含所有字段、评分、原话证据）
- 后端校验（评分规则 + 证据规则），失败最多重试2次
- 轻量润色（只润文本字段，不改分数和证据）
- 可视化数据打包（雷达图、强度条、行动卡片）
- 合并输出给前端渲染
四、Waiting页
等待文案（每3秒切换）
- 正在整理你的回答线索……
- 正在校准你的五维镜像……
- 正在提炼你的当下信号……
- 正在生成你的支点行动……
固定提示：已保存你的对话，可放心离开。
超时（>45秒）：提示继续等待或稍后查看
失败处理：静默重试1次 → 再失败显示"重新生成"按钮，不丢对话
五、技术实现要点
- 雷达图：Canvas/SVG前端渲染（不需要图片）
- MBTI推算：AI基于对话综合判断，非标准测试题
- 星座：后端根据用户输入月/日计算，查预置模板
- 报告存储：sessionId关联，支持断点续看
待范总确认的问题
- MBTI展示方式：直接显示4字母类型（如INFP）+ 中文名，还是只显示描述不显示类型码？
- 星座是否必填：用户不提供生日时，星座模块是否显示？还是整个模块跳过？
- 报告是否分免费/付费：现阶段全部内容免费看，还是部分模块付费解锁？
v2.0 封版更新（2026-02-23）
最终确认
- ✅ 星座：加入（对话结尾问生日，无生日不显示模块）
- ✅ MBTI：加入（AI根据对话综合推算，显示4字母类型码+中文名）
- ✅ 三条路线：已废弃，改为「当下信号」
- ✅ 图标：星座用Unicode符号（♈♉♊♋♌♍♎♏♐♑♒♓），MBTI用4字母+配色（分析者紫/外交者绿/哨兵蓝/探险家橙）
- ✅ 现阶段全部免费看
- ✅ 30题正式版已上线
技术实现状态
- API：ycapis GPT-5.3-Codex，
/v1/responses端点 - 报告生成时长：约40-45秒
- Waiting页：90秒超时，4句轮播文案，呼吸动画
- 报告页：滚动触发逐模块入场动画（IntersectionObserver）
- mock预览：
/report-preview?mock=1
已知问题（下版）
- Session存内存，PM2重启丢失 → 需Redis或文件持久化
- 报告生成较慢 → 考虑流式输出或分段生成
Gitea
- 仓库：https://git.darkerilclaw.com/lulu/lingjing
- 封版commit：0211f6a