| name | pdf-ai-explorer |
| description | 当文档内容过长无法一次查看、需要搜索关键词定位信息、或需要按页按节点浏览 DocJSON/PDF 结构时使用此 skill。适合与 xdev、agentic-extract 配合做长文档阅读与定位。 |
pdf-ai-explorer
pdf-ai-explorer 负责长文档导航，不负责 schema、标注、评估或 agentic loop。
前置检查
命令
先检查：
pdf-ai-explorer --help
如果命令不可用，先安装：
uv tool install extract-agent
如果你只想单独安装这个导航工具，再单独装：
uv tool install pdf-ai-explorer
extract-agent 和 pdf-ai-explorer 发布到 PyPI，默认安装命令不需要指定私有 index。
配置
按读取对象区分：
- 读 docjson：通常只要命令可用
- 直接读
.pdf：需要 PDF 解析服务配置
配置来源：
- 环境变量：
MEMECT_API_URL
- 配置文件：
~/.config/pdf-ai-explorer/config.toml
最小配置示例：
api_url = "http://localhost:6111/api"
或：
export MEMECT_API_URL="http://localhost:6111/api"
如果和 xdev 一起使用，建议把它和 XDEV_MEMECT_API_BASE 配成同一个地址。
最小验证：
- 命令存在：
pdf-ai-explorer --help
- 已有 docjson：
pdf-ai-explorer outline /path/to/doc.json
什么时候用
xdev doc 只显示前 1000 字，不够看- 需要先看文档大纲再定位字段
- 需要用关键词快速定位章节
- 需要查看某个节点的上下文、兄弟节点、子节点
不要用来做什么
- 不要把它当成 schema/标注工具
- 不要在这里解释
agentic-extract run / auto
- 不要用它替代
xdev 的数据导入和评估
最短路径
- 先拿到 docjson 路径
outline 看整体结构search 找关键词read / content 看具体内容inspect 看节点上下文
获取 docjson 路径
在 xdev doc <doc_id> 输出里通常会直接提示 docjson 路径。
也可以通过代码拿：
python -c "from xdev.api import get_docjson_path; print(get_docjson_path('doc_001'))"
命令速查
pdf-ai-explorer outline <doc.json>：查看文档大纲pdf-ai-explorer read <doc.json> <page>：按页阅读pdf-ai-explorer search <doc.json> <query>：搜索关键词pdf-ai-explorer content <doc.json> <node_id>：查看指定节点内容pdf-ai-explorer inspect <doc.json> <node_id>：查看节点上下文
使用建议
- 先
outline，再 search 或 read
search 适合快速定位字段相关章节inspect 适合理解节点在整棵文档树里的位置- 如果用户真正要做的是数据维护，切到
xdev
- 如果用户真正要做的是启动 agentic loop，切到
agentic-extract
