内容
# Xberg
<div align="center" style="display: flex; flex-wrap: wrap; gap: 8px; justify-content: center; margin: 20px 0;">
<a href="https://github.com/xberg-io/alef">
<img src="https://img.shields.io/badge/Bindings-alef%20%E8%AF%81%E4%B9%A6-007ec6" alt="Bindings">
</a>
<!-- Language Bindings -->
<a href="https://crates.io/crates/xberg">
<img src="https://img.shields.io/crates/v/xberg?label=Rust&color=007ec6" alt="Rust">
</a>
<a href="https://pypi.org/project/xberg/">
<img src="https://img.shields.io/pypi/v/xberg?label=Python&color=007ec6" alt="Python">
</a>
<a href="https://www.npmjs.com/package/@xberg/node">
<img src="https://img.shields.io/npm/v/@xberg/node?label=Node.js&color=007ec6" alt="Node.js">
</a>
<a href="https://www.npmjs.com/package/@xberg/wasm">
<img src="https://img.shields.io/npm/v/@xberg/wasm?label=WASM&color=007ec6" alt="WASM">
</a>
<a href="https://central.sonatype.com/artifact/io.xberg/xberg">
<img src="https://img.shields.io/maven-central/v/io.xberg/xberg?label=Java&color=007ec6" alt="Java">
</a>
<a href="https://github.com/xberg-io/xberg/tree/main/packages/go">
<img src="https://img.shields.io/github/v/tag/xberg-io/xberg?label=Go&color=007ec6&filter=v1*" alt="Go">
</a>
<a href="https://www.nuget.org/packages/Xberg/">
<img src="https://img.shields.io/nuget/v/Xberg?label=C%23&color=007ec6" alt="C#">
</a>
<a href="https://packagist.org/packages/xberg-io/xberg">
<img src="https://img.shields.io/packagist/v/xberg-io/xberg?label=PHP&color=007ec6" alt="PHP">
</a>
<a href="https://rubygems.org/gems/xberg">
<img src="https://img.shields.io/gem/v/xberg?label=Ruby&color=007ec6" alt="Ruby">
</a>
<a href="https://hex.pm/packages/xberg">
<img src="https://img.shields.io/hexpm/v/xberg?label=Elixir&color=007ec6" alt="Elixir">
</a>
<a href="https://xberg-io.r-universe.dev/xberg">
<img src="https://img.shields.io/badge/R-xberg-007ec6" alt="R">
</a>
<a href="https://pub.dev/packages/xberg">
<img src="https://img.shields.io/pub/v/xberg?label=Dart&color=007ec6" alt="Dart">
</a>
<a href="https://central.sonatype.com/artifact/io.xberg/xberg-android">
<img src="https://img.shields.io/maven-central/v/io.xberg/xberg-android?label=Kotlin&color=007ec6" alt="Kotlin">
</a>
<a href="https://github.com/xberg-io/xberg/tree/main/packages/swift">
<img src="https://img.shields.io/badge/Swift-SPM-007ec6" alt="Swift">
</a>
<a href="https://github.com/xberg-io/xberg/tree/main/packages/zig">
<img src="https://img.shields.io/badge/Zig-package-007ec6" alt="Zig">
</a>
<a href="https://github.com/xberg-io/xberg/releases">
<img src="https://img.shields.io/badge/C-FFI-007ec6" alt="C FFI">
</a>
<a href="https://github.com/xberg-io/xberg/pkgs/container/xberg">
<img src="https://img.shields.io/badge/Docker-ghcr.io-007ec6?logo=docker&logoColor=white" alt="Docker">
</a>
<a href="https://github.com/xberg-io/xberg/pkgs/container/charts%2Fxberg">
<img src="https://img.shields.io/badge/Helm-ghcr.io-007ec6?logo=helm&logoColor=white" alt="Helm">
</a>
<!-- Project Info -->
<a href="https://github.com/xberg-io/xberg/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-MIT-007ec6" alt="License">
</a>
<a href="https://docs.xberg.io">
<img src="https://img.shields.io/badge/Docs-xberg-007ec6" alt="Documentation">
</a>
<a href="https://huggingface.co/xberg-io">
<img src="https://img.shields.io/badge/Hugging%20Face-Xberg-007ec6" alt="Hugging Face">
</a>
</div>
<div align="center" style="display: flex; flex-wrap: wrap; gap: 12px; justify-content: center; margin: 28px 0 24px;">
<a href="https://discord.gg/xt9WY3GnKR">
<img height="22" src="https://img.shields.io/badge/Discord-%E8%8A%8B%E9%99%88-007ec6?logo=discord&logoColor=white" alt="Join Discord">
</a>
<a href="https://docs.xberg.io/demo.html">
<img height="22" src="https://img.shields.io/badge/%E7%9B%B4%E6%9C%96%E6%88%A1%E7%A0%81-Open-007ec6?logo=webassembly&logoColor=white" alt="Live Demo">
</a>
<a href="https://github.com/xberg-io/xberg/stargazers">
<img height="22" src="https://img.shields.io/github/stars/xberg-io/xberg?style=social" alt="GitHub Stars">
</a>
</div>
从 96 种文件格式和 306 种编程语言中以原生速度提取文本、元数据、转录和代码智能，无需 GPU。
## 什么是 Xberg？为什么使用 Xberg？
Xberg 是一个文档智能框架，具有 Rust 核心和 16 种语言的原生绑定。它将文档、图像、音频和源代码转换为干净的结构化文本 - 从 96 种文件格式和 306 种编程语言中提取表格、元数据、转录和代码智能。
现代 AI 和 RAG 管道需要快速、可靠的提取，无需 GPU 或大量依赖项。Xberg 从单个 Rust 核心提供这些功能：SIMD 加速解析、纯 Rust PDF、多 GB 文件流式传输和跨所有绑定的一致输出。作为库、CLI、REST API 或 MCP 服务器运行。
OCR（Tesseract、PaddleOCR、EasyOCR 和 VLM 跨 143 个视觉提供商）、Whisper 音频/视频转录、切分、语言检测、嵌入和结构化 LLM 提取均已内置。
### 功能
| 功能 | 描述 |
| ------- | ----------- |
| **96 种文件格式** | PDF、Office、图像、HTML/XML、电子邮件、存档和学术格式，涵盖 8 类别 |
| **306 种语言** | 代码智能 - 函数、类、导入、符号、文档字符串 - 通过 tree-sitter |
| **多语言** | Rust、Python、Node.js、WebAssembly、Ruby、Go、Java、Kotlin、C#、PHP、Elixir、R、Dart、Swift、Zig 和 C 的原生绑定 |
| **OCR** | Tesseract（包括 WASM）、PaddleOCR、EasyOCR 和 VLM OCR 跨 143 个视觉提供商 - 可通过插件扩展 |
| **转录** | Whisper ONNX 转录 MP3、M4A、WAV、WebM 和 MP4 音频轨道 |
| **LLM 智能** | 结构化 JSON 提取、嵌入和 VLM OCR 通过 [liter-llm](https://github.com/xberg-io/liter-llm)，包括本地引擎 |
| **部署** | 作为库、CLI 工具、REST API 服务器或 MCP 服务器使用 |
| **高性能** | Rust 核心，具有纯 Rust PDF、SIMD 优化、全并行和多 GB 文件流式传输 |
| **令牌高效输出** | TOON 线格式使用的令牌比 JSON 少 30-50%，适用于 LLM/RAG 管道 |
| **可扩展** | 插件系统用于自定义 OCR 后端、验证器、后处理器、提取器和渲染器 |
### 支持的格式
96 种文件格式，涵盖 8 类别 - Office 文档、图像（启用 OCR）、网络和结构化数据、电子邮件、存档、学术和音频/视频 - 以及 306 种编程语言的代码智能。有关完整列表，请参阅 [格式参考](https://docs.xberg.io/reference/formats/)。
<div align="center">
<a href="https://github.com/xberg-io/xberg/stargazers">
<img src="docs/assets/star.gif" alt="Star Xberg on GitHub" width="640">
</a>
</div>
<p align="center"><strong>⭐️ 点击此仓库以表示支持 - 它有助于其他人发现 Xberg。</strong></p>
## 快速开始
### 语言包
<details open>
<summary><strong>Python</strong></summary>
```sh
pip install xberg
```
```sh
uv add xberg
```
请参阅 [Python README](https://github.com/xberg-io/xberg/tree/main/packages/python) 以获取完整文档。
</details>
<details>
<summary><strong>Node.js</strong></summary>
```sh
npm install @xberg/node
```
请参阅 [Node.js README](https://github.com/xberg-io/xberg/tree/main/crates/xberg-node) 以获取完整文档。
</details>
<details>
<summary><strong>Rust</strong></summary>
```sh
cargo add xberg
```
请参阅 [Rust README](https://github.com/xberg-io/xberg/tree/main/crates/xberg) 以获取完整文档。
</details>
<details>
<summary><strong>Go</strong></summary>
```sh
go get github.com/xberg-io/xberg
```
请参阅 [Go README](https://github.com/xberg-io/xberg/tree/main/packages/go) 以获取完整文档。
</details>
<details>
<summary><strong>Java</strong></summary>
可在 Maven Central 上以 `io.xberg:xberg` 形式获取。请参阅 [Java README](https://github.com/xberg-io/xberg/tree/main/packages/java) 以获取依赖项代码段和当前版本。
</details>
<details>
<summary><strong>C#</strong></summary>
```sh
dotnet add package Xberg
```
请参阅 [C# README](https://github.com/xberg-io/xberg/tree/main/packages/csharp) 以获取完整文档。
</details>
<details>
<summary><strong>Ruby</strong></summary>
```sh
gem install xberg
```
请参阅 [Ruby README](https://github.com/xberg-io/xberg/tree/main/packages/ruby) 以获取完整文档。
</details>
<details>
<summary><strong>PHP</strong></summary>
```sh
composer require xberg-io/xberg
```
请参阅 [PHP README](https://github.com/xberg-io/xberg/tree/main/packages/php) 以获取完整文档。
</details>
<details>
<summary><strong>Elixir</strong></summary>
在 `mix.exs` 依赖项中添加 `{:xberg, "~> 5.0"}`。请参阅 [Elixir README](https://github.com/xberg-io/xberg/tree/main/packages/elixir) 以获取完整文档。
</details>
<details>
<summary><strong>WebAssembly</strong></summary>
```sh
npm install @xberg/wasm
```
请参阅 [WebAssembly README](https://github.com/xberg-io/xberg/tree/main/crates/xberg-wasm) 以获取完整文档。
</details>
<details>
<summary><strong>R</strong></summary>
从 r-universe 安装。请参阅 [R README](https://github.com/xberg-io/xberg/tree/main/packages/r) 以获取完整文档。
</details>
<details>
<summary><strong>Kotlin（Android）</strong></summary>
可在 Maven Central 上以 `io.xberg:xberg-android` 形式获取。请参阅 [Kotlin README](https://github.com/xberg-io/xberg/tree/main/packages/kotlin-android) 以获取依赖项代码段和当前版本。
</details>
<details>
<summary><strong>Swift</strong></summary>
通过 Swift Package Manager 添加。请参阅 [Swift README](https://github.com/xberg-io/xberg/tree/main/packages/swift) 以获取完整文档。
</details>
<details>
<summary><strong>Dart / Flutter</strong></summary>
```sh
dart pub add xberg
```
请参阅 [Dart README](https://github.com/xberg-io/xberg/tree/main/packages/dart) 以获取完整文档。
</details>
<details>
<summary><strong>Zig</strong></summary>
通过 `zig fetch` 添加。请参阅 [Zig README](https://github.com/xberg-io/xberg/tree/main/packages/zig) 以获取完整文档。
</details>
<details>
<summary><strong>C/C++（FFI）</strong></summary>
从此工作空间构建源代码。请参阅 [C（FFI）README](https://github.com/xberg-io/xberg/tree/main/crates/xberg-ffi) 以获取完整文档。
</details>
<details>
<summary><strong>CLI</strong></summary>
```sh
brew install xberg-io/tap/xberg
```
请参阅 [CLI 用法](https://docs.xberg.io/cli/usage/) 以获取完整文档。
</details>
<details>
<summary><strong>Docker</strong></summary>
```sh
docker pull ghcr.io/xberg-io/xberg:latest
```
请参阅 [Docker 指南](https://docs.xberg.io/guides/docker/) 以获取 API、CLI 和 MCP 服务器模式的指南。
</details>
<details>
<summary><strong>MCP 服务器</strong></summary>
以 [Model Context Protocol](https://modelcontextprotocol.io/) 服务器运行 Xberg。预构建的二进制文件（Homebrew、`install.sh`、Docker）包含它；从源代码启用 `mcp` 功能。
```sh
# 预构建（Homebrew / install.sh / Docker）- 已包含 MCP
brew install xberg-io/tap/xberg
xberg mcp # stdio（默认）
# 从源代码 - 启用 mcp 功能
cargo install xberg-cli --features mcp
xberg mcp
# HTTP 传输代替 stdio
xberg mcp --transport http --host 127.0.0.1 --port 8001
```
将其添加到 MCP 客户端（Claude Desktop `claude_desktop_config.json`、Cursor `.cursor/mcp.json`）：
```json
{
"mcpServers": {
"xberg": { "command": "xberg", "args": ["mcp"] }
}
}
```
请参阅 [MCP 集成指南](https://docs.xberg.io/guides/mcp-integration/) 以获取工具、资源、提示、HTTP 传输和配置信息。
</details>
### AI 编码助手
从 [`xberg-io/plugins`](https://github.com/xberg-io/plugins) 市场安装 Xberg 插件。它包含 Xberg 代理技能（提取 API、OCR 后端、配置、语言约定）并适用于每种主要编码代理 - 在下面扩展您的工具。
<details open>
<summary><strong>Claude Code</strong></summary>
```text
/plugin marketplace add xberg-io/plugins
/plugin install xberg@xberg
```
</details>
<details>
<summary><strong>Codex CLI</strong></summary>
```text
/plugins add https://github.com/xberg-io/plugins
```
然后搜索 `xberg` 并选择 **安装插件**。
</details>
<details>
<summary><strong>Cursor</strong></summary>
设置 → 插件 → 从 URL 添加 → `https://github.com/xberg-io/plugins`，然后选择 **xberg**。
</details>
<details>
<summary><strong>Gemini CLI</strong></summary>
```text
gemini extensions install https://github.com/xberg-io/plugins
```
</details>
<details>
<summary><strong>Factory Droid</strong></summary>
```text
droid plugin marketplace add https://github.com/xberg-io/plugins
droid plugin install xberg@xberg
```
</details>
<details>
<summary><strong>GitHub Copilot CLI</strong></summary>
```text
copilot plugin marketplace add https://github.com/xberg-io/plugins
copilot plugin install xberg@xberg
```
</details>
<details>
<summary><strong>opencode</strong></summary>
将包添加到 `opencode.json`:
```json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["@xberg/opencode-xberg"]
}
```
</details>
## 文档
完整的指南、每种绑定 API 参考和完整的格式和配置参考都位于 **[xberg.io](https://xberg.io/)**。在浏览器中使用 [实时演示](https://docs.xberg.io/demo.html) 试用。
## 贡献
欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
加入我们的 [Discord 社区](https://discord.gg/xt9WY3GnKR) 以获取问题和讨论。
## Xberg.dev 的一部分
- [Xberg Enterprise](https://github.com/xberg-io/xberg-enterprise) - 带有 SDK、仪表板和可观察性的托管提取 API。
- [crawlberg](https://github.com/xberg-io/crawlberg) - HTML→Markdown 和 HTML→Markdown 以及 headless-Chrome 备用。
- [html-to-markdown - fast, lossless HTML→Markdown 引擎。
- [liter-llm](https://github.com/xberg-io/liter-llm) - 通用 LLM API 客户端，具有 14 种语言的原生绑定和 143 种提供商。
- [tree-sitter-language-pack](https://github.com/xberg-io/tree-sitter-language-pack) - tree-sitter 语法和代码智能原语。
- [alef](https://github.com/xberg-io/alef) - 多语言绑定生成器，在 5 个多语言仓库中生成每种语言的绑定。
## 许可
MIT 许可（MIT）- 详情请参阅 [LICENSE](LICENSE)。请参阅 [MIT 许可](https://www.opensource.org/licenses/MIT) 获取完整文本。
MCP 配置
以下是此 MCP Server 的配置信息，可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器