Honyac 使い方ガイド

要件

• macOS 14 以降

セットアップ手順

1. Honyac アプリ（Honyac.app）を /Applications フォルダに配置します
2. アプリを起動すると、メニューバーに翻訳アイコンが表示されます
3. メニューから「設定…」を開きます
4. 接続方式（Ollama または OpenAI 互換 API）を選び、翻訳用モデルと文法解説用モデルを設定します

macOS のサービスとして右クリック翻訳を登録するため、Honyac.app は Applications フォルダに置いてください。

Ollama は標準サポートの接続方式です。既定で http://127.0.0.1:11434 に接続します。

手順

1. 設定画面の接続方式で「Ollama」を選びます
2. 「モデルを取得」を押すと、Ollama にインストール済みのモデル一覧から選べます
3. 翻訳用モデルと文法解説用モデルをそれぞれ選びます
4. 接続テストで接続を確認します

Ollama では、翻訳・解説の処理後にモデルを自動アンロード（keep_alive: 0）するため、使わないときにメモリを占有し続けません。

OpenAI 互換のチャットAPIを提供するサービスなら、多くのものを接続先に利用できます。

利用できるサービスの例

サービス	備考
OpenClaw（VPS）	サービス側のモデルエイリアスを利用できる場合があります
Hermes Agent	OpenAI 互換 API を提供
Open WebUI	ローカルで動く UI/API サーバー
LiteLLM	複数のバックエンドを OpenAI 互換にまとめるプロキシ
LM Studio	ローカル LLM の実行環境
vLLM	高速な推論サーバー

設定方法

1. 接続方式で「OpenAI 互換 API」を選びます
2. API ベースURL・API キーを入力します
3. 翻訳用モデル・文法解説用モデルにモデル名を指定します。実モデル名だけでなく、OpenClaw のようなサービス側のエイリアスも利用できる場合があります
4. 「接続テスト」で URL・認証・モデル名を確認してから使います

セキュリティ上の注意

• HTTPS と認証を有効にしてください
• API ポートを無認証で公開しないでください

通信先とプライバシーはユーザーの接続設定に依存します。サービスの設定手順はそれぞれの公式ドキュメントを参照してください。

Honyac では、翻訳用モデルと文法解説用モデルを別々に設定できます。

2つの役割

• 翻訳用モデル — 翻訳ボタンを押したときだけ呼び出されます
• 文法解説用モデル — 「文法を解説」ボタンと質問チャットで呼び出されます

選び方の例

• 翻訳には素早く回答できる軽めのモデル、解説には丁寧な説明が得意なモデルを組み合わせる
• はじめは両方に同じモデルを設定し、使い分けてみたくなったら変更する

2つの役割に同じモデルを設定することも可能です。モデルや接続先はユーザーが管理し、クラウドAPIキーは必須ではありません。

翻訳プロンプトと文法解説プロンプトは、どちらも複数行で編集・保存できます。

編集の対象

プロンプト	役割
翻訳プロンプト	翻訳用モデルへの指示
文法解説プロンプト	文法解説用モデルへの指示（質問チャットでも同じモデルを使用）

テンプレート変数

プロンプト内では原文・訳文・言語をテンプレート変数として利用できます。解説プロンプトで「この原文と訳文について説明して」といった指示を書くときに使います。

リセット

どちらのプロンプトにもリセットボタンがあり、現在の既定プロンプトを即時適用できます。編集に失敗してもすぐ戻せます。

既定の翻訳プロンプトが守ること

• 意訳・創作・情報の追加を禁止
• 感情、評価、助動詞、否定、時制、熟語、句動詞、文数、段落、改行などの意味を忠実に保持
• be excited to のような感情・態度のニュアンスを中立な表現へ弱めない

文法解説の表示言語は設定で変更できます。

• 初期値は macOS のシステム言語です
• 日本語を選ぶと、文法・単語の解説が日本語で表示されます
• 質問チャットの回答も、設定した解説言語で返ってきます

グローバルショートカットは、設定画面から好きなキーの組み合わせへ変更できます。

仕様

• 初期値は ⌥⌘H です
• ⌘・⌥・⌃ を含む組み合わせを登録できます
• 他のアプリや macOS で使用中の組み合わせは、競合として検出されます
• 登録に失敗した場合は、以前のショートカットが維持されます
• 設定画面で、現在のショートカットと登録結果を確認できます

Safari や Chrome などで文章を選択し、右クリックから「サービス」→「Honyacで翻訳」を選ぶと、Honyac が開いて選択文を翻訳します。

表示されない場合

1. Honyac.app が Applications フォルダにあることを確認します
2. Honyac とブラウザを一度終了して、再起動します
3. macOS の「システム設定 → キーボード → キーボードショートカット → サービス」で有効状態を確認します

OpenAI 互換 API の設定画面には「接続テスト」があります。

入力したベースURL・認証・モデル名が正しく機能するかを確認できます。新しい接続先を追加したときや、モデル名を変更したときにまず試してみてください。

• 翻訳処理は、接続先として設定した LLM に対して行われます
• Ollama などのローカル構成では、文章を外部クラウドへ送信せずに利用できます
• OpenAI 互換 API を使う場合は、HTTPS と認証を有効にし、API ポートを無認証で公開しないでください
• 使用するモデル・接続先はユーザーが選択できます
• 実際の通信範囲は、ユーザーの接続設定に依存します

対応OSを教えてください

macOS 14 以降に対応しています。

Ollama がなくても使えますか

はい。OpenAI 互換 API を利用するローカル環境（LM Studio、Open WebUI、vLLM など）や、OpenClaw のような VPS 上のサービスでも利用できます。

翻訳用モデルと文法解説用モデルを個別に選べますか

選べます。設定画面の登録済みモデルから個別に選択できます。2つの役割に同じモデルを設定することも可能です。

ショートカットが他のアプリと競合した場合はどうなりますか

競合として検出され、登録に失敗した場合は以前のショートカットが維持されます。設定画面で確認できます。

解説言語を変更できますか

できます。初期値は macOS のシステム言語で、設定から変更できます。

複数言語対応の予定はありますか

初期リリースでは日本語 ⇄ 英語に対応しています。複数言語への対応は、将来の有料アクティベーション機能（Pro）として予定しています。