# 千问千答产品 TODO 清单（按代码影响顺序与改动大小排序）

> 版本：v0.1  
> 日期：2026-07-31  
> 范围：仅针对“千问千答·五个月实修陪伴服务”本身，不包含慧能训练师培养、教务排班、师资认证、收入结算、老学员权益转轨等独立业务系统。

## 1. 产品边界

千问千答当前产品定位是：

> 面向大本营学员的 AI 实修陪伴工具，用来帮助学员查课程知识、梳理当下议题、找到功课方向、沉淀成长记录，并在必要时由用户主动生成给人工老师看的求助卡。

明确不做：

- 不做自动转人工；
- 不做老师派单；
- 不做工单流转；
- 不做老师处理状态；
- 不做师资认证、见习、督导、收入结算；
- 不做 108000 / 40000 老学员权益转轨账户；
- 不把慧能训练师体系强行塞进千问千答。

允许做：

- AI 在回复中提醒用户：“这个问题建议找人工老师确认”；
- 用户主动生成“老师求助卡”；
- 用户自行复制求助卡发给老师或班级群；
- 后台记录“用户生成过求助卡”这个事实，用于运营分析，但不形成派单。

## 2. 排序原则

本 TODO 按两个维度排序：

1. **代码影响顺序**：先排会影响数据库模型、Agent 调用链、用户权益判断的底层改动，再排用户端和后台页面。
2. **改动大小**：优先识别大改动和依赖项，避免先做小功能后返工。

改动大小标记：

- **L**：大改动，涉及数据库迁移、核心服务、前后端多处联动；
- **M**：中改动，涉及新增接口、页面和部分业务逻辑；
- **S**：小改动，主要是 UI、配置、文案或局部功能增强。

## 3. 总体依赖顺序

```text
权益版本体系
  ↓
主题会话机制
  ↓
主题摘要 / 近期实修回顾
  ↓
Agent 调用链接入近期实修回顾与权益
  ↓
用户端实修能力：求助卡、分享稿、近期实修回顾
  ↓
后台运营能力：用户详情、成本、问题洞察二期
  ↓
报告体系：周报、月报、五个月总结
```

不要先做周报、分享稿或漂亮页面。它们依赖主题会话和近期实修回顾，提前做会变成“无数据可用的壳”。

## 4. TODO 清单

### 01. 权益版本体系

- 优先级：P0
- 改动大小：L
- 影响范围：数据库、用户管理、登录态/Profile、聊天额度校验、用户端权益展示、后台配置
- 建议先做：是

#### 当前现状

当前用户模型主要有：

- 启用状态；
- 每日聊天额度；
- 已用次数；
- 有效期。

这还不能表达文档中的：

- 大本营基础版；
- 五个月深度陪伴版；
- 高频加购包。

#### 目标

建立真正的“产品权益”模型，而不是只用每日消息额度顶替。

#### 需要新增的数据

建议新增：

- `sys_entitlement_plan`：权益版本；
- `sys_user_entitlement`：用户当前权益；
- `sys_user_entitlement_log`：权益变更日志。

权益版本字段建议包含：

- 名称；
- 类型：基础版 / 深度陪伴版 / 高频加购包；
- 有效天数；
- 每月主题会话额度；
- 是否开启近期实修回顾；
- 是否开启周报/月报；
- 是否允许生成老师求助卡；
- 是否允许生成班级分享稿；
- 是否参与普通额度扣减；
- 状态；
- 创建时间、更新时间。

#### 需要改的代码模块

- 后端：
  - 用户模型；
  - 用户管理接口；
  - 用户登录/Profile 接口；
  - 聊天前置校验；
  - 系统配置或新增权益配置接口。
- 管理端：
  - 用户管理；
  - 用户新增/导入；
  - 用户详情；
  - 权益配置页面。
- 用户端：
  - 个人权益展示；
  - 额度提醒展示。

#### 验收标准

- 管理员可以创建/启用/停用权益版本；
- 管理员可以给用户分配权益；
- 用户登录后能看到自己的权益状态；
- 聊天接口按权益判断是否可用；
- 所有权益变更有审计记录。

---

### 02. 主题会话机制

- 优先级：P0
- 改动大小：L
- 影响范围：数据库、聊天服务、Agent 上下文、额度扣减、记录审计、用户端会话 UI
- 依赖：权益版本体系

#### 当前现状

