在终端中运行的DeepSeek模型编码代理
Hmbown/DeepSeek-TUI 是一个基于 Rust 开发的终端原生编码代理,专门为 DeepSeek V4 模型设计。它利用 DeepSeek V4 的 1M 令牌上下文窗口和前缀缓存技术,让模型能够直接在终端中访问工作区,执行文件读写、Shell 命令、Git 操作、网络搜索、子代理编排等任务。整个工具仅需一个二进制文件,无需 Node 或 Python 运行时环境。它内置了 MCP 客户端、沙箱环境和持久化任务队列,支持三种工作模式(计划、代理、YOLO)以及思考模式流式输出。用户可以通过键盘驱动的 TUI 界面高效交互,还支持会话保存恢复、工作区回滚、推理强度调节等功能。该工具适用于需要深度代码分析、自动化编程、批量审查或长期运行的后台任务场景,特别适合追求终端原生体验的开发者。
💡 应用场景
最适合需要深度代码分析、自动化批量修改或长期后台任务的终端原生开发者,尤其是使用DeepSeek V4模型并追求高效键盘驱动工作流的场景。
深度代码审查与重构
问题:大型代码库的逐行审查耗时且容易遗漏,手动执行重构风险高。
方案:利用DeepSeek V4的1M令牌上下文窗口,让模型一次性读取整个工作区,自动分析代码结构、检测问题并生成重构方案,通过Plan模式预览变更,Agent模式逐步确认执行。
示例:对一个包含数百个文件的Rust项目进行API兼容性审查,模型自动发现废弃接口并生成替换代码,开发者只需在TUI中按需批准修改。
自动化批量代码修改
问题:需要在多个文件中重复执行相同的代码替换或模式化修改,手动操作易出错且效率低。
方案:通过YOLO模式让模型自动执行批量文件读写和Shell命令,利用持久化任务队列在后台运行,支持断点恢复。
示例:将项目中所有Python日志调用从logging.info替换为自定义logger.info,模型自动遍历所有.py文件并应用补丁,开发者只需启动任务后查看结果。
长期运行的后台代码分析
问题:需要持续监控代码质量或执行定期检查,但手动启动分析任务繁琐且无法持久化。
方案:使用持久化任务队列和HTTP/SSE运行时API,部署为后台服务,自动执行LSP诊断、代码风格检查或安全扫描,结果通过TUI或API查询。
示例:在CI/CD流程中集成deepseek serve --http,每次提交后自动对变更文件进行静态分析并生成报告,开发者通过TUI查看历史会话。
跨会话的复杂调试与修复
问题:调试一个涉及多个模块的bug时,上下文容易丢失,重启会话后需要重新描述问题。
方案:利用会话保存/恢复功能,在调试过程中随时创建检查点,后续从断点处继续分析;结合用户记忆功能保存调试偏好。
示例:调试一个内存泄漏问题,模型逐步分析堆栈并修改代码,开发者下班前保存会话,第二天恢复后模型继续从上次分析结果出发,最终定位到循环引用。
📊 项目信息
- 语言
- Rust
- Stars
- ⭐ 21,709
- Forks
- 1,688
- 今日新增
- +3,731
- 排名
- #3
- 收录
- 总榜
- 趋势日期
- 2026年5月8日
- 最后推送
- 2026/5/8
🏷️ 标签
DeepSeek-TUI 5分钟快速开始
DeepSeek-TUI 是一个终端原生编码代理,专为 DeepSeek V4 模型设计,支持 1M 令牌上下文,单二进制文件即可运行。
🖥️ 操作系统
🔧 工具
📝 操作步骤
下载预编译二进制文件
从 GitHub Releases 页面下载适合你系统的二进制文件。Linux x64、macOS ARM64 等均有提供。
替换 <your-os> 和 <arch> 为你的系统(如 linux-x64、darwin-arm64)
$ curl -LO https://github.com/Hmbown/DeepSeek-TUI/releases/latest/download/deepseek-<your-os>-<arch>.tar.gz解压文件
$ tar -xzf deepseek-*.tar.gz将两个二进制文件移动到 PATH 中
$ sudo mv deepseek /usr/local/bin/ && sudo mv deepseek-tui /usr/local/bin/设置 API 密钥
首次运行会提示输入 DeepSeek API 密钥,密钥保存在 ~/.deepseek/config.toml。也可以提前设置环境变量。
设置环境变量,替换为你的真实密钥
$ export DEEPSEEK_API_KEY='your-api-key-here'启动 TUI
在终端中运行 deepseek 命令启动 TUI 界面。
启动 DeepSeek-TUI
$ deepseek发送第一条消息
在 TUI 中输入一条简单指令,例如 '列出当前目录文件',然后按 Enter 发送。
在 TUI 输入框中输入此消息并回车
$ 列出当前目录文件✅ 验证成功
成功看到模型执行命令并返回结果,说明 DeepSeek-TUI 已正常运行。
- ✓TUI 界面正常显示
- ✓模型响应并执行了工具调用
- ✓输出结果包含文件列表或任务完成信息
⚡ 快速提示
🔍 常见问题排查
❓ 运行 deepseek 报错 'command not found'
→ 确保二进制文件已移动到 /usr/local/bin 或 PATH 中的其他目录。
❓ 启动后提示 API 密钥未设置
→ 设置环境变量 DEEPSEEK_API_KEY 或运行 deepseek auth set --provider deepseek 交互式输入。
❓ 模型响应慢或超时
→ 检查网络连接,或按 Ctrl+C 取消当前请求后重试。
🎯 下一步
阅读文档
查看 docs/ 目录下的详细文档,了解 MCP、会话保存等功能。
尝试 YOLO 模式
在 TUI 中按 Tab 切换到 YOLO 模式,体验自动批准工具调用。
配置项目覆盖
在工作目录创建 .deepseek/config.toml 覆盖全局配置。
