ja-furigana-cli

furigana CLI バイナリ + ローカル HTTP サーバー。 ja-furigana lib crate のフロントエンド。

Status: v0.1.x (alpha) — 公開 API はまだ変更され得る。

インストール

cargo install ja-furigana-cli
# → ~/.cargo/bin/furigana がインストールされる

GitHub Releases から OS 別の binary をダウンロードする方法もあります (RyuuNeko1107/ja-furigana/releases)。

使い方

# 1 ショット変換 (--mode は tts | hiragana | ruby | kanji | romaji | romaji-kunrei)
furigana lookup '灰桜の散る道'                       # → tts (default)
furigana lookup '灰桜の散る道' --mode ruby           # → {灰桜|はいざくら}...
furigana lookup '灰桜の散る道' --mode hiragana       # → はいざくらのちるみち
furigana lookup '灰桜の散る道' --mode romaji         # → haizakura no chiru michi (ヘボン式)
furigana lookup '灰桜の散る道' --mode romaji-kunrei  # → 訓令式

# 出力ルール: 漢字 → ひらがな化、 アルファベット / 数字 / 記号 → カタカナ統一
furigana lookup 'Anthropic の Claude を使う' --mode hiragana
# → アンソロピックのクロードをつかう
furigana lookup 'PostgreSQL 16 で動かす' --mode hiragana
# → ポストグレスキューエルジュウロクでうごかす

# 対話モード (REPL) — 引数なしで起動 = REPL (Windows なら exe ダブルクリック相当)
furigana
furigana repl --mode hiragana

# 辞書管理
furigana dict pull                       # GitHub Release から最新 furigana-dict を取得
furigana dict pull --version v0.1.3      # version pin
furigana dict add 灰桜 ハイザクラ        # ユーザー辞書に追加
furigana dict list                       # 現状サマリ
furigana dict remove 灰桜
furigana dict import path/to/extra.toml  # 既存 TOML を user 配下に取り込み

# ローカル HTTP サーバー (`/furigana` エンドポイント)
furigana serve                                 # http://127.0.0.1:8000
furigana serve --bind 0.0.0.0:8000             # 外部からも叩く
furigana serve --auto-pull                     # 起動時に最新 dict を自動取得
FURIGANA_TOKEN=<secret> furigana serve         # 認証有効

辞書を最新化する一番シンプルな方法は furigana dict pull してから process を再起動。 無停止運用したい場合は --auto-pull (起動時 1 回) や [auto_update] 定期 polling (config.toml に 1 セクション、admin_tokens 不要) が選択肢。詳細は docs/HTTP_API.md を参照。

データディレクトリの default は 実行ファイルと同じフォルダ (portable 配置)。 --data-dir <path> または FURIGANA_DATA_DIR で上書き可能。

詳細は プロジェクト README を参照。

ライセンス

MIT License.