用途：为 NeqSim 任务求解流程检索工程文档（压缩机曲线、机械图纸、管线表、P&ID、数据表、厂商文件、材料证书、防火/PFP 文件等），尤其在空化/液击、封闭液体火灾破裂等场景中收集证据。
主要能力：
- 文档来源按优先级：用户提供的本地目录、任务 references 目录、自动检索后端（需配置，不在公开仓库中）。
- 所有文档须保存在任务目录 task_solve/YYYY-MM-DD_slug/step1_scope_and_research/references/ 内，不得写到 output/、figures/ 等任务外路径。
- 文档类型代码包括 CE 性能曲线、DS 数据表、AA 总布置图、MD 机械图、RV 厂商手册、RE 报告、ER 装配图、PL 零件表、PI/PF 工艺流程、IN 仪表数据表、SP 规格书、LL 管线表、MC 材料证书、FP 防火、FC 火灾/后果研究。
- 按任务类型做相关性评分过滤（如 compressor_analysis、pipeline_design、trapped_liquid_fire_rupture 等），阈值默认 0.5，低分文档跳过。
- PDF 可用 pymupdf 或 devtools/pdf_to_figures.py 转 PNG，再用 view_image 读取曲线、图纸、数据表。
- 生成 retrieval_manifest.json 记录来源、标签、检索日期、已用/被过滤文档，保证可追溯。
使用方式：
- 手动放文档：把 PDF 放入 references/，或创建任务时用 --refs-dir 指向已有目录。
- 下载 helper（推荐）： python devtools/stid_download.py --task-dir task_solve/2026-04-16_my_task --inst MYINST --tags 30PT0001 30PT0002 33AI0001 加 --convert-png 可同时转图；也可用 --docs 指定文档编号。
- 转换：python devtools/pdf_to_figures.py task_solve/.../references/ --outdir task_solve/.../figures/
- 通用接口：from devtools.doc_retriever import retrieve_documents；无后端时返回空列表。
- 提取的路由表可交给 PipingRouteBuilder 用于水力学建模，需字段：segment_id、from_node/to_node、length、internal_diameter、wall_thickness、elevation_change、minor_losses、source_ref。
适用场景：压缩机/泵/透平分析、换热器与分离器分析、管道设计、封闭液体火灾破裂证据收集。
限制：自动检索需后端配置（devtools/doc_retrieval_config.yaml，gitignored，不在公开仓库）；手动与自动文档共存、手动文档不被覆盖；每次须在任务目录内保存并生成 manifest。未提供具体收费、价格和平台信息。