当Qoder内存占用高、响应延迟或OOM时，需通过五步清理：一、禁用卸载未用插件；二、执行记忆快照剪枝；三、配置插件懒加载；四、高内存插件沙盒隔离；五、禁用非必要磁盘缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您观察到Qoder在持续运行过程中内存占用持续偏高、响应延迟增加或出现非预期的OOM错误，则可能是由于未启用插件卸载机制、长期驻留的非核心岗位插件持续执行健康检查与上下文同步所致。以下是针对不常用插件进行深度清理以降低系统负载的具体操作路径：
一、禁用并卸载未分配任务的岗位插件
Qoder默认加载全部预置岗位插件（如digital-analyst、digital-lawyer、digital-designer），即使仅启用digital-programmer角色，其余插件仍维持独立线程、内存缓存及定时心跳，造成约65%的冗余后台资源开销。通过主动识别并卸载未使用插件，可直接削减线程数与GC压力。
1、访问Qoder Web控制台，导航至http://localhost:8080/#/system/modules。
2、在模块列表中筛选状态为Enabled但对应角色未被任何工作流调用的插件项。
3、点击该插件行右侧的Disable按钮。
4、在弹出确认框中勾选Unload from memory and stop background workers选项。
5、刷新监控面板，验证Thread Count与RSS Memory数值是否同步下降。
二、执行插件级记忆快照剪枝
每个启用的岗位插件会维护独立的记忆维度（记忆、技能、策略、验证规则、工作流），其中未触发更新的技能与策略条目可能长期滞留内存。Qoder支持按插件粒度执行记忆老化清理，强制淘汰超时未访问的记忆块。
1、在Qoder CLI中执行命令：qoder memory prune --plugin digital-analyst --ttl 7d。
2、对已停用但尚未卸载的插件，追加--force-unload参数：qoder memory prune --plugin digital-lawyer --ttl 0s --force-unload。
3、运行qoder debug memory --plugin digital-analyst --snapshot验证输出中是否无残留条目。
4、重复执行上述命令，覆盖所有已禁用插件名称。
三、配置插件启动策略为按需加载
默认情况下，Qoder在服务启动时预加载全部插件运行时环境。启用插件懒加载策略后，仅当首个工作流明确调用某岗位时，其运行时才被初始化，空闲状态下不占用任何堆内存与线程资源。
1、编辑Qoder主配置文件config/agent.yaml。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、定位plugins:节点，在其下添加字段：loading_strategy: lazy-on-first-use。
3、为每个插件子项添加enabled: false，例如：digital-designer: { enabled: false }。
4、保存后执行qoderctl restart --graceful，新策略将在下次工作流调度时生效。
四、隔离高内存插件至独立沙盒容器
部分插件（如涉及多模态解析或实时音视频处理的digital-media）具备更高内存基线需求。将其从主Agent进程剥离至专用沙盒容器，可防止其内存泄漏波及核心调度模块，并实现独立GC周期控制。
1、进入Qoder集成中心 > 沙盒管理 > 新建容器。
2、容器类型选择Plugin-Isolation，绑定目标插件名称digital-media。
3、设置内存上限为1.2GB，启用OOM Killer自动重启策略。
4、保存配置后，在工作流编排界面将所有调用digital-media的节点路由至该沙盒容器ID。
五、禁用插件内置持久化缓存
多数插件默认启用磁盘缓存以加速技能加载与上下文恢复，但该机制在纯内存型任务场景下反而引入I/O延迟与内存映射开销。关闭非必要插件的磁盘持久化，可消除mmap区域占用并减少Page Cache污染。
1、在Qoder CLI中执行：qoder config plugin --name digital-analyst --disable-disk-cache。
2、对已部署插件批量执行：qoder config plugin --all --disable-disk-cache。
3、确认配置写入config/plugins/digital-analyst.yaml中disk_cache_enabled: false字段已生效。
4、重启对应插件进程或执行qoder plugin reload digital-analyst使配置即时应用。
