feat: Add command line support

Author: zibo-chen

.github/workflows/rust.yml

@@ -3,6 +3,8 @@ name: Rust
 on:
   push:
     branches: [ "main" ]
+    tags:
+      - 'v*'
   pull_request:
     branches: [ "main" ]
 
@@ -11,12 +13,56 @@ env:
 
 jobs:
   build:
-
     runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build
+        run: cargo build --verbose
+      - name: Run tests
+        run: cargo test --verbose
 
+  release:
+    name: Release
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            artifact_name: ocr
+            asset_name: ocr-linux-amd64
+          - os: windows-latest
+            artifact_name: ocr.exe
+            asset_name: ocr-windows-amd64.exe
+          - os: macos-latest
+            artifact_name: ocr
+            asset_name: ocr-macos-amd64
+    
     steps:
-    - uses: actions/checkout@v4
-    - name: Build
-      run: cargo build --verbose
-    - name: Run tests
-      run: cargo test --verbose
+      - uses: actions/checkout@v4
+      
+      - name: Setup Rust
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+      
+      - name: Build Release Binary
+        run: cargo build --release --bin ocr
+      
+      - name: Rename Binary
+        shell: bash
+        run: |
+          if [ "${{ matrix.os }}" = "windows-latest" ]; then
+            cp target/release/${{ matrix.artifact_name }} ${{ matrix.asset_name }}
+          else
+            cp target/release/${{ matrix.artifact_name }} ${{ matrix.asset_name }}
+          fi
+      
+      - name: Upload Release Asset
+        uses: softprops/action-gh-release@v1
+        with:
+          files: ${{ matrix.asset_name }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1 +1,8 @@
 /target
+**/*.rs.bk
+Cargo.lock
+*.pdb
+.idea/
+.vscode/
+*.exe
+ocr-*-amd64*

Cargo.lock

@@ -30,17 +30,24 @@ exclude = [
 [lib]
 crate-type = ["lib", "cdylib"]
 
+[[bin]]
+name = "ocr"
+path = "src/main.rs"
+
 [dependencies]
 image = "0.25.6"
 imageproc = "0.25"
 ndarray = { version = "0.16", features = ["rayon", "serde"] }
 thiserror = "2"
 log = "0.4"
 env_logger = "0.10"
-
 crossbeam-channel = "0.5"
 once_cell = "1.17"
 
+clap = { version = "4.5", features = ["derive"] }
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+
 [dependencies.mnn]
 git = "https://github.com/zibo-chen/mnn-rs.git"
 features = []

Cargo.toml

@@ -13,6 +13,7 @@ PaddleOCRモデルをベースにしたRustで実装された軽量で効率的
 - **高性能**: MNN推論フレームワークで最適化
 - **最小限の依存関係**: 軽量で容易に統合可能
 - **カスタマイズ可能**: 異なるユースケース向けの調整可能なパラメータ
+- **コマンドラインツール**: OCR認識のための簡単なコマンドラインインターフェース
 
 ## インストール
 
@@ -37,6 +38,32 @@ branch = "main"
 - MNN形式に変換された事前学習済みPaddleOCRモデル
 - テキスト認識用の文字セットファイル
 
+## コマンドラインツール
+
+このライブラリには、直接OCR認識を行うための組み込みコマンドラインツールが提供されています：
+
+```bash
+# 基本的な使用法
+./ocr -p path/to/image.jpg
+
+# JSON形式で出力（詳細情報と位置を含む）
+./ocr -p path/to/image.jpg -m json
+
+# 詳細なログ情報を表示
+./ocr -p path/to/image.jpg -v
+```
+
+### コマンドラインオプション
+
+```
+オプション:
+  -p, --path <IMAGE_PATH>  認識する画像のパス
+  -m, --mode <MODE>        出力モード: json(詳細) または text(シンプル) [デフォルト: text]
+  -v, --verbose            詳細なログ情報を表示するかどうか
+  -h, --help               ヘルプ情報を表示
+  -V, --version            バージョン情報を表示
+```
+
 ## 使用例
 
 ```rust

README.ja.md

@@ -13,6 +13,7 @@ PaddleOCR 모델을 기반으로 Rust로 구현된 경량 및 효율적인 OCR(
 - **고성능**: MNN 추론 프레임워크로 최적화됨
 - **최소한의 의존성**: 경량이며 쉽게 통합 가능
 - **사용자 정의 가능**: 다양한 사용 사례에 맞게 조정 가능한 매개변수
+- **명령줄 도구**: OCR 인식을 위한 간단한 명령줄 인터페이스
 
 ## 설치
 
@@ -37,6 +38,32 @@ branch = "main"
 - MNN 형식으로 변환된 사전 훈련된 PaddleOCR 모델
 - 텍스트 인식을 위한 문자 집합 파일
 
+## 명령줄 도구
+
+이 라이브러리는 직접 OCR 인식을 수행할 수 있는 내장 명령줄 도구를 제공합니다:
+
+```bash
+# 기본 사용법
+./ocr -p path/to/image.jpg
+
+# JSON 형식으로 출력 (자세한 정보와 위치 포함)
+./ocr -p path/to/image.jpg -m json
+
+# 상세 로그 정보 표시
+./ocr -p path/to/image.jpg -v
+```
+
+### 명령줄 옵션
+
+```
+옵션:
+  -p, --path <IMAGE_PATH>  인식할 이미지 경로
+  -m, --mode <MODE>        출력 모드: json(상세) 또는 text(간단) [기본값: text]
+  -v, --verbose            상세 로그 정보 표시 여부
+  -h, --help               도움말 정보 출력
+  -V, --version            버전 정보 출력
+```
+
 ## 사용 예시
 
 ```rust
@@ -77,6 +104,22 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
 }
 ```
 
+## 실행 예시
+
+다음은 이 라이브러리의 실행 예시입니다:
+
+### 예시 1
+![원본 이미지 1](res/1.png)
+![OCR 결과 1](res/1_ocr_result.png)
+
+### 예시 2
+![원본 이미지 2](res/2.png)
+![OCR 결과 2](res/2_ocr_result.png)
+
+### 예시 3
+![원본 이미지 3](res/3.png)
+![OCR 결과 3](res/3_ocr_result.png)
+
 ## API 참조
 
 ### 텍스트 감지 (Det)