必须使用@attachments显式注入pdf才能触发解析；quest模式支持文档绑定与结构化任务；cli可批量解析pdf；扫描件需手动启用ocr。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在 Qoder 的 Agent 模式中尝试让 AI 理解 PDF 文档内容（如合同条款、论文图表或技术手册），但系统未返回结构化解析结果，则可能是由于 PDF 未被正确加载至上下文或未触发文档解析流水线。以下是实现 PDF 内容读取与语义理解的具体操作方法：
一、通过 @attachments 显式注入 PDF 文件
Qoder 的 Agent 模式不自动扫描上传区或历史附件，必须使用 @attachments 语法显式将 PDF 注入当前对话上下文，该操作会激活内置文档解析器与多模态理解通道，支持文本提取、表格还原及逻辑段落识别。
1、在 Agent 模式对话输入框中，点击右侧的 “Add Context” 按钮。
2、从弹出菜单中选择 @attachments 选项。
3、选取本地 PDF 文件（支持加密 PDF 以外的常规格式，含扫描件）。
4、上传完成后，在同一轮对话中发送指令，例如：“请提取该PDF第3页中的所有表格，并转为Markdown格式”。
二、在 Quest 模式中绑定 PDF 启动结构化任务
Quest 模式专为文档驱动型任务设计，可将 PDF 作为任务初始化参数，强制启用 Spec 驱动解析流程，适用于需分步执行、带校验环节的复杂场景（如合同比对、条款抽取）。
1、切换至 Quest 模式（界面右上角模式选择器）。
2、点击 “New Quest”，在配置面板中点击 “Upload Document” 区域。
3、拖入目标 PDF 文件，系统自动显示文档元数据（页数、标题、是否含图）。
4、在 “Task Specification” 输入框中填写结构化指令，例如：“抽取全部‘违约责任’章节下的金额数值与触发条件，按JSON输出”。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、调用 CLI 子代理批量解析本地 PDF 集合
当需处理多个 PDF 或集成进自动化工作流时，CLI 提供 general-purpose 子代理接口，绕过 UI 层直接调用底层 DocParser，支持并发解析、自定义分块策略与缓存复用。
1、确保已安装 Qoder CLI 工具链并完成身份认证。
2、执行命令：qoder agent run --tool doc-parser --input /path/to/reports/*.pdf --chunk-size 2000。
3、解析结果以 JSONL 格式输出至指定目录，每行对应一个 PDF 的分块内容、页码索引与置信度评分。
4、将输出文件路径粘贴至 Agent 模式对话框，附加指令：“基于以下结构化块，生成摘要并标注高风险条款位置”。
四、启用 OCR 增强解析扫描版 PDF
对于无文本层的扫描 PDF，标准解析器仅返回空内容。此时需手动启用 OCR 模块，调用内置 Tesseract 引擎进行图像文字识别，该步骤必须在上传后立即触发，不可延后补启。
1、完成 @attachments 上传后，不发送任何指令，等待右下角出现 “PDF processed (text layer: none)” 提示。
2、立刻输入：“/ocr enable for this document”（斜杠指令触发 OCR 流程）。
3、系统返回 “OCR started — ETA 12s” 后，等待状态变为 “OCR completed, 92% text recovery”。
4、随后发送分析指令，例如：“识别所有带红色边框的表格单元格内容，并列出其所在页码”。
