Reader Rs — Documentation skill for Claude Code

Reader

Agent 原生文档阅读、搜索与提取 CLI：PDF / Word（含 .doc）/ EPUB / Office / CSV 等 14 种文档格式加图片（png / jpg 等 8 种），按页/节读、正则搜、目录批量搜、OCR 识图、图片本体与元数据一键导出；grep 语义退出码，Rust 单二进制。

[](https://github.com/raystyle/reader_rs/actions/workflows/ci.yml) [](LICENSE)

从本地 PDF、markdown、图片与 Office 家族文档读文本层，给 Agent 稳定可解析的输出。Rust 单二进制、单调用无交互；命令 `reader`（缩写 `rr`）。

做什么	命令示例
读：按页或标题节取正文	reader extract ./doc.pdf --pages 1-3
搜：字面、正则、目录批量	rr search ./材料 "配置" -C 2
结构化提取：mq 表达式（jq 风格）	reader query ./notes.md ".h2"
取图：图片本体导出与元数据对齐	reader figures ./scan.pdf --pages 12-32
一键：文本+图片+元数据落一目录	reader export ./paper.pdf --ocr

• PDF 按页读；markdown 与 Word / EPUB / ODT / RTF / Office / CSV 等 14 种格式按标题节读；图片文件（png / jpg / bmp / gif / webp / tiff 等 8 种扩展名）单图即单页
• 扫描件与图片以 needs_ocr 检出，--ocr 兜底识别（PP-OCRv6 tiny，首用下载约 6.2 MB 模型）
• 行式标记、grep 语义退出码 0/1/2；--format json 包膜加 --filter 点路径裁剪、分页 next_offset
• --llms 紧凑命令索引；reader skill 生成 SKILL.md 给编码 agent 自动发现

全平台安装

前置：Rust 工具链（1.88+，推荐 ）。支持 Windows / macOS / Linux，CI 三系统门禁见 [.github/workflows/ci.yml](.github/workflows/ci.yml)。

预编译二进制（无 Rust 工具链时用）：[GitHub Releases](https://github.com/raystyle/reader_rs/releases) 页按平台取资产，解压即得 `reader` 与 `rr`（Windows 为 `.exe`），同附 README、LICENSE、SKILL.md 与 `.sha256` 校验文件：

资产	平台
reader-v<版本>-x86_64-pc-windows-msvc.zip	Windows x86_64
reader-v<版本>-x86_64-unknown-linux-gnu.tar.gz	Linux x86_64（glibc）
reader-v<版本>-x86_64-unknown-linux-musl.tar.gz	Linux x86_64 静态（Alpine / 容器 / 最小镜像；v0.2.1 起）
reader-v<版本>-aarch64-apple-darwin.tar.gz	macOS Apple 芯片
reader-v<版本>-x86_64-apple-darwin.tar.gz	macOS Intel

从源码安装（`reader` 与 `rr` 两个命令一起装）：

git clone https://github.com/raystyle/reader_rs
cd reader_rs
cargo install --path .

或直接远端安装：

cargo in