项目简介
DeepSeek-TUI 是一个运行在终端里的 AI 编码 Agent，基于 DeepSeek V4 模型。它能读写文件、执行 Shell 命令、搜索网页、管理 Git、协调子 Agent——全程由键盘驱动，无需 GUI。
它不是另一个聊天机器人，而是一个真正能在本地工作区里动手干活的编码助手。
GitHub
https://github.com/Hmbown/DeepSeek-TUI
它是什么
DeepSeek-TUI 由两个 Rust 二进制组成：
deepseek # 调度器 CLI（入口命令）
deepseek-tui # TUI 运行时（终端界面）
安装后直接在终端输入 deepseek 启动交互式 TUI 界面，或者 deepseek "fix this bug" 作为一次性命令运行。
核心功能
🧠
推理流式输出
实时看到 DeepSeek 的推理块（reasoning blocks），了解模型如何思考问题
📚
100 万 Token 上下文
超大上下文窗口，支持上下文压缩、前缀缓存感知成本报告
🔧
全工具套件
文件操作、Shell 执行、Git 管理、网页搜索/浏览、Patch 应用、子 Agent 协调、MCP 服务器
🎛️
Auto 模式
--model auto 自动选择模型和推理级别，简单任务用 Flash，复杂任务用 Pro
💾
会话保存/恢复
长时间运行任务可 checkpoint，随时恢复，还支持会话分叉
🔄
工作区回滚
Side-Git 快照机制，/restore 回滚，不影响仓库 .git
🔍
LSP 诊断
每次编辑后自动注入 rust-analyzer/pyright/tsc/gopls/clangd 诊断到上下文
🌐
HTTP/SSE API
deepseek serve --http 支持无头 Agent 工作流
🤖
MCP 协议
连接 Model Context Protocol 服务器扩展工具链
💰
实时成本追踪
每轮/会话级别的 Token 用量、成本估算、缓存命中率
🌏
本地化 UI
en/ja/zh-Hans/pt-BR 自动检测
Auto 模式
这是 DeepSeek-TUI 最实用的功能之一：--model auto 或 /model auto
在每轮发送前，系统用一个小的 deepseek-v4-flash 路由调用分析当前任务，自动决定：
| 参数 | 选项 |
|---|
| 模型 | deepseek-v4-flash / deepseek-v4-pro |
| 推理级别 | off / high / max |
- 简单任务 → Flash + 推理 off
- 编码/调试 → 可能升级到 Pro + high/max
- 架构/安全审查 → 自动选择更高级配置
上游 API 只收到具体模型和推理设置，永远不会收到 "auto"。TUI 界面显示选定的路由，成本按实际运行的模型计费。
三种运行模式
| 模式 | 行为 | 适用场景 |
|---|
| Plan | 只读探索，不修改文件 | 理解代码库、分析架构 |
| Agent | 交互式，每次工具调用需批准 | 日常开发、需要人工把关 |
| YOLO | 自动批准所有操作 | 批量重构、CI 自动化 |
配合 Shift + Tab 可切换推理力度：off → high → max
技术架构
deepseek (调度器 CLI)
└── deepseek-tui (TUI 运行时)└── ratatui 界面└── 异步引擎├── OpenAI 兼容流式客户端├── 工具调用注册表（Shell/文件/Git/Web/子Agent/MCP/RLM）├── 会话状态管理 + 轮次追踪├── 耐用任务队列└── LSP 子系统
安装方式
方式一：npm（最简单）
npm install -g deepseek-tui
方式二：Cargo（无需 Node）
cargo install deepseek-tui-cli --locked # deepseek 入口
cargo install deepseek-tui --locked # deepseek-tui 运行时
方式三：Scoop（Windows）
scoop update
scoop install deepseek-tui
方式四：Homebrew（macOS）
brew tap Hmbown/deepseek-tui
brew install deepseek-tui
方式五：Docker
docker run --rm -it -e DEEPSEEK_API_KEY -v "$PWD:/workspace" ghcr.io/hmbown/deepseek-tui:latest
方式六：直接下载
访问 GitHub Releases 下载预编译二进制：Linux x64/ARM64、macOS x64/ARM64、Windows x64
中国大陆用户可加速：
npm install -g deepseek-tui --registry=https://registry.npmmirror.com
快速开始
1. 安装
npm install -g deepseek-tui
2. 配置 API Key
# 交互式配置
deepseek auth set --provider deepseek# 或环境变量
export DEEPSEEK_API_KEY="YOUR_KEY"# 验证配置
deepseek auth status
deepseek doctor
3. 运行
# 交互式 TUI
deepseek# 一次性命令
deepseek "explain this function"# Auto 模式
deepseek --model auto "fix this bug"# YOLO 自动批准
deepseek --yolo
实战场景
🚀 场景一：修复一个线上 Bug
启动 Agent 模式，让 DeepSeek-TUI 帮你定位和修复：
deepseek --model auto "这个接口返回 500，帮我定位问题并修复"
Agent 会：
- 读取相关代码文件和日志
- 运行测试复现问题
- 定位 bug 根因
- 提交修复方案，等待你批准
🔍 场景二：理解一个陌生的代码库
使用 Plan 模式只读分析：
deepseek --plan "分析这个项目的架构，画出模块依赖关系"
Agent 会遍历代码库，理解架构，输出分析报告，不会修改任何文件。
⚡ 场景三：批量重构
用 YOLO 模式自动执行大规模重构：
deepseek --yolo "把所有类名从 PascalCase 改为 snake_case"
Agent 会自动搜索、修改、测试验证，不满意可以随时 /restore 回滚。
🧪 场景四：代码审查
拉取 PR 进行预审：
deepseek run pr 42 # 拉取 PR #42 并预填充审查提示
总结
DeepSeek-TUI 把 AI 编码 Agent 带进了终端——不依赖浏览器，不依赖 GUI，纯键盘驱动。
✅ 23,211 Stars — Rust 编写，性能可靠
✅ 终端编码 Agent — 读写文件、执行命令、搜索网页、管理 Git
✅ 推理流式输出 — 实时看到模型的思考过程
✅ 100 万 Token 上下文 — 大型代码库也能处理
✅ Auto 模式 — 自动选择模型和推理级别，省成本
✅ 三种运行模式 — Plan / Agent / YOLO 覆盖不同场景
✅ 工作区回滚 — Side-Git 快照，不满意随时恢复
✅ LSP 诊断 — 编辑后自动注入错误/警告到上下文
✅ 全平台支持 — Linux / macOS / Windows
✅ MIT 开源 — 自由使用
如果你习惯在终端里工作，DeepSeek-TUI 是目前最成熟的终端 AI 编码 Agent。
🚀 GitHub：https://github.com/Hmbown/DeepSeek-TUI
💻 官网：https://deepseek-tui.com
