Linux 知识库

Appearance

DeepSeek-TUI ​

1. 基础介绍 ​

DeepSeek TUI 是一款开源、终端原生的 AI 编程代理（Coding Agent），由独立开发者 Hunter Bown（Hmbown）创建，基于 DeepSeek V4 系列模型，提供 100 万 token 的超长上下文窗口。它不是一个简单的聊天界面，而是一个能在终端中直接读写文件、执行 Shell 命令、管理 Git、搜索网页、调用 MCP 服务器的全功能 AI 编程助手。

  • 开发者：Hunter Bown（独立开发者，与 DeepSeek Inc. 无关）
  • 技术栈：Rust（单二进制文件，无需 Node.js 或 Python 运行时）
  • 开源协议：MIT
  • GitHub：https://github.com/Hmbown/deepseek-tui
  • 官方网站：https://deepseek-tui.com
  • GitHub Star：32.6K+
  • 最新版本：v0.8.39（2026-05-17）
  • 上下文窗口：100 万 token（DeepSeek V4 原生支持）

1.1 核心功能 ​

  • 终端原生代理：不是聊天框，而是能执行操作的代理——读取编辑文件、运行 Shell 命令、管理 Git、搜索网页
  • 三种工作模式：Plan（只读探索）、Agent（交互式，危险操作需审批）、YOLO（自动批准）
  • 思维链流式输出：实时查看模型的推理过程
  • 100 万 token 上下文：智能压缩机制，超出时自动压缩；前缀缓存感知，节省成本
  • RLM 并行推理：rlm_query 可并行派发 1~16 个子代理进行批量分析和并行推理
  • 完整工具套件：文件操作、Shell 执行、Git、Web 搜索/浏览、apply-patch、子代理、MCP 服务器
  • 会话保存/恢复：断点续传，长时间工作不丢失上下文
  • 工作区回滚：通过 side-git 在每次对话前后创建快照，支持 /restore 和 revert_turn
  • 持久任务队列：后台任务可跨重启持久化，适合定时自动化、长期代码审查
  • HTTP/SSE 运行时 API：deepseek serve --http 支持无头代理工作流
  • 推理强度调节：通过 Shift + Tab 在 off → high → max 之间切换
  • 多语言支持：内置英语、日语、简体中文、巴西葡萄牙语

1.2 应用场景 ​

  • 在终端中直接进行 AI 辅助编程，无需切换窗口
  • 代码审查和 Bug 修复
  • 大规模代码库重构
  • 自动化 Git 操作（提交、分支管理）
  • 多文件批量编辑和重构
  • Web 搜索辅助的问题排查

2. 安装和配置 ​

2.1 安装方式 ​

Cargo 安装（推荐，需 Rust 1.88+） ​

bash
cargo install deepseek-tui-cli --locked

安装后 deepseek 命令会位于 ~/.cargo/bin/ 目录。

npm 安装（无需 Rust 工具链，需 Node 18+） ​

bash
npm install -g deepseek-tui

npm 包装器会自动从 GitHub Releases 下载对应平台的预构建二进制文件。

Homebrew 安装（macOS / Linux） ​

bash
brew tap Hmbown/deepseek-tui
brew install deepseek-tui

Scoop 安装（Windows） ​

bash
scoop bucket add deepseek-tui https://github.com/Hmbown/scoop-bucket
scoop install deepseek-tui

Docker 安装 ​

bash
docker pull ghcr.io/hmbown/deepseek-tui:latest

直接下载二进制文件 ​

从 GitHub Releases 页面下载对应平台的预构建二进制文件。

2.2 国内网络加速 ​

Cargo 方式（推荐国内用户）：配置清华 tuna 镜像源

在 ~/.cargo/config.toml 中添加：

toml
[source.crates-io]
replace-with = "tuna"

[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

然后执行 cargo install deepseek-tui-cli --locked。

npm 方式：

bash
npm config set registry https://registry.npmmirror.com
npm install -g deepseek-tui

2.3 配置 API Key ​

DeepSeek TUI 需要 DeepSeek API Key 才能运行。

方式一：环境变量

bash
export DEEPSEEK_API_KEY=sk-...

方式二：配置文件持久化

bash
deepseek auth set --provider deepseek --api-key sk-...

2.4 验证安装 ​

bash
deepseek --version
deepseek doctor

deepseek doctor 会检查 API Key、网络连接、沙箱可用性和 MCP 服务器状态，完整日志输出到 ~/.deepseek/doctor.log。

2.5 更新 ​

bash
deepseek update

如果通过 Homebrew 或 npm 安装，优先使用包管理器更新：

bash
brew upgrade deepseek-tui
# 或
npm update -g deepseek-tui

3. 使用指南 ​

3.1 首次运行 ​

bash
cd path/to/your/project
deepseek

默认进入 Plan 模式（只读）。按 Tab 切换到 Agent 模式（需审批执行），再按一次切换到 YOLO 模式（自动审批）。

3.2 三种工作模式 ​

模式说明适用场景
Plan只读探索模式，不能修改文件代码审查、架构分析、学习理解
Agent交互模式，危险操作需手动确认日常开发、谨慎的代码修改
YOLO自动审批模式，所有操作自动执行有沙箱保护时的批量自动化操作

3.3 内置指令（Slash Commands） ​

指令功能
/model切换模型和推理级别
/restore回滚到会话的某个历史状态
/session管理会话（保存、恢复、列表）
/help显示帮助信息

3.4 工作流示例 ​

bash
# 进入项目目录，启动 DeepSeek TUI
$ cd my-project
$ deepseek

# Plan 模式下询问项目结构
> 分析这个项目的目录结构和主要模块

# 切换到 Agent 模式，执行具体操作
# 按 Tab 切换到 Agent 模式
> 给 src/main.rs 添加错误处理

# YOLO 模式执行批量操作
# 再按 Tab 切换到 YOLO 模式
> 运行 cargo fmt 和 cargo clippy

4. 常见问题 ​

DeepSeek TUI 和 Claude Code 有什么区别？ ​

DeepSeek TUI 是终端原生的 AI 编程代理，基于 DeepSeek V4 模型（而非 Claude），提供 100 万 token 上下文窗口，采用 Rust 编写为单二进制文件。功能定位上类似于 Claude Code，但专为 DeepSeek 模型生态优化。

需要付费吗？ ​

工具本身免费开源（MIT 协议）。使用时需要 DeepSeek API Key，API 调用按 DeepSeek 官方定价计费。

支持哪些操作系统？ ​

支持 Linux（x64/ARM64）、macOS（x64/ARM64）、Windows（x64）。

是否支持中文？ ​

支持。内置简体中文界面，DeepSeek 模型本身也有出色的中文理解能力。

需要 Rust 环境吗？ ​

不需要。可以通过 npm、Homebrew、Scoop 或直接下载二进制文件安装，无需 Rust 工具链。Cargo 安装方式才需要 Rust 1.88+。

最后更新：2026-05-20