DeepSeek Engineer：集成 DeepSeek API 的开源 AI 编程助手，支持文件读取、编辑并生成结构化响应

快速阅读

1. 功能：DeepSeek Engineer 支持文件读取、创建、编辑，并生成结构化JSON响应。
2. 技术：基于 DeepSeek API 和 Pydantic 数据模型，确保类型安全和数据一致性。
3. 应用：适用于代码审查、文档生成、实时代码协作等场景。

正文（附运行示例）

DeepSeek Engineer 是什么

DeepSeek Engineer 是一款开源的 AI 编程助手，集成了 DeepSeek API，通过命令行界面与用户进行交互。它能够读取本地文件、创建新文件，并对现有文件进行实时差异编辑。DeepSeek Engineer 使用 Pydantic 进行类型安全的文件操作，确保所有响应都以 JSON 格式输出。

DeepSeek Engineer 的主要目标是帮助开发者在对话中引用文件内容，生成代码或提出差异编辑建议。它通过系统提示引导对话，确保输出的格式和内容符合预期，同时支持文件的创建和编辑。

DeepSeek Engineer 的主要功能

1. DeepSeek 客户端配置：自动配置 API 客户端，连接到环境变量中指定的 DeepSeek 端点。
2. 数据模型：基于 Pydantic 进行类型安全的文件操作，包括文件创建、更新和片段替换。
3. 系统提示：通过预设的系统提示引导对话，确保所有回复都遵循 JSON 输出格式。
4. 辅助函数：提供文件读取、创建、编辑和差异展示等功能，简化文件系统操作。
5. “/add” 命令：支持用户快速读取文件内容，并将其作为系统消息插入对话中。

DeepSeek Engineer 的技术原理

1. API 集成：集成 DeepSeek API，通过命令行与 DeepSeek 服务进行交互。
2. 环境变量：使用环境变量指定 DeepSeek 服务的端点，确保配置的灵活性和安全性。
3. Pydantic 数据模型：基于 Pydantic 库定义和验证数据模型，确保文件操作的类型安全和数据一致性。
4. 系统提示：通过预设的系统提示引导对话，确保输出的格式和内容符合预期。
5. 文件操作函数：实现一系列辅助函数，处理文件的读取、创建、编辑和差异展示。
6. 对话管理：维护对话历史列表，跟踪用户和助手之间的交互，保持对话上下文。

如何运行 DeepSeek Engineer

1. 准备环境

在.env文件中配置 DeepSeek API 密钥：

DEEPSEEK_API_KEY=your_api_key_here

2. 安装依赖并运行

使用 pip 安装依赖并运行：

pip install -r requirements.txt
python3 main.py

或者使用 uv 作为更快的替代方案：

uv venv
uv run main.py

3. 开始交互

运行脚本后，进入交互式终端。输入请求或代码问题，使用/add path/to/file命令添加文件内容到对话中。当助手建议创建或编辑文件时，可以直接在本地环境中确认更改。输入exit或quit结束会话。

资源

• GitHub 仓库：https://github.com/Doriandarko/deepseek-engineer