前置条件
- 1DeepSeek API Key（在 platform.deepseek.com 获取）
- 2Rust 1.88+ 或 Node.js 18+（二选一）
- 3支持 macOS / Linux / Windows (WSL2)
腾讯智能体开发平台 ADP
新客首月专属价，最高直降 880 元，构建/分发/治理企业级 Agent
如何接入 DeepSeek-TUI 到终端
DeepSeek-TUI 是一款基于 DeepSeek V4 系列的开源命令行编程智能体，专为开发者设计。它可以读取和编辑文件、执行 Shell 命令、搜索网页、管理 Git，并支持 MCP 服务器扩展，让 AI 能力直接在终端中发挥作用。
前置准备
1. 获取 DeepSeek API Key
- 访问 platform.deepseek.com 注册账号
- 进入「API Keys」页面，点击「创建 API Key」
- 复制生成的
sk-...格式密钥
警告
⚠️ 请妥善保管 API Key，不要泄露或提交到公开仓库
2. 系统要求
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| Rust | 1.88+ | 可选，通过 Cargo 安装 |
| Node.js | 18+ | 可选，通过 npm 安装 |
二选一安装即可，推荐根据你已有的环境选择。
3. 支持的系统
- macOS（Apple Silicon 和 Intel）
- Linux
- Windows（推荐 WSL2）
分步安装指南
方式一：npm 安装（推荐，跨平台）
bash
1# 全局安装
2npm install -g deepseek-tui
3
4# 验证安装
5deepseek --version中国大陆用户（使用国内镜像）：
bash
1# 设置 npm 镜像
2npm config set registry https://registry.npmmirror.com
3
4# 重新安装
5npm install -g deepseek-tui方式二：Cargo 安装（macOS / Linux）
bash
1# 安装调度器 CLI
2cargo install deepseek-tui-cli --locked
3
4# 验证安装
5deepseek --version中国大陆用户（配置 Cargo 镜像）：
bash
1# 在 ~/.cargo/config.toml 中添加
2[source.crates-io]
3registry = "https://github.com/rust-lang/crates.io-index"
4replace-with = 'tuna'
5
6[source.tuna]
7registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
8
9# 安装
10cargo install deepseek-tui-cli --locked方式三：预编译二进制（macOS）
bash
1# Apple Silicon (M1/M2/M3)
2curl -fsSL -o deepseek \
3 https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-macos-arm64
4
5# Intel
6curl -fsSL -o deepseek \
7 https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-macos-x64
8
9# 添加执行权限并移动到 PATH
10chmod +x deepseek
11sudo mv deepseek /usr/local/bin/方式四：Docker 运行
bash
1# 克隆仓库
2git clone https://github.com/Hmbown/deepseek-tui
3cd deepseek-tui
4
5# 构建镜像
6docker build -t deepseek-tui .
7
8# 运行容器
9docker run --rm -it \
10 -e DEEPSEEK_API_KEY=$DEEPSEEK_API_KEY \
11 -v ~/.deepseek:/home/deepseek/.deepseek \
12 -v "$PWD:/work" -w /work \
13 deepseek-tui配置 API Key
方法一：环境变量
bash
1# 临时设置（当前终端生效）
2export DEEPSEEK_API_KEY=sk-your-api-key-here
3
4# 持久化（macOS/Linux zsh）
5echo 'export DEEPSEEK_API_KEY=sk-your-api-key-here' >> ~/.zshrc
6source ~/.zshrc方法二：命令行配置
bash
1# 设置 DeepSeek 为默认提供商
2deepseek auth set --provider deepseek --api-key sk-your-api-key-here高级配置：自定义 API 地址
如使用自建反向代理或私有镜像：
bash
1export DEEPSEEK_BASE_URL=https://your-custom-endpoint.com/v1快速开始
1. 进入项目目录
bash
1cd /path/to/your/project2. 启动 TUI 界面
bash
1deepseek3. 开始交互
在 TUI 界面中，你可以：
- 提问：直接输入问题，如"这个代码库是做什么的？"
- 切换模式：按 Tab 键在 Plan/Agent 模式间切换
- 执行操作：在 Agent 模式下，DeepSeek-TUI 可以帮你读写文件、执行命令
4. 环境诊断
如遇问题，运行诊断命令：
bash
1deepseek doctor诊断报告会保存到 ~/.deepseek/doctor.log
核心功能与使用模式
三种执行模式
| 模式 | 说明 | 安全性 |
|---|---|---|
| Plan 模式 | 只读模式，仅分析和理解代码 | ⭐⭐⭐ 最安全 |
| Agent 模式 | 询问模式，每次操作需确认 | ⭐⭐ 安全 |
| YOLO 模式 | 自动执行，无需审批 | ⚠️ 慎用 |
切换方式：在 TUI 界面按 Tab 键
核心工具能力
| 工具 | 功能 |
|---|---|
read_file | 读取文件内容 |
edit_file | 编辑文件 |
grep | 搜索文件内容 |
apply_patch | 应用补丁 |
exec_shell | 执行 Shell 命令 |
mcp_* | 调用 MCP 服务器工具 |
常用命令
bash
1# MCP 相关操作
2deepseek mcp list # 列出已配置的 MCP 服务器
3deepseek mcp add <name> # 添加 MCP 服务器
4
5# 服务模式
6deepseek serve # 启动服务模式
7
8# 评估功能
9deepseek eval # 运行评估测试
10
11# 认证管理
12deepseek auth list # 列出已保存的凭证
13deepseek auth set # 设置新的凭证场景应用
场景一：代码分析与重构
text
1你：帮我分析这个项目的架构，并找出可以优化的地方
2
3DeepSeek-TUI 会：
41. 读取项目的核心文件
52. 分析代码结构和依赖关系
63. 给出优化建议场景二：批量文件修改
text
1你：将所有 .js 文件中的 var 替换为 const
2
3DeepSeek-TUI 会：
41. 搜索所有 .js 文件
52. 逐一替换 var 为 const
63. 每次修改前确认（Plan 模式）场景三：Git 操作辅助
text
1你：帮我创建一个新分支，修复 #123 问题，提交 PR
2
3DeepSeek-TUI 会：
41. 创建新分支
52. 定位相关代码
63. 进行修复
74. 提交并创建 PR场景四：MCP 工具集成
DeepSeek-TUI 支持调用 MCP 服务器扩展能力：
bash
1# 配置 MCP 服务器
2deepseek mcp add my-server --command "npx" --args "my-mcp-server"支持的 MCP 工具类型：mcp_<server>_<tool> 格式调用
配置文件结构
DeepSeek-TUI 首次运行会自动创建配置目录 ~/.deepseek/，结构如下：
text
1~/.deepseek/
2├── config.toml # 主配置文件（API 密钥、模型、钩子）
3├── mcp.json # MCP 服务器定义
4├── skills/ # 用户技能目录
5├── sessions/ # 检查点和离线队列
6├── tasks/ # 后台任务存储
7└── audit.log # 凭证/审批/提权审计日志项目级配置（可选）
在项目根目录创建 ./.deepseek/ 目录，可以覆盖全局配置：
bash
1mkdir -p .deepseek
2# 添加项目特定的配置最佳实践
安全建议
- 使用 Plan 模式分析代码：在陌生代码库中，先用 Plan 模式了解结构
- Agent 模式手动确认：重要操作使用 Agent 模式，每次执行前确认
- 避免 YOLO 模式：除非你完全信任将要执行的操作
- 定期检查审计日志：查看
~/.deepseek/audit.log
性能优化
- 使用范围读取：避免一次性读取大文件，减少 Token 消耗
- 合理设置上下文：根据任务复杂度选择合适的模型
- 批量操作：多个相似操作可以一次请求完成
故障排查
| 问题 | 解决方案 |
|---|---|
| "API Key 无效" | 检查 DEEPSEEK_API_KEY 环境变量是否正确设置 |
| 网络连接失败 | 配置 HTTP_PROXY / HTTPS_PROXY 环境变量 |
| Windows 运行报错 | 推荐使用 WSL2，而非原生 Windows |
| Token 消耗过大 | 启用范围读取功能，避免加载不必要的上下文 |
bash
1# 网络问题排查
2curl -I https://api.deepseek.com
3
4# 查看详细日志
5cat ~/.deepseek/doctor.log扩展与进阶
MCP 服务器扩展
DeepSeek-TUI 支持通过 MCP（Model Context Protocol）扩展工具能力：
bash
1# 安装 MCP 服务器
2npm install -g @modelcontextprotocol/server-filesystem
3
4# 配置 MCP
5deepseek mcp add filesystem --command "npx" --args "-y @modelcontextprotocol/server-filesystem ./"自定义技能
在 ~/.deepseek/skills/ 目录下创建技能文件：
markdown
1# ~/.deepseek/skills/my-skill/SKILL.md
2
3## 技能描述
4你的自定义技能说明
5
6## 使用方法
7如何使用这个技能官方资源
- 🌐 官网：deepseek-tui.com
- 📖 完整文档：deepseek-tui.com/zh/docs
- 🗺️ 路线图：deepseek-tui.com/zh/roadmap
- 💬 问题反馈：GitHub Issues
- ☕ 支持开发者：buymeacoffee.com/hmbown
总结
DeepSeek-TUI 将强大的 DeepSeek V4 模型能力带入终端，为开发者提供了一个键盘驱动的编程智能体。通过支持文件编辑、Shell 执行、MCP 扩展和多种执行模式，它既能保证安全性，又能提升开发效率。
无论是代码分析、重构辅助、Git 操作还是自动化任务，DeepSeek-TUI 都能成为你终端中的得力助手。立即安装，体验「住在终端里的编程智能体」吧！
常见问题
QDeepSeek-TUI 和 DeepSeek-V4-Plus 有什么区别？
DeepSeek-TUI 是终端编程智能体，提供交互式 TUI 界面和沙箱保护；V4-Plus 是网页端模型。TUI 可以直接读写文件、执行命令，V4-Plus 主要用于对话。
QWindows 原生支持吗？
推荐使用 WSL2，Windows 原生安装可能遇到兼容性问题。
Q如何切换不同的模型提供商？
使用命令 deepseek auth set --provider <provider> 切换，DeepSeek-TUI 内置支持 9 个提供商。