跳到主要内容

窗口渲染与历史上下文构建

上一篇我们讲解了会话记忆装载的流程，得到了 ConversationMemoryContext 对象。这一篇我们继续讲解如何渲染最近对话窗口，以及如何基于记忆上下文构建两种不同用途的历史上下文。

窗口渲染方法​

在 loadMemoryContext 方法中，无论是否开启长期摘要，系统都需要渲染最近对话窗口。这里有两个关键方法：renderRecentTranscript 和 renderAnswerRecentTranscript，它们的用途不同。

renderRecentTranscript：面向编排的窗口​

这个方法渲染用于问题改写和路由的最近对话窗口，包含用户问题和助手回答：

private String renderRecentTranscript(List<ConversationExchangeView> exchanges,
                                      int keepRecentTurns,
                                      int recentTranscriptMaxChars) {
    List<ConversationExchangeView> renderableExchanges = new ArrayList<>();
    for (ConversationExchangeView exchange : exchanges) {
        //判断一个轮次是否应保留在最近窗口中。
        if (shouldKeepInRecentWindow(exchange)) {
            renderableExchanges.add(exchange);
        }
    }
    if (renderableExchanges.isEmpty()) {
        return "";
    }

    // 只保留最近 keepRecentTurns 轮，避免窗口无限膨胀。
    int fromIndex = Math.max(0, renderableExchanges.size() - keepRecentTurns);
    StringBuilder builder = new StringBuilder("【最近对话原文】\n");
    for (int index = fromIndex; index < renderableExchanges.size(); index++) {
        ConversationExchangeView exchange = renderableExchanges.get(index);
        if (StrUtil.isNotBlank(exchange.getQuestion())) {
            builder.append("用户：")
                .append(clipText(exchange.getQuestion(), MAX_QUESTION_LENGTH))
                .append('\n');
        }
        if (exchange.getStatus() == ChatTurnStatus.COMPLETED && StrUtil.isNotBlank(exchange.getAnswer())) {
            // rewrite / route 窗口只保留已完成回答，避免把中途输出或异常轮次当作稳定上下文。
            builder.append("助手：")
                .append(clipText(exchange.getAnswer(), MAX_ANSWER_LENGTH))
                .append('\n');
        }
    }

    return clipRecentTranscript(builder.toString().trim(), recentTranscriptMaxChars);
}

关键逻辑

  1. 过滤可渲染轮次：调用 shouldKeepInRecentWindow 方法，过滤掉不应该出现在窗口中的轮次
  2. 截取最近 N 轮：只保留最近 keepRecentTurns 轮，避免窗口无限膨胀
  3. 渲染问题和回答：
    • 用户问题：直接渲染，最多保留 MAX_QUESTION_LENGTH 字符
    • 助手回答：只保留已完成的回答（status == COMPLETED），避免把中途输出或异常轮次当作稳定上下文
  4. 截断窗口：最终按 recentTranscriptMaxChars 截断，控制总长度

渲染示例

【最近对话原文】
用户：Java 的特点是什么？
助手：Java 是一种面向对象的编程语言...
用户：它的性能怎么样？
助手：Java 的性能在企业级应用中表现优秀...

renderAnswerRecentTranscript：面向回答的窗口​

这个方法渲染用于答案生成的最近对话窗口，只包含用户问题，不包含助手回答：

private String renderAnswerRecentTranscript(List<ConversationExchangeView> exchanges,
                                            int keepRecentTurns,
                                            int maxChars) {
    if (exchanges == null || exchanges.isEmpty()) {
        return "";
    }
    List<ConversationExchangeView> renderableExchanges = new ArrayList<>();
    for (ConversationExchangeView exchange : exchanges) {
        if (exchange != null
            && exchange.getStatus() != ChatTurnStatus.RUNNING
            && StrUtil.isNotBlank(exchange.getQuestion())) {
            renderableExchanges.add(exchange);
        }
    }
    if (renderableExchanges.isEmpty()) {
        return "";
    }

    // 回答窗口只取最近若干轮的用户问题，服务于"追问承接"而非事实检索。
    int fromIndex = Math.max(0, renderableExchanges.size() - keepRecentTurns);
    StringBuilder builder = new StringBuilder("【最近相关对话】\n");
    for (int index = fromIndex; index < renderableExchanges.size(); index++) {
        ConversationExchangeView exchange = renderableExchanges.get(index);
        if (StrUtil.isNotBlank(exchange.getQuestion())) {
            builder.append("用户：")
                .append(clipText(exchange.getQuestion(), MAX_QUESTION_LENGTH))
                .append('\n');
        }
    }
    return clipRecentTranscript(builder.toString().trim(), maxChars);
}

付费内容提示

该文档的全部内容仅对「码力全开」项目实战&技术讲解 知识星球用户开放

加入星球，一次获得完整项目资料、全栈技术知识库和长期答疑服务。

100万+字全栈技术知识库深入讲解技术核心、数据库、中间件和分布式等内容
8套热门的实战项目持续更新的企业级项目覆盖高并发、微服务、数据中台 和 AI Agent 等方向
AI 技术知识大模型面试详解覆盖 AI 模型原理、Agent、RAG、MCP、Skills、Harness 等核心知识点
文档 + 视频两种讲解形式既能系统阅读，也能跟随视频理解核心业务

完整项目实战资料

每套项目均包含从 0 到 1 讲解文档核心业务讲解视频

从基础项目到复杂业务场景，项目资料会持续更新。

8 套项目
  • 01Nexus Agent AI 智能体
  • 02Nexus Agent Pro 完全版
  • 03黑马点评Plus
  • 04大麦
  • 05大麦Pro
  • 06大麦AI
  • 07流量切换
  • 08数据中台

加入后还能获得

进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。

从学习、面试到项目启动，都可以继续获得支持。

  • 1 对 1 解答项目和技术问题都可以提问
  • 针对性补充没有讲清楚的内容会继续补充
  • 面试与简历指导梳理回答技巧和项目亮点
  • 中间件云环境项目依赖可以直接接入使用
  • 面试后复盘被问住的问题可以继续交流
  • 远程问题解决项目启动问题可协助排查
知识星球二维码

扫码进入知识星球

  1. 打开微信，扫描左侧二维码，加入「码力全开」项目实战&技术讲解 知识星球
  2. 查看星球使用指导，获取完整项目讲解资料索引
解锁全部付费内容
🎁优惠