1. 什么是 DeepSeek？

DeepSeek 是一个强大的编码助手应用，通过 DeepSeek API，可以帮助开发者更高效地处理对话生成、文件操作和代码修改。它能读取本地文件，创建新文件，实时修改已有文件，并将所有内容以结构化的 JSON 格式返回。

如果你不想看下面冗长的介绍，而是想直接copy就用，可以参考下面代码仓库：

github.com/XiaomingX/d…

2. 主要功能简介

1. DeepSeek 客户端配置

   • 自动配置 API 客户端，使用有效的 DEEPSEEK_API_KEY 连接 DeepSeek 服务，确保与 DeepSeek API 的无缝对接。
   • 根据指定的环境变量，动态调整 DeepSeek 端点，实时获取类似 GPT 的流式回复。

2. 数据模型

   • 利用 Pydantic 实现类型安全的文件操作，主要包括：

     • FileToCreate：用于描述创建或更新的文件内容。
     • FileToEdit：描述对现有文件进行代码片段替换。
     • AssistantResponse：结构化的聊天回复，可能包含文件的修改指令。

3. 系统提示

   • 系统提示会指导对话，确保每个回复都符合 JSON 格式，且包含可执行的文件操作（如文件创建或编辑）。

4. 常用命令

   • read_local_file：读取指定文件路径的内容并返回文本。
   • create_file：创建一个新文件或覆盖现有文件，内容由用户提供。
   • show_diff_table：以表格形式展示文件修改建议，帮助你清晰了解文件差异。
   • apply_diff_edit：应用修改，将差异编辑到指定文件中。

5. “/add” 命令

   • 使用 /add path/to/file 可以快速读取指定文件的内容，并将内容插入到对话中。
   • 使用 /add path/to/folder 可以将目录下的所有文件（排除二进制文件和隐藏文件）批量添加到对话中，方便批量处理。

6. 对话流程

   • 所有对话会记录在 conversation_history 中，便于追溯和修改。
   • DeepSeek API 会流式传输助手的回复，并将内容解析成 JSON 格式，确保文件操作指令准确执行。

7. 交互式会话

   • 运行 python3 main.py 启动交互式循环，进入命令行模式。
   • 输入你的问题或代码需求，使用 /add path/to/file 添加文件内容，助手会为你生成代码或修改建议。
   • 输入 “exit” 或 “quit” 退出会话。

3. 快速入门步骤

0. 获取 API 密钥 如果你还没有 DeepSeek API 密钥，可以在 DeepSeek API 文档 上注册并申请。注册后通常会获得10元的余额。

1. 配置 API 密钥 在项目根目录下创建一个 .env 文件，并添加你的 API 密钥：

   DEEPSEEK_KEY=你的_api_key
   
   

2. 安装依赖并运行 选择以下任一方式来启动项目：

   • 使用 pip 安装：

     git clone --depth 1 https://github.com/XiaomingX/deepseek-quickstart
     pip install -r requirements.txt
     python3 main.py
     
     

3. 开始体验 现在你可以开始使用 DeepSeek 提供的多行流式响应功能，输入 /add path/to/file 来读取文件内容，然后进行修改，最终确认并编辑文件。

4. 深度推理版（main-r1.py）

新增 main-r1.py 脚本，采用 DeepSeek 推理模型（deepseek-reasoner），支持 “思维链” 推理（Chain of Thought, CoT）：

• 显示推理过程并给出最终答案。
• 保留文件操作和差异编辑功能。
• 展示推理过程，只记录最终结论。

通过 python3 main-r1.py 启动，享受增强版推理体验，帮助你更好地理解和验证答案。

注意：这是 XiaomingX 开发的实验项目，旨在测试 DeepSeek v3 API 的新功能。作为快速原型使用时，请根据需要进行调整。

最后的最后

感谢你们的阅读和喜欢，作为一位在一线互联网行业奋斗多年的老兵，我深知在这个瞬息万变的技术领域中，持续学习和进步的重要性。

为了帮助更多热爱技术、渴望成长的朋友，我特别整理了一份涵盖大模型领域的宝贵资料集。

这些资料不仅是我多年积累的心血结晶，也是我在行业一线实战经验的总结。

这些学习资料不仅深入浅出，而且非常实用，让大家系统而高效地掌握AI大模型的各个知识点。如果你愿意花时间沉下心来学习，相信它们一定能为你提供实质性的帮助。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

大模型知识脑图

为了成为更好的 AI大模型 开发者，这里为大家提供了总的路线图。它的用处就在于，你可以按照上面的知识点去找对应的学习资源，保证自己学得较为全面。

经典书籍阅读

阅读AI大模型经典书籍可以帮助读者提高技术水平，开拓视野，掌握核心技术，提高解决问题的能力，同时也可以借鉴他人的经验。对于想要深入学习AI大模型开发的读者来说，阅读经典书籍是非常有必要的。

实战案例

光学理论是没用的，要学会跟着一起敲，要动手实操，才能将自己的所学运用到实际当中去，这时候可以搞点实战案例来学习。

面试资料

我们学习AI大模型必然是想找到高薪的工作，下面这些面试题都是总结当前最新、最热、最高频的面试题，并且每道题都有详细的答案，面试前刷完这套面试题资料，小小offer，不在话下

640套AI大模型报告合集

这套包含640份报告的合集，涵盖了AI大模型的理论研究、技术实现、行业应用等多个方面。无论您是科研人员、工程师，还是对AI大模型感兴趣的爱好者，这套报告合集都将为您提供宝贵的信息和启示。

这份完整版的大模型 AI 学习资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】