Coding agent for DeepSeek models that runs in your terminal
💡 Use Cases
最适合需要深度代码分析、自动化批量修改或长期后台任务的终端原生开发者,尤其是使用DeepSeek V4模型并追求高效键盘驱动工作流的场景。
深度代码审查与重构
Problem: 大型代码库的逐行审查耗时且容易遗漏,手动执行重构风险高。
Solution: 利用DeepSeek V4的1M令牌上下文窗口,让模型一次性读取整个工作区,自动分析代码结构、检测问题并生成重构方案,通过Plan模式预览变更,Agent模式逐步确认执行。
Example: 对一个包含数百个文件的Rust项目进行API兼容性审查,模型自动发现废弃接口并生成替换代码,开发者只需在TUI中按需批准修改。
自动化批量代码修改
Problem: 需要在多个文件中重复执行相同的代码替换或模式化修改,手动操作易出错且效率低。
Solution: 通过YOLO模式让模型自动执行批量文件读写和Shell命令,利用持久化任务队列在后台运行,支持断点恢复。
Example: 将项目中所有Python日志调用从logging.info替换为自定义logger.info,模型自动遍历所有.py文件并应用补丁,开发者只需启动任务后查看结果。
长期运行的后台代码分析
Problem: 需要持续监控代码质量或执行定期检查,但手动启动分析任务繁琐且无法持久化。
Solution: 使用持久化任务队列和HTTP/SSE运行时API,部署为后台服务,自动执行LSP诊断、代码风格检查或安全扫描,结果通过TUI或API查询。
Example: 在CI/CD流程中集成deepseek serve --http,每次提交后自动对变更文件进行静态分析并生成报告,开发者通过TUI查看历史会话。
跨会话的复杂调试与修复
Problem: 调试一个涉及多个模块的bug时,上下文容易丢失,重启会话后需要重新描述问题。
Solution: 利用会话保存/恢复功能,在调试过程中随时创建检查点,后续从断点处继续分析;结合用户记忆功能保存调试偏好。
Example: 调试一个内存泄漏问题,模型逐步分析堆栈并修改代码,开发者下班前保存会话,第二天恢复后模型继续从上次分析结果出发,最终定位到循环引用。
📊 Project Info
- Language
- Rust
- Stars
- ⭐ 18,696
- Forks
- 1,412
- Today
- +5,799
- Ranking
- #2
- Collection
- Overall
- Trending Date
- May 7, 2026
- Last Push
- 5/7/2026
🏷️ Topics
DeepSeek-TUI 5分钟快速开始
DeepSeek-TUI 是一个终端原生编码代理,专为 DeepSeek V4 模型设计,支持 1M 令牌上下文,单二进制文件即可运行。
🖥️ OS
🔧 Tools
📝 Steps
下载预编译二进制文件
从 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 界面正常显示
- ✓模型响应并执行了工具调用
- ✓输出结果包含文件列表或任务完成信息
⚡ Quick Tips
🔍 Troubleshooting
❓ 运行 deepseek 报错 'command not found'
→ 确保二进制文件已移动到 /usr/local/bin 或 PATH 中的其他目录。
❓ 启动后提示 API 密钥未设置
→ 设置环境变量 DEEPSEEK_API_KEY 或运行 deepseek auth set --provider deepseek 交互式输入。
❓ 模型响应慢或超时
→ 检查网络连接,或按 Ctrl+C 取消当前请求后重试。
🎯 Next Steps
阅读文档
查看 docs/ 目录下的详细文档,了解 MCP、会话保存等功能。
尝试 YOLO 模式
在 TUI 中按 Tab 切换到 YOLO 模式,体验自动批准工具调用。
配置项目覆盖
在工作目录创建 .deepseek/config.toml 覆盖全局配置。