当前系统有聊天会话和聊天消息，但没有“一个具体议题”的主题会话概念。

文档中明确说，千问千答不应该按一条消息计费，而应该按“一个主题会话”计算。

#### 目标

把“聊天消息”升级为“围绕一个议题的主题会话”，权益消耗按主题会话计算。

#### 需要新增的数据

建议新增：

- `sys_topic_session`：主题会话；
- `sys_topic_message_link`：主题与消息关联，或者在消息表增加 `topic_session_id`。

主题会话字段建议包含：

- 用户 ID；
- 普通聊天 session ID；
- 主题标题；
- 核心问题；
- 状态：进行中 / 已完成 / 已归档；
- 起始时间；
- 结束时间；
- 消息数；
- Token 消耗；
- 是否已扣减权益；
- 推荐过的功课摘要；
- 是否生成过求助卡；
- 是否生成过分享稿。

#### 关键难点

要判断用户新发的问题是：

- 继续当前主题；
- 开启新主题；
- 对上一个回答追问；
- 只是闲聊或固定信息查询。

一期可以先做保守方案：

- 用户端默认当前聊天为一个主题；
- 超过一定间隔或用户点击“开启新主题”后创建新主题；
- AI 辅助生成主题标题；
- 先不要完全依赖模型自动判断切题。

#### 需要改的代码模块

- 后端：
  - 聊天发送接口；
  - 聊天历史接口；
  - ChatService；
  - ChatStreamService；
  - Agent 调用链；
  - 记录审计接口。
- 用户端：
  - 新建主题；
  - 当前主题状态；
  - 历史主题列表。
- 管理端：
  - 聊天详情展示主题；
  - 用户详情展示主题统计。

#### 验收标准

- 用户可以围绕一个主题连续追问；
- 一个主题只扣一次主题额度；
- 管理后台能看到主题会话；
- 主题能关联原始聊天消息；
- 主题结束后可用于近期实修回顾沉淀。

---

### 03. 主题摘要与近期实修回顾

- 优先级：P0
- 改动大小：L
- 影响范围：数据库、Agent 上下文、模型调用、用户端“近期回顾”、后台用户详情
- 依赖：主题会话机制

#### 当前现状

当前已有会话摘要和上下文消息数，用于解决当前会话记忆问题。产品不再建设长期人格化成长画像，避免用户和 Agent 对过程、标签及结果形成执着。

#### 目标

把每个主题会话沉淀成简短回顾，再从最近30天、最多10个新版主题生成“近期实修回顾”。只帮助保持连续性和回到当下，不评价成长结果。

#### 需要新增的数据

建议新增：

- `sys_topic_summary`：主题摘要；
- `sys_user_growth_profile`：近期实修回顾（历史画像字段仅兼容保留）；
- `sys_growth_profile_revision`：近期回顾版本记录。

主题摘要字段建议包含：

- 主题 ID；
- 用户原始问题摘要；
- 本次关注；
- 可以继续留意的问题；
- 生成模型；
- 生成时间。

近期实修回顾字段包含：

- 用户 ID；
- 近期回顾；
- 近期关注（最多3项）；
- 来源主题摘要 ID；
- 数据版本；
- 最近更新时间。

#### 需要改的代码模块

- 后端：
  - 主题结束逻辑；
  - 摘要生成服务；
  - 近期回顾更新服务；
  - Agent Prompt 构建逻辑；
  - 模型服务。
- 用户端：
  - 近期实修回顾；
  - 主题摘要展示。
- 管理端：
  - 用户详情里的近期实修回顾；
  - 摘要重生成。

#### 验收标准

- 一个主题结束后可以生成摘要；
- 近期实修回顾能基于限定时间窗口更新；
- Agent 只能把近期回顾用于保持连续性，并优先依据本轮表达；
- 旧画像、情绪/身体/关系模式、做过或有效功课、近期变化均不再生成、展示或注入；
- 不把全部历史原文塞进模型；
- 后台能查看档案更新记录。

---

### 04. Agent 调用链接入权益、主题与近期实修回顾

- 优先级：P0
- 改动大小：L
- 影响范围：Agent 主链路、调试预览、用户端流式输出、检索日志
- 依赖：权益版本体系、主题会话机制、近期实修回顾

#### 当前现状

Agent 已经可以：

