Emigo：EmacsのAIを使った複雑なプログラミング作業のアシスタント

はじめに

EmigoはMatthewZMD氏がGitHubで開発したEmacs用のオープンソースAIプログラミングアシスタントで、大規模な言語モデル（LLM）を統合することで、プログラマーのEmacsでのコード解析や修正などの作業を支援します。Emigoは、MatthewZMD氏によってGitHub上で開発されたオープンソースのEmacs用AIプログラミングアシスタントです。大規模な言語モデル（LLM）を統合することで、プログラマがEmacsでコードを解析、生成、修正するのを支援します。Emigoの中核機能は「エージェント型AI」で、テキストを生成するだけでなく、ファイルを読んだり、コードを書いたり、コマンドを実行したりといったツールを使ってプロジェクトと対話することができます。テキストを生成するだけでなく、ファイルを読んだり、コードを書いたり、コマンドを実行したりといったツールを使ってプロジェクトと対話することができる。アイダーによって開発され クライン EmigoはAidermacsの後継ソフトで、Aidermacsのようなツールにインスパイアされています。現在、Emigoはベータテスト中であり、開発者が試用し、フィードバックを得られるよう、機能はまだ改良されています。

機能一覧

• エージェントベースのツール使用AIは、ファイルの読み書きやコマンドの実行など、タスクの要求に応じてツールを選択・実行する。
• Emacsとのシームレスな統合インターフェイスとショートカットは、Emacsのネイティブな使い心地と同じです。
• 複数のAIモデルをサポートLiteLLM経由でOpenRouterやDeepseekなどのモデルに接続。
• コンテキスト管理対話履歴とプロジェクトファイルを自動的に記録し、一貫性のある会話を実現。
• ファイルコンテキスト追加AI分析に「@」記号で素早くファイルを追加。
• コードパッチの生成と表示AIから返されたコード変更は、見やすくハイライトされている。

ヘルプの使用

EmigoはEmacsユーザーのためのAIアシスタントです。ここでは、Emigoのインストール方法と使い方を詳しく説明します。

設置プロセス

1. 環境要件の検査
   • Emacsバージョン28以上が必要。https://www.gnu.org/software/emacs/ からダウンロードしてインストールできます。
   • Python 3.xが必要です。Python 3.xがインストールされている人は省略できますし、インストールされていない人はhttps://www.python.org/。
2. ダウンロード Emigo
   ターミナルで以下のコマンドを実行し、Emacsの設定ディレクトリにEmigoをクローンします：

git clone https://github.com/MatthewZMD/emigo.git ~/.emacs.d/emigo

3. Pythonの依存関係をインストールする
   Emigoのディレクトリに移動し、実行します：

cd ~/.emacs.d/emigo
pip install -r requirements.txt

これにより、LiteLLMなどの必要なPythonライブラリがインストールされます。

4. Emacsの設定
   Emacsの設定ファイル（通常は ~/.emacs.d/init.el)、以下のコードを追加する：

(use-package emigo
:straight (:host github :repo "MatthewZMD/emigo")
:config
(emigo-enable) ;; 自动启动后台进程
:custom
(emigo-model "openrouter/deepseek/deepseek-chat-v3-0324") ;; 设置默认模型
(emigo-base-url "https://openrouter.ai/api/v1") ;; 设置 API 地址
(emigo-api-key (emigo-read-file-content "~/.config/openrouter/key.txt"))) ;; 加载 API 密钥

• 構成::
  • emigo-modelAIモデルの選択と推奨 オープンルーター Deepseekの。
  • emigo-base-urlAPIサービスのアドレスを入力してください。
  • emigo-api-keyOpenRouter(https://openrouter.ai)からキーを取得し、指定したパスに保存する。

5. インストールの確認
   設定を保存したら、Emacsを再起動します。 M-x emigo新しいバッファが表示されれば、インストールは成功です。

使用方法

Emigoの操作は主にEmacs上でショートカットとインタラクティブウィンドウを組み合わせて行います。

エミゴの立ち上げ

• プロジェクト・ディレクトリで M-x emigo専用バッファは、キャリッジ・リターンの後にオープンされる。
• Git リポジトリにいる場合、Emigo はリポジトリのルートディレクトリをセッションパスとして使用します。カレントディレクトリを使うには C-u M-x emigo.

入力プロンプト

• 例えば、バッファに要件を入力してください：

请优化 @src/main.py 中的排序函数

• エミゴは自動的に src/main.py そして処理のためにAIに送られる。

コンテキストにファイルを追加する

• ファイルを"@"記号で参照する。 @src/utils.pyそうでない場合は、Emigoがコンテキストに追加する。
• コンテキストファイルを表示するには C-c C-l(ランニング) emigo-list-context-files).
• ファイルを削除するには C-c C-f(ランニング) emigo-remove-file-from-context).

AIとの対話

• タスクが入力されると、AIがそれを分析して結果を返す。例えば

请帮我调试 @src/main.c 中的内存泄漏

• AIから返されたパッチはハイライト表示される：

- free(ptr);
+ if (ptr) free(ptr);

ツール使用プロセス

• Emigoのエージェントベースの機能は、ツールを通じて実装される。AIは、以下のようなタスクに基づいてツールを選択する：
• read_fileファイルの内容を読む。
• write_to_fileファイルに書き込む。
• execute_commandコマンドを実行する。
• AIが促すかもしれない：

我需要运行 gcc -o test main.c，同意吗？

• プレス y ツール実行後、ダイアログに結果が入力されることを確認する。

セッション管理

• コンテキストを確認する C-c C-l 現在のファイルのリストを表示します。
• セッションの再起動：バッファを閉じて再度実行する M-x emigo.

開発状況アラート

• Emigoは現在ベータ版であり、APIの変更、不安定な機能、不完全なドキュメントがある可能性があります。テスト目的でのみ使用し、GitHub経由で問題を提出することをお勧めします。

アプリケーションシナリオ

1. コードデバッギング
   Cプロジェクトでクラッシュを見つけたら、"@main.c for errors "とタイプすると、AIが解析して修正を提案してくれる。
2. ドキュメントの再構築
   Refactor functions in @src/utils.py "と入力すると、最適化されたコードが生成され、パッチが表示されます。
3. コマンド実行
   プロジェクトに"@src/main.cをコンパイル "と入力すると、AIは次のように選択する。 execute_command ツールラン gcc.

品質保証

1. Emigoの対応機種は？
   LiteLLMを通じて、OpenRouterのDeepseek、Anthropicの クロード などを使用する場合は、コンフィギュレーションでモデル名とAPIを指定するだけです。
2. プロンプトが反応しないのはなぜですか？
   APIキーが無効か、ネットワークに問題がある可能性があります。キーファイルのパスとネットワーク接続を確認し、APIキーが無効であることを確認してください。 emigo-base-url アクセスしやすい。
3. Emigoをアップデートするには？
   ある ~/.emacs.d/emigo ディレクトリ・ラン git pullそしてEmacsを再起動する。