DeepSeek-TUI 是什么?
DeepSeek TUI 是一个完全运行在终端里的编程智能体。它让 DeepSeek 前沿模型直接访问你的工作区:读写文件、运行 shell 命令、搜索浏览网页、管理 git、调度子智能体——全部通过快速、键盘驱动的 TUI 完成。
它面向 DeepSeek V4(deepseek-v4-pro / deepseek-v4-flash)构建,原生支持 100 万 token 上下文窗口和思考模式流式输出。

主要功能
- 原生 RLM(rlm_query)—— 利用现有 API 客户端并行调度 1-16 个低成本 deepseek-v4-flash 子任务,用于批量分析和并行推理
- 思考模式流式输出 —— 实时观察模型在解决问题时的思维链展开
- 完整工具集 —— 文件操作、shell 执行、git、网页搜索/浏览、apply-patch、子智能体、MCP 服务器
- 100 万 token 上下文 —— 上下文接近上限时自动智能压缩,支持前缀缓存感知以降低成本
- 三种交互模式 —— Plan(只读探索)、Agent(带审批的默认交互)、YOLO(可信工作区自动批准)
- 推理强度档位 —— 用 Shift+Tab 在 off → high → max 之间切换
- 会话保存和恢复 —— 长任务的断点续作
- 工作区回滚 —— 通过 side-git 记录每轮前后快照,支持 /restore 和 revert_turn,不影响项目自己的 .git
- 持久化任务队列 —— 后台任务在重启后仍然存在,支持计划任务和长时间运行的操作
- HTTP/SSE 运行时 API —— deepseek serve –http 用于无界面智能体流程
- MCP 协议 —— 连接 Model Context Protocol 服务器扩展工具,见 docs/MCP.md
- LSP 诊断 —— 每次编辑后通过 rust-analyzer、pyright、typescript-language-server、gopls、clangd 提供内联错误/警告
- 用户记忆 —— 可选的持久化笔记文件注入系统提示,实现跨会话偏好保持
- 多语言 UI —— 支持 en、ja、zh-Hans、pt-BR,支持自动检测
- 实时成本跟踪 —— 按轮次和会话统计 token 用量与成本估算,含缓存命中/未命中明细
- 技能系统 —— 可通过 GitHub 安装的组合式指令包,无需后端服务
怎么安装使用?
方式一:从源码编译(推荐,需要 Rust 1.85+)
git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI
cargo install --path crates/tui --locked
cargo install --path crates/cli --locked方式二:直接下载预编译二进制
覆盖 Linux x64/ARM64、macOS x64/ARM64、Windows x64,前往 GitHub Releases 页面,下载对应平台的二进制文件,解压后放入 PATH 即可。

