🐳 DeepSeek TUI 专为 DeepSeek V4 构建的终端原生编程代理：支持 100 万 token 上下文、思维链流式输出和前缀缓存感知。以自包含的 Rust 二进制文件形式发布——包含 MCP 客户端、沙箱和持久化任务队列。简体中文 README

安装

deepseek 以自包含的 Rust 二进制文件形式发布——运行它不需要 Node.js 或 Python 运行时。选择你机器上已有的任意方式；它们都会将相同的二进制文件添加到你的 PATH 中。

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. 直接下载 — 不需要 Node，不需要工具链。

https://github.com/Hmbown/DeepSeek-TUI/releases

预构建支持 Linux x64/ARM64、macOS x64/ARM64、Windows x64。

在中国大陆，可以通过 --registry=https://registry.npmmirror.com 加速 npm 路径，或使用下方的 Cargo 镜像。

它是什么？

DeepSeek TUI 是一个完全运行在终端中的编程代理。它让 DeepSeek 的前沿模型能够直接访问你的工作区——读取和编辑文件、运行 shell 命令、搜索网络、管理 git 以及编排子代理——所有这些都通过一个快速、键盘驱动的 TUI 完成。专为 DeepSeek V4（deepseek-v4-pro / deepseek-v4-flash）构建，支持 100 万 token 上下文窗口和原生思维链（chain-of-thought）流式输出。

主要特性

• 原生 RLM（rlm_query） — 并行派发 1–16 个廉价的 deepseek-v4-flash 子任务，用于批量分析和并行推理，全部基于现有 API 客户端
• 思维链流式输出 — 实时观察模型在处理任务时的思维链展开过程
• 完整工具套件 — 文件操作、shell 执行、git、网络搜索/浏览、应用补丁、子代理、MCP 服务器
• 100 万 token 上下文 — 上下文填满时自动智能压缩；支持前缀缓存感知以降低成本
• 三种模式 — Plan（只读探索）、Agent（交互式需审批）、YOLO（自动审批）
• 推理努力等级 — 通过 Shift + Tab 在 off → high → max 之间循环切换
• 会话保存/恢复 — 检查点保存和恢复长时间运行的会话
• 工作区回滚 — 通过 /restore 和 revert_turn 实现回合前后的 side-git 快照，不影响仓库的 .git
• 持久化任务队列 — 后台任务在重启后仍然存在；适用于定时自动化、长时间运行的审查等场景
• HTTP/SSE 运行时 API — deepseek serve --http 用于无头代理工作流
• MCP 协议 — 连接到 Model Context Protocol 服务器以扩展工具能力；详见 docs/MCP.md
• LSP 诊断 — 每次编辑后通过 rust-analyzer、pyright、typescript-language-server、gopls、clangd 显示内联错误/警告
• 用户记忆 — 可选的持久化笔记文件，注入到系统提示中，用于跨会话偏好设置
• 本地化界面 — 支持 en、ja、zh-Hans、pt-BR，自动检测
• 实时成本追踪 — 每回合和会话级别的 token 使用量和成本估算；缓存命中/未命中明细
• 技能系统 — 可组合、可安装的指令包，来自 GitHub，无需后端服务

架构说明

deepseek（调度 CLI）→ deepseek-tui（配套二进制文件）→ ratatui 界面 ↔ 异步引擎 ↔ 兼容 OpenAI 的流式客户端。工具调用通过类型化注册表（shell、文件操作、git、网络、子代理、MCP、RLM）路由，结果流式返回对话记录。引擎管理会话状态、回合追踪、持久化任务队列以及 LSP 子系统，该子系统在下一次推理步骤之前将编辑后的诊断信息反馈到模型上下文中。详见 docs/ARCHITECTURE.md。

快速开始

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 密钥。密钥会保存到 ~/.deepseek/config.toml，这样你可以在任何目录下使用，无需操作系统凭据提示。你也可以提前设置：

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（Raspberry Pi、Asahi、Graviton、HarmonyOS PC）

从 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 # 提供 deepseek-tui deepseek --version

预构建二进制文件也可以从 GitHub Releases 下载。对于镜像发布资源，请使用 DEEPSEEK_TUI_RELEASE_BASE_URL。

Windows（Scoop）

Scoop 是一个 Windows 包管理器。安装后，运行：

scoop install deepseek-tui

从源码安装

适用于任何 Tier-1 Rust 目标平台——包括 musl、riscv64、FreeBSD 和较旧的 ARM64 发行版。

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 # 需要