会话记忆

1. 页面概览

会话记忆管理页（V5 Stage 6，B5-5.5）是 LightAIP 的记忆流管理入口，路由为 /memory-manage。AIP 的 NLQ 链路以 user_id:data_source 复合键作为会话键，为每个用户在每个数据源上各维护一条记忆流（互不串扰）：最近 6 轮保存原文、更早轮次压缩为 LLM 摘要，并附带实体提及抽取。本页提供当前登录用户的会话列表（数据源/会话键/消息条数/最近活动，含分页）、单会话记忆条目的按时间正序查看（含分页），以及按会话清空与一键清空全部记忆。

页面所有数据都来自 GET /chat/sessions、GET|DELETE /chat/sessions/:sid/memory，归属校验在后端按当前登录用户过滤。一句话总结：会话记忆页是"记忆流可见 + 按会话/全部清理"的隐私与调试工具。

2. 访问入口

2.1 路由与菜单

2.2 认证与权限

meta 配置 requiresAuth: true；请求经 action/web/src/api/aipClient.js（baseURL /aip-api/v1）附 localStorage.aip_token，401 跳 /login。普通登录用户可访问，但仅能查看/清空自己的记忆。

2.3 端口与 API 前缀

AIP 后端默认端口 18080，API 前缀 /aip-api，实际请求路径 /aip-api/v1/chat/sessions。

3. 界面布局

+--------------------------------------------------+
| 会话记忆管理                                      |
|  AIP NLQ 会话记忆 · 按「用户 + 数据源」隔离 · 最近 6 轮原文 + 更早轮次摘要 · 实体提及标注 |
+--------------------------------------------------+
| [操作结果提示 alert（有消息时显示，可关闭）]          |
+--------------------------------------------------+
| 会话列表（N）[刷新][清空全部]                       |
|  表格：数据源 | 用户 / 会话键 | 消息条数 | 最近活动 | 操作 |
|         [查看记忆]                                 |
|  分页条：第 X/Y 页  每页[10▾] [上一页][下一页]       |
+--------------------------------------------------+
| 记忆条目 — <session_id> [数据源标签]（共 N 条）[清空本会话记忆] |
|  表格：时间 | 角色 | 内容 | 摘要 | 实体提及          |
|  分页条：第 X/Y 页  每页[20▾] [上一页][下一页]       |
+--------------------------------------------------+

各板块职责：

• 会话列表：当前登录用户的所有记忆会话概览（数据源、会话键、消息条数、最近活动时间），列表按页展示；「数据源」列读后端返回的 data_source 字段（历史行无该值 → unknown；不从 session_id 拆字符串——复合键不可反向解析）；「清空全部」一键清空当前用户全部会话记忆（二次确认显示会话数与总条数）；空列表时提示先去「智能查询」完成一次自然语言查询。
• 记忆条目：选中会话后按时间升序展示每条消息，列含时间、角色徽标（用户/助手）、内容、摘要（旧轮次压缩）、实体提及标签；标题处附该会话的数据源标签；条目按页展示。

4. 交互元素

5. 后端关联

5.1 端点表

5.2 关键机制

• 每用户每数据源一条记忆流（2026-09-15 起）：NLQ 链路 HandleQuery 以 user_id + ":" + data_source 复合键作为会话键（空/匿名用户回退 default，空/None 源回退 unknown），使数据源 A 上问过的表名/列名不会被带到数据源 B 的提问里。查询成功与诚实拒答两种轮次都回写记忆（schema 守卫拒绝、执行失败等错误轮次不写）。anl_conversation_memory 表按 (session_id, created_at) 索引存储 role / content / data_source / summary / entities。
• 原文 + 摘要两级存储：Append 附带轻量实体提及抽取（正则命中表/指标名）；Context 组装 prompt 时把每一轮渲染为 <memory-round index data_source at [summary]> 闭合 XML 块（最近 6 轮原文 + 更早轮次摘要），无摘要的旧轮滚动用 LLM 批量压缩一次并回写，失败降级为整轮跳过；超出 maxTokens 预算时从最旧轮起整轮丢弃（不做字符截断，永不输出半截 XML）。
• 归属校验：所有端点按 memoryCurrentUserID(c) 过滤，非匿名用户仅可读写自己的会话记忆；会话 ID 为空返回 MEMORY_BAD_SESSION（400），服务异常返回 MEMORY_ERROR（500）。
• 分页参数：GET /chat/sessions 无分页参数（一次返回全部会话，前端分页）；GET /chat/sessions/:sid/memory 支持 limit（默认 50、上限 500）但不支持 offset，故页面以 limit=500 一次取回后做前端渲染分页；DELETE 仅支持按会话清空，无单次"清空全部"端点，前端「清空全部」由逐会话调用该端点实现（未新增后端接口）。
• 自动清理：调度器注册 aip:memory-cleanup 任务，每日 4 点删除 30 天前的记忆。

6. 权限与安全

• 认证为 JWT（aip_token），/chat/sessions 路由挂 protected 登录组。
• 后端强制按登录用户过滤会话归属，本页不存在越权查看他人记忆的路径。
• 清空记忆为不可逆写操作，前端二次确认，且 DELETE 只能作用于当前登录用户自己的会话。

7. 常见问题与排错

问题 1：会话列表为空

现象：提示"暂无会话记忆"。

原因：尚未在「智能查询」完成过成功的自然语言查询；查询失败轮次不写记忆。

处理：先去「智能查询」跑通一次查询，再回到本页点「刷新」。

问题 1b：同一个人的记忆分成了好几条会话

现象：列表里同一个用户出现多条会话，会话键形如 <user_id>:<数据源>。

原因：属预期——2026-09-15 起记忆按「用户 + 数据源」隔离，每在数据源上对话一次就产生（或续写）一条该数据源的记忆流。

处理：无需处理；按「数据源」列区分即可。历史遗留会话（改造前的裸 user_id 行）数据源显示为 unknown，不再参与新链路读写，可在本页清空。

问题 2：点「查看记忆」提示"加载记忆条目失败"

现象：红色 alert 报错。

原因：会话 ID 含特殊字符（复合键含 :）、后端 401，或服务返回 MEMORY_ERROR。

处理：确认 aip_token 有效；查看后端日志定位 MEMORY_ERROR；会话 ID 经 encodeURIComponent 处理，一般无需手工转义。

问题 3：清空后记忆条目仍有余留

现象：提示"已清空记忆（N 条）"，但表格仍有数据。

原因：清空返回的 deleted 是后端删除条数，随后页面自动重新加载会话记忆，可能是刷新竞态或删除未提交。

处理：再次点「刷新」确认；若仍有数据则查看后端日志确认 DELETE 是否成功。

8. 已知缺陷与边界