DeepSeek TUI
面向 DeepSeek V4 的终端原生编程智能体：100 万 token 上下文、思考模式流式推理、前缀缓存感知。自包含 Rust 二进制发布——开箱即带 MCP 客户端、沙箱和持久化任务队列。
安装
deepseek 是自包含 Rust 二进制——运行时不依赖 Node.js 或 Python。
下面几种方式装出来的是同一套二进制，按你已有的工具链选一个即可：
# 1. npm —— 已装 Node 的最方便方式。npm 包只是一个下载器，
# 会从 GitHub Releases 拉取对应平台的预编译二进制，
# 并不会让 deepseek 本身依赖 Node 运行时。
npm install -g deepseek-tui
# 2. Cargo —— 无需 Node。
cargo install deepseek-tui-cli --locked # `deepseek` 入口
cargo install deepseek-tui --locked # `deepseek-tui` TUI 二进制
# 3. Homebrew —— macOS 包管理器。
brew tap Hmbown/deepseek-tui
brew install deepseek-tui
# 4. 直接下载 —— 无需任何工具链。
# https://github.com/Hmbown/DeepSeek-TUI/releases
# 覆盖 Linux x64/ARM64、macOS x64/ARM64、Windows x64
中国大陆访问较慢时，npm 可加
--registry=https://registry.npmmirror.com， 或使用下方的 Cargo 镜像。
这是什么？
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 安装的组合式指令包，无需后端服务
架构说明
deepseek（调度器 CLI）→ deepseek-tui（伴随二进制）→ ratatui 界面 ↔ 异步引擎 ↔ OpenAI 兼容流式客户端。工具调用通过类型化注册表（shell、文件操作、git、web、子智能体、MCP、RLM）路由，结果流式返回对话记录。引擎管理会话状态、轮次追踪、持久化任务队列和 LSP 子系统——它在下一步推理前将编辑后诊断反馈到模型上下文中。
快速开始
npm install -g deepseek-tui
deepseek --version
deepseek
预构建二进制覆盖 Linux x64、Linux ARM64（v0.8.8 起）、macOS x64、macOS ARM64 和 Windows x64。其他目标平台（musl、riscv64、FreeBSD 等）请见下方的从源码安装或 docs/INSTALL.md。
首次启动时会提示输入 DeepSeek API key。密钥保存到 ~/.deepseek/config.toml，在任意目录、IDE 终端和脚本中都能使用，不会触发系统密钥环弹窗。
也可以提前配置：
deepseek auth set --provider deepseek # 保存到 ~/.deepseek/config.toml
export DEEPSEEK_API_KEY="YOUR_KEY" # 环境变量方式；需要在非交互式 shell 中使用请放入 ~/.zshenv
deepseek
deepseek doctor # 验证安装
轮换或移除密钥：
deepseek auth clear --provider deepseek。
Linux ARM64（HarmonyOS 轻薄本、openEuler、Kylin、树莓派、Graviton 等）
从 v0.8.8 起，npm i -g deepseek-tui 直接支持 glibc 系的 ARM64 Linux。你也可以从 Releases 页面 下载预编译二进制，放到 PATH 目录中。
中国大陆 / 镜像友好安装
如果在中国大陆访问 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 资产。
Windows (Scoop)
Scoop 是一个 Windows 软件包管理器。安装好 Scoop 后，运行：
scoop install deepseek-tui
从源码安装
适用于任何 Tier-1 Rust 目标，包括 musl、riscv64、FreeBSD 以及尚无预编译包的 ARM64 发行版。 ```bash # Linux 构建依赖（Debian/Ubuntu/RHEL）： # sudo apt-get install -y build-essential pkg-config libdbus-1-dev # sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel git clone https://github.com/Hmbown/DeepSeek-TUI.git cd DeepSeek-TUI cargo install --path crates/cli --locked # 需要 Rust 1.88+；提供 `deepseek` cargo install --path crates/tui --locked # 提供 `deepseek-tui` ``` 两个二进制都需要安装。交叉编译和平台特定说明见 [docs/INSTALL.md](docs/INSTALL.md)。其他模型提供方
# 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
v0.8.13 新功能
稳定性发布：聚焦 DeepSeek V4 运行时可靠性、工具调用恢复和 TUI 状态准确性。完整更新日志。
- 无需 LLM 的压缩预剪枝 —— 付费摘要前先机械压缩旧的大型工具结果；重复读取只保留最新完整内容
- 重复工具调用防循环 —— 同一轮内第三次完全相同的
(tool, args)会变成纠正性工具结果，而不是继续卡住重试 - V4 缓存命中率状态栏 —— 状态栏现在识别
usage.prompt_tokens_details.cached_tokens - 工具调用恢复 —— 无效 JSON 参数、幻觉工具名和严格 schema 问题会在分发前修复或清理
- 区分大小写的模型 ID —— 第三方 provider 的模型名保留用户输入大小写，同时继续规范化紧凑 DeepSeek 别名
- 忙碌状态修复 —— 如果 turn 开始前分发失败，会清除
working...，避免后续输入一直进入 pending - 不会弹出 Keychain 的 doctor 密钥检查 —— 诊断流程不再读取 OS keyring
- macOS Terminal 颜色兼容 ——
xterm-256color会使用 256 色索引，避免鲸蓝主题被渲染成绿色/青色块
使用方式
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。
模式
| 模式 | 行为 |
|---|---|
| Plan 🔍 | 只读调查；模型先探索并提出计划（update_plan + checklist_write），然后再做更改 |
| Agent 🤖 | 默认交互模式；多步工具调用带审批门禁 |
| YOLO ⚡ | 在可信工作区自动批准工具；仍会维护计划和清单以保持可见性 |
配置
用户配置：~/.deepseek/config.toml。项目覆盖：<workspace>/.deepseek/config.toml（以下密钥被拒绝：api_key、base_url、provider、mcp_config_path）。完整选项见 config.example.toml。
常用环境变量：
| 变量 | 用途 |
|---|---|
DEEPSEEK_API_KEY |
DeepSeek API key |
DEEPSEEK_BASE_URL |
API base URL |
DEEPSEEK_MODEL |
默认模型 |
DEEPSEEK_PROVIDER |
deepseek（默认）、nvidia-nim、fireworks、sglang |
DEEPSEEK_PROFILE |
配置 profile 名称 |
DEEPSEEK_MEMORY |
设为 on 启用用户记忆 |
NVIDIA_API_KEY / FIREWORKS_API_KEY / SGLANG_API_KEY |
提供商认证 |
SGLANG_BASE_URL |
自托管 SGLang 端点 |
NO_ANIMATIONS=1 |
启动时强制无障碍模式 |
SSL_CERT_FILE |
企业代理的自定义 CA 包 |
UI 语言与模型输出语言相互独立——在 config.toml 中设置 locale、使用 /config locale zh-Hans、或依赖 LC_ALL/LANG。详见 docs/LOCALIZATION.md 和 docs/CONFIGURATION.md。
切换为中文界面
如果界面是其他语言，可以在 TUI 内一键切换为简体中文：
- 在 Composer 里输入
/config，按 Tab 或 Enter 打开配置面板。 - 选择 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
模型和价格
| 模型 | 上下文 | 输入（缓存命中） | 输入（缓存未命中） | 输出 |
|---|---|---|---|---|
deepseek-v4-pro |
1M | $0.003625 / 1M* | $0.435 / 1M* | $0.87 / 1M* |
deepseek-v4-flash |
1M | $0.0028 / 1M | $0.14 / 1M | $0.28 / 1M |
旧别名 deepseek-chat / deepseek-reasoner 映射到 deepseek-v4-flash。NVIDIA NIM 变体使用你的 NVIDIA 账号条款。
DeepSeek Pro 价格是限时 75% 折扣，有效期到 2026-05-31 15:59 UTC；该时间之后 TUI 成本估算会回退到 Pro 基础价格。
创建和安装技能
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 <name>（激活）、/skill new（创建）、/skill install github:<owner>/<repo>（社区）、/skill update / uninstall / trust。社区技能直接从 GitHub 安装，无需后端服务。已安装技能在模型可见的会话上下文里列出；当任务匹配技能描述时，智能体可通过 load_skill 工具自动读取对应的 SKILL.md。
文档
| 文档 | 主题 |
|---|---|
| ARCHITECTURE.md | 代码库内部结构 |
| CONFIGURATION.md | 完整配置参考 |
| MODES.md | Plan / Agent / YOLO 模式 |
| MCP.md | Model Context Protocol 集成 |
| RUNTIME_API.md | HTTP/SSE API 服务 |
| INSTALL.md | 各平台安装指南 |
| MEMORY.md | 用户记忆功能指南 |
| SUBAGENTS.md | 子智能体角色分类与生命周期 |
| KEYBINDINGS.md | 完整快捷键目录 |
| RELEASE_RUNBOOK.md | 发布流程 |
| LOCALIZATION.md | UI 语言矩阵与切换 |
| OPERATIONS_RUNBOOK.md | 运维和恢复 |
完整更新历史：CHANGELOG.md。
致谢
本项目由不断壮大的贡献者社区共同打造：
- merchloubna70-dot — 28 个 PR，涵盖功能、修复和 VS Code 扩展基础架构 (#645–#681)
- WyxBUPT-22 — Markdown 表格、粗体/斜体和水平线渲染 (#579)
- loongmiaow-pixel — Windows + 中国安装文档 (#578)
- 20bytes — 用户记忆文档和帮助优化 (#569)
- staryxchen — glibc 兼容性预检 (#556)
- Vishnu1837 — glibc 兼容性改进 (#565)
- shentoumengxin — Shell
cwd边界验证 (#524) - toi500 — Windows 粘贴修复报告
- xsstomy — 终端启动重绘报告
- melody0709 — 斜杠前缀回车激活报告
- lloydzhou 和 jeoor — 压缩成本报告
- Agent-Skill-007 — README 清晰化改进 (#685)
- woyxiang — Windows Scoop 安装文档 (#696)
- wangfeng — 价格/折扣信息更新 (#692)
- zichen0116 — CODE_OF_CONDUCT.md (#686)
- dfwqdyl-ui — 模型 ID 大小写兼容性报告 (#729)
- Oliver-ZPLiu —
working...卡死状态 Bug 报告，含详细复现步骤和修复建议 (#738) - Hafeez Pizofreude —
fetch_url的 SSRF 保护和 Star History 图表 - Unic (YuniqueUnic) — 基于 schema 的配置 UI（TUI + web）
- Jason — SSRF 安全加固
贡献
欢迎提交 pull request——请先查看 CONTRIBUTING.md 并留意开放 issue 中的好入门任务。
本项目与 DeepSeek Inc. 无隶属关系。
