DeepSeek TUI 完全指南：终端里的 AI 编程助手

一、DeepSeek TUI 是什么？

DeepSeek TUI 是一个基于 DeepSeek V4 的开源终端编程智能体。说白了，就是一个让你在命令行里直接调用 AI 帮写代码的工具。

它不是网页，也不是 API，而是一个本地运行的 TUI（终端用户界面）程序。你在项目目录下运行 deepseek，AI 就能读取你的代码、帮你分析、修改、调试。

二、安装方式（按需选择）

方式1：Cargo（推荐，需 Rust 1.88+）

cargo install deepseek-tui-cli --locked

方式2：npm

npm install -g deepseek-tui  # 需 Node 18+

方式3：Homebrew（macOS/Linux）

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

方式4：预编译二进制

支持 macOS Intel/Apple Silicon、Linux x64/arm64、Windows x64

# 以 macOS Apple Silicon 为例
curl -fsSL -o deepseek \
  https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-macos-arm64
chmod +x deepseek
xattr -d com.apple.quarantine deepseek 2>/dev/null || true
sudo mv deepseek /usr/local/bin/

方式5：Docker

git clone https://github.com/Hmbown/deepseek-tui
cd deepseek-tui
docker build -t deepseek-tui .
docker run --rm -it \
  -e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  -v "$(PWD:/work" -w /work \
  deepseek-tui

方式6：从源码编译

git clone https://github.com/Hmbown/deepseek-tui
cd deepseek-tui
cargo build --release --locked
cargo install --path crates/cli --locked      # 安装 deepseek 命令
cargo install --path crates/tui --locked     # 安装 deepseek-tui 命令

中国用户镜像加速

如果 Cargo 下载慢，可以配置清华镜像：

# ~/.cargo/config.toml
[source.crates-io]
replace-with = "tuna"

[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

验证安装

deepseek --version
deepseek doctor

三、快速开始

1. 获取 API Key

去 platform.deepseek.com 注册并创建 API Key，格式为 sk-...

2. 配置认证

方式一：环境变量

export DEEPSEEK_API_KEY=sk-...

方式二：保存到配置文件

deepseek auth set --provider deepseek --api-key sk-...

3. 开始使用

cd path/to/your/project
deepseek

四、三种工作模式

模式	说明	适用场景
Plan	只读模式，可 grep/读文件/列目录	代码审查、需求分析
Agent	默认模式，多步工具调用	日常开发（推荐）
YOLO	全权模式，自动批准所有操作	信任 AI、完全自动化

切换方式： 按 Tab 在三种模式间循环切换

五、核心工具一览

文件操作

• read_file – 读取文件
• list_dir – 列出目录
• write_file – 写入文件
• edit_file – 编辑文件
• apply_patch – 应用补丁

搜索

• grep_files – 文件内 grep
• file_search – 文件搜索
• web_search – 网络搜索
• fetch_url – 抓取 URL

Shell 命令

• exec_shell – 执行 shell 命令
• exec_shell_wait – 执行并等待
• exec_shell_interact – 交互式执行

Git / 诊断 / 测试

• git_status – Git 状态
• git_diff – Git 差异
• diagnostics – 诊断
• run_tests – 运行测试

子 Agent / RLM

• agent_open – 打开 Agent 会话
• agent_eval – 在 Agent 会话中执行
• agent_close – 关闭 Agent 会话
• rlm_* – 递归语言模型相关操作

MCP 扩展

通过 ~/.deepseek/mcp.json 配置 MCP 服务器，可扩展更多工具。

六、审批模式与沙箱安全

approval_mode 设置

模式	说明
suggest	默认 – 按模式规则执行，危险操作前提问
auto	自动批准所有工具调用
never	阻止任何非安全/非只读操作

沙箱机制

DeepSeek TUI 内置沙箱隔离：

• Linux: landlock
• macOS: seatbelt
• Windows: AppContainer / restricted tokens

解除限制

/trust  # 解除当前会话的工作区边界限制

七、配置文件结构

~/.deepseek/
├── config.toml    # API密钥、模型、钩子配置
├── mcp.json      # MCP 服务器定义
├── skills/       # 用户自定义技能（每个含 SKILL.md）
├── sessions/     # 检查点 + 离线队列
├── tasks/        # 后台任务存储
├── audit.log     # 凭证/审批/授权日志
└── .deepseek/    # 项目级配置（可选，每个仓库）

八、完整配置示例

# ~/.deepseek/config.toml
api_key = "sk-..."
base_url = "https://api.deepseek.com"
default_text_model = "deepseek-v4-pro"  # 默认模型
                                      # deepseek-v4-flash 用于快速/子智能体

[ui]
default_mode = "agent"        # plan | agent | yolo
approval_mode = "suggest"     # suggest | auto | never
reasoning_effort = "high"     # off | high | max

[hooks]
enabled = true
default_timeout_secs = 30

[[hooks.hooks]]
event = "session_start"  # tool_call_before | tool_call_after | message_submit | mode_change | on_error | shell_env
command = "~/.deepseek/hooks/pre.sh"

九、支持的 AI 提供商

提供商	ID	环境变量
DeepSeek	deepseek	DEEPSEEK_API_KEY
NVIDIA NIM	nvidia-nim	NVIDIA_API_KEY
OpenAI	openai	OPENAI_API_KEY
OpenRouter	openrouter	OPENROUTER_API_KEY
Novita	novita	NOVITA_API_KEY
Fireworks	fireworks	FIREWORKS_API_KEY
sglang	sglang	SGLANG_API_KEY
vLLM	vllm	VLLM_API_KEY
Ollama	ollama	OLLAMA_API_KEY

切换提供商：deepseek auth set --provider <id>

十、快捷键速查

快捷键	功能
Tab	切换模式 (Plan / Agent / YOLO)
Shift+Tab	切换推理强度
Ctrl+L	清屏，保留会话
Ctrl+C	取消当前轮次
Ctrl+D	退出
/help	斜杠命令面板
/config	交互式编辑配置
/trust	解除当前会话工作区边界

十一、自定义技能（Skills）

可以在 ~/.deepseek/skills/<name>/ 目录下创建自定义技能，每个技能包含 SKILL.md 文件定义其行为和能力。

总结

DeepSeek TUI 是一款为开发者打造的本地终端编程助手，核心优势：

• 🚀 终端内直接使用，无需切换窗口
• 🔧 支持文件操作、Shell、Git、网络搜索等丰富工具
• 🛡️ 三种模式 + 审批机制，兼顾效率与安全
• 🔌 MCP 扩展支持，可对接各种服务
• 📦 开源免费，MIT 协议

GitHub：Hmbown/deepseek-tui

官网：deepseek-tui.com