QoderWake需通过文档准备、知识库创建、内容上传与验证四步实现培训资料应用；须确保文件为PDF/DOCX/TXT/Markdown/CSV格式、≤5MB、UTF-8无BOM编码、无加密或扫描图，并规范命名与路径；在Qoder CN控制台创建指定成员可见的知识库，上传后验证向量化完成及召回准确性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake自动读取企业内部培训资料知识库，用于生成岗位考核题、新员工引导话术或实时解答培训相关提问，这要求完成文档准备、知识库创建、内容上传与验证四步操作，缺一不可。
确认培训资料格式与编码合规性
系统仅支持PDF、DOCX、TXT、Markdown、CSV五种格式，且单个文件≤5 MB、必须为UTF-8编码、不含加密或扫描图像——任意一项不满足，上传后将直接跳过解析，知识库中不会出现该文档的任何切块或索引。
检查文件名是否含反斜杠、冒号、星号等非法字符；若使用Windows系统编辑过文档，需用Notepad++另存为UTF-8无BOM格式，否则中文会显示为乱码。
将所有培训资料整理至同一本地文件夹，例如D:\training\onboarding-v3\，避免路径中出现空格或中文。
在Qoder CN控制台创建培训专用知识库
1、使用管理员账号登录Qoder CN管理控制台，点击左侧导航栏「知识管理」→「新建知识库」。
2、填写知识库名称为“新员工入职培训知识库”，应用场景选择「智能问答」，描述字段写明覆盖范围：“含《IT系统操作指南》《信息安全红线手册》《客户服务SOP（2026版）》三份核心材料”。
3、设置可见范围为“指定成员组”，勾选HRBP与部门导师组，【不选“全部成员”】，防止未入职人员提前获取敏感流程细节。
4、点击确定提交，等待页面提示“创建成功”后，记下该知识库ID（如kb-train-onboard-7a2f），后续CLI命令和侧边栏挂载需用到。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
上传培训文档并触发自动向量化
方法一：通过Web控制台批量上传
进入刚创建的知识库详情页 → 点击「上传文档」→ 将D:\training\onboarding-v3\下全部文件拖入上传区 → 勾选“启用表格与术语自动提取” → 点击「开始处理」。
方法二：使用CLI命令行上传（适合超20份文档场景）
在终端中执行：qoder-cli kb upload --kb-id kb-train-onboard-7a2f --path D:\training\onboarding-v3\ --recursive。该命令会递归扫描子目录，但不会上传隐藏文件或以点开头的文件（如.DS_Store）。
上传完成后，状态栏显示“已就绪（32/32 文档完成向量化）”即表示全部文档已切块、嵌入并构建索引，此时可立即进行问答测试。
在QoderWake中验证培训知识召回效果
打开QoderWake桌面端，在搜索框输入：“新员工首次登录OA系统需要几步？”，观察返回结果是否精准定位到《IT系统操作指南》第2.1节内容，并高亮“① 领取初始账号 → ② 访问oa.company.com → ③ 输入身份证后六位重置密码”三个步骤。
若返回空结果或匹配错误文档，说明某份PDF是扫描图而非文字型，需用Adobe Acrobat执行OCR后再重传。
右键任一返回片段 → 选择「查看原始来源」，确认跳转位置与你本地文件中的实际页码一致，这是验证知识锚点绑定准确性的关键动作。
