需强制Waker优先检索私有知识库：1.控制台设“严格知识锚定”并禁用兜底生成；2.将知识库显式绑定至Waker，权重调至85%；3.用CLI命令或界面完成绑定；4.通过日志验证[KB-RETRIEVAL]命中。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当QoderWake在处理用户提问时默认依赖通用模型推理而非你上传的业务知识，导致回答偏离内部规范、遗漏关键流程或引用过期文档，你需要强制Waker在生成答案前优先检索并融合私有知识库内容。
启用知识库优先检索模式
该模式会覆盖默认的“先推理后检索”流程，改为“先查库再补全”，确保所有回答必须锚定知识库片段，避免幻觉输出。
1、登录Qoder CN管理控制台 → 进入「知识管理」→ 选择目标知识库 → 点击右上角「设置」图标；
2、在「检索策略」区域，将匹配模式由“宽松语义匹配”切换为【严格知识锚定】；
3、勾选“禁用无匹配兜底生成”，此项启用后，若知识库未返回任何相关块，Waker将直接返回“暂无相关依据”，不再自行编造答案；
4、点击保存，系统立即重载该知识库的向量索引与检索路由表。
绑定知识库到具体Waker实例
单个知识库需显式挂载至指定Waker，否则即使启用优先模式，该Waker仍使用全局默认知识源。
方法一：通过控制台图形界面绑定
1、进入「数字员工管理」→ 找到目标Waker（如“支付故障排查员”）→ 点击「编辑配置」；
2、在「知识接入」模块中，点击「添加知识源」→ 从下拉列表选择已创建的知识库名称；
3、在「权重分配」滑块中，将知识库贡献度调至85%，模型推理权重同步降至15%；
4、确认绑定后，该Waker所有后续问答请求将自动携带知识库ID上下文发起检索。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法二：通过CLI命令行强制绑定
执行命令：qoderwake waker set-knowledge --waker-id=pay-troubleshooter --kb-id=payment-kb-v3 --priority=high；
【注意】命令中的--kb-id必须与Qoder CN中知识库详情页显示的唯一标识完全一致，大小写敏感，输错将导致绑定失败且无报错提示。
验证知识库是否真正生效
仅靠界面状态判断不可靠，必须通过真实查询触发底层检索链路并检查日志证据。
第一步：构造一条明确命中知识库的测试问题
例如提问：“支付网关返回ERR_CODE_409时应如何幂等重试？”——该问题关键词需完整复现知识库文档标题或正文高频短语；
第二步：开启实时日志监控
在终端执行：qoderwake logs -f --filter="retrieval" --limit=20；
第三步：提交问题并观察日志流
若看到类似[KB-RETRIEVAL] hit=3, score_avg=0.82, source=payment-kb-v3的日志条目，说明知识库已成功召回；
若日志中仅出现[MODEL-FALLBACK]而无KB标识，则证明绑定未生效或检索阈值过高，需返回前两步检查配置。
