qoderwake任务变慢主因是向量检索延迟高、嵌入模型加载阻塞或知识片段解析耗时长；需依次诊断检索延迟、切换轻量嵌入模型、限制召回数量与长度、禁用非必要知识源同步。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake连接外部知识库后任务执行变慢，常见于向量检索延迟高、嵌入模型加载阻塞或知识片段解析耗时过长，直接影响根因分析、代码生成等关键环节响应速度。
检查知识库检索链路延迟
第一步：在QoderWake CLI中执行诊断命令：qoderwake knowledge probe --verbose，观察输出中vector_search_latency_ms是否持续高于800ms。
第二步：若该值超阈值，进入管理控制台 → 知识库 → 对应知识源 → 点击“测试检索”，输入“error 500”类高频查询词，记录从提交到返回结果的完整耗时。
第三步：确认知识库服务端是否启用缓存——若未开启Redis或本地LRU缓存，每次查询都将触发全量向量计算，【必须在知识库服务配置中启用query_cache_ttl: 300s】，否则后续相同语义查询仍走冷路径。
切换轻量级嵌入模型
方法一：Web控制台快速切换
1、登录QoderWake Web控制台，进入「知识库 > 模型配置」页面。
2、将当前嵌入模型由text-embedding-3-large改为text-embedding-3-small，该模型参数量减少67%，推理延迟下降约41%。
3、点击保存后，系统自动触发嵌入模型热替换，无需重启Agent服务。
方法二：手动修改配置文件（适用于CLI部署）
编辑~/.qoderwake/knowledge/config.yaml，将embedding_model:字段值替换为qoder-embed-small-v2，保存后执行qoderwake knowledge reload生效。
限制知识片段召回数量与长度
知识库默认单次召回10条片段，每条最大2048字符，但QoderWake在后续RAG融合阶段需逐条解析、重排序、拼接上下文——片段越多，CPU解码与prompt组装越慢。
1、在知识库配置页找到「检索策略」区域。
2、将「最大召回数」从10调至【3】，将「单片段截断长度」设为512。
3、勾选「启用语义去重」，避免同一文档不同段落重复召回导致冗余计算。
这一步操作起来很简单，直接滑动数值条即可完成，但必须同步检查任务日志中retrieved_chunks_count是否已稳定降至3～4条，否则说明前端缓存未刷新。
禁用非必要知识源实时同步
当多个知识源（如Confluence+Notion+本地PDF）同时启用双向同步时，QoderWake会在后台持续拉取变更并触发增量索引重建，占用大量I/O与内存资源，间接拖慢当前任务执行。
方法一：关闭低频知识源同步
进入「知识库 > 源管理」，对近30天无查询记录的知识源（如“历史SOP归档库”），点击右侧「同步设置」→ 关闭「启用自动同步」开关。
方法二：调整同步频率
对仍需保留但更新不频繁的知识源（如API文档快照），将同步周期从“每15分钟”改为“每4小时”，并在「高级选项」中启用「仅同步变更页」，避免整库扫描。
【注意：修改后需手动点击“立即同步一次”以确保索引状态一致，否则可能召回过期内容】