国内用户可配合 TUNA、rsproxy、腾讯云 COS 或阿里云 OSS 镜像加速下载:
国内访问较慢时,npm 可加 –registry=https://registry.npmmirror.com, 或使用下方的 Cargo 镜像
export DEEPSEEK_TUI_RELEASE_BASE_URL="https://你的镜像地址"第二步:配置 API Key
首次启动会自动提示你输入 DeepSeek API Key,也可以提前配置:
# 方式一:命令行登录
deepseek login --api-key "YOUR_DEEPSEEK_API_KEY"
# 方式二:环境变量
export DEEPSEEK_API_KEY="YOUR_DEEPSEEK_API_KEY"DeepSeek API Key 可在 platform.deepseek.com 申请,10 美元的额度对普通用户来说可以使用 6~8 周。
第三步:启动与常用命令
deepseek # 交互式 TUI
deepseek "explain this function" # 一次性提示
deepseek --model deepseek-v4-flash "summarize" # 指定模型
deepseek --yolo # 自动批准工具
deepseek auth set --provider deepseek # 保存 API key
deepseek doctor # 检查配置和连接
deepseek doctor --json # 机器可读诊断
deepseek setup --status # 只读安装状态
deepseek setup --tools --plugins # 创建本地工具和插件目录
deepseek models # 列出可用 API 模型
deepseek sessions # 列出已保存会话
deepseek resume --last # 恢复最近会话
deepseek resume <SESSION_ID> # 按 UUID 恢复指定会话
deepseek fork <SESSION_ID> # 在指定轮次分叉会话
deepseek serve --http # HTTP/SSE API 服务
deepseek pr <N> # 获取 PR 并预填审查提示
deepseek mcp list # 列出已配置 MCP 服务器
deepseek mcp validate # 校验 MCP 配置和连接
deepseek mcp-server # 启动 dispatcher MCP stdio 服务器第四步:进阶使用技巧(常用快捷键)
| 按键 | 功能 |
|---|---|
| Tab | 补全 / 或 @;运行中则把草稿排队;否则切换模式 |
| Shift+Tab | 切换推理强度:off → high → max |
| F1 | 可搜索帮助面板 |
| Esc | 返回 / 关闭 |
| Ctrl+K | 命令面板 |
| Ctrl+R | 恢复旧会话 |
| Alt+R | 搜索提示历史和恢复草稿 |
| Ctrl+S | 暂存当前草稿(/stash list、/stash pop 恢复) |
| @path | 在输入框中附加文件或目录上下文 |
| ↑(在输入框开头) | 选择附件行进行移除 |
完整快捷键目录:docs/KEYBINDINGS.md。
其他模型提供方
除了 DeepSeek 官方 API,还可以接入 NVIDIA NIM、Fireworks 或自托管的 SGLang 服务:
# NVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
deepseek --provider nvidia-nim
# Fireworks
deepseek auth set --provider fireworks --api-key "YOUR_FIREWORKS_API_KEY"
deepseek --provider fireworks --model deepseek-v4-pro
# 自托管 SGLang
SGLANG_BASE_URL="http://localhost:30000/v1" deepseek --provider sglang --model deepseek-v4-flash
# 自托管 vLLM
VLLM_BASE_URL="http://localhost:8000/v1" deepseek --provider vllm --model deepseek-v4-flash创建和安装技能
DeepSeek TUI 从工作区目录(.agents/skills → skills → .opencode/skills → .claude/skills)和全局 ~/.deepseek/skills 发现技能。每个技能是一个包含 SKILL.md 的目录:
~/.deepseek/skills/my-skill/
└── SKILL.md需要 YAML frontmatter:
---
name: my-skill
description: 当 DeepSeek 需要遵循我的自定义工作流时使用这个技能。
---
# My Skill
这里写给智能体的指令。常用命令:/skills(列出)、/skill (激活)、/skill new(创建)、/skill install github:/(社区)、/skill update / uninstall / trust。社区技能直接从 GitHub 安装,无需后端服务。已安装技能在模型可见的会话上下文里列出;当任务匹配技能描述时,智能体可通过 load_skill 工具自动读取对应的 SKILL.md。
其他说明
中国大陆 / 镜像友好安装
如果在中国大陆访问 GitHub 或 npm 下载较慢,可以通过 Cargo 注册表镜像安装:
# ~/.cargo/config.toml
[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"然后安装两个二进制(调度器在运行时会调用 TUI):
cargo install deepseek-tui-cli --locked # 提供推荐入口 `deepseek`
cargo install deepseek-tui --locked # 提供交互式 TUI 伴随二进制
deepseek --version也可以直接从 GitHub Releases 下载预编译二进制。DEEPSEEK_TUI_RELEASE_BASE_URL 可用于镜像后的 release 资产。
切换为中文界面
如果界面是其他语言,可以在 TUI 内一键切换为简体中文:
1. 在 Composer 里输入 /config,按 Tab 或 Enter 打开配置面板。
2. 选择 Edit locale,在 New: 字段输入 zh-Hans,按 Enter 应用。
可选语言:auto | en | ja | zh-Hans | pt-BR。
也可以在 ~/.deepseek/config.toml 里直接设置 locale = “zh-Hans”,或通过 LC_ALL / LANG 环境变量自动选择:
# ~/.deepseek/config.toml
[tui]
locale = "zh-Hans"或者通过环境变量(中文系统通常已自动生效):
LANG=zh_CN.UTF-8 deepseek run原创文章,作者:howkunet,如若转载,请注明出处:https://www.intoep.com/ai/73264.html















