qoderwake解析企业文档需完成三项准备：一是确认格式为pdf/docx/txt/markdown/csv且单个文件≤5mb；二是确保utf-8编码及内容可提取（pdf需文本层可复制）；三是规范命名（去特殊字符、用短横线替代空格）、markdown文件须有唯一一级标题、所有文件置于同一根目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让QoderWake能准确读取并理解企业内部的PDF、Word、Markdown等业务文档，必须先完成文档格式校验、编码确认与结构规范三项硬性准备，否则上传后将卡在解析阶段或返回乱码结果。
确认文档格式与大小限制
QoderWake仅支持PDF、DOCX、TXT、Markdown、CSV五种格式，其他如WPS原生格式、Pages、加密PDF、扫描图转文字失败的PDF均无法解析。单个文件体积不得超过5 MB——超限文件会被系统直接拒绝，不进入队列也不报错，只显示“上传失败”。
检查方法：右键文件→属性→查看“类型”和“大小”，对超过5 MB的PDF可用Adobe Acrobat“另存为→减小文件大小”，Word文档则另存为DOCX后用「文件→信息→压缩图片」降低体积。
验证UTF-8编码与内容可提取性
非UTF-8编码（如GBK、ISO-8859-1）会导致中文标题、表格、术语全部乱码，且系统不会提示编码错误，仅表现为向量检索召回率极低。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
用VS Code打开TXT或Markdown文件，底部状态栏查看编码标识；若显示GBK，点击该标识→选择“通过编码重新打开”→选UTF-8→保存。PDF无需手动改编码，但需确保原文本层可被复制——尝试Ctrl+A全选→Ctrl+C复制，若粘贴后为空白或乱码，则属扫描图像型PDF，须用OCR工具（如天翎OCR）先行识别导出为纯文本再上传。
整理文档命名与结构
第一步：删除所有文件名中的特殊符号（\ / : * ? " | ），空格统一替换为短横线（-），长度控制在200字符内。例如把“API接口说明（v2.3_2024最新版）.pdf”改为“api-interface-spec-v2-3.pdf”。
第二步：确保每个Markdown文件以【# 开头的一级标题必须存在且唯一】，无标题或含多个#号标题的文件将被跳过索引，不参与知识召回。
第三步：将全部待上传文档放入同一本地文件夹，不要嵌套子文件夹——QoderWake控制台上传时不会递归扫描子目录，仅处理根目录下文件。
