用途:这是围绕 lit CLI(LiteParse)的代理使用技能,用于在本地、无需模型地解析文档,读取 PDF、DOCX、PPTX、XLSX 或图片中的文本、表格与特定数值。
主要能力与用法:核心原则是“只解析一次到文件,然后检索文件”。lit parse 每次调用都会重新完整抽取,反复解析是最大浪费。示例:lit parse "/abs/path/doc.pdf" --format text --no-ocr -o /tmp/doc.txt && wc -l /tmp/doc.txt,随后仅用 shell 工具检索该文件,不再重跑 lit parse。
检索纪律:每个 Bash 调用都是一次模型往返。用 grep -C 在一条命令中同时拿到命中位置与上下文,如 grep -n -i -C4 "total assets" /tmp/doc.txt | head -40;只有在已知确切行号且需要更大窗口时才用 sed -n 'A,Bp'。独立查询应合并到一条命令中批量执行,例如对多个关键词用 for 循环加 echo 标签与 grep 一次完成。输出始终用 head 限制并用 -n 带行号。目标是在 ≤3 条搜索命令内解决一个问题。
关键词不确定时的排序检索:内置 BM25 排序脚本,命令为 ./.claude/skills/effective-liteparse/scripts/search.py /tmp/doc.txt -q "materiality assessment priority topics" -k 8 -e 5,-k 为匹配数,-e 为上下文行数;应使用含多个同义词的自然语言查询,一次代替多轮试探性 grep。
数字版与扫描件:数字版 PDF(有真实文本层,几乎所有企业、金融、ESG 报告)始终加 --no-ocr,更快且文本一致;扫描 PDF 或图片则去掉 --no-ocr,若数值缺失或数字异常,应改用可视化读页而非相信 OCR。
可视化读页为最后手段:截图最耗上下文(单张高 DPI 页面可达约 14 万字符)。仅在文本与表格确实无法回答时,用 lit screenshot "/abs/path/doc.pdf" --target-pages "13" --dpi 150 -o /tmp/shots/ 渲染单页,注意是 --target-pages 而非 --pages,DPI 用约 150–200,不要用 300+,也不要重复渲染同一页。
同一文档多个问题:保留 /tmp/doc.txt 复用即可。不要浪费轮次做前置检查(lit --version、ls -la、--help),除非确实失败。常用参数:--format text|json、--no-ocr、--target-pages "1-5,10"、--dpi <n>(默认 150)、--ocr-language <iso>;仅当需要边界框或版式时才用 json,且仍应检索而非整体加载。
环境:PDF 开箱可用;缺少 lit 时执行 npm i -g @llamaindex/liteparse;Office 文档需 LibreOffice,图片需 ImageMagick(两者都会自动转换为 PDF)。
限制:具体收费、价格与平台支持等资料暂未提供;JSON 输出体积较大,不宜整体载入上下文。