如何接入 DeepSeek-TUI 到终端

DeepSeek-TUI 是一款基于 DeepSeek V4 系列的开源命令行编程智能体，专为开发者设计。它可以读取和编辑文件、执行 Shell 命令、搜索网页、管理 Git，并支持 MCP 服务器扩展，让 AI 能力直接在终端中发挥作用。

前置准备

1. 获取 DeepSeek API Key

1. 访问 platform.deepseek.com 注册账号
2. 进入「API Keys」页面，点击「创建 API Key」
3. 复制生成的
   text

   复制

   1sk-...

   格式密钥

2. 系统要求

二选一安装即可，推荐根据你已有的环境选择。

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/project

2. 启动 TUI 界面

bash
复制
1deepseek

3. 开始交互

在 TUI 界面中，你可以：

• 提问：直接输入问题，如"这个代码库是做什么的？"
• 切换模式：按 Tab 键在 Plan/Agent 模式间切换
• 执行操作：在 Agent 模式下，DeepSeek-TUI 可以帮你读写文件、执行命令

4. 环境诊断

如遇问题，运行诊断命令：

bash
复制
1deepseek doctor

诊断报告会保存到

1~/.deepseek/doctor.log

核心功能与使用模式

三种执行模式

切换方式：在 TUI 界面按 Tab 键

核心工具能力

1read_file

1edit_file

1grep

1apply_patch

1exec_shell

1mcp_*

常用命令

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 工具类型：

1mcp_<server>_<tool>

配置文件结构

DeepSeek-TUI 首次运行会自动创建配置目录

1~/.deepseek/

text
复制
1~/.deepseek/
2├── config.toml      # 主配置文件（API 密钥、模型、钩子）
3├── mcp.json         # MCP 服务器定义
4├── skills/          # 用户技能目录
5├── sessions/        # 检查点和离线队列
6├── tasks/           # 后台任务存储
7└── audit.log        # 凭证/审批/提权审计日志

项目级配置（可选）

在项目根目录创建

1./.deepseek/

bash
复制
1mkdir -p .deepseek
2# 添加项目特定的配置

最佳实践

安全建议

1. 使用 Plan 模式分析代码：在陌生代码库中，先用 Plan 模式了解结构
2. Agent 模式手动确认：重要操作使用 Agent 模式，每次执行前确认
3. 避免 YOLO 模式：除非你完全信任将要执行的操作
4. 定期检查审计日志：查看
   text

   复制

   1~/.deepseek/audit.log

性能优化

1. 使用范围读取：避免一次性读取大文件，减少 Token 消耗
2. 合理设置上下文：根据任务复杂度选择合适的模型
3. 批量操作：多个相似操作可以一次请求完成

故障排查

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 ./"

自定义技能

在

1~/.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 都能成为你终端中的得力助手。立即安装，体验「住在终端里的编程智能体」吧！