DeepSeek-TUI 是一款终端原生的开源 AI 编程智能体,由独立开发者 Hunter Bown(GitHub 账号 Hmbown)使用 Rust 语言编写,于 2026 年 1 月在 GitHub 发布,采用 MIT 开源协议。与只能在网页对话框里回答问题的传统 AI 不同,DeepSeek-TUI 是一款"终端里的行动型智能体"——它完全运行在终端中,拥有本地系统操作权限,能够读写文件、执行 Shell 命令、搜索网页、管理 Git 仓库、调度子智能体,并通过键盘驱动的高效 TUI(Terminal UI)界面完成全部操作,无需打开浏览器或切换 IDE。DeepSeek-TUI 专为 DeepSeek V4 系列模型(deepseek-v4-pro / deepseek-v4-flash)量身打造,原生支持 100 万 Token 超长上下文窗口和思考模式流式输出,采用双 Rust 二进制文件(deepseek 调度器 + deepseek-tui 运行时)分发,不依赖 Node.js 或 Python 运行时,下载即可使用。项目在 2026 年 5 月迅速登上 GitHub Trending 榜单,被开发者称为"DeepSeek 版 Claude Code",截至 2026 年 5 月已在 GitHub 累计获得超过 3.3 万 Star。
DeepSeek-TUI 的核心功能围绕"让 AI 在终端里真正动手写代码"展开,覆盖从代码编写到项目管理的完整开发链路:
支持直接读写工作区文件,应用补丁(apply-patch),并通过 FIM(Fill-in-the-Middle)编辑工具调用 DeepSeek /beta fill-in-the-middle 端点实现精准代码修改,无需手动复制粘贴。
在终端内直接运行 Shell 命令,执行编译、测试、部署等操作,所有输出实时回传至 TUI 界面,无需切换窗口。
内置 Git 操作支持,可执行提交、分支管理、差异查看等常用 Git 命令,AI 可自动生成 commit message 并完成提交。
内置网络搜索和页面浏览能力,AI 可自主搜索技术文档、查错找解、收集参考资料,并可将搜索结果直接用于代码编写。
5. 子智能体调度(RLM)
支持通过 rlm_query 工具并行调度 1–16 个 deepseek-v4-flash 子智能体,用于批量分析和并行推理任务,大幅提升复杂任务的执行效率。
原生集成 Model Context Protocol(MCP)客户端,可连接外部 MCP 服务器扩展工具链,兼容日益增长的 MCP 生态。
实时展示 DeepSeek V4 的推理链(Chain-of-Thought),模型如何分析问题、走了哪条路径、中途是否调整思路,全部在终端中流式可见,调试体验大幅提升。
每次文件编辑后自动触发 LSP 诊断,支持 rust-analyzer、pyright、typescript-language-server、gopls、clangd 等主流语言服务器,在终端内即可获得 IDE 级别的实时错误和警告提示。
按轮次和会话统计 Token 用量、缓存命中/未命中比例及费用估算,开发者可以实时掌握调用成本,避免意外账单。
DeepSeek-TUI 设计了三种递进式交互模式,通过 Tab 键循环切换,覆盖从安全分析到完全自动化的全场景开发需求:
Plan 模式是"只读探索"模式。在此模式下,DeepSeek-TUI 可以读取和分析文件、浏览代码库结构、执行 Shell 命令进行查询,但拒绝任何文件写入操作,Shell 执行的高风险命令也需要逐次审批。
适用场景:初次接触一个陌生代码库时,先用 Plan 模式让 AI 分析架构、理解模块依赖关系、识别潜在问题,确认无误后再进入下一步。
Agent 模式是标准开发模式。AI 可以读写文件、执行 Shell 命令、调用工具,但每次工具调用都需要用户逐次审批确认。这是安全性与开发效率的平衡点,适合大多数日常开发场景。
适用场景:功能开发、Bug 修复、代码重构等需要 AI 动手操作,但希望关键环节由人工把关的场景。
YOLO(You Only Live Once)模式是"全自动"模式。所有工具调用自动批准,AI 可以连续执行多轮文件修改、Shell 命令和 Git 操作,无需人工干预。
适用场景:批量重构、重复性脚本执行、CI 自动化等确定性较高的任务。使用前建议确认当前工作区已纳入 Git 版本管理,以便在出现意外结果时快速回滚。
推理强度配合切换
三种模式之外,还可以通过 Shift+Tab 切换推理强度档位:off(关闭推理,速度最快)→ high(高强度推理)→ max(最高推理强度,精度最高但速度最慢)。简单任务用 off,复杂调试用 high 或 max,配合模式切换灵活控制 AI 的行为边界。
推荐的使用顺序是:先用 Plan 模式分析代码结构和影响范围 → 切换到 Agent 模式逐次执行并审批 → 确认安全后用 YOLO 模式批量推进剩余确定性任务。
DeepSeek-TUI 的会话管理能力远超一般终端 AI 工具,专门设计了多层级的状态保存与恢复机制,解决长任务中断、误操作回滚等实际开发痛点:
随时可以通过命令保存当前会话的完整状态(对话历史、工作区上下文、工具调用记录),下次启动 DeepSeek-TUI 时通过 Ctrl+R 快速恢复,继续上次的未完成工作,真正实现"断点续作"。
在任务执行的关键节点手动或自动创建检查点,记录当前工作区的完整状态。如果后续操作出现问题,可以一键回滚到最近的检查点,而不必撤销所有操作。
这是 DeepSeek-TUI 最具特色的功能之一。它通过独立的 side-git 机制,在每一轮 AI 操作前后分别记录工作区快照(pre-turn snapshot / post-turn snapshot),支持 /restore 命令精确回滚到任意一轮操作前的状态。
关键优势在于:side-git 快照与你的项目主仓库 .git 完全独立,AI 的实验性修改不会污染你的 Git 提交历史,回滚操作也不会影响已提交的代码。
通过 Ctrl+S 可以暂存当前提示词和上下文状态,类似 IDE 的"未保存草稿"功能。支持 /stash list 查看暂存列表、/stash pop 恢复最近暂存、/stash clear 清空暂存区,方便在多任务之间灵活切换。
后台任务(如长时间运行的测试、批量文件处理)的状态会被持久化到本地队列中,即使 DeepSeek-TUI 进程退出或系统重启,任务队列也不会丢失,重新启动后可继续执行或查看结果。
基于保存的会话状态,可以创建分支副本,在两个不同方向上并行尝试解决方案,而不必担心互相干扰。这对于 A/B 测试不同修复方案尤其有用。
支持。DeepSeek-TUI 内置了与 OpenClaw、Claude Code 兼容的 Skills(技能包)系统,用户可以通过社区共享的可复用指令包扩展 AI 的能力边界。
DeepSeek-TUI 按以下优先级路径自动发现已安装的 Skills:
优先级 | 路径 | 说明 |
|---|---|---|
1 | .agents/skills/ | 项目级技能,跟随项目仓库 |
2 | skills/ | 当前工作区级技能 |
3 | ~/.deepseek/skills/ | 用户全局技能,跨项目共享 |
每个 Skill 是一个包含 SKILL.md 文件的文件夹,SKILL.md 用自然语言描述"遇到某类任务时应该如何执行",AI 会在运行时自动读取并遵循。
2.如何从 GitHub 安装社区技能
可以通过命令行直接从 GitHub 仓库安装技能:
/skill install github:<owner>/<repo>安装完成后重启 DeepSeek-TUI 即可生效。社区中已有涵盖代码审查、文档生成、测试编写、部署自动化等场景的技能包,且数量在持续增长。
Skills 和 MCP(Model Context Protocol)是两套互补的扩展机制:Skills 提供"执行方法论"(如何完成任务),MCP 提供"工具能力"(可以调用哪些外部工具)。两者可以同时使用,例如一个 Skill 可以指导 AI 通过 MCP 连接的数据库工具完成数据查询任务。
4.与同类工具的技能系统对比
DeepSeek-TUI 的 Skills 系统与 OpenClaw 的 Skills 生态基本兼容,社区技能可以跨工具复用。相较于 Hermes Agent 的"自动进化生成技能",DeepSeek-TUI 目前的技能系统以手动安装社区技能为主,更适合希望快速获得成熟技能能力的用户。
DeepSeek-TUI 以双 Rust 静态链接二进制文件(deepseek 调度器 + deepseek-tui 运行时)的形式分发,不依赖 Node.js 或 Python 运行时,安装过程非常简洁。根据您的系统环境和已有工具链,可以选择以下任一方式:
npm install -g deepseek-tui说明:npm 包本质上是一个下载器,会从 GitHub Releases 拉取对应平台的预编译二进制文件,并不会让 DeepSeek-TUI 本身依赖 Node.js 运行时。
cargo install deepseek-tui-cli --locked # 提供 `deepseek` 入口命令
cargo install deepseek-tui --locked # 提供 `deepseek-tui` TUI 二进制要求:Rust 1.88+。中国大陆用户可配置 Cargo 清华 TUNA 镜像加速:
# ~/.cargo/config.toml
[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"brew tap Hmbown/deepseek-tui
brew install deepseek-tui访问 https://github.com/Hmbown/DeepSeek-TUI/releases 下载对应平台的二进制文件,放入 PATH 目录即可:
平台 | 文件 |
|---|---|
Linux x64 | deepseek-linux-x64 |
Linux ARM64 | deepseek-linux-arm64(v0.8.8+) |
macOS x64 | deepseek-macos-x64 |
macOS ARM64 | deepseek-macos-arm64 |
Windows x64 | deepseek-windows-x64.exe |
docker run --rm -it \
-e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
-v ~/.deepseek:/home/deepseek/.deepseek \
-v "$PWD:/workspace" \
-w /workspace \
ghcr.io/hmbown/deepseek-tui:latest安装后:配置 API Key
安装完成后,需要先配置 DeepSeek API Key 才能使用:
# 方式一:交互式配置(推荐)
deepseek auth set --provider deepseek
# 方式二:环境变量方式
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"
# 验证安装
deepseek --version
deepseek doctorAPI Key 最终保存在 ~/.deepseek/config.toml 中,支持多 profile 管理和随时切换。
中国大陆用户加速提示
使用 npm 安装时,可切换至国内镜像加速下载:
npm config set registry https://registry.npmmirror.com
npm install -g deepseek-tui在云服务器上部署 DeepSeek-TUI 可以实现 7×24 小时持续可用,尤其适合需要长时间运行的任务(如自动代码审查、定时构建、批量处理等场景)。推荐部署步骤如下:
建议配置:1 核 1GB 内存起步(基础功能),2 核 4GB 以上(复杂任务和并行子智能体)。操作系统推荐 Ubuntu 22.04 或 Debian 12,存储空间建议至少 20GB 可用空间。
腾讯云轻量应用服务器(Lighthouse)提供开箱即用的 Linux 镜像( https://cloud.tencent.com/act/pro/deepseek-tui ) ,用户创建服务器实例时选择 Ubuntu 或 Debian 镜像,系统自动完成基础环境配置,SSH 登录即可开始安装 DeepSeek-TUI。
登录服务器后,推荐使用 Cargo 或预编译二进制方式安装(服务器环境通常不定 Node.js):
# 方式一:Cargo 安装
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
cargo install deepseek-tui-cli --locked
cargo install deepseek-tui --locked
# 方式二:直接下载预编译二进制(更快)
wget https://github.com/Hmbown/DeepSeek-TUI/releases/latest/download/deepseek-linux-x64
chmod +x deepseek-linux-x64
sudo mv deepseek-linux-x64 /usr/local/bin/deepseekexport DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"
# 建议写入 ~/.bashrc 或 ~/.zshrc 使其持久化
echo 'export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.bashrcDeepSeek-TUI 本身运行在终端中,不需要对外开放端口,但需要注意:
在云服务器上,建议使用 tmux 或 screen 保持 DeepSeek-TUI 会话持久化:
# 安装 tmux
sudo apt install tmux -y
# 创建持久化会话
tmux new -s deepseek
# 在 tmux 会话中启动 DeepSeek-TUI
deepseek
# 按 Ctrl+B 再按 D detach,会话在后台保持运行
# 重新连接:tmux attach -t deepseek自动化部署建议
对于需要频繁创建部署环境的场景,可以使用腾讯云轻量应用服务器的"自定义镜像"功能,将已安装 DeepSeek-TUI 的服务器制作成镜像,后续创建新实例时直接选用该镜像,秒级完成部署。
DeepSeek-TUI 和 OpenClaw 都是 2026 年备受关注的开源 AI 智能体项目,两者在功能覆盖面上有部分重叠(都支持终端操作、文件管理、Shell 执行等),但在设计定位、技术架构和核心体验上存在本质区别:
deepseek 调度器 + deepseek-tui 运行时)协同工作,架构更精简,不依赖 Node.js/Python 运行时。deepseek-v4-pro 和 deepseek-v4-flash,同时也兼容通过 OpenAI 兼容 API 接入其他模型(如 NVIDIA NIM、Fireworks AI、自托管 SGLang 等)。聚焦 DeepSeek 的策略让其在推理质量、上下文利用效率和成本控制上更有针对性。MEMORY.md + 日期日志),通过向量语义搜索和 BM25 混合检索;适用人群建议
DeepSeek-TUI 和 Hermes Agent 都是 2026 年 GitHub 上增速最快的开源 AI 智能体项目,两者都支持终端操作、Skills 扩展、子智能体调度等能力,但设计哲学和核心差异化能力有本质区别:
SKILL.md 技能包为主,用户可以手动编写或从 GitHub 安装技能,Skills 文件静态存在,不会自动变化;SKILL.md 技能文件,并会通过离线批量进化算法(基于 DSPy 框架和 GEPA 核心算法)定期优化已有技能,实现真正意义上的"越用越聪明"。适用场景建议
DeepSeek-TUI 的 Token 消耗优化是一个系统性问题,与其"专为 DeepSeek V4 打造"的设计密切相关。以下是经过社区验证的实用优化方法:
DeepSeek V4 支持前缀缓存机制——当多次 API 调用的请求前缀(系统提示词、工具定义等)相同时,后续调用会直接命中缓存,价格可低至 $0.0036/百万 Token(约为未命中价格的 1/10)。
DeepSeek-TUI 在设计上已原生支持前缀缓存感知:系统提示词和工具定义在会话期间尽量保持不变,最大化缓存命中率。用户在做配置时,应避免每次请求都动态修改系统提示词,以维持较高的缓存命中率。
DeepSeek-TUI 支持 --model auto 或 /model auto 自动模式:在每轮请求发送前,系统用一个轻量的 deepseek-v4-flash 路由调用分析当前任务复杂度,自动决定使用 deepseek-v4-flash(便宜、快速)还是 deepseek-v4-pro(强大、稍贵),以及推理级别(off/high/max)。
实际使用建议:日常简单查询和代码补全使用 deepseek-v4-flash + 推理 off;复杂架构设计和调试任务才切换到 deepseek-v4-pro + 推理 high/max,可显著降低日常使用成本。
DeepSeek-TUI 在会话上下文接近 100 万 Token 上限时会自动触发智能压缩——将较早的对话内容概括为简短摘要,释放 Token 空间。这一功能默认开启,用户也可以通过配置调整触发阈值,避免过早或过晚压缩。
对于只需要分析理解代码、不需要修改文件的场景,使用 Plan 模式(按 Tab 切换),AI 不会执行文件写入操作,工具调用次数显著减少,Token 消耗也随之降低。
浏览器截图、大文件内容、长命令输出等工具返回结果往往会占用大量 Token。DeepSeek-TUI 支持在配置中设置工具输出长度上限,避免超长工具返回结果撑大上下文。
虽然 DeepSeek-TUI 支持会话保存和恢复,但过多的历史检查点和 side-git 快照会占用磁盘空间。定期清理不再需要的检查点文件,保持工作区整洁,也有助于减少上下文加载时的冗余信息。
对于需要稳定调用 DeepSeek API 的用户,腾讯云 Token Plan 提供固定订阅费模式,额度内调用单价显著低于按量计费,且档位越高百万 Token 单价越低。用户可以在腾讯云控制台上为 Token Plan 设置用量告警阈值,当套餐额度消耗达到 80%、90% 时自动发送通知,避免额度用尽后产生按量计费费用。了解更多可访问:https://cloud.tencent.com/act/pro/tokenplan
DeepSeek-TUI 作为终端原生的编程智能体,在以下开发场景中有显著优势:
在终端中直接描述需求,AI 自动编写代码、执行编译、运行测试,全过程无需离开终端。配合三种交互模式使用:Plan 模式先分析现有代码 → Agent 模式逐次审批执行 → YOLO 模式批量完成后缀性工作,开发效率大幅提升。
将报错日志、堆栈信息直接贴给 DeepSeek-TUI,AI 会读取相关源代码文件,分析根因,提出修复方案,并在 Agent/YOLO 模式下直接修改代码。结合 LSP 诊断,修复后可以立即看到是否还有残留编译错误。
接手一个新项目时,使用 Plan 模式让 DeepSeek-TUI 遍历代码库,分析模块依赖关系、理解架构设计,并自动生成或更新 README、API 文档、架构说明等文档文件,大幅降低上手门槛。
DeepSeek-TUI 可以自动生成有意义的 commit message、协助进行 code review(指出潜在 bug、性能问题、安全风险),甚至可以根据 PR 描述自动修改代码以符合审查意见。
在 YOLO 模式下,可以让 DeepSeek-TUI 执行大批量的确定性任务,如:批量修改 API 调用方式、统一代码风格、生成 CRUD 样板代码等。配合工作区回滚功能,即使重构出错也可以快速恢复。
DeepSeek-TUI 内置网页搜索能力,可以在终端中直接搜索技术文档、开源项目对比、API 使用方法等,并基于搜索结果生成学习笔记或示例代码,适合在学习新技术时作为随身助手。
通过 Shell 执行能力,DeepSeek-TUI 可以帮你编写 GitHub Actions、Jenkins Pipeline、Dockerfile、docker-compose.yml 等 CI/CD 配置文件,并在本地直接测试验证,确认无误后再推送到代码仓库。
对于需要稳定运行 DeepSeek-TUI 的开发团队,可以将其部署在腾讯云轻量应用服务器上,结合腾讯云监控(Cloud Monitor)对运行状态、资源消耗进行实时监控,确保开发辅助服务 7×24 小时稳定在线。
结论:DeepSeek-TUI 本身并非恶意软件,作为开源项目代码完全公开可查,但其强大的系统操作权限如果配置不当,确实存在安全风险。
DeepSeek-TUI 的 GitHub 仓库源码完全公开,采用 MIT 开源协议,不存在"先天后门"。但正因为它被设计为"可以代替用户在终端中执行系统级操作",如果使用者未能正确配置安全策略,就可能因 AI 理解偏差或外部攻击导致意外损失。
风险一:提示词注入(Prompt Injection)攻击
这是目前所有 AI 编程智能体面临的普遍性安全风险。攻击原理是:攻击者构造一段包含隐藏恶意指令的代码注释或文档字符串,当 DeepSeek-TUI 被用户要求"帮我 review 这段代码"或"解释这个文件"时,它会把代码内容(包括隐藏在注释中的恶意指令)一并送给大模型处理,如果模型未能识别这是"注入指令"而非"用户真实意图",就可能执行恶意操作(如将环境变量中的 API Key 发送到攻击者控制的服务器)。
风险二:YOLO 模式下的误操作风险
YOLO 模式会自动批准所有工具调用,如果 AI 对任务的理解出现偏差(在大模型领域并非小概率事件),可能会批量删除文件、错误修改配置、提交错误代码等。虽然 DeepSeek-TUI 提供了工作区回滚(side-git 快照)机制,但预防仍然比事后恢复更重要。
风险三:API Key 和敏感信息泄露
DeepSeek-TUI 的配置文件(~/.deepseek/config.toml)中可能包含 DeepSeek API Key 等敏感信息。如果文件权限配置不当,或在使用时意外将 API Key 粘贴到共享终端或聊天窗口,就会造成敏感数据泄露。此外,项目工作区中的 .env 文件、配置文件等也可能在被 AI 读取后出现在对话上下文中,进而被发送到 DeepSeek API 服务端。
风险四:恶意技能包(供应链攻击)
虽然 DeepSeek-TUI 的 Skills 生态尚在发展中,但从 GitHub 安装社区技能包时,仍存在供应链攻击风险——恶意技能包可能在 SKILL.md 中嵌入隐藏指令,导致 AI 在执行任务时触发非预期行为。
针对上述问题,DeepSeek-TUI 社区及安全研究人员已提出以下安全使用建议:
.env、密钥文件等高度敏感信息;API Key 应通过环境变量或密钥管理服务存储,避免明文写在配置文件里;在腾讯云上部署 DeepSeek-TUI 时,还可以结合腾讯云日志服务(CLS)将工具调用审计日志发送到云端,通过日志告警规则监控异常行为(如短时间内大量文件删除操作),进一步提升安全防护水平。