DeepSeek-TUI：终端里的 AI 编码 Agent

🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6

项目简介

DeepSeek-TUI 是一个运行在终端里的 AI 编码 Agent，基于 DeepSeek V4 模型。它能读写文件、执行 Shell 命令、搜索网页、管理 Git、协调子 Agent——全程由键盘驱动，无需 GUI。

它不是另一个聊天机器人，而是一个真正能在本地工作区里动手干活的编码助手。

GitHub
https://github.com/Hmbown/DeepSeek-TUI
Stars
23,211 ⭐
Forks
1,858
创建
2026-01-19
语言
Rust
协议
MIT License

它是什么

DeepSeek-TUI 由两个 Rust 二进制组成：

deepseek # 调度器 CLI（入口命令） deepseek-tui # TUI 运行时（终端界面）

安装后直接在终端输入 deepseek 启动交互式 TUI 界面，或者 deepseek "fix this bug" 作为一次性命令运行。

核心功能

🧠
推理流式输出
实时看到 DeepSeek 的推理块（reasoning blocks），了解模型如何思考问题
📚
100 万 Token 上下文
超大上下文窗口，支持上下文压缩、前缀缓存感知成本报告
🔧
全工具套件
文件操作、Shell 执行、Git 管理、网页搜索/浏览、Patch 应用、子 Agent 协调、MCP 服务器
🎛️
Auto 模式
--model auto 自动选择模型和推理级别，简单任务用 Flash，复杂任务用 Pro
💾
会话保存/恢复
长时间运行任务可 checkpoint，随时恢复，还支持会话分叉
🔄
工作区回滚
Side-Git 快照机制，/restore 回滚，不影响仓库 .git
🔍
LSP 诊断
每次编辑后自动注入 rust-analyzer/pyright/tsc/gopls/clangd 诊断到上下文
📋
耐用任务队列
后台任务可存活于重启之间
🌐
HTTP/SSE API
deepseek serve --http 支持无头 Agent 工作流
🤖
MCP 协议
连接 Model Context Protocol 服务器扩展工具链
💰
实时成本追踪
每轮/会话级别的 Token 用量、成本估算、缓存命中率
🌏
本地化 UI
en/ja/zh-Hans/pt-BR 自动检测

Auto 模式

这是 DeepSeek-TUI 最实用的功能之一：--model auto 或 /model auto

在每轮发送前，系统用一个小的 deepseek-v4-flash 路由调用分析当前任务，自动决定：

参数选项
模型deepseek-v4-flash / deepseek-v4-pro
推理级别off / high / max
  • 简单任务 → Flash + 推理 off
  • 编码/调试 → 可能升级到 Pro + high/max
  • 架构/安全审查 → 自动选择更高级配置

上游 API 只收到具体模型和推理设置，永远不会收到 "auto"。TUI 界面显示选定的路由，成本按实际运行的模型计费。

三种运行模式

模式行为适用场景
Plan只读探索，不修改文件理解代码库、分析架构
Agent交互式，每次工具调用需批准日常开发、需要人工把关
YOLO自动批准所有操作批量重构、CI 自动化

配合 Shift + Tab 可切换推理力度：off → high → max

技术架构

deepseek (调度器 CLI) └── deepseek-tui (TUI 运行时) └── ratatui 界面 └── 异步引擎 ├── OpenAI 兼容流式客户端 ├── 工具调用注册表（Shell/文件/Git/Web/子Agent/MCP/RLM） ├── 会话状态管理 + 轮次追踪 ├── 耐用任务队列 └── LSP 子系统

安装方式

方式一：npm（最简单）

npm install -g deepseek-tui

方式二：Cargo（无需 Node）

cargo install deepseek-tui-cli --locked # deepseek 入口 cargo install deepseek-tui --locked # deepseek-tui 运行时

方式三：Scoop（Windows）

scoop update scoop install deepseek-tui

方式四：Homebrew（macOS）

brew tap Hmbown/deepseek-tui brew install deepseek-tui

方式五：Docker

docker run --rm -it -e DEEPSEEK_API_KEY -v "$PWD:/workspace" ghcr.io/hmbown/deepseek-tui:latest

方式六：直接下载

访问 GitHub Releases 下载预编译二进制：Linux x64/ARM64、macOS x64/ARM64、Windows x64

中国大陆用户可加速：

npm install -g deepseek-tui --registry=https://registry.npmmirror.com

快速开始

1. 安装

npm install -g deepseek-tui

2. 配置 API Key

# 交互式配置 deepseek auth set --provider deepseek # 或环境变量 export DEEPSEEK_API_KEY="YOUR_KEY" # 验证配置 deepseek auth status deepseek doctor

3. 运行

# 交互式 TUI deepseek # 一次性命令 deepseek "explain this function" # Auto 模式 deepseek --model auto "fix this bug" # YOLO 自动批准 deepseek --yolo

实战场景

🚀 场景一：修复一个线上 Bug

启动 Agent 模式，让 DeepSeek-TUI 帮你定位和修复：

deepseek --model auto "这个接口返回 500，帮我定位问题并修复"

Agent 会：

  • 读取相关代码文件和日志
  • 运行测试复现问题
  • 定位 bug 根因
  • 提交修复方案，等待你批准

🔍 场景二：理解一个陌生的代码库

使用 Plan 模式只读分析：

deepseek --plan "分析这个项目的架构，画出模块依赖关系"

Agent 会遍历代码库，理解架构，输出分析报告，不会修改任何文件。

⚡ 场景三：批量重构

用 YOLO 模式自动执行大规模重构：

deepseek --yolo "把所有类名从 PascalCase 改为 snake_case"

Agent 会自动搜索、修改、测试验证，不满意可以随时 /restore 回滚。

🧪 场景四：代码审查

拉取 PR 进行预审：

deepseek run pr 42 # 拉取 PR #42 并预填充审查提示

总结

DeepSeek-TUI 把 AI 编码 Agent 带进了终端——不依赖浏览器，不依赖 GUI，纯键盘驱动。

✅ 23,211 Stars — Rust 编写，性能可靠
✅ 终端编码 Agent — 读写文件、执行命令、搜索网页、管理 Git
✅ 推理流式输出 — 实时看到模型的思考过程
✅ 100 万 Token 上下文 — 大型代码库也能处理
✅ Auto 模式 — 自动选择模型和推理级别，省成本
✅ 三种运行模式 — Plan / Agent / YOLO 覆盖不同场景
✅ 工作区回滚 — Side-Git 快照，不满意随时恢复
✅ LSP 诊断 — 编辑后自动注入错误/警告到上下文
✅ 全平台支持 — Linux / macOS / Windows
✅ MIT 开源 — 自由使用

如果你习惯在终端里工作，DeepSeek-TUI 是目前最成熟的终端 AI 编码 Agent。

🚀 GitHub：https://github.com/Hmbown/DeepSeek-TUI

💻 官网：https://deepseek-tui.com

🔗 我的中转站：https://api.aiseo.one/register?channel=c_0qyhisw6
posted @ 2026-05-10 03:46  ciaochao  阅读(136)  评论(0)    收藏  举报