v0.8.25 · MIT · Rust

DeepSeek TUI
终端里的编程智能体

围绕 DeepSeek V4 打造的终端编程助手。流式思考、1M token 上下文、审批门控、Auto 路由,在你的终端里读写文件、执行命令、管理 Git、编排子代理。

⭐ 18K+ GitHub Stars 🚀 37+ Releases 🦀 Rust 双二进制架构 🌐 中/英/日/葡 多语言
🚀 访问 GitHub 📦 查看安装方式
KEY FEATURES

15 项核心能力一览

从 Auto 智能路由到 Durable 持久任务队列,DeepSeek TUI 不是一个简单的 DeepSeek 包装器,而是深度围绕 V4 模型经济学与能力设计的编程代理框架。

🤖

Auto 智能路由

--model auto 会先用 Flash 做一次轻量路由调用,自动为每个 turn 选择 Pro/Flash + thinking off/high/max 的最优组合。

🧠

思考流式输出

实时渲染 V4-Pro 的 reasoning_content,像看模型"边想边写"。支持空文本 reasoning → tool-call 的复杂 turn。

🛠️

完整工具链

文件读写、Shell 执行、Git 管理、Web 搜索(DuckDuckGo + Bing 回退)、apply-patch、sub-agents、MCP、RLM。

📚

1M Token 上下文

内置 prefix-cache 感知的成本统计,缓存命中费用仅为未命中的 1/10;支持手动 /compact 与自动压缩。

🎭

三种运行模式

Plan(只读探索)/ Agent(默认审批)/ YOLO(自动批准)按工作场景快速切换。

推理强度档位

Shift+Tab 在 off → high → max 之间循环切换,为任务量身匹配算力预算。

💾

会话存续

长任务检查点、一键 resume 继续;tool-output 溢出会落盘到 ~/.deepseek/tool_outputs

工作区回滚

基于 side-git 的 turn 前/后快照,/restorerevert_turn 可回退改动,绝不污染你的 .git

📋

持久任务队列

后台任务可在 TUI 重启后继续运行,适合长耗时批处理/分析流。

🌐

HTTP/SSE 服务模式

deepseek serve --http 将 agent 暴露为无头 API,可编排到 CI 或其他系统。

🔌

MCP 协议

接入 Model Context Protocol 服务器扩展工具集,支持 stdio 传输。

🌀

原生 RLM

并发 1–16 个 Flash 子代理做批量分析/并行推理,性价比极高。

🔍

LSP 诊断

每次修改后调用 rust-analyzer、pyright、tsserver、gopls、clangd 获取错误/警告并喂回模型。

💰

实时费用追踪

逐 turn 与会话级别的 token 用量、缓存命中/未命中拆分与费用估算。

📦

Skills 系统

从 GitHub 可组合、可安装的指令包;无需后端服务。.agents/skills.claude/skills、全局目录自动发现。

INSTALLATION

五种安装方式

DeepSeek TUI 发行为 Rust 原生二进制:dispatcher 命令 deepseek 与伴生 TUI 运行时 deepseek-tui。选择任一熟悉的安装路径即可。

# 推荐路径 —— 无需 Rust 工具链,自动下载预编译二进制
npm install -g deepseek-tui

# 国内加速
npm install -g deepseek-tui --registry=https://registry.npmmirror.com

deepseek --version
# 需要 Rust 1.88+,无需 Node
cargo install deepseek-tui-cli --locked   # 提供 deepseek
cargo install deepseek-tui     --locked   # 提供 deepseek-tui
brew tap Hmbown/deepseek-tui
brew install deepseek-tui
scoop update
scoop install deepseek-tui
deepseek --version
docker run --rm -it \
  -e DEEPSEEK_API_KEY \
  -v "$PWD:/workspace" \
  ghcr.io/hmbown/deepseek-tui:latest
git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI
cargo install --path crates/cli --locked
cargo install --path crates/tui --locked
QUICKSTART

零基础 5 分钟上手

按顺序完成这 5 步,即可从"从未听说过"到"在终端里让 DeepSeek 帮你写代码"。

① 安装二进制

任选一种安装方式;推荐 npm(无需额外工具链)。

npm install -g deepseek-tui
deepseek --version   # 应显示 deepseek 0.8.25

② 获取并配置 API Key

platform.deepseek.com 注册账号、创建 API Key(新用户通常有免费额度)。

# 方法 A:交互式保存到 ~/.deepseek/config.toml(推荐)
deepseek auth set --provider deepseek

# 方法 B:环境变量
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"

# 方法 C:Windows PowerShell
$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"

③ 自检环境

确认版本、认证、MCP、Skills、存储目录全部就绪。

deepseek doctor
deepseek auth status

④ 启动 TUI

在你要协作的项目根目录执行。默认进入 Agent 模式,每个文件修改都需审批。

cd your-project
deepseek --model auto       # 让 TUI 自动选模型与思考等级
# 或显式指定
deepseek --model deepseek-v4-pro
deepseek --provider fireworks --model deepseek-v4-pro

⑤ 第一次对话

在输入框写任意需求,如"帮我读一下 README 并总结要点"。模型会先给 Plan,你按 Enter 审批每个工具调用。完成后用 Ctrl+C 两次退出。

THREE MODES

Plan · Agent · YOLO 三种模式

按"你对风险的容忍度"选择运行模式;用 Shift+Tab 的顶部栏指示器快速切换。

PLAN

只读探索

严格只读:可读文件、搜索代码、分析结构、产出方案,但不能执行 Shell、写文件、提交 Git。

  • 适合:陌生仓库勘探
  • 适合:审阅前置调研
  • 适合:希望先看"计划"再决定
AGENT · 默认

审批模式