- 使用知识库；
- 使用运行参数；
- 使用上下文摘要；
- 记录检索日志；
- 支持后台预览。
- 用户端正式聊天已按权益决定是否注入近期实修回顾；
- 后台 Agent 预览已支持选择“模拟学员”，用于注入该学员权益和近期实修回顾上下文。

但后续要让 Agent 区分：

- 当前用户是什么权益；
- 当前问题属于哪个主题；
- 是否可使用近期实修回顾；
- 是否需要提醒找人工老师确认；
- 是否允许生成求助卡/分享稿。

#### 目标

让 Agent 不只是“回答问题”，而是运行在“权益 + 主题 + 近期实修回顾 + 知识库”的产品上下文中。

#### 需要改的代码模块

- 后端：
  - PromptService / RAGService / KnowledgeAgentService；
  - ChatStreamService；
  - AgentDebugService；
  - 检索日志；
  - AI 请求日志。
- 管理端：
  - Agent 调试支持模拟用户权益和主题上下文；
  - 后台预览与用户端表现保持一致。

#### 验收标准

- 用户端和后台预览链路参数一致；
- Agent 能拿到当前主题摘要；
- 深度版用户可以使用近期实修回顾；
- 基础版不会调用近期实修回顾；
- 生成日志能看出本次用了哪些上下文。

#### 开发进度

- 2026-07-31：已补齐后台预览的“模拟学员”入口；选择学员后，预览链路会加载该学员权益、主题额度使用量和实修回顾上下文，并在检索追踪中记录 `load_debug_user_context`。默认不选择学员时，保持原后台调试行为。
- 2026-07-31：后台预览已支持继续选择具体主题，加载主题摘要、滚动摘要和最近消息；正式聊天与后台预览均会按权益注入实修回顾、求助卡和分享稿能力，并在追踪中记录模型路由与上下文来源。
- 2026-07-31：一期全链路已完成隔离生产编排、真实模型问答、流式响应、主题上下文、实修回顾、求助卡、分享稿、异步报告和记录审计验收。详细结果见《一期全链路验收记录》。
- 2026-08-03：主题结束已改为持久化异步沉淀。接口快速结束主题并创建唯一任务，后台独立生成主题摘要和近期实修回顾；支持自动重试、服务重启恢复、用户端状态查询和后台手动重试，原同步模型调用不再阻塞用户操作。

---

### 05. 老师求助卡

- 优先级：P0
- 改动大小：M
- 影响范围：用户端、后端生成接口、记录审计、后台用户详情
- 依赖：主题会话机制、主题摘要

#### 产品边界

这不是转人工工单。

用户主动生成一张卡片，然后自行复制给老师。

系统不做：

- 自动派单；
- 老师接单；
- 老师处理状态；
- 后台工单流转。

#### 目标

把 AI 已经梳理过的信息整理成适合发给老师看的求助卡。

#### 求助卡内容建议

- 我遇到的问题；
- AI 已经帮我梳理出的重点；
- 我现在最明显的情绪/身体感受；
- 我已经尝试过的功课；
- 我仍然卡住的地方；
- 我想请老师确认的问题；
- 相关主题时间；
- 用户可自行删改的提示。

#### 需要新增的数据

建议新增：

- `sys_teacher_help_card`

字段建议包含：

- 用户 ID；
- 主题 ID；
- 内容；
- 生成来源；
- 是否被用户复制；
- 创建时间。

#### 需要改的代码模块

- 后端：
  - 求助卡生成接口；
  - 求助卡历史接口。
- 用户端：
  - 生成按钮；
  - 卡片预览；
  - 复制按钮。
- 管理端：
  - 用户详情展示生成历史；
  - 记录审计可查看。

#### 验收标准

- 用户可以从当前主题生成求助卡；
- 求助卡内容可编辑、可复制；
- 不出现“已转人工”“等待老师处理”等文案；
- 后台只记录生成历史，不做派单。

#### 开发进度

- 2026-07-31：已新增 `sys_teacher_help_card`，用户端支持从当前会话生成“老师求助卡”、弹窗编辑并复制；复制后仅记录已复制时间。后台聊天详情可查看生成过的求助卡内容和复制状态，不做派单、不做处理状态。

---

### 06. 班级分享稿

- 优先级：P1
- 改动大小：M
- 影响范围：用户端、后端生成接口、主题记录
- 依赖：主题会话机制、主题摘要

#### 目标

帮助用户把一次实修看见整理成适合发班级群的分享稿。

