操作与参数图解
上下文与记忆参数
区分模型配置容量、对话压缩和长期记忆检索，避免把预算当成实时消耗。
上下文容量与四组高级选项
上下文容量页面连续记录了压缩比例、历史保留、工具结果压缩、视觉压缩和 byte Token 估算。顶部数值来自模型配置，不是实时使用量。
| 配置项 | 控件或采集示例 | 作用与检查 |
|---|---|---|
| 启用上下文压缩 | 开关 · 已选择 | 上下文达到阈值时整理旧对话；重要输入仍应保留原始文件。 |
| 上下文压缩阈值比例 | 滑块 | 模型配置容量乘此比例，得到触发压缩的预算阈值。 |
| 上下文保留阈值比例 | 滑块 | 压缩后保留的近期上下文比例；应小于触发压缩比例。 |
| 历史记录保留天数 | 数值输入 · 0 | 设定历史文件保留时长；0 表示永久保留，需关注磁盘增长。 |
| 启用工具结果压缩 | 开关 · 已选择 | 大工具结果保存在文件中，向模型提供有限预览，降低上下文占用。 |
| 最近工具结果预览字节数 | 文本输入 | 限制最近工具结果在上下文中的预览大小；单位是字节。 |
| 完整工具结果文件保留天数 | 滑块 | 控制完整工具结果文件清理时限；与对话历史保留设置分开。 |
| 启用 Visual Compact | 开关 · 未选择 | 将旧对话转换为图片；需要当前模型支持图片输入。 |
| 压缩强度 | 单选项 · 未选择 | 选择低、中、高视觉压缩；更高强度可能降低文字可读性。 |
| 低 | 单选项 · 条件满足后可编辑 · 已选择 | 优先保持视觉压缩后的文字清晰度。 |
| 中 | 单选项 · 条件满足后可编辑 · 未选择 | 采用中等视觉压缩密度。 |
| 高 | 单选项 · 条件满足后可编辑 · 未选择 | 提高视觉压缩密度，先检查文字是否可读。 |
| 对话存储路径 | 文本输入 | 设置对话文件保存位置，路径基于当前工作区的配置解释。 |
| byte/Token 估算除数 | 滑块 | 用于粗估 Token 数量，不是模型实际计费的精确换算。 |
记忆提取整理与检索服务
自动记忆按对话轮数提取，梦境任务定时整理。主动搜索和每轮自动搜索可以分别控制。向量服务未配置时保留 BM25 关键词搜索；重排序与 Embedding 的 API 配置相互独立。
- 设置提取频率及日记通知。
- 配置梦境计划和通知。
- 需要语义搜索时填写 Embedding 协议、地址、模型和维度。
- 开启重排序前填写对应服务。
- 验证维度后再重建索引。
| 配置项 | 控件或采集示例 | 作用与检查 |
|---|---|---|
| 启用对话记忆 | 开关 · 已选择 | 从历史对话中提取可长期使用的信息。 |
| 记录频率（对话轮数） | 数值输入 · 5 | 每累计指定轮数触发提取；截图中的 5 是采集环境示例。 |
| 仅在对话日记有变化或任务失败时发送到收件箱 | 开关 · 已选择 | 只在记忆内容改变或任务失败时向收件箱发通知，避免无变化提醒。 |
| 启用梦境整理 | 开关 · 已选择 | 按计划整理记忆分块，合并或维护长期信息。 |
| 梦境定时 | 单选项 · 未选择 | 设置每日、每周或 Cron 表达式的后台整理时间。 |
| 每天 | 单选项 · 已选择 | 任务在每日指定时刻触发。 |
| 每周 | 单选项 · 未选择 | 按选定的星期与时刻触发。 |
| 高级 | 单选项 · 未选择 | 使用 Cron 表达式或展开的高级参数，按对应分组填写。 |
| 仅在记忆整理有变化或任务失败时发送到收件箱 | 开关 · 已选择 | 只在记忆内容改变或任务失败时向收件箱发通知，避免无变化提醒。 |
| 允许智能体按需主动调用 memory_search | 开关 · 已选择 | 填写允许访问的对象标识，按界面要求逐条或用指定分隔符输入；核对权限范围。 |
| 每轮对话自动搜索，无需智能体主动调用工具 | 开关 · 未选择 | 开启后在每轮对话前自动召回相关记忆，可能增加检索请求和上下文开销。 |
| 自动记忆搜索时返回的最大结果数 | 数值输入 · 2 · 条件满足后可编辑 | 限制每次自动召回放入上下文的记忆条数；增大后核对相关性与上下文占用。 |
| 启用重排序 | 开关 · 未选择 | 向 reranker 服务提交召回候选并重新排序；需另行配置服务。 |
| API 地址 | 文本输入 · 条件满足后可编辑 | 填写目标服务的访问地址，包含服务要求的协议、端口和路径；本机地址仅对本机服务有效。 |
| 模型名称 | 文本输入 · 条件满足后可编辑 | 选择或填写该服务实际支持的模型标识；界面声明能力后仍需通过真实调用验证。 |
| API 密钥 | 文本输入 · 条件满足后可编辑 | 填写该服务签发的认证凭据；不要把示例占位文字当作真实密钥，也不要公开截图中的实际值。 |
| 候选倍数 | 数值输入 · 3 · 条件满足后可编辑 | 先召回目标条数乘此倍数的候选，再重排为最终 Top N。 |
| 超时时间（秒） | 数值输入 · 10 · 条件满足后可编辑 | 设置该阶段允许等待的上限；按字段标注的时间单位填写，过短容易误判为失败。 |
| 向量模型 SDK 类型 | 选择框 | 选择 Embedding 服务的调用协议，须与服务端一致。 |
| Base URL | 文本输入 | 填写目标服务的访问地址，包含服务要求的协议、端口和路径；本机地址仅对本机服务有效。 |
| API Key | 文本输入 | 填写该服务签发的认证凭据；不要把示例占位文字当作真实密钥，也不要公开截图中的实际值。 |
| 请求时传递维度 | 开关 · 条件满足后可编辑 · 未选择 | 支持维度参数的服务可接收 dimensions；并非所有模型支持。 |
| 向量维度 | 数值输入 · 1024 · 条件满足后可编辑 | 须与模型实际返回维度一致；更换维度后核对或重建索引。 |
| 启用 Embedding 缓存 | 开关 · 条件满足后可编辑 · 已选择 | 复用已有文本向量，减少重复请求。 |
| 最大缓存条目数 | 数值输入 · 10000 · 条件满足后可编辑 | 限制向量缓存规模，避免内存或磁盘持续增长。 |
| 单条输入字符预算 | 数值输入 · 8192 · 条件满足后可编辑 | 限制一条 Embedding 输入的字符数，与模型 Token 限制不同。 |
| 最大批处理大小 | 数值输入 · 10 · 条件满足后可编辑 | 一次向量请求的文本条数；过大可能触发服务限制。 |
| 初始化超时时间 | 数值输入 · 15.000 · 条件满足后可编辑 | 向量服务初始化的等待上限，单位为秒。 |
资源占用与诊断
点击资源与诊断，核对组件存储与进程占用。这里显示采集时的实时数据，不代表产品固定内存需求。维护入口的重建索引会改变索引数据，先保留需要的资料。