每一个副作用操作都会弹出批准框,你看到 diff / command 后再决定 yes/no。

  • 适合:所有生产级编码工作
  • 适合:不信任 LLM 自作主张
  • 适合:希望随时可拦截
YOLO

全自动

关闭审批弹框,tool call 直接执行。v0.8.8+ 修复了 git -C 的信任检查。

  • 适合:受信任的 sandbox 工作区
  • 适合:批量迁移/重构
  • 慎用:敏感仓库 / 生产环境
COMMANDS

全部指令参考

左侧为 dispatcher CLI 子命令(在 shell 中运行),右侧为 TUI 内斜杠命令(在 TUI 输入框键入 / 触发)。

🧰 Dispatcher CLI 子命令

命令作用
deepseek启动 TUI(默认当前工作区)
deepseek --model auto启动并启用 Auto 路由
deepseek --model deepseek-v4-pro固定模型启动
deepseek --provider <name>切换供应商:deepseek / nvidia-nim / openrouter / novita / fireworks / sglang / vllm / ollama / openai
deepseek --version打印版本
deepseek doctor完整环境自检(版本、auth、MCP、Skills、存储)
deepseek auth set --provider <name>保存 API Key 到 ~/.deepseek/config.toml
deepseek auth status查看当前凭据来源(config/keyring/env)
deepseek auth clear --provider <name>清除保存的 Key
deepseek update自升级(带 SHA-256 校验)
deepseek serve --http启动 HTTP/SSE 无头运行时
deepseek mcp init生成 MCP 配置模板
deepseek setup --mcp交互向导初始化 MCP
deepseek setup --tools脚手架 ~/.deepseek/tools
deepseek setup --plugins脚手架 ~/.deepseek/plugins
deepseek resume [session-id]恢复上次会话

⌨️ TUI 内斜杠命令

命令作用
/help显示所有斜杠命令
/model切换模型(弹出选择器)
/model auto启用 Auto 路由
/model deepseek-v4-pro / deepseek-v4-flash切换到指定模型
/mode plan / /mode agent / /mode yolo切换三种运行模式
/thinking off|high|max设置思考强度档位
/compact手动压缩上下文,节省 token
/clear清空当前会话
/new开新会话
/resume恢复上一会话
/save [name]显式保存会话检查点
/restore回滚 side-git 快照到上一 turn 前
/diff查看当前未提交的工作区差异
/cost显示 token 用量与费用
/context查看上下文占用与缓存命中率
/mcp管理 MCP 服务器(reload/list)
/mcp reload改动 mcp.json 后热重载
/skills列出/启用/禁用 Skills
/memory编辑跨会话 User Memory
/lang zh-Hans|en|ja|pt-BR切换界面语言
/theme切换主题
/quit退出 TUI
KEYBINDINGS

键盘快捷键

DeepSeek TUI 是纯键盘驱动的。掌握这些快捷键,手可以不离开键盘。

快捷键功能
Enter提交输入 / 批准审批
Shift+Enter输入框换行
Ctrl+Enter强制提交(替代方案)
Esc中断当前 turn / 取消审批
Ctrl+C一次=中断,两次=退出
Ctrl+S把当前草稿存到 composer stash
Tab自动补全 / 切换面板焦点
Shift+Tab切换推理强度档位 off → high → max
/ 历史消息导航
PageUp / PageDown滚动脚本区
Ctrl+L清屏(保留会话)
Ctrl+R搜索历史消息
/进入斜杠命令模式
@快速引用文件 / 符号
ADVANCED

进阶用法

当你已经熟悉基础操作后,这些是真正解锁 DeepSeek TUI 威力的手柄。

🌐

多供应商切换

# NVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "KEY"
deepseek --provider nvidia-nim

# Fireworks
deepseek --provider fireworks --model deepseek-v4-pro

# 自建 vLLM
VLLM_BASE_URL="http://localhost:8000/v1" \
deepseek --provider vllm --model deepseek-v4-flash
🌀

RLM 并发推理

在 TUI 中直接让 agent 使用 rlm_query,它会并发最多 16 个 Flash 子代理完成批量分析。

# 典型指令(自然语言)
用 rlm_query 并发分析 src/ 下
所有 .rs 文件里是否使用了
unsafe,并逐文件汇总
🔌

MCP 服务器接入

# ~/.deepseek/mcp.json
{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@mcp/server-fs"]
    }
  }
}

改完执行 /mcp reload

📦

Skills 发现顺序

TUI 按下列顺序自动发现 skills(截断时优先工作区):

  • ./skills/
  • ./.agents/skills/
  • ./.claude/skills/
  • ~/.agents/skills/
  • ~/.deepseek/skills/
🌐

HTTP/SSE 无头运行

deepseek serve --http --port 8787

# 客户端调用
curl -N http://localhost:8787/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"message":"..."}'
📝

User Memory

持久偏好会注入到系统提示。在 TUI 内 /memory 编辑,或直接改:

# ~/.deepseek/memory.md
- 始终使用繁体中文输出
- 禁止修改 .env 文件
- 代码注释全部英文
TROUBLESHOOTING

常见问题速查

现象解法
MISSING_COMPANION_BINARY两个二进制都必须在 PATH:deepseek + deepseek-tui
国内 npm 慢--registry=https://registry.npmmirror.com
鉴权 401 / 403deepseek auth clearauth set,并检查 env 是否残留
API 连接失败deepseek doctor 查看 base_url,必要时自定义 OPENAI_BASE_URL
CJK 粘贴换行变 Enter(v0.8.24)升级到 v0.8.25+(#1342 已修复)
macOS Seatbelt 阻止 MCP编辑 sandbox_mode 后手动 /mcp reload
token 费用高/cost 查看明细,/compact 压缩,或切 Flash + thinking off