1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | anydoc | GitHub |
| 作者/维护者 | Firecrawl（文档抓取与解析领域的开发者工具公司） | 仓库 README |
| 来源链接 | https://github.com/firecrawl/anydoc | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 16,565 / 938 | GitHub API |
| 最新版本 | v0.1.9（2026-08-13 发布） | GitHub API |
| 安装方式 | npx（CLI）/ npm（Node.js）/ pip（Python）/ cargo（Rust）/ npm（浏览器 WASM）五种渠道 | 仓库 README |
2. 功能介绍与亮点
anydoc 是一个用 Rust 编写的文档转换引擎，把 Word（.doc/.docx）、PowerPoint（.ppt/.pptx）、Excel（.xls/.xlsx）、OpenDocument（.odt/.ods/.odp）、RTF、EPUB、CSV、PDF 等 20 余种格式统一转换为干净的 GitHub-Flavored Markdown，供 agent 直接读取文档内容。
核心亮点：
- 零安装即用：
npx -y @firecrawl/anydoc <file>一条命令完成转换，无需预先安装依赖 - 多语言绑定齐全：除 CLI 外还提供 Node.js、Python、Rust 原生库、浏览器 WASM 四种集成方式，覆盖不同技术栈团队
- 工程质量可查证：仓库配有跨格式基准测试集与变异测试（mutation testing），厂商自测数据显示中位转换耗时 4.4 毫秒（该数据来自厂商私有测试集与 LLM 评审，具体量级建议自行验证）
- 两周内快速起量：仓库 2026-08-03 创建，8-04 加入该 Agent Skill，截至查证时已获 1.6 万余星，累计 70 个开放 issue、活跃的 PR 讨论，社区互动真实存在（非仅星数堆积）
- 格式检测自动化：无需手动指定格式，遇到 stdin 输入或扩展名不准确时才需要显式
--format参数
3. 适用场景
固定分类：文档与办公自动化
适合需要让 agent 读取用户提供的各类办公文档、但 agent 本身无法直接解析这些二进制格式的场景——例如批量把归档的 Word/PPT/Excel/PDF 转成 Markdown 供后续检索或写入知识库，或是处理 .doc/.ppt/.rtf/.epub 等老旧格式而不想手工转换。受益对象包括需要为 agent 打通异构文档输入管道的开发者，以及要把大量历史文档整理进 RAG 或知识库流程的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——SKILL.md 采用标准 YAML front matter（name/description/license/metadata），可直接放入 skills 目录使用。
- Codex：支持——据公开资料，Codex 已采纳同一开放的 SKILL.md 规范；该技能正文仅依赖标准命令行调用，不含任何 Claude 专属字段或 API。
- OpenClaw：支持——同上，技能本体无平台专有依赖。
- Hermes Agent：支持——同上。
- 以上四项均基于 SKILL.md 格式规范与公开资料判断，未在各平台逐一实机安装测试。
5. 推荐理由
多数文档转换类技能只覆盖单一格式（如只处理 PDF 或只处理 Word），而 anydoc 用一个技能、一条命令覆盖 20 余种常见办公与出版格式，且免安装、免凭据、核心功能完全免费。对需要把任意来源文档喂给 agent 处理的场景，它是低摩擦的首选：一次集成即可应对用户丢过来的各种格式，不必为每种格式单独接一个转换工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 1.6 万余星（两周内达成），远超五千星门槛；有独立第三方博客评测与 GitHub issue 区多位具名用户的真实反馈，社区互动（issue/PR 讨论）真实活跃，非单纯刷星 |
| 可用性 | 9 | npx 一条命令即可用，同时提供 Node/Python/Rust/浏览器四种语言绑定；文档含基准测试与故障说明；近一周内仍有版本发布（v0.1.9），维护活跃；核心功能无付费依赖 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 通过 npx 在本地运行官方发布的 CLI，权限范围明确：仅读取指定文件并输出转换结果 |
| ② 运行时联网外发 | 核心转换在本地完成，不上传文档内容；仅当用户主动选用可选的 Firecrawl 托管 OCR 服务处理扫描件时才会联网，且需用户显式选择 |
| ③ API Key/凭据存储 | 核心 CLI 无需任何凭据；仅可选的托管 OCR 服务需要账号 |
| ④ 可疑指令 | SKILL.md 全文通读未发现提示注入或与任务无关的夹带指令 |
| ⑤ 作者/组织信誉 | Firecrawl 为有一定知名度的开发者工具公司，anydoc 本身开源、各项指标公开可查 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 近一周内仍有版本发布，issue 与 PR 持续处理 |
综合评分 = 三项均值 = 8.67
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 anydoc 的差异 |
|---|---|---|
| markdown-exporter | 把 Markdown 一键转成 Word/PPT/Excel/PDF 等十余种格式，方向是“生成办公文档” | 与 anydoc 方向相反：markdown-exporter 做 Markdown→办公格式的生成，anydoc 做办公格式→Markdown 的读取抽取，二者互补而非重叠 |
| Anthropic 官方 docx/pdf/pptx/xlsx 四件套 | 针对单一格式做深度读写编辑（创建、填表、追踪修订等） | 定位是“编辑已知格式的文档”；anydoc 定位是“快速读懂任意来源文档”，覆盖格式更广（含 .doc/.ppt/.rtf/.epub 等旧格式与 ODF），但不做编辑与格式生成 |
| convert-word-to-md（github/awesome-copilot 官方合集子技能） | 官方出品，专门处理单一 .docx 转 Markdown，依赖预装 Python 与 markitdown 库 | 每种格式各自独立一个技能，需要为混合文件夹同时调用多个技能；anydoc 用单一技能自动识别并覆盖全部 20 余种格式，且无需额外安装运行时依赖 |
8. 用户评价
- Kevin Riedl（Wavect GmbH 董事总经理，独立博客评测，2026-08-10）：认为 anydoc 是“常规办公文档转 Markdown 场景的可靠默认选项”，尤其适合以本地执行、无额外 API 调用为优先的场景；同时明确指出它不做 OCR、语义字段抽取或完整 RAG 管线，扫描件与版式复杂的文档效果欠佳，建议这类场景改用 Docling 或 MarkItDown 等工具。
- tpulvers（GitHub issue #58）：报告 PDF 中希伯来语/阿拉伯语等从右至左文字转换后顺序颠倒，该问题已被修复并关闭。
- Michael-WhiteCapData（GitHub issue #27）：报告 Excel 表格中的数字格式在转换时丢失（如百分比 7.5% 被转成 0.075），该问题目前仍处于开放状态。
9. 其他补充
除 CLI 外，anydoc 同时以 npm、pip、cargo 三种包管理器发布原生库，并提供浏览器端 WASM 版本，便于不同技术栈的团队在各自的应用中直接调用转换能力，而不局限于命令行场景。
10. 安装使用方式
CLI（推荐，Agent Skill 场景默认方式）：
npx -y @firecrawl/anydoc <file> # 输出到标准输出
npx -y @firecrawl/anydoc <file> -o out.md # 写入文件
npx -y @firecrawl/anydoc - --format csv < f # 从标准输入读取需要 Node 20+ 环境；无需提前安装，首次运行自动拉取。
作为 Agent Skill 安装：
git clone https://github.com/firecrawl/anydoc /tmp/anydoc
mkdir -p ~/.claude/skills/convert-documents-to-markdown
cp -r /tmp/anydoc/skills/convert-documents-to-markdown/* ~/.claude/skills/convert-documents-to-markdown/复制后即可使用，无需重启或额外配置。
其他集成方式：
- Node.js：
npm install @firecrawl/anydoc，调用toMarkdown() - Python：
pip install firecrawl-anydoc，调用anydoc.to_markdown() - Rust：
cargo add anydoc - 浏览器：
npm install @firecrawl/anydoc-wasm
11. 注意事项
- 扫描件与纯图片 PDF 不支持 OCR（作者自述），需要借助 Firecrawl 官方托管的 Parse API（付费服务）或其他 OCR 工具补齐。
- 已知问题：部分 Excel 数字格式（如百分比）转换后可能丢失原有表示形式，处理财务类表格建议转换后人工校验。
- 仓库创建仅两周多、星数增长极快，长期维护节奏与生态成熟度仍需时间观察。
- 转换速度与质量的基准数据来自厂商自有测试集，具体表现建议在自己的文档样本上独立验证。