딥시크 엔지니어: 딥시크 API를 기반으로 하는 실험적인 코딩 도우미로, 큐워드가 포함되어 있습니다.

일반 소개

DeepSeek Engineer는 직관적인 명령줄 인터페이스를 통해 사용자와 상호 작용하여 다양한 소프트웨어 개발 작업을 지원할 수 있는 DeepSeek API를 기반으로 개발된 강력한 프로그래밍 보조 도구입니다. 이 도구는 대규모 언어 모델의 강력한 기능과 실용적인 파일 시스템 조작 및 지능형 코드 처리 기능을 결합하여 일반 코드 대화뿐만 아니라 로컬 파일의 읽기, 생성 및 실시간 수정을 지원합니다. 딥시크 엔지니어는 구조화된 JSON 응답 메커니즘을 통해 사용자의 의도를 정확하게 파악하고 코드 생성, 파일 편집 등 다양한 개발 지원을 제공할 수 있습니다. 여러 줄 스트리밍 응답 출력을 지원하며, 간단한 명령어로 파일 내용을 빠르게 가져오고 정확하게 편집할 수 있어 개발자의 프로그래밍 효율성을 향상시키는 강력한 보조 도구가 될 수 있습니다.

기능 목록

• 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. 환경 준비

먼저 다음을 준비해야 합니다:

1. DeepSeek API 키 받기
2. 설정.env파일을 열고 API 키를 구성합니다:

DEEPSEEK_API_KEY=your_api_key_here

2. 설치 단계

DeepSeek Engineer는 두 가지 설치 옵션을 제공합니다:

pip를 사용한 설치(기존 방식)

pip install -r requirements.txt
python3 main.py

UV를 사용한 설치(더 빠른 대안)

uv venv
uv run main.py

3. 핵심 기능 사용에 대한 안내

기능 작동 흐름

1. 대화형 세션 시작하기: 스크립트를 실행합니다(예python3 main.py)를 눌러 터미널에서 대화형 루프를 시작합니다. 요청 또는 코드 질문을 입력합니다.
2. 파일 콘텐츠 추가: 입력 /add path/to/file 을 클릭하여 대화 상자에 파일 내용을 추가합니다. 다음과 같이 입력할 수도 있습니다. /add path/to/folder 를 클릭하여 디렉터리의 모든 파일(바이너리 및 숨김 파일 제외)을 추가합니다.
3. 문서 변경 사항 확인어시스턴트가 새 파일 또는 편집한 파일을 제안하면 로컬 환경에서 바로 변경 사항을 확인할 수 있습니다.
4. 세션 종료: 입력 exit 어쩌면 quit 를 클릭하여 세션을 종료합니다.

주요 기능

• DeepSeek 클라이언트 구성: 유효한 DEEPSEEK_API_KEY를 사용하도록 API 클라이언트를 자동으로 구성하고 환경 변수에 지정된 DeepSeek 엔드포인트에 연결하여 GPT 클래스 완료를 스트리밍합니다.
• 데이터 모델생성 또는 업데이트할 파일을 설명하는 FileToCreate, 기존 파일의 특정 코드 세그먼트 교체를 설명하는 FileToEdit, 채팅 응답 및 잠재적인 파일 작업을 구조화하는 AssistantResponse 등 Pydantic을 통한 유형 안전 파일 작업 처리입니다.
• 시스템 경고종합적인 system_PROMPT가 대화를 안내하여 모든 응답이 JSON 출력을 엄격하게 따르도록 하며 파일을 만들거나 편집할 수 있는 옵션을 제공합니다.
• 도우미 기능:: 로컬 파일의 내용을 읽는 read_local_file, 파일을 만들거나 덮어쓰는 create_file, 제안된 파일 변경 내용을 여러 줄로 된 표로 표시하는 show_diff_table, 기존 파일에 스니펫 수준의 변경 내용을 적용하는 apply_diff_edit이 포함됩니다.
• "/add" 명령사용자가 입력할 수 있습니다. /add path/to/file 파일의 내용을 빠르게 읽고 시스템 메시지로 대화에 삽입할 수 있습니다. 사용자는 다음과 같이 입력할 수도 있습니다. /add path/to/folder 를 사용하여 디렉터리의 모든 파일(바이너리 및 숨김 파일 제외)을 추가하면 어시스턴트가 파일 내용을 참조하여 추가 논의, 코드 생성 또는 차이점 제안을 할 수 있습니다.
• 대화 흐름대화_기록 목록을 유지하여 사용자와 어시스턴트 간의 메시지를 추적하고, DeepSeek API를 통해 어시스턴트의 응답을 스트리밍하여 JSON으로 파싱하여 텍스트 응답 및 파일 수정 지침을 보존합니다.

결함 해결

1. API 연결 문제:
   • API 키가 올바르게 구성되었는지 확인
   • 네트워크 연결 상태 확인
2. 파일 작업 오류입니다:
   • 파일 권한 설정 확인
   • 대상 경로가 쓰기 가능한 경로인지 확인합니다.
3. 응답 구문 분석 문제:
   • 입력 형식이 올바른지 확인
   • 세션을 다시 시작해보세요.