SuperAPI AI 工具集

effective-liteparse

设计与创作

查看项目

更新于 10-15 20:05

技能介绍

用途:针对涉及 PDF、DOCX、PPTX、XLSX 或图像等文档文件的读取任务,用本地、无需模型的 lit CLI 提取文本、表格或特定值,并强调低成本用法。

主要能力与核心原则:lit parse 每次调用都会重新完整解析整份文档,因此最佳实践是每份文档只解析一次到临时文件,之后所有搜索都针对该文件进行。例如:lit parse "/abs/path/doc.pdf" --format text --no-ocr -o /tmp/doc.txt && wc -l /tmp/doc.txt。随后用 grep、sed 等 shell 工具搜索,而非反复运行 lit parse。

搜索纪律:尽量减少往返次数,控制结果规模。优先在同一命令中用 grep -n -i -C4 获取定位和上下文;对多项独立查询可用 for 循环批量执行并加标签;始终用 head 限制输出并加 -n 显示行号。一般目标是在 3 条搜索命令内解决一个问题,若两条定向 grep 无法定位,改用捆绑的 BM25 排序脚本 search.py,例如:./.claude/skills/effective-liteparse/scripts/search.py /tmp/doc.txt -q "materiality assessment priority topics" -k 8 -e 5。

出生数字与扫描件区分:出生数字 PDF 传 --no-ocr 更快且文本相同;扫描件或图像去掉 --no-ocr,若数值缺失或数字异常应改用可视化读页。

可视化读页仅作最后手段:截图对上下文成本极高,仅在文本与表格无法回答时使用;一次只渲染一页,用 --target-pages "N",DPI 取约 150–200,避免重复渲染。命令示例:lit screenshot "/abs/path/doc.pdf" --target-pages "13" --dpi 150 -o /tmp/shots/。

常用参数:--format text|json、--no-ocr、--target-pages "1-5,10"、--dpi <n>(默认 150)、--ocr-language <iso>;--format json 仅用于需要边界框或布局时,且应搜索而非整体载入。避免在无用命令如版本、帮助或目录列表上浪费回合。

安装:PDF 开箱即用;缺少 lit 时执行 npm i -g @llamaindex/liteparse。Office 文档需 LibreOffice,图像需 ImageMagick(两者会自动转换为 PDF)。文档未提供更详细的适用场景与限制说明。