#### 分享稿要求

- 不暴露过多隐私；
- 不替用户夸大成长；
- 不写成营销文；
- 重点表达：
  - 我看见了什么；
  - 我做了什么功课；
  - 当下有什么变化；
  - 我还在继续观察什么。

#### 需要新增的数据

建议新增：

- `sys_share_draft`

#### 需要改的代码模块

- 后端：
  - 分享稿生成接口；
  - 分享稿历史接口。
- 用户端：
  - 生成分享稿；
  - 编辑；
  - 复制。
- 管理端：
  - 用户详情可查看生成摘要。

#### 验收标准

- 用户可以生成分享稿；
- 分享稿可编辑、可复制；
- 分享稿不会自动发送到任何群；
- 后台可统计生成次数。

#### 开发进度

- 2026-07-31：已新增 `sys_share_draft`，用户端支持从当前会话生成“班级分享稿”、弹窗编辑并复制；复制后仅记录已复制时间。后台聊天详情可查看生成过的分享稿内容和复制状态，不自动发送到任何群。

---

### 07. 知识库类型规则继续落地

- 优先级：P1
- 改动大小：M
- 影响范围：知识库管理、检索策略、Agent Prompt 注入、检索日志
- 依赖：当前知识库体系

#### 当前现状

知识库已有类型：

- 课程知识库；
- 答疑知识库；
- 固定信息类知识库；
- 通用知识库。

但后续还要把类型规则更明确地用于 Agent 决策。

#### 目标

不同知识库类型在回答中的优先级不同。

#### 规则建议

- 固定信息类知识库优先级最高；
- 回答上课时间、带练安排、回放、音频、课程作业、会议链接、服务权益、助教联系方式时，优先使用固定信息类；
- 课程知识库用于解释课程内容和功课；
- 答疑知识库用于参考过往答疑；
- 如果固定信息类与其他知识冲突，以固定信息类为准；
- 不依赖管理员手写主提示词，应由系统规则注入。

#### 需要改的代码模块

- 后端：
  - KnowledgeAgentService；
  - 检索排序；
  - KnowledgeList 构建；
  - 检索日志。
- 管理端：
  - 知识库类型说明；
  - 检索日志展示知识库类型。

#### 验收标准

- 固定信息问题优先召回固定信息类；
- 检索日志能看到知识库类型和优先级；
- 知识冲突时能说明采用固定信息类。

#### 开发进度

- 2026-07-31：已有固定信息类优先召回、Prompt 类型规则注入和冲突处理规则；本次补充检索日志候选切片的知识库类型/优先级展示，并在知识库详情页展示类型使用规则说明。

---

### 08. 柔性额度提醒

- 优先级：P1
- 改动大小：M
- 影响范围：聊天前置校验、用户端提示、权益体系
- 依赖：权益版本体系、主题会话机制

#### 目标

避免用户感觉自己在购买 Token 或单次问答。

#### 规则建议

- 不直接强调“还剩几次提问”；
- 展示为“本月主题使用情况”；
- 接近上限时提示：
  - 本月深度主题使用较多；
  - 建议先完成已有功课；
  - 如需持续陪伴可联系运营升级；
- 超出后不要突然硬断所有能力，可以保留基础知识查询或提示联系运营确认。

#### 需要改的代码模块

- 后端：
  - 权益校验服务；
  - 聊天接口；
  - 用户 Profile。
- 用户端：
  - 权益提示；
  - 聊天前提醒；
  - 超额后的友好提示。

#### 验收标准

- 用户不会看到生硬的 Token/次数售卖提示；
- 权益不足时提示清楚；
- 基础版和深度版提示不同。

#### 开发进度

- 2026-07-31：用户端额度条已改为“本月主题使用情况 / 今日陪伴使用情况”，接近上限时给出先沉淀/消化功课的提醒；后端每日额度超限文案已从“次数用完”改为陪伴式权益确认提示。主题额度超限已使用柔性文案。

---

### 09. 成本统计与模型分流

- 优先级：P1
- 改动大小：L
- 影响范围：模型配置、AI 请求日志、看板、Agent 路由
- 依赖：主题会话机制、知识库类型规则

#### 当前现状

系统已有 Token 记录和模型配置，但还没有完整成本核算和模型路由。

#### 目标

满足文档中“成本控制不能只靠限制次数”的要求。

