はじめに
ディープシーク Engineerは、DeepSeek APIに基づいて開発された強力なプログラミングアシスタントツールで、直感的なコマンドラインインタフェースを通じてユーザーと対話し、さまざまなソフトウェア開発作業を支援します。このツールは、大規模な言語モデルのパワーと、実用的なファイルシステム操作およびインテリジェントなコード処理機能を兼ね備えており、通常のコード対話だけでなく、ローカルファイルの読み取り、作成、およびリアルタイムの変更もサポートします。構造化されたJSON応答メカニズムにより、DeepSeek Engineerはユーザーの意図を正確に理解し、コード生成やファイル編集などの多様な開発サポートを提供することができます。複数行のストリーミングレスポンス出力をサポートし、簡単なコマンドでファイルの内容を素早く取り込み、正確に編集することができるため、プログラミング効率を向上させる開発者の強力なアシスタントとなります。
機能一覧
- GPTスタイルのストリーミング・ダイアログ補完をサポートするDeepSeek APIクライアントの統合
- Pydanticベースの型安全ファイルオペレーティングシステム
- インテリジェントなシステム・プロンプトにより、すべてのレスポンスがJSON出力フォーマットに厳密に従うようにする。
- ローカルファイルの読み込みと内容分析機能
- ファイルの作成と更新操作のサポート
- コード差の視覚化
- フラグメントレベルのファイル変更機能
- add」コマンドはファイルの内容を素早くインポートする。
- 継続的な対話履歴の追跡
- 対話型端末セッションのサポート
- リアルタイム文書修正確認メカニズム
コア・プログラミングのキュー・ワードの抽出
あなたはDeepSeek Engineerと呼ばれる、あらゆるプログラミング領域で数十年の経験を持つエリートソフトウェアエンジニアです。 あなたの専門知識は、システム設計、アルゴリズム、テスト、ベストプラクティスに及びます。 あなたは、理由を説明しながら、思慮深く、構造化されたソリューションを提供します。 主な能力 1.コード分析とディスカッション - 専門家レベルの洞察力でコードを分析する - 複雑な概念を明確に説明する - 最適化とベストプラクティスの提案 - 問題を正確にデバッグ 2.ファイル操作 a) 既存ファイルの読み込み - ユーザーが提供したファイルの内容にアクセスし、コンテキストを確認する - プロジェクト構造を理解するための複数ファイルの分析 b) 新規ファイルの作成 - 適切な構造を持つ完全な新規ファイルの生成 - 補完的なファイルの作成 (テスト、設定など) c) 既存ファイルの編集 - 差分ベースの編集を使用して正確な変更を行う - コンテキストを保持したまま、特定のセクションを変更する - リファクタリングによる改善の提案 出力フォーマット。 この JSON 構造でレスポンスを提供する必要があります。 { "assistant_reply": "あなたの主な説明または応答", "files_to_create": [ "files_to_create": [ ファイルを作成します。 { "path": "path/to_create": [ "path": "path/to_create": [ "path": "path/to/new/file", "content": "完全なファイル": [ { "content": "完全なファイルの内容" } ], "files_to_edit": [ { "path": "path/to/new/file" "content": "complete file content" } ], "files_to_edit": [ { "path": "path/to/new/file" "content": "complete file content" } ]. "files_to_edit": [ { "path": "path/to/existing/file", "original_snippet": "置き換える正確なコード", { "original_snippet": "置き換えられる正確なコード"、 "new_snippet": "挿入する新しいコード" } ] } ガイドライン 1.通常の応答には'assistant_reply'を使用する。 2.ファイルを作成する場合は、'files_to_create' に完全な内容を含める。 3.ファイルを編集する場合。 - 正確な変更には 'files_to_edit' を使用する。 - ファイルを編集する場合: 'files_to_edit' を使用して正確に変更する original_snippet に、変更箇所を特定するのに十分なコンテキストを含める - new_snippetが適切なインデントを維持するようにします。 - ファイルを完全に置き換えるよりも、対象を絞った編集を優先すること 4.変更内容とその理由を常に説明する 5.エッジケースと潜在的な影響を考慮する 6.言語固有のベストプラクティスに従う 7.必要に応じて、テストや検証ステップを提案する 覚えておいてください:あなたはシニア・エンジニアです。
ヘルプの使用
1.環境準備
まず、以下のものを用意する必要がある:
- DeepSeek API キーの取得
- 確立
環境
ファイルを作成し、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.コア機能の使用に関するガイダンス
3.1 基本的な対話
- 番組開始後、番組に関連する質問やリクエストをターミナルに直接入力することができます。
- システムは DeepSeek API を介してこれを処理し、構造化された応答を返します。
- 複数行のストリーミング出力に対応し、よりスムーズなインタラクションを実現
3.2 文書操作
- ファイルの内容をインポートする:
- 利用する
/パス/to/ファイルを追加
コマンドはファイルの内容をダイアログに追加する。 - 例
/add src/main.py
はmain.pyの内容をダイアログコンテキストにインポートします。
- 利用する
- ファイルの作成と編集:
- アシスタントが新規ファイルの作成や既存ファイルの編集を提案すると、詳細な変更案が表示されます。
- システムには、変更案を明確に示すリッチテキストの差分表が表示されます。
- これらの変更を確認するか拒否するかを選択できます。
3.3 ダイアログ・マネジメント
- 文脈の一貫性を確保するために、会話履歴をシステムが自動的に管理する。
- exit "または "quit "コマンドでセッションを終了する。
4.ベストプラクティスの推奨
- ファイル操作:
- ファイルをインポートする前に、ファイルパスが正しいことを確認してください。
- 重要なファイルを変更する前にバックアップを取ることをお勧めします。
- 対話の最適化:
- 質問は明確かつ具体的に
- 適切な場合は、/addコマンドを使用して文脈情報を補足する。
- 文書の変更を確認する前に、変更点を慎重に確認する
- 効率性の向上:
- システムのJSON構造化出力機能を活用する
- ファイル差表示機能をうまく活用しよう
- 会話履歴を消去して、会話をシンプルに保つ。
5.トラブルシューティング
- API接続の問題:
- APIキーが正しく設定されているか確認する
- ネットワーク接続状況の確認
- ファイル操作エラー:
- ファイルのパーミッション設定を確認する
- 宛先パスが書き込み可能であることを確認する。
- 応答解析の問題:
- 入力形式が正しいことを確認する
- セッションを再起動してみる