DeepSeek-TUI:终端里的 AI 编程助手,9.1k Star 的开源 DeepSeek 桌面客户端

DeepSeek-TUI 是一款运行在终端的 DeepSeek AI 编程代理工具,支持代码生成、调试、重构,即装即用免费调用 DeepSeek API,轻量高效程序员必备。

DeepSeek-TUI 是什么?

DeepSeek TUI 是一个完全运行在终端里的编程智能体。它让 DeepSeek 前沿模型直接访问你的工作区:读写文件、运行 shell 命令、搜索浏览网页、管理 git、调度子智能体——全部通过快速、键盘驱动的 TUI 完成。

它面向 DeepSeek V4(deepseek-v4-pro / deepseek-v4-flash)构建,原生支持 100 万 token 上下文窗口和思考模式流式输出。

DeepSeek-TUI:终端里的 AI 编程助手,9.1k Star 的开源 DeepSeek 桌面客户端

主要功能

  • 原生 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 即可。

DeepSeek-TUI:终端里的 AI 编程助手,9.1k Star 的开源 DeepSeek 桌面客户端

国内用户可配合 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/skillsskills.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

(0)
抢不到GLM Coding Plan?OpenCode Go订阅教程,低成本接入Claude Code与开源模型
上一篇 2026-04-28 15:02
Windows 上安装 Claude Code + 接入阿里云百炼国产大模型免费使用
下一篇 2026-05-08 16:26

相关推荐

发表回复

登录后才能评论
扫码了解
扫码了解
反馈建议
分享本页
返回顶部