#### 需要新增/修改

模型配置增加：

- 输入 Token 单价；
- 输出 Token 单价；
- 货币；
- 适用场景；
- 是否可用于摘要/报告/固定信息/深度梳理。

AI 日志增加：

- 估算成本；
- 路由原因；
- 问题类型；
- 是否命中知识库。

模型分流建议：

- 固定信息查询：低成本模型；
- 简单课程知识：低成本模型；
- 深度议题梳理：高能力模型；
- 周报/月报：异步模型；
- 管理后台问题洞察：批处理模型。

#### 需要改的代码模块

- 后端：
  - ModelConfig；
  - ModelClientService；
  - Agent 路由服务；
  - AI 日志；
  - 数据看板。
- 管理端：
  - 模型管理；
  - 成本看板；
  - 路由规则配置。

#### 验收标准

- 每次 AI 请求能计算成本；
- 看板能看到日/月成本；
- 不同问题类型可以走不同模型；
- 日志能解释为什么选这个模型。

#### 开发进度

- 2026-07-31：一期已新增模型输入/输出千 Token 单价、币种、适用场景和可用能力字段；AI 请求日志记录模型 ID、估算成本、币种、问题类型、知识命中和路由原因；数据看板展示筛选范围内估算成本。暂未自动切换模型，避免影响正式回答稳定性，后续再基于这些字段做模型分流。
- 2026-07-31：二期先完成低风险后台任务分流。模型管理支持“多个可用模型 + 一个默认主模型”；周期报告和主题摘要按能力标签选模型，无匹配时回退默认主模型；正式聊天、追问改写和检索重排仍固定使用默认主模型。后台生成会记录实际模型、分流原因、Token、耗时和估算成本，数据看板增加按调用场景、模型和币种拆分的成本明细。固定信息和正式聊天的自动分流暂不启用，待后台任务运行稳定并核对成本后再做。
- 2026-07-31：正式问答分流增加可配置规则，系统配置提供“关闭分流 / 仅固定信息 / 保守分流”三档，升级后默认保持“仅固定信息”，不会静默扩大分流范围。“保守分流”只把短、明确、仅命中课程/问答/通用知识，且不涉及个人感受、关系、建议、判断的问题交给“简单知识”能力模型；混合固定信息、未命中、深度或个人化问题仍使用默认主模型。用户端和后台 Agent 预览共用同一规则，日志继续记录实际模型、问题类型和路由原因；旧的 `fixed_info_model_routing_enabled` 配置仍作为兼容回退。

---

### 10. 用户端个人中心与“近期实修回顾”

- 优先级：P1
- 改动大小：M
- 影响范围：用户端、用户权益接口、近期回顾接口、主题历史
- 依赖：主题会话机制、近期实修回顾

#### 目标

为用户提供统一的账号、套餐、用量和权益入口；同时帮助用户看见最近谈到的内容并回到当下，不形成成长成绩单或长期自我标签。

#### 用户端建议展示

- 账号与当前套餐；
- 套餐说明、生效时间和有效期；
- 本月主题、今日问答用量和剩余额度；
- 当前套餐包含的能力；
- 最近主题；
- 主题摘要；
- 每周小结；
- 每月回顾；
- 老师求助卡历史；
- 班级分享稿历史。

#### 注意

不要做成复杂 CRM，也不要让用户有被监控感。表达应偏“我的实修记录”，不是“后台画像”。

#### 验收标准

- 用户能查看自己的主题记录；
- 用户能查看近期回顾；
- 基础版和深度版展示边界不同。

#### 开发进度

- 2026-07-31：用户端原“我的档案”弹窗已扩展为实修记录视图，可查看实修回顾、最近主题沉淀、最近老师求助卡和最近班级分享稿；仍保持“我的实修记录”表达，不做后台画像式展示。
- 2026-08-03：升级为 V2“近期实修回顾”。移除常见情绪、身体/关系模式、做过或有效功课、近期变化等字段；旧版数据不再展示或注入 Agent，下一次主题沉淀时按最近30天、最多10个新版主题懒重建。
- 2026-08-03：新增用户端“个人中心”，顶部头像入口统一展示账号、当前套餐、有效期、本月主题和今日问答用量、剩余额度及能力清单；近期回顾、周期回顾、求助卡和分享稿按栏目查看。基础版会明确提示未包含的能力，不做成长评分、打卡天数或结果排名。
- 2026-08-03：完成权益到期与续期闭环。后台用户列表支持按权益版本、生效中、7 天内到期、8-30 天内到期、已到期和默认权益筛选；支持单人及最多 200 人批量续期，未到期从原到期日顺延，已到期从当前时间恢复，长期有效和未分配专属权益会明确拒绝。续期使用请求唯一键防止重复加天，并记录操作人、前后到期时间和备注；小时级维护任务分批归档已到期权益。用户端在临近到期及自动切换基础权益时使用柔性提示，并明确已有聊天、回顾和卡片不会丢失。

