快速阅读

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