Hmbown / DeepSeek-TUI

7,187548+2,434 todayRust

在终端中运行的DeepSeek模型编码代理

Hmbown/DeepSeek-TUI 是一个基于 Rust 开发的终端原生编码代理，专门为 DeepSeek V4 模型设计。它利用 DeepSeek V4 的 1M 令牌上下文窗口和前缀缓存技术，让模型能够直接在终端中访问工作区，执行文件读写、Shell 命令、Git 操作、网络搜索、子代理编排等任务。整个工具仅需一个二进制文件，无需 Node 或 Python 运行时环境。它内置了 MCP 客户端、沙箱环境和持久化任务队列，支持三种工作模式（计划、代理、YOLO）以及思考模式流式输出。用户可以通过键盘驱动的 TUI 界面高效交互，还支持会话保存恢复、工作区回滚、推理强度调节等功能。该工具适用于需要深度代码分析、自动化编程、批量审查或长期运行的后台任务场景，特别适合追求终端原生体验的开发者。

📊 项目信息

语言: Rust
Stars: ⭐ 7,187
Forks: 548
今日新增: +2,434
排名: #1
收录: 总榜
趋势日期: 2026年5月5日
最后推送: 2026/5/5

🏷️ 标签

clideepseekllmrustterminaltui

📸 截图

DeepSeek-TUI 5分钟快速开始

DeepSeek-TUI 是一个终端原生编码代理，专为 DeepSeek V4 模型设计，支持 1M 令牌上下文，单二进制文件即可运行。

🖥️ 操作系统

macOSWindowsLinux

🔧 工具

终端— 运行命令

📝 操作步骤

下载预编译二进制文件

从 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/

✓预期输出：命令执行后无错误输出，deepseek 和 deepseek-tui 命令可用。

💡如果下载慢，可以使用 npm 安装：npm i -g deepseek-tui（需要 Node.js，但仅用于安装）。

设置 API 密钥

首次运行会提示输入 DeepSeek API 密钥，密钥保存在 ~/.deepseek/config.toml。也可以提前设置环境变量。

设置环境变量，替换为你的真实密钥

$ export DEEPSEEK_API_KEY='your-api-key-here'

✓预期输出：无输出，但后续运行不再提示输入密钥。

💡密钥可以从 platform.deepseek.com 获取。

启动 TUI

在终端中运行 deepseek 命令启动 TUI 界面。

启动 DeepSeek-TUI

$ deepseek

✓预期输出：终端显示 TUI 界面，顶部有模式指示器（如 Agent），底部有输入框。

💡如果报错找不到 deepseek-tui，确保两个二进制文件都在 PATH 中。

发送第一条消息

在 TUI 中输入一条简单指令，例如 '列出当前目录文件'，然后按 Enter 发送。

在 TUI 输入框中输入此消息并回车

$ 列出当前目录文件

✓预期输出：模型会思考并执行 ls 命令，然后在界面中显示文件列表。

💡按 Tab 可以自动补全命令或文件路径。

✅ 验证成功

成功看到模型执行命令并返回结果，说明 DeepSeek-TUI 已正常运行。

✓TUI 界面正常显示
✓模型响应并执行了工具调用
✓输出结果包含文件列表或任务完成信息

⚡ 快速提示

导航按 F1 查看所有快捷键帮助

配置按 Shift+Tab 切换推理强度（off/high/max）

命令输入 /help 查看命令列表

🔍 常见问题排查

❓ 运行 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 覆盖全局配置。