DeepSeek TUI

它是什么？

DeepSeek TUI 是一个运行在终端中的编码代理。它可以通过键盘驱动的 TUI 读取和编辑文件、运行 shell 命令、搜索网络、管理 git 以及协调子代理。

它以 DeepSeek V4 ( deepseek-v4-pro/ deepseek-v4-flash) 为核心构建，包括 100 万个令牌的上下文窗口、流式推理块和前缀缓存感知成本报告。

主要特点

• 自动模式—— --model auto//model auto为每一轮选择模型和思维水平
• 思维模式流式传输——在模型运行时，可以看到 DeepSeek 推理模块。
• 全套工具——文件操作、shell 执行、git、网页搜索/浏览、应用补丁、子代理、MCP 服务器
• 1M-token 上下文— 上下文跟踪、手动或配置的压缩以及前缀缓存遥测
• 三种模式——计划（只读浏览）、代理（交互式审批）、YOLO（自动审批）
• 推理努力程度层级——循环off → high → max切换Shift + Tab
• 会话保存/恢复— 检查点和恢复长时间运行的会话
• 工作区回滚——使用 side-git 进行版本控制前的快照和版本控制后的快照，/restore而revert_turn无需触及您的仓库。.git
• 持久化任务队列——后台任务可以在重启后继续运行
• HTTP/SSE 运行时 API —deepseek serve --http用于无头代理工作流
• MCP 协议——连接到模型上下文协议服务器以获取扩展工具；请参阅docs/MCP.md
• 原生 RLM（ ）—使用同一个 API 客户端，rlm_query通过低成本子节点运行批量分析deepseek-v4-flash
• LSP 诊断——每次编辑后通过 rust-analyzer、pyright、typescript-language-server、gopls 和 clangd 等工具显示内联错误/警告。
• 用户内存——可选的持久性笔记文件，注入到系统提示符中，用于跨会话偏好设置。
• 本地化用户界面—— en，，，带自动检测ja功能zh-Hanspt-BR
• 实时成本跟踪——每次回合和会话级别的令牌使用量和成本估算；缓存命中/未命中率细分
• 技能系统——可组合、可安装的GitHub指令包，无需后端服务

它是如何连接的

自动模式

当您希望 DeepSeek TUI 决定一个回合需要多少模型和推理能力时，可以使用deepseek --model auto它。/model auto

自动模式同时控制两个设置：

• 型号：deepseek-v4-flash或deepseek-v4-pro
• 思考：off，，high或max

在发送正式请求之前，应用程序会先进行一次简单的deepseek-v4-flash路由调用，此时不会进行任何思考。该路由会查看最新的请求和上下文，然后为正式请求选择一个具体的模型和思考级别。简短的请求可以保留在 Flash 中，无需思考；而编码、调试、发布工作、架构设计、安全审查或涉及多个步骤的复杂任务则可以升级到专业级或更高级别的思考级别。

auto这是 DeepSeek TUI 的本地设置。上游 API 不会接收到该设置model: "auto"；它接收的是为该回合选择的具体模型和思维设置。TUI 显示所选路线，成本跟踪基于实际运行的模型。如果路由调用失败或返回无效答案，应用程序将回退到本地启发式算法。除非您为子代理指定显式模型，否则它们将继承自动模式。

当您需要可重复的基准测试、严格的成本上限或特定的供应商/模型映射时，请使用固定模型或固定思维水平。

Linux ARM64（树莓派、朝日、Graviton、HarmonyOS PC）

npm i -g deepseek-tui适用于基于glibc的ARM64 Linux系统，版本从v0.8.8开始。您也可以从发布页面下载预编译的二进制文件，并将它们放在您的目录中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   # provides `deepseek`cargo install deepseek-tui     --locked   # provides `deepseek-tui`deepseek --version

用法

deepseek                                         # interactive TUI

deepseek "explain this function"                 # one-shot prompt

deepseek --model deepseek-v4-flash "summarize"   # model override

deepseek --model auto "fix this bug"             # auto-select model + thinking

deepseek --yolo                                  # auto-approve tools

deepseek auth set --provider deepseek            # save API key

deepseek doctor                                  # check setup & connectivity

deepseek doctor --json                           # machine-readable diagnostics

deepseek setup --status                          # read-only setup status

deepseek setup --tools --plugins                 # scaffold tool/plugin dirs

deepseek models                                  # list live API models

deepseek sessions                                # list saved sessions

deepseek resume --last                           # resume the most recent session in this workspace

deepseek resume <SESSION_ID>                     # resume a specific session by UUID

deepseek fork <SESSION_ID>                       # fork a session at a chosen turn

deepseek serve --http                            # HTTP/SSE API server

deepseek serve --acp                             # ACP stdio adapter for Zed/custom agents

deepseek pr <N>                                  # fetch PR and pre-seed review prompt

deepseek mcp list                                # list configured MCP servers

deepseek mcp validate                            # validate MCP config/connectivity

deepseek mcp-server                              # run dispatcher MCP stdio server

deepseek update                                  # check for and apply binary updates

项目地址：https://github.com/Hmbown/DeepSeek-TUI