qoder需将markdown文档显式注册为知识源才能构建可检索、可关联、可执行的知识库。须先规范整理文件（唯一一级标题、合规命名），再通过控制台上传或cli注入（支持标签与分块配置），最后在ide中快捷调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把散落在本地的Markdown技术文档、API说明、开发规范统一管理起来，让Qoder能像读代码一样精准理解这些知识，并在写代码时自动调用、引用、校验——不是简单上传，而是构建可检索、可关联、可执行的知识库。
将Markdown文档转为Qoder可识别的知识源
Qoder不接受原始文件夹拖入，必须通过控制台或CLI显式注册为知识源，否则文档不会被索引进向量库。
第一步：确认文档已按规范整理。每个Markdown文件应有明确标题（【# 开头的一级标题必须存在且唯一】），避免无标题或重复标题；文件名不含空格和特殊符号，例如用api-authentication.md而非API认证_v2.1(最新).md。
第二步：登录Qoder Wake控制台 → 进入「数字员工管理」→ 选择目标实例 → 点击「知识库配置」→ 「新增数据源」→ 选择「本地文件上传」。
第三步：拖入已整理好的Markdown文件（单次≤10个，单文件≤10MB），上传后等待状态栏变为“已就绪”。这一步不可跳过，系统不会后台静默处理未触发上传的文件。
用CLI批量注入带标签的Markdown知识
当你的文档超过50份，或需要按模块打标（如backend、security、onboarding），手动上传效率低且无法回溯分类逻辑。
方法一：使用qodercli命令行工具注入
在项目根目录下执行：qodercli knowledge inject --path ./docs/markdown/ --tags backend,security。该命令会递归扫描所有.md文件，自动提取一级标题作为文档摘要，并绑定指定标签。
方法二：配合.qoder/knowledge/config.yaml精细控制分块策略
创建配置文件，指定chunk_size: 512和overlap: 64，避免API参数表被错误切分；若文档含大量代码块，需设preserve_code_fences: true，否则代码上下文将丢失。
在代码中实时引用知识库内容
你写Controller时想快速插入一段JWT鉴权逻辑说明，不用切出IDE翻文档——Qoder支持在编辑器内直接唤出匹配知识片段。
在VS Code或Qoder IDE中，光标置于任意函数上方，按下Cmd+Shift+I（macOS）或Ctrl+Shift+I（Windows），输入“JWT token校验流程”，AI会从已挂载的Markdown知识库中检索最相关段落，并以内联卡片形式呈现。
注意：该功能仅对已成功解析为“已就绪”状态的知识源生效，未完成解析的文档不会出现在检索结果中。
如果返回空结果，先检查对应Markdown文件是否包含关键词的近义表述——Qoder默认启用语义检索，但不会匹配错别字或缩写变体（如“auth”不会命中“authentication”全文）。
