qoderwake仅支持pdf、docx、txt、markdown、csv五种格式；非支持格式会直接报错，需通过验证命令、编码检查及格式转换确保解析稳定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake知识库要求上传的本地文档必须能被系统稳定解析并完成向量化处理，因此仅接受特定格式文件，非支持格式将直接被拒绝且不提示具体原因。
官方明确支持的五种文件格式
QoderWake当前仅解析以下任一格式的文档：PDF、DOCX、TXT、Markdown、CSV。其他格式（如PPTX、XLSX、RTF、EPUB、HTML）不在支持列表内，上传后会触发“unsupported format”错误并中断入库流程。
格式验证实操步骤
第一步：打开文件属性面板，确认扩展名与实际内容一致。例如，某些伪DOCX文件实为ZIP重命名，系统会因无法提取正文而报错“invalid container structure”。
第二步：对PDF文件执行qoderwake doc validate --format=pdf命令，检查是否含加密或扫描图层。含密码保护或纯图片型PDF将跳过文本提取阶段，导致后续切块为空。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
第三步：用VS Code以UTF-8编码打开TXT/Markdown文件，确认无BOM头——带BOM的UTF-8文件在Linux环境会被识别为GBK，引发乱码与字段截断。
常见误传格式及替代方案
方法一：XLSX文件 → 先另存为CSV（选择UTF-8编码），禁用公式保留原始值；若含多Sheet，需拆分为多个CSV并加前缀标注来源。
方法二：PPTX文件 → 使用PowerPoint“另存为→大纲/讲义→TXT”，再手动补全标题层级标记（如# 一级标题、## 二级标题），否则系统无法识别语义结构。
方法三：网页HTML → 用浏览器插件“SingleFile”保存为完整HTML，再用qoderwake doc convert --from=html --to=md命令转为Markdown，自动剥离脚本与样式残留。
