提交qiming-mcp-proxy
This commit is contained in:
121
qiming-mcp-proxy/document-parser/fixtures/technical_doc.md
Normal file
121
qiming-mcp-proxy/document-parser/fixtures/technical_doc.md
Normal file
@@ -0,0 +1,121 @@
|
||||
# Rust 项目技术文档
|
||||
|
||||
## 项目概述
|
||||
|
||||
这是一个基于 Rust 的文档解析器项目,支持多种文档格式的解析和处理。
|
||||
|
||||
## 架构设计
|
||||
|
||||
### 核心组件
|
||||
|
||||
1. **格式检测器** - 自动识别文档格式
|
||||
2. **解析引擎** - 支持多种格式的解析
|
||||
3. **存储服务** - 管理解析结果和元数据
|
||||
4. **任务队列** - 异步处理文档解析任务
|
||||
|
||||
### 技术栈
|
||||
|
||||
- **语言**: Rust 2021 Edition
|
||||
- **异步运行时**: Tokio
|
||||
- **数据库**: Sled (嵌入式)
|
||||
- **Web 框架**: Axum
|
||||
- **序列化**: Serde
|
||||
|
||||
## API 接口
|
||||
|
||||
### 文档上传
|
||||
|
||||
```http
|
||||
POST /api/v1/documents/upload
|
||||
Content-Type: multipart/form-data
|
||||
|
||||
file: [binary data]
|
||||
format: "auto"
|
||||
```
|
||||
|
||||
### 解析状态查询
|
||||
|
||||
```http
|
||||
GET /api/v1/documents/{id}/status
|
||||
```
|
||||
|
||||
### 解析结果获取
|
||||
|
||||
```http
|
||||
GET /api/v1/documents/{id}/content
|
||||
Accept: application/json
|
||||
```
|
||||
|
||||
## 配置说明
|
||||
|
||||
### 环境变量
|
||||
|
||||
```bash
|
||||
# 服务器配置
|
||||
SERVER_PORT=8087
|
||||
SERVER_HOST=0.0.0.0
|
||||
|
||||
# 日志配置
|
||||
LOG_LEVEL=info
|
||||
LOG_PATH=./logs/app.log
|
||||
|
||||
# 存储配置
|
||||
SLED_PATH=./data/sled
|
||||
SLED_CACHE_CAPACITY=1048576
|
||||
```
|
||||
|
||||
## 部署指南
|
||||
|
||||
### 开发环境
|
||||
|
||||
```bash
|
||||
# 克隆项目
|
||||
git clone <repository-url>
|
||||
cd document-parser
|
||||
|
||||
# 安装依赖
|
||||
cargo install
|
||||
|
||||
# 运行测试
|
||||
cargo test
|
||||
|
||||
# 启动服务
|
||||
cargo run
|
||||
```
|
||||
|
||||
### 生产环境
|
||||
|
||||
```bash
|
||||
# 构建发布版本
|
||||
cargo build --release
|
||||
|
||||
# 运行服务
|
||||
./target/release/document-parser
|
||||
```
|
||||
|
||||
## 性能指标
|
||||
|
||||
### 解析速度
|
||||
|
||||
| 文档类型 | 平均解析时间 | 内存使用 |
|
||||
|----------|--------------|----------|
|
||||
| Markdown | 50ms | 2MB |
|
||||
| Word | 200ms | 10MB |
|
||||
| PDF | 500ms | 25MB |
|
||||
|
||||
### 并发能力
|
||||
|
||||
- 最大并发解析任务:10
|
||||
- 队列容量:100
|
||||
- 超时设置:30秒
|
||||
|
||||
## 总结
|
||||
|
||||
这个技术文档包含了:
|
||||
- 项目架构说明
|
||||
- API 接口定义
|
||||
- 配置和部署指南
|
||||
- 性能指标数据
|
||||
- 代码示例
|
||||
|
||||
用于测试复杂 Markdown 内容的解析能力。
|
||||
Reference in New Issue
Block a user