Qoder_Markdown增强插件：打造程序员专属知识库管理系统

本地散落的Markdown技术文档、API说明和开发规范，若想统一管理，让Qoder像读取代码一样精准理解这些知识，并在编写代码时自动调用、引用和校验，并非简单上传文件即可实现。你需要构建一个可检索、可关联、可执行的知识库。

直接将文件夹拖入系统无法生效——Qoder不会自动索引未正式注册的文档。你必须通过控制台或CLI完成注册流程，否则相关文档不会被导入向量库。

将Markdown文档转换为Qoder可识别的知识源

第一步：规范整理文档。每个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（Mac）或Ctrl+Shift+I（Windows），输入“JWT token校验流程”，AI将从已挂载的Markdown知识库中检索最相关的段落，以内联卡片形式展示。

请注意：该功能仅对已成功解析为“已就绪”状态的知识源有效。未完成解析的文档不会出现在检索结果中。

若返回空白结果，请先检查对应Markdown文件中是否包含关键词的近义表述。Qoder默认使用语义检索，但不会匹配错别字或缩写变体（例如“auth”无法命中“authentication”）。