feat: 完善周期报告与用户行为分析

- 支持可配置周报月报模板与登录后异步补生成\n- 增加用户行为埋点和后台分析页面\n- 移除主题额度并保留实修回顾结算\n- 修复历史会话续聊上下文丢失
This commit is contained in:
2026-08-19 11:53:34 +08:00
parent 833763c461
commit efe835be81
75 changed files with 3325 additions and 578 deletions

View File

@@ -101,12 +101,10 @@ Agent 调用链接入近期实修回顾与权益
- 名称;
- 类型:基础版 / 深度陪伴版 / 高频加购包;
- 有效天数;
- 每月主题会话额度;
- 是否开启近期实修回顾;
- 是否开启周报/月报;
- 是否允许生成老师求助卡;
- 是否允许生成班级分享稿;
- 是否参与普通额度扣减;
- 状态;
- 创建时间、更新时间。
@@ -213,7 +211,7 @@ Agent 调用链接入近期实修回顾与权益
#### 验收标准
- 用户可以围绕一个主题连续追问;
- 一个主题只扣一次主题额度
- 内部对话分段不计费、不计数,也不影响用户继续问答
- 管理后台能看到主题会话;
- 主题能关联原始聊天消息;
- 主题结束后可用于近期实修回顾沉淀。
@@ -340,7 +338,7 @@ Agent 已经可以:
#### 开发进度
- 2026-07-31已补齐后台预览的“模拟学员”入口;选择学员后,预览链路会加载该学员权益、主题额度使用量和实修回顾上下文,并在检索追踪中记录 `load_debug_user_context`。默认不选择学员时,保持原后台调试行为
- 2026-08-17后台预览的“模拟学员”入口会加载该学员的能力权益和实修回顾上下文,并在检索追踪中记录 `load_debug_user_context`;不再加载或显示任何主题额度数据
- 2026-07-31后台预览已支持继续选择具体主题加载主题摘要、滚动摘要和最近消息正式聊天与后台预览均会按权益注入实修回顾、求助卡和分享稿能力并在追踪中记录模型路由与上下文来源。
- 2026-07-31一期全链路已完成隔离生产编排、真实模型问答、流式响应、主题上下文、实修回顾、求助卡、分享稿、异步报告和记录审计验收。详细结果见《一期全链路验收记录》。
- 2026-08-03主题结束已改为持久化异步沉淀。接口快速结束主题并创建唯一任务后台独立生成主题摘要和近期实修回顾支持自动重试、服务重启恢复、用户端状态查询和后台手动重试原同步模型调用不再阻塞用户操作。
@@ -544,12 +542,8 @@ Agent 已经可以:
#### 规则建议
- 不直接强调“还剩几次提问”;
- 展示为“本月主题使用情况”;
- 接近上限时提示
- 本月深度主题使用较多;
- 建议先完成已有功课;
- 如需持续陪伴可联系运营升级;
- 超出后不要突然硬断所有能力,可以保留基础知识查询或提示联系运营确认。
- 展示“今日问答使用情况”;
- 达到每日调用上限后给出明确、柔性的恢复时间和联系运营提示
#### 需要改的代码模块
@@ -570,7 +564,7 @@ Agent 已经可以:
#### 开发进度
- 2026-07-31用户端额度条已改为“本月主题使用情况 / 今日陪伴使用情况”,接近上限时给出先沉淀/消化功课的提醒;后端每日额度超限文案已从“次数用完”改为陪伴式权益确认提示。主题额度超限已使用柔性文案
- 2026-08-17移除月度主题额度及其扣减、统计和拦截逻辑用户仅受每日问答次数限制。内部对话分段与摘要继续专门服务于近期实修回顾不再具有任何额度含义
---
@@ -657,7 +651,7 @@ AI 日志增加:
- 账号与当前套餐;
- 套餐说明、生效时间和有效期;
- 本月主题、今日问答用量和剩余额度
- 今日问答用量和剩余次数
- 当前套餐包含的能力;
- 最近主题;
- 主题摘要;
@@ -680,7 +674,7 @@ AI 日志增加:
- 2026-07-31用户端原“我的档案”弹窗已扩展为实修记录视图可查看实修回顾、最近主题沉淀、最近老师求助卡和最近班级分享稿仍保持“我的实修记录”表达不做后台画像式展示。
- 2026-08-03升级为 V2“近期实修回顾”。移除常见情绪、身体/关系模式、做过或有效功课、近期变化等字段;旧版数据不再展示或注入 Agent下一次主题沉淀时按最近30天、最多10个新版主题懒重建。
- 2026-08-03新增用户端“个人中心”顶部头像入口统一展示账号、当前套餐、有效期、本月主题和今日问答用量、剩余额度及能力清单;近期回顾、周期回顾、求助卡和分享稿按栏目查看。基础版会明确提示未包含的能力,不做成长评分、打卡天数或结果排名。
- 2026-08-03新增用户端“个人中心”顶部头像入口统一展示账号、当前套餐、有效期、今日问答用量及能力清单近期回顾、周期回顾、求助卡和分享稿按栏目查看。基础版会明确提示未包含的能力不做成长评分、打卡天数或结果排名。
- 2026-08-03完成权益到期与续期闭环。后台用户列表支持按权益版本、生效中、7 天内到期、8-30 天内到期、已到期和默认权益筛选;支持单人及最多 200 人批量续期,未到期从原到期日顺延,已到期从当前时间恢复,长期有效和未分配专属权益会明确拒绝。续期使用请求唯一键防止重复加天,并记录操作人、前后到期时间和备注;小时级维护任务分批归档已到期权益。用户端在临近到期及自动切换基础权益时使用柔性提示,并明确已有聊天、回顾和卡片不会丢失。
---
@@ -704,7 +698,6 @@ AI 日志增加:
- 当前权益;
- 权益有效期;
- 本月主题会话数;
- 使用频率;
- Token/成本;
- 最近主题;
@@ -722,7 +715,7 @@ AI 日志增加:
#### 开发进度
- 2026-07-31:后台用户管理新增“详情”抽屉,独立接口按需读取用户运营摘要;展示当前权益、权益有效期、本月主题数、近30天活跃天数、会话/消息/Token/成本、最近主题、近期实修回顾、老师求助卡和班级分享稿记录。列表接口仍只返回分页摘要,避免用户管理打开变慢。
- 2026-08-17:后台用户详情不再展示月度主题计数或主题总数;保留近30天活跃天数、会话/消息/Token/成本、实修回顾资料、求助卡和分享稿记录。
---
@@ -782,6 +775,7 @@ AI 日志增加:
- 2026-07-31报告生成已改为数据库持久化异步任务。管理员点击生成后接口立即返回后台 Worker 独立生成;支持等待、执行中、成功、空报告、失败状态,最多自动重试 3 次,服务重启后会恢复超时任务。同一用户、类型和周期由唯一约束保证幂等。
- 2026-07-31已接入自然周和自然月定时生成。默认按 `Asia/Shanghai` 在每周一 02:00 生成上一自然周周报、每月 1 日 03:00 生成上一自然月月报;只为权益开启周期报告且本周期存在成功主题摘要的有效用户入队。用户端只显示成功报告,后台可查看任务状态、执行次数、失败原因并手动重新生成。
- 2026-08-03周期报告升级为 V2 实修回顾,只读取新版主题摘要,不再读取长期画像,也不生成情绪/身体/关系模式、功课效果、成长变化、评分或下一阶段目标;旧版报告默认隐藏,重新生成后升级为 V2。
- 2026-08-18周期报告升级为 V3。周报改为读取自然周内全部已完成聊天消息超长材料按消息边界分批整理并逐层归并月报改为等待并汇总覆盖该月的周报。管理后台“内容生成”新增周报告、月报告两套独立变量、AI 规则、排版模板、预览、测试和版本回滚配置;旧版报告隐藏并按新来源重新生成。
---

View File

@@ -26,7 +26,7 @@
| 用户登录 | 通过 | 通过真实页面完成验证码登录并进入聊天页 |
| 用户端流式问答 | 通过 | 显示“思考中”,随后流式展示 Markdown 回答;发送后输入框立即清空 |
| 用户端主题上下文 | 通过 | 连续消息均绑定同一主题,历史消息与主题上下文可继续使用 |
| 用户端个人中心 | 通过 | 顶部统一入口展示账号、套餐说明、有效期、本月主题、今日问答、剩余额度和能力清单;近期回顾与生成记录分栏展示;临期或降级时显示柔性说明 |
| 用户端个人中心 | 通过 | 顶部统一入口展示账号、套餐说明、有效期、今日问答用量和能力清单;近期回顾与生成记录分栏展示;临期或降级时显示柔性说明 |
| 后台 Agent 预览 | 通过 | 可选择模拟学员和具体主题,能够加载权益、主题摘要、最近消息和近期实修回顾 |
| Agent 运行追踪 | 通过 | 能看到 `load_debug_user_context`、模型路由等追踪节点 |
| 主题沉淀 | 通过 | 结束主题快速入队;主题摘要与近期实修回顾后台生成;支持幂等、自动重试、重启恢复和管理员手动重试 |