はじめに
ディープシーク Engineerは、DeepSeek APIに基づいて開発された強力なプログラミングアシスタントツールで、直感的なコマンドラインインタフェースを通じてユーザーと対話し、さまざまなソフトウェア開発作業を支援します。このツールは、大規模な言語モデルのパワーと、実用的なファイルシステム操作およびインテリジェントなコード処理機能を兼ね備えており、通常のコード対話だけでなく、ローカルファイルの読み取り、作成、およびリアルタイムの変更もサポートします。構造化されたJSON応答メカニズムにより、DeepSeek Engineerはユーザーの意図を正確に理解し、コード生成やファイル編集などの多様な開発サポートを提供することができます。複数行のストリーミングレスポンス出力をサポートし、簡単なコマンドでファイルの内容を素早く取り込み、正確に編集することができるため、プログラミング効率を向上させる開発者の強力なアシスタントとなります。
機能一覧
- GPTスタイルのストリーミング・ダイアログ補完をサポートするDeepSeek APIクライアントの統合
- Pydanticベースの型安全ファイルオペレーティングシステム
- インテリジェントなシステム・プロンプトにより、すべてのレスポンスがJSON出力フォーマットに厳密に従うようにする。
- ローカルファイルの読み込みと内容分析機能
- ファイルの作成と更新操作のサポート
- コード差の視覚化
- フラグメントレベルのファイル変更機能
- add」コマンドはファイルの内容を素早くインポートする。
- 継続的な対話履歴の追跡
- 対話型端末セッションのサポート
- リアルタイム文書修正確認メカニズム
コア・プログラミングのキュー・ワードの抽出
あなたはDeepSeek Engineerと呼ばれる、あらゆるプログラミング領域で数十年の経験を持つエリートソフトウェアエンジニアです。
あなたの専門知識は、システム設計、アルゴリズム、テスト、ベストプラクティスに及びます。
あなたは、理由を説明しながら、思慮深く、構造化されたソリューションを提供します。
主な能力
1.コード分析とディスカッション
- 専門家レベルの洞察力でコードを分析する
- 複雑な概念を明確に説明する
- 最適化とベストプラクティスの提案
- 問題を正確にデバッグ
2.ファイル操作
a) 既存ファイルの読み込み
- ユーザーが提供したファイルの内容にアクセスしてコンテキストを確認する
- プロジェクト構造を理解するための複数ファイルの分析
b) 新規ファイルの作成
- 適切な構造を持つ完全な新規ファイルの生成
- 補完ファイルの作成（テスト、設定など）
c) 既存ファイルの編集
- 差分ベースの編集による正確な変更
- コンテキストを保持したまま、特定のセクションを変更する
- リファクタリングの改善提案
出力フォーマット。
このJSON構造でレスポンスを提供する必要があります。
{
"ファイル_to_create": [
{ "path": "path/to_create": [ "path": "path/to/new/file": "content": "完全なファイル": [
"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": "挿入する新しいコード"
}
]
}
通常の応答には'assistant_reply'を使用する。
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.コア機能の使用に関するガイダンス
機能 操作の流れ
- インタラクティブ・セッションの開始スクリプトを実行する：
python3 main.py) をクリックすると、ターミナルでインタラクティブなループが始まります。リクエストやコードの質問を入力してください。 - ファイルの内容を追加する入力
/パス/to/ファイルを追加と入力すると、ファイルの内容がダイアログに追加されます。また/パス/to/フォルダを追加をクリックすると、ディレクトリ内のすべてのファイル（バイナリと隠しファイルを除く）が追加されます。 - 文書変更の確認アシスタントが新しいファイルや編集したファイルを提案すると、ローカル環境で直接変更を確認することができます。
- セッション終了入力
出口もしかしたらやめるでセッションを終了する。
主な機能
- 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 "コマンドを入力することができます。
/パス/to/ファイルを追加ファイルの内容を素早く読み取り、システムメッセージとしてダイアログに挿入。ユーザーは/パス/to/フォルダを追加をクリックすると、ディレクトリ内のすべてのファイル(バイナリと隠しファイルを除く)が追加されます。これにより、アシスタントは、さらなる議論、コード生成、またはdiffの提案のためにファイルの内容を参照できるようになります。 - 対話の流れユーザとアシスタントの間のメッセージを追跡するためにconversation_historyリストを維持し、DeepSeek APIを介してアシスタントの返信をストリーミングします。
障害解決
- API接続の問題：
- APIキーが正しく設定されているか確認する
- ネットワーク接続状況の確認
- ファイル操作エラー：
- ファイルのパーミッション設定を確認する
- 宛先パスが書き込み可能であることを確認する。
- 応答解析の問題：
- 入力形式が正しいことを確認する
- セッションを再起動してみる
日本語 
简体中文 
English 
Deutsch (Sie) 
Português do Brasil