性能、上下文与长会话问题

本页帮助解决 Qoder CLI 运行卡顿、资源占用高或上下文压力大的问题。

​

上下文压力大 / 频繁压缩

对话过长时，上下文接近窗口上限会触发自动压缩（Compaction），可能拖慢响应：

• 用 /compact 主动压缩上下文，释放空间。
• 用 /context 查看当前上下文占用。
• 复杂或长任务可拆分为多个较短会话，用 /new 开新会话。
• 通过 model.maxSessionTurns 限制会话保留的回合数（-1 为不限）。
• 大型任务善用子 Agent 隔离，避免主上下文膨胀。

​

内存占用高

• advanced.autoConfigureMemory（默认开启）会自动配置 Node.js 内存上限。
• 用 ui.showMemoryUsage 在界面显示内存占用以便观察。
• 超大仓库中，记忆发现受 context.discoveryMaxDirs（默认 200）约束；必要时收敛工作目录范围。

​

高 CPU / 渲染卡顿

界面渲染相关的调优项（多数标注“需重启”）：

• ui.terminalBuffer、ui.renderProcess：终端缓冲与渲染进程架构。
• ui.useAlternateBuffer + ui.incrementalRendering：增量渲染可减少闪烁（仅在启用备用缓冲区时支持）。
• 在低性能终端上，可关闭 ui.showSpinner、ui.loadingPhrases 等动态元素。

​

工具执行慢

• 搜索：确保 tools.useRipgrep（默认开启）以获得更快的内容搜索。
• Shell 超时：tools.shell.inactivityTimeout（默认 300 秒）控制无输出超时；长命令可适当调大。
• MCP 首轮开销：连接多个 MCP 服务器时，开启懒加载（mcp.lazyLoad 或 QODER_MCP_LAZY=1）可减少首轮 token 与加载开销。

​

启动慢

• 减少不必要的 MCP 服务器与插件，或用懒加载。
• 收敛记忆发现范围，避免在超大目录树中启动。

​

下一步

• 上下文机制：记忆工作原理。
• 配置项全表：配置项、环境变量与文件路径。
• 错误信息与 FAQ：错误信息与 FAQ。