项目简介
DeepSeek-TUI 是一个运行在终端里的 AI 编码 Agent，基于 DeepSeek V4 模型。它能读写文件、执行 Shell 命令、搜索网页、管理 Git、协调子 Agent——全程由键盘驱动，无需 GUI。
它不是另一个聊天机器人，而是一个真正能在本地工作区里动手干活的编码助手。
它是什么
DeepSeek-TUI 由两个 Rust 二进制组成：
deepseek # 调度器 CLI（入口命令）
deepseek-tui # TUI 运行时（终端界面）安装后直接在终端输入 deepseek 启动交互式 TUI 界面，或者 deepseek "fix this bug" 作为一次性命令运行。
核心功能
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 镜像加速：
npm install -g deepseek-tui --registry=https://registry.npmmirror.com快速开始
1. 安装
npm install -g deepseek-tui2. 配置 API Key
# 方式一：交互式配置
deepseek auth set --provider deepseek
# 方式二：环境变量
export DEEPSEEK_API_KEY="YOUR_KEY"
# 验证配置
deepseek auth status
deepseek doctor3. 运行
# 交互式 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 模式只读分析：
# 进入 Plan 模式，Agent 只能读取，不能修改
# 在 TUI 中切换模式，或使用 --plan 参数
deepseek --plan "分析这个项目的架构，画出模块依赖关系"Agent 会遍历代码库，理解架构，输出分析报告，不会修改任何文件。
⚡ 场景三：批量重构
用 YOLO 模式自动执行大规模重构：
# YOLO 模式，自动批准所有操作
deepseek --yolo "把所有类名从 PascalCase 改为 snake_case"Agent 会自动：
- 搜索所有需要修改的文件
- 逐个执行重构
- 运行测试验证
- 如果测试失败自动调整
配合工作区回滚功能，不满意可以随时 /restore。
🧪 场景四：代码审查
拉取 PR 进行预审：
deepseek run pr 42 # 拉取 PR #42 并预填充审查提示总结
DeepSeek-TUI 把 AI 编码 Agent 带进了终端——不依赖浏览器，不依赖 GUI，纯键盘驱动。
如果你习惯在终端里工作，DeepSeek-TUI 是目前最成熟的终端 AI 编码 Agent。
🚀 GitHub：https://github.com/Hmbown/DeepSeek-TUI
💻 官网：https://deepseek-tui.com