Waker需显式触发事件并携带匹配的上下文锚点才能调用知识库，未设为默认或锚点错误将导致回退至无知识模式；支持CLI、YAML任务、桌面端右键及HTTP API四种激活方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake知识库连接成功后，Waker不会自动调用知识库内容，必须通过显式触发事件并携带目标上下文锚点，才能激活知识检索与推理链。缺少上下文锚点或事件类型不匹配，Waker将跳过知识库访问，仅依赖内置模型生成响应。
确认知识库已就绪并绑定到当前工作区
进入QoderWake控制台 →「知识管理」→「已连接源」，检查状态栏显示“✅ 已同步（N条）”且“Last indexed”时间在5分钟内。若显示“⚠️ 索引中断”或“未授权访问”，需返回配置页重新验证OAuth令牌或重置文件夹权限。
点击对应知识库右侧的「设为默认」按钮。该操作会将知识库ID写入工作区级config.yaml的default_knowledge_source字段，【未设为默认的知识库无法被Waker自动命中】。
通过CLI提交带锚点的结构化事件
Waker只响应结构化事件，不解析自由对话。必须使用qoderwake submit命令并指定--target-context参数指向知识库路径。
第一步：在终端中进入项目根目录，确保已执行qoderwake login并处于登录态。
第二步：运行以下命令，其中.git是知识库默认上下文锚点（由首次配置第五步设定）：
qoderwake submit --event-type=knowledge-query --target-context=".git" --metadata='{"query":"如何配置本地唤醒声纹校准？"}'
注意：target-context值必须与知识库配置时声明的anchor完全一致，大小写与路径分隔符均敏感。填错会导致Waker回退至无知识模式。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
在Quest任务中注入知识库引用
方法一：使用YAML编排任务时，在spec.steps节点下添加knowledge_ref字段：
steps:
- action: execute-command
command: "git status"
knowledge_ref: "QW-KB-7X9F-M2T4"
该ID需从知识库详情页复制，不可手写。Waker执行此step前会自动检索该知识库中与当前命令上下文最相关的3段内容，并注入prompt。
方法二：在QoderWake桌面端界面右键任意代码块 → 选择「用知识库解释」→ 系统自动提取当前选中文本语义，向默认知识库发起embedding相似度检索，结果以折叠面板形式嵌入思考链底部。
通过HTTP API强制路由至知识模块
向https://api.qoder.com/v1/quest/start发送POST请求，请求体JSON中必须包含knowledge_override字段：
{
"spec": { "goal": "解释声纹校准失败的五个常见原因" },
"knowledge_override": { "source_id": "QW-KB-7X9F-M2T4", "max_chunks": 5 }
}
该字段会绕过工作区默认设置，直接将本次Quest锁定至指定知识库。若source_id不存在或权限不足，API立即返回403错误而非降级处理。
