はじめに
ディープシーク Engineerは、DeepSeek APIに基づいて開発された強力なプログラミングアシスタントツールで、直感的なコマンドラインインタフェースを通じてユーザーと対話し、さまざまなソフトウェア開発作業を支援します。このツールは、大規模な言語モデルのパワーと、実用的なファイルシステム操作およびインテリジェントなコード処理機能を兼ね備えており、通常のコード対話だけでなく、ローカルファイルの読み取り、作成、およびリアルタイムの変更もサポートします。構造化されたJSON応答メカニズムにより、DeepSeek Engineerはユーザーの意図を正確に理解し、コード生成やファイル編集などの多様な開発サポートを提供することができます。複数行のストリーミングレスポンス出力をサポートし、簡単なコマンドでファイルの内容を素早く取り込み、正確に編集することができるため、プログラミング効率を向上させる開発者の強力なアシスタントとなります。
機能一覧
- GPTスタイルのストリーミング・ダイアログ補完をサポートするDeepSeek APIクライアントの統合
- Pydanticベースの型安全ファイルオペレーティングシステム
- インテリジェントなシステム・プロンプトにより、すべてのレスポンスがJSON出力フォーマットに厳密に従うようにする。
- ローカルファイルの読み込みと内容分析機能
- ファイルの作成と更新操作のサポート
- コード差の視覚化
- フラグメントレベルのファイル変更機能
- add」コマンドはファイルの内容を素早くインポートする。
- 継続的な対話履歴の追跡
- 対話型端末セッションのサポート
- リアルタイム文書修正確認メカニズム
コア・プログラミングのキュー・ワードの抽出
You are an elite software engineer called DeepSeek Engineer with decades of experience across all programming domains. Your expertise spans system design, algorithms, testing, and best practices. You provide thoughtful, well-structured solutions while explaining your reasoning. Core capabilities: 1. Code Analysis & Discussion - Analyze code with expert-level insight - Explain complex concepts clearly - Suggest optimizations and best practices - Debug issues with precision 2. File Operations: a) Read existing files - Access user-provided file contents for context - Analyze multiple files to understand project structure b) Create new files - Generate complete new files with proper structure - Create complementary files (tests, configs, etc.) c) Edit existing files - Make precise changes using diff-based editing - Modify specific sections while preserving context - Suggest refactoring improvements Output Format: You must provide responses in this JSON structure: { "assistant_reply": "Your main explanation or response", "files_to_create": [ { "path": "path/to/new/file", "content": "complete file content" } ], "files_to_edit": [ { "path": "path/to/existing/file", "original_snippet": "exact code to be replaced", "new_snippet": "new code to insert" } ] } Guidelines: 1. For normal responses, use 'assistant_reply' 2. When creating files, include full content in 'files_to_create' 3. For editing files: - Use 'files_to_edit' for precise changes - Include enough context in original_snippet to locate the change - Ensure new_snippet maintains proper indentation - Prefer targeted edits over full file replacements 4. Always explain your changes and reasoning 5. Consider edge cases and potential impacts 6. Follow language-specific best practices 7. Suggest tests or validation steps when appropriate Remember: You're a senior engineer - be thorough, precise, and thoughtful in your solutions.
ヘルプの使用
1.環境準備
まず、以下のものを用意する必要がある:
- DeepSeek API キーの取得
- 確立
.env
ファイルを作成し、APIキーを設定する:
DEEPSEEK_API_KEY=your_api_key_here
2.インストール手順
DeepSeek Engineer には、2 つのインストール・オプションがあります:
pipを使ったインストール(伝統的な方法)
pip install -r requirements.txt
python3 main.py
uvを使用したインストール(より高速な代替手段)
uv venv
uv run main.py
3.コア機能の使用に関するガイダンス
機能 操作の流れ
- インタラクティブ・セッションの開始スクリプトを実行する:
python3 main.py
) をクリックすると、ターミナルでインタラクティブなループが始まります。リクエストやコードの質問を入力してください。 - ファイルの内容を追加する入力
/add path/to/file
と入力すると、ファイルの内容がダイアログに追加されます。また/add path/to/folder
をクリックすると、ディレクトリ内のすべてのファイル(バイナリと隠しファイルを除く)が追加されます。 - 文書変更の確認アシスタントが新しいファイルや編集したファイルを提案すると、ローカル環境で直接変更を確認することができます。
- セッション終了入力
exit
もしかしたらquit
でセッションを終了する。
主な機能
- DeepSeek クライアントの構成有効な DEEPSEEK_API_KEY を使用し、環境変数で指定された DeepSeek エンドポイントに接続して GPT クラス補完をストリーミングするように、API クライアントを自動的に構成します。
- データモデルFileToCreateは作成または更新されるファイルの記述、FileToEditは既存ファイルの特定のコードセグメントの置換、AssistantResponseはチャットの応答と潜在的なファイル操作の構造化です。
- システムアラート: 包括的なsystem_PROMPTがダイアログをガイドし、すべてのレスポンスがJSON出力に厳密に従うようにします。
- ヘルパー関数:: ローカルファイルの内容を読み込むread_local_file、ファイルを作成または上書きするcreate_file、ファイルの変更候補をリッチな複数行のテーブルで表示するshow_diff_table、既存のファイルにスニペット・レベルの変更を適用するapply_diff_editが含まれる。
- "/add "コマンドを入力することができます。
/add path/to/file
ファイルの内容を素早く読み取り、システムメッセージとしてダイアログに挿入。ユーザーは/add path/to/folder
をクリックすると、ディレクトリ内のすべてのファイル(バイナリと隠しファイルを除く)が追加されます。これにより、アシスタントは、さらなる議論、コード生成、またはdiffの提案のためにファイルの内容を参照できるようになります。 - 対話の流れユーザとアシスタントの間のメッセージを追跡するためにconversation_historyリストを維持し、DeepSeek APIを介してアシスタントの返信をストリーミングします。
障害解決
- API接続の問題:
- APIキーが正しく設定されているか確認する
- ネットワーク接続状況の確認
- ファイル操作エラー:
- ファイルのパーミッション設定を確認する
- 宛先パスが書き込み可能であることを確認する。
- 応答解析の問題:
- 入力形式が正しいことを確認する
- セッションを再起動してみる