DeepSeek Engineer：基于DeepSeek API的实验性编码助手,附提示词

综合介绍

DeepSeek Engineer是一款基于DeepSeek API开发的强大编程助手工具，它能够通过直观的命令行界面与用户进行交互，协助完成各种软件开发任务。该工具将大型语言模型的能力与实用的文件系统操作和智能代码处理功能相结合，不仅可以进行常规的代码对话，还支持本地文件的读取、创建和实时修改。通过结构化的JSON响应机制，DeepSeek Engineer能够精确理解用户意图，提供代码生成、文件编辑等多样化的开发支持。它的特色在于支持多行流式响应输出，并且可以通过简单的命令实现文件内容的快速导入和精确编辑，是开发者提升编程效率的得力助手。

功能列表

• DeepSeek API客户端集成，支持GPT风格的流式对话完成
• 基于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. 核心功能使用指南

3.1 基本对话

• 启动程序后，您可以直接在终端输入编程相关的问题或请求
• 系统会通过DeepSeek API进行处理并返回结构化的回应
• 支持多行流式输出，让交互更加流畅

3.2 文件操作

1. 导入文件内容：
   • 使用/add path/to/file命令将文件内容添加到对话中
   • 例如：/add src/main.py将把main.py的内容导入到对话上下文
2. 文件创建和编辑：
   • 当助手建议创建新文件或编辑现有文件时，会显示详细的变更建议
   • 系统会展示一个富文本差异表格，清晰显示proposed changes
   • 您可以选择确认或拒绝这些变更

3.3 对话管理

• 系统自动维护conversation_history，确保上下文连贯性
• 使用"exit"或"quit"命令结束会话

4. 最佳实践建议

1. 文件操作：
   • 在导入文件前，确保文件路径正确
   • 建议在修改重要文件前进行备份
2. 对话优化：
   • 保持问题清晰具体
   • 适时使用/add命令补充上下文信息
   • 在确认文件修改前仔细review变更内容
3. 效率提升：
   • 利用系统的JSON结构化输出特性
   • 善用文件差异显示功能
   • 适时清理对话历史，保持会话简洁

5. 故障排除

1. API连接问题：
   • 检查API密钥配置是否正确
   • 确认网络连接状态
2. 文件操作错误：
   • 验证文件权限设置
   • 确保目标路径可写
3. 响应解析问题：
   • 检查输入格式是否正确
   • 尝试重启会话