---

### 11. 后台用户详情升级

- 优先级：P1
- 改动大小：M
- 影响范围：管理端用户详情、用户接口、统计接口
- 依赖：权益版本体系、主题会话机制、近期实修回顾

#### 当前现状

用户管理主要是名单、额度、状态。

#### 目标

让后台能判断用户使用情况和产品价值。

#### 后台用户详情建议展示

- 当前权益；
- 权益有效期；
- 本月主题会话数；
- 使用频率；
- Token/成本；
- 最近主题；
- 近期实修回顾；
- 求助卡生成记录；
- 分享稿生成记录；
- 是否高频使用。

#### 验收标准

- 管理员可以从用户详情理解该用户是否真的在使用；
- 可以识别高频用户；
- 可以识别几乎未使用用户；
- 可以看到深度版价值是否被使用。

#### 开发进度

- 2026-07-31：后台用户管理新增“详情”抽屉，独立接口按需读取用户运营摘要；展示当前权益、权益有效期、本月主题数、近30天活跃天数、会话/消息/Token/成本、最近主题、近期实修回顾、老师求助卡和班级分享稿记录。列表接口仍只返回分页摘要，避免用户管理打开变慢。

---

### 12. 周报、月报、五个月总结

- 优先级：P2
- 改动大小：L
- 影响范围：异步任务、模型调用、近期实修回顾、用户端、后台
- 依赖：主题会话机制、近期实修回顾、成本统计

#### 不建议过早做

报告依赖主题摘要和近期实修回顾。如果先做，只能从原始聊天拼凑，成本高且质量不稳定。

#### 目标

体现深度陪伴版的连续价值。

#### 报告类型

- 每周实修小结；
- 每月实修回顾；
- 阶段实修回顾。

#### 报告内容建议

- 本周期主要议题；
- 近期关注；
- 可以继续留意的问题；
- 可以带给老师确认的问题。

#### 需要改的代码模块

- 后端：
  - 定时任务；
  - 报告生成服务；
  - 报告存储；
  - 成本记录。
- 用户端：
  - 报告列表；
  - 报告详情。
- 管理端：
  - 报告查看；
  - 重新生成；
  - 生成状态。

#### 验收标准

- 报告异步生成，不阻塞聊天；
- 用户端可查看；
- 后台可查看和重新生成；
- 生成失败有错误记录。

#### 开发进度

- 2026-07-31：一期已新增周期报告数据表 `sys_periodic_report`，支持周报、月报、阶段总结三种类型；后台用户详情可手动生成/重新生成报告并查看状态、来源主题/摘要、失败原因；用户端“我的实修档案”可查看已生成报告。当前版本先做同步手动生成，后续再接定时/异步任务，聊天链路不会被报告生成阻塞。
- 2026-07-31：报告生成已改为数据库持久化异步任务。管理员点击生成后接口立即返回，后台 Worker 独立生成；支持等待、执行中、成功、空报告、失败状态，最多自动重试 3 次，服务重启后会恢复超时任务。同一用户、类型和周期由唯一约束保证幂等。
- 2026-07-31：已接入自然周和自然月定时生成。默认按 `Asia/Shanghai` 在每周一 02:00 生成上一自然周周报、每月 1 日 03:00 生成上一自然月月报；只为权益开启周期报告且本周期存在成功主题摘要的有效用户入队。用户端只显示成功报告，后台可查看任务状态、执行次数、失败原因并手动重新生成。
- 2026-08-03：周期报告升级为 V2 实修回顾，只读取新版主题摘要，不再读取长期画像，也不生成情绪/身体/关系模式、功课效果、成长变化、评分或下一阶段目标；旧版报告默认隐藏，重新生成后升级为 V2。

---

### 13. 问题洞察二期

