上下文配置

上下文管理控制 AI 的对话记忆和历史消息处理。

基础配置

context:
  # 最大消息数
  maxMessages: 20
  
  # 清理策略
  cleaningStrategy: sliding
  
  # 持久化到数据库
  persistent: true

配置参数

参数	类型	默认值	说明
maxMessages	number	20	保留的最大消息数
maxTokens	number	-	最大 Token 数
cleaningStrategy	string	sliding	清理策略
persistent	boolean	true	是否持久化
shareGroup	boolean	false	群成员共享上下文

清理策略

sliding（滑动窗口）

保留最近 N 条消息，超出后删除最早的消息：

context:
  cleaningStrategy: sliding
  maxMessages: 20

summarize（摘要）

超出限制时，自动生成历史消息摘要：

context:
  cleaningStrategy: summarize
  maxMessages: 30
  summaryThreshold: 20  # 触发摘要的阈值

none（不清理）

不自动清理，需手动结束对话：

context:
  cleaningStrategy: none

Token 限制

按 Token 数限制上下文：

context:
  maxTokens: 8000
  reserveTokens: 1000  # 为回复预留的 Token

持久化

context:
  # 保存到数据库
  persistent: true
  
  # 过期时间（小时），0 表示不过期
  expiry: 24

持久化后，重启服务不会丢失对话历史。

群组共享

context:
  # 群成员共享同一上下文
  shareGroup: false

• true: 群内所有人共享一个对话
• false: 每个用户独立对话

系统消息

context:
  # 是否包含系统消息
  includeSystem: true
  
  # 系统消息位置: first | last
  systemPosition: first

引用消息

context:
  # 解析引用消息
  parseReply: true
  
  # 引用消息最大长度
  replyMaxLength: 500

图片处理

context:
  # 图片在上下文中的保留方式
  imageHandling: reference  # reference | inline | ignore
  
  # 图片最大保留数
  maxImages: 5

完整示例

context:
  maxMessages: 20
  maxTokens: 8000
  cleaningStrategy: sliding
  persistent: true
  expiry: 24
  shareGroup: false
  includeSystem: true
  systemPosition: first
  parseReply: true
  replyMaxLength: 500
  imageHandling: reference
  maxImages: 5

手动管理

结束对话

#结束对话

查看上下文

#查看对话

下一步

• 记忆配置 - 长期记忆系统
• MCP 配置 - MCP 服务器配置