- 优先级：P2
- 改动大小：M
- 影响范围：记录审计、问题统计、知识库补充流程
- 依赖：当前问题洞察一期

#### 当前现状

已有一期：

- 用户消息清洗；
- 多问题拆分；
- 同义词归一；
- 相似问题聚合；
- 后台问题洞察 Tab。

#### 二期目标

从“看高频问题”升级为“辅助运营和知识库改进”。

#### TODO

- 清洗结果持久化，避免每次重新扫原始消息；
- 增加问题分类：
  - 课程知识类；
  - 功课操作类；
  - 情绪梳理类；
  - 固定信息类；
  - 服务权益类；
  - 无知识命中类；
- 高频问题一键转“知识库补充建议”；
- 标记 AI 经常答不好的问题；
- 标记召回失败问题；
- 支持人工合并/拆分问题组。

#### 开发进度

- 2026-07-31：二期第一步已在现有统计结果中增加问题分类、关联 AI 请求数、无知识命中次数、请求失败次数、是否需要知识跟进和运营处理建议；后台问题洞察卡片已展示分类标签、无命中/失败标记和建议动作。暂未新增持久化清洗表和人工合并/拆分能力，避免一次性扩大数据模型。
- 2026-07-31：已新增 `sys_question_insight_cleaned_question` 持久化清洗表和清洗版本字段。后台“刷新并统计”只增量处理尚未清洗的用户消息；低价值消息也会写入过滤占位记录，避免后续反复读取聊天原文；统计、筛选和分页均直接读取清洗结果。并发刷新由数据库唯一约束和单消息事务隔离去重，不会重复沉淀同一消息。
- 暂缓：高频问题一键转知识库补充建议、人工合并/拆分问题组，以及清洗规则升级后的版本重建入口。当前先切换到其他产品板块。

#### 验收标准

- 能看到高频问题趋势；
- 能看到知识库缺口；
- 能把问题转成知识库补充任务；
- 不影响记录审计页面加载速度。

---

## 5. 建议实施批次

### 第一批：底层产品模型

目标：把千问千答从“聊天工具”变成“权益化实修陪伴产品”。

包含：

1. 权益版本体系；
2. 主题会话机制；
3. 主题摘要与近期实修回顾；
4. Agent 调用链接入权益、主题与近期实修回顾。

这一批改动最大，但越早做越少返工。

### 第二批：用户可感知价值

目标：让用户明显感受到深度陪伴版的差异。

包含：

1. 老师求助卡；
2. 班级分享稿；
3. 用户端“我的实修档案”；
4. 柔性额度提醒。

### 第三批：运营和成本验证

目标：支撑 980 / 1280 的商业模型是否成立。

包含：

1. 成本统计；
2. 模型分流；
3. 后台用户详情升级；
4. 问题洞察二期。

### 第四批：连续陪伴增强

目标：体现五个月周期服务价值。

包含：

1. 周报；
2. 月报；
3. 五个月总结。

## 6. 当前阶段结论

- 千问千答不建设老师端或“老师工作版”，老师仍由学员自行联系；
- 周报、月报的异步与定时生成已经完成，本计划中的连续陪伴主链路已完成一期闭环；
- 一期主要功能链路已验收通过；主题摘要和近期实修回顾已改为持久化异步生成，原同步等待风险已经关闭；
- 问题洞察的知识库补充建议、人工合并和拆分暂缓；
- 下一阶段切换到其他产品板块时，再按对应板块重新确认范围、依赖和验收标准。

### 2026-08-03 管理后台前端模块化

- `App.vue` 已从 2122 行降至 1069 行，只保留登录、菜单壳层、模型管理和系统配置等尚未迁出的逻辑；已删除主文件中失效的旧知识库管理代码。新组件均经过统一格式化，不用压缩成超长单行换取表面行数。
- 数据看板、用户管理、用户详情、记录审计、聊天详情、AI 请求详情、检索日志和人工关注已按业务职责拆成独立组件，各组件自行管理接口请求、分页、筛选和详情状态。
- 各菜单页面改为按需加载，生产构建主入口由约 556KB 降至约 323KB；Agent 管理等大页面形成独立产物，不再阻塞后台首屏。
- 已完成本地 Docker 真页面回归：数据看板、用户管理、记录审计、检索日志、人工关注可正常切换；用户详情、聊天详情、AI 请求详情、检索详情均可打开，聊天消息分页仍保留。
