DeepSeek TUI完整安装配置教程

📖 阅读指南

本教程专为新手设计，每个步骤都有详细说明和可视化辅助

蓝色提示框 = 重要信息，橙色提示框 = 注意事项，绿色提示框 = 成功提示

深色终端框 = 命令行界面模拟，帮助你理解操作结果

建议按顺序阅读，不要跳过任何步骤

💡 适合谁用？

程序员：需要频繁使用命令行的开发者

学生：学习编程，需要 AI 辅助理解代码

技术爱好者：喜欢终端操作，追求效率的用户

新手：想要一个简单的方式开始使用 AI 编程助手

┌─ DeepSeek TUI 工作流程 ─

# 你在终端输入命令

$ deepseek

# DeepSeek TUI 启动

✓ 连接到 DeepSeek API

✓ 加载配置文件

✓ 准备就绪

# 你可以开始对话了！

> 帮我写一个 Python 计算斐波那契数列的函数

# AI 返回结果

当然可以！这是一个简单的实现：

def fibonacci(n):

ifn <= 1:

returnn

returnfibonacci(n-1) + fibonacci(n-2)

# 你可以继续对话或执行其他操作

└────────────────────────

检查项

最低要求

推荐配置

操作系统

Windows 10/11 macOS 10.15+ Linux 任意发行版

最新稳定版系统

Node.js

18.0.0 或更高

20.x LTS 版本

内存

4 GB RAM

8 GB RAM

磁盘空间

500 MB 可用空间

1 GB 可用空间

网络

能访问互联网

稳定的网络连接

1

打开终端

Windows 按 Win+R 输入 cmd；Mac 打开"终端"应用；Linux 按 Ctrl+Alt+T

$ 终端命令

node --version

┌─ 已安装 Node.js ─

$ node --version

v20.10.0

✓ Node.js 已安装，版本符合要求

# 如果版本号 >= v18.0.0，可以直接跳到第三章

└────────────────────────

┌─ 未安装 Node.js ─

$ node --version

✗ 'node' 不是内部或外部命令，也不是可运行的程序

或批处理文件。

! 需要安装 Node.js，请继续阅读下一章

└────────────────────────

⚠️ 版本号解读

v18.0.0 = 版本 18，符合最低要求 ✓

v20.10.0 = 版本 20，推荐版本 ✓✓

v16.20.0 = 版本 16，版本过低需要升级 ✗

显示"不是内部命令" = 未安装，需要安装

📦 什么是 Node.js？

Node.js 是一个让 JavaScript 可以在电脑本地运行的平台

DeepSeek TUI 是用 JavaScript 编写的，所以需要 Node.js 才能运行

安装 Node.js 的同时也会安装 npm（Node Package Manager），用来安装各种工具

这就像是安装游戏需要先安装游戏引擎一样

1

下载安装包

访问 nodejs.org，点击绿色按钮下载 LTS 版本

配置文件

https://nodejs.org

┌─ Node.js 官网下载页面 ─

┌─────────────────────────────────────────┐

││

│Node.js®│

││

│┌─────────────────┐│

││20.10.0 LTS│← 点击这个绿色按钮 │

││(Recommended)││

│└─────────────────┘│

││

│Other Downloads← 或点击这里看更多选项 │

││

└─────────────────────────────────────────┘

# LTS = Long Term Support（长期支持版本）

# 推荐新手使用 LTS 版本，更稳定

└────────────────────────

2

运行安装程序

双击下载的 .msi 文件，按向导提示安装

步骤

操作说明

许可协议

勾选"I accept the terms in the License Agreement"，点击 Next

安装路径

保持默认 C:\Program Files\nodejs\，点击 Next

自定义设置

确保勾选"Add to PATH"，这样可以在任何位置使用 node 命令

完成安装

点击 Install，等待安装完成，点击 Finish

3

验证安装

打开新的终端窗口，输入命令检查版本

$ 终端命令

node --version

npm --version

┌─ 验证成功 ─

$ node --version

v20.10.0

$ npm --version

10.2.3

✓ Node.js 和 npm 都安装成功了！

└────────────────────────

🍎 Mac 用户注意

macOS 有两种安装方式：官方安装包（推荐新手）或 Homebrew（适合有经验的用户）

这里介绍官方安装包方式，最简单直接

1

下载安装包

访问 nodejs.org，下载 macOS 版本的 .pkg 文件

2

运行安装程序

双击 .pkg 文件，按向导提示完成安装

3

验证安装

打开终端，输入命令检查

$ 终端命令

node --version

🐧 Linux 用户注意

不同 Linux 发行版有不同的包管理器，这里以 Ubuntu/Debian 为例

如果你使用其他发行版（如 Fedora、Arch），命令会略有不同

1

使用包管理器安装

打开终端，执行以下命令

$ 终端命令

# 更新软件包列表

sudo apt update

# 安装 Node.js

sudo apt install nodejs npm

# 或者使用 NodeSource 安装最新版本

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

sudo apt install -y nodejs

2

验证安装

输入命令检查版本

$ 终端命令

node --version

📦 什么是 npm？

npm = Node Package Manager（Node 包管理器）

它是 Node.js 的官方包管理工具，用来安装各种 JavaScript 程序和库

-g 参数表示"全局安装"，这样你可以在任何位置使用 deepseek 命令

这就像是应用商店，npm install 就是"下载安装"的意思

1

打开终端

确保终端可以正常使用

2

执行安装命令

输入以下命令并等待安装完成

$ 终端命令

npm install -g deepseek-tui

┌─ 安装过程 ─

$ npm install -g deepseek-tui

added 142 packages in 3s

23 packages are looking for funding

run`npm fund` for details

✓ 安装完成！

└────────────────────────

⚠️ 可能遇到的问题

如果显示权限错误（EACCES），在命令前加 sudo（Mac/Linux）或以管理员身份运行终端（Windows）

如果安装很慢，可以尝试切换 npm 镜像源：npm config set registry https://registry.npmmirror.com

安装时间取决于网络速度，通常需要 1-3 分钟

3

验证安装

输入以下命令检查是否安装成功

$ 终端命令

deepseek --version

┌─ 验证成功 ─

$ deepseek --version

1.0.0

✓ DeepSeek TUI 安装成功！

└────────────────────────

$ 终端命令

npx deepseek-tui

💡 npx vs npm install

npx：临时运行，不占用磁盘空间，每次都要重新下载

npm install -g：永久安装，随时可用，推荐日常使用

如果你是第一次使用，建议用 npx 试用；如果决定长期使用，用 npm install -g 安装

$ 终端命令

# 克隆仓库

git clone https://github.com/deepseek-ai/deepseek-tui.git

# 进入目录

cd deepseek-tui

# 安装依赖

npm install

# 编译

npm run build

# 链接到全局

npm link

🔑 什么是 API Key？

API Key 是一串独特的字符，用来验证你的身份

它就像是你的"用户名+密码"组合，让服务器知道你是谁

每个用户的 API Key 都是唯一的，不要分享给他人

DeepSeek 会赠送一定的免费额度给新用户

1

访问官网

打开浏览器，访问 DeepSeek 开放平台

配置文件

https://platform.deepseek.com

2

注册账号

点击"注册"按钮，按提示完成注册

┌─ 注册流程 ─

┌─────────────────────────────────────────┐

│DeepSeek 开放平台│

││

│┌─────────┐┌─────────┐│

││登录││注册│ ← 点击这里│

│└─────────┘└─────────┘│

││

│注册方式：│

│○ 手机号 + 验证码│

│○ 邮箱 + 密码│

││

│[填写信息] → [获取验证码] → [完成注册]│

││

└─────────────────────────────────────────┘

└────────────────────────

1

登录后进入控制台

登录成功后，点击"API Keys"或"密钥管理"

2

创建新密钥

点击"创建 API Key"按钮

┌─ API Key 管理页面 ─

┌─────────────────────────────────────────┐

│API Keys 管理│

││

│┌─────────────────────────────┐│

││+ 创建 API Key│ ← 点击 │

│└─────────────────────────────┘│

││

│我的 API Keys：│

│┌──────────────────────────────────┐│

││ 名称: my-key-1││

││ 创建时间: 2024-01-15││

││ 状态: 正常││

│└──────────────────────────────────┘│

││

└─────────────────────────────────────────┘

└────────────────────────

3

命名并创建

给密钥起个名字（如"my-laptop"），然后创建

4

复制密钥

创建成功后，立即复制密钥字符串

┌─ API Key 创建成功 ─

┌─────────────────────────────────────────┐

│✓ API Key 创建成功！│

││

│密钥: sk-abc123def456ghi789│

││

│⚠️ 请立即复制并保存！│

│此密钥只显示一次，关闭后将无法再次查看│

││

│[复制][我已保存]│

││

└─────────────────────────────────────────┘

└────────────────────────

⚠️ 重要提醒

API Key 只会在创建时显示一次，请务必立即复制保存

建议保存在密码管理器或安全的文本文件中

如果丢失了，只能删除重新创建，无法找回原密钥

不要把 API Key 分享给他人，也不要上传到公开的代码仓库

1

打开终端

确保可以正常使用命令行

2

执行配置命令

输入以下命令，将 your-api-key 替换为你的实际密钥

$ 终端命令

deepseek auth set --provider deepseek --api-key your-api-key

$ 终端命令

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

┌─ 配置成功 ─

$ deepseek auth set --provider deepseek --api-key sk-abc123

✓ API key configured successfully

✓ Provider: deepseek

# 配置完成！

└────────────────────────

$ 终端命令

deepseek doctor

┌─ 环境诊断 ─

$ deepseek doctor

DeepSeek TUI Diagnostics

========================

✓ Node.js version: v20.10.0

✓ npm version: 10.2.3

✓ DeepSeek TUI version: 1.0.0

✓ API key configured

✓ Connection to DeepSeek API: OK

All checks passed! You are ready to use DeepSeek TUI.

└────────────────────────

💡 doctor 命令的作用

deepseek doctor 会检查你的环境配置

它会验证 Node.js、API Key、网络连接等

如果显示所有检查通过（All checks passed），说明配置正确

如果有错误，会根据错误类型给出解决建议

$ 终端命令

# 查看当前配置

deepseek config list

# 修改默认模型

deepseek config set model deepseek-chat

# 修改超时时间（秒）

deepseek config set timeout 60

1

打开终端

进入你想要工作的目录

2

启动程序

输入 deepseek 命令

$ 终端命令

deepseek

┌─ DeepSeek TUI 启动界面 ─

$ deepseek

╔═══════════════════════════════════════════╗

║║

║🤖 DeepSeek TUI v1.0.0║

║║

║模式: Agent[P]lan[A]gent[Y]OLO║

║模型: deepseek-chat║

║║

╚═══════════════════════════════════════════╝

> 你好！我是 DeepSeek AI。有什么可以帮助你的吗？

Typeyour message and press Enter to chat

PressCtrl+C to exit

> _← 光标在这里，输入你的问题

└────────────────────────

┌─ 第一次对话示例 ─

> 你好，请介绍一下你自己

你好！我是 DeepSeek，一个 AI 助手。我可以帮助你：

• 回答问题和解释概念

• 编写和调试代码

• 分析文件和项目

• 提供建议和创意

有什么我可以帮你的吗？

> 帮我写一个 Python 的 Hello World 程序

当然可以！这是一个简单的 Python Hello World 程序：

```python

print("Hello, World!")

```

你可以这样运行它：

1. 将代码保存为 hello.py

2. 在终端运行: python hello.py

> _

└────────────────────────

操作

按键/命令

说明

发送消息

Enter

输入完成后按回车发送

退出程序

Ctrl + C

退出 DeepSeek TUI

切换模式

P / A / Y

Plan/Agent/YOLO 模式切换

清屏

/clear

清除屏幕上的所有内容

查看帮助

/help

显示所有可用命令

📋 Plan 模式特点

AI 只提供建议，不会实际执行任何操作

适合在动手之前先让 AI 帮你制定计划

完全安全，不会修改你的任何文件

适合新手了解 AI 能做什么

┌─ Plan 模式示例 ─

[模式: Plan]

> 我想创建一个 Python Web 应用，需要哪些步骤？

我来为你规划一个 Python Web 应用的开发步骤：

## 1. 技术选型

-框架: Flask 或 FastAPI

-数据库: SQLite（开发）/ PostgreSQL（生产）

-前端: HTML + CSS + JavaScript

## 2. 项目结构

myapp/

├──app.py

├──templates/

├──static/

└──requirements.txt

## 3. 开发步骤

1.安装依赖: pip install flask

2.创建基础应用

3.添加路由和视图

4.创建模板文件

5.添加样式和脚本

# 注意：这只是建议，不会实际创建任何文件

└────────────────────────

🤖 Agent 模式特点

AI 可以执行操作，但会征求你的同意

每次要修改文件或执行命令前，都会询问"是否继续？"

平衡了便利性和安全性

推荐日常使用

┌─ Agent 模式示例 ─

[模式: Agent]

> 帮我创建一个 hello.py 文件，内容是打印 Hello World

我来帮你创建这个文件。

计划：

1. 创建文件 hello.py

2. 写入内容: print("Hello, World!")

─────────────────────────────────

文件: hello.py

```python

print("Hello, World!")

```

─────────────────────────────────

⚠️ 是否执行此操作？

[Y] 是[N] 否[A] 全部执行[?] 帮助

> Y← 输入 Y 并回车确认

✓ 文件已创建: hello.py

└────────────────────────

⚡ YOLO 模式特点

AI 会直接执行操作，不会询问确认

效率最高，适合重复性任务

⚠️ 有风险，可能意外修改重要文件

建议只在确定安全的情况下使用

┌─ YOLO 模式示例 ─

[模式: YOLO]

> 批量重命名当前目录下所有 .txt 文件，在前面加上 old_

✓ 已重命名: file1.txt → old_file1.txt

✓ 已重命名: file2.txt → old_file2.txt

✓ 已重命名: notes.txt → old_notes.txt

完成！共重命名 3 个文件。

# 注意：操作已直接执行，没有询问确认

└────────────────────────

特性

Plan

Agent

YOLO

执行操作

❌ 不执行

✓ 询问后执行

✓ 直接执行

安全性

⭐⭐⭐⭐⭐

⭐⭐⭐⭐

⭐⭐

效率

⭐⭐

⭐⭐⭐⭐

⭐⭐⭐⭐⭐

适用场景

规划、咨询

日常开发

批量操作

命令

说明

deepseek

启动 DeepSeek TUI

Ctrl + C

退出程序

/quit

退出程序（同 Ctrl+C）

命令

说明

deepseek auth set

设置 API Key

deepseek config list

查看当前配置

deepseek config set

修改配置项

deepseek doctor

诊断环境配置

命令

说明

/help

显示帮助信息

/clear

清屏

/model

切换模型

@文件路径

引用文件内容，如 @README.md

┌─ 错误信息 ─

$ deepseek

✗ 'deepseek' 不是内部或外部命令，也不是可运行的程序

或批处理文件。

# 或者

$ deepseek

zsh: command not found: deepseek

└────────────────────────

🔧 解决方法

1. 确认 DeepSeek TUI 已安装：npm list -g deepseek-tui

2. 检查 npm 全局安装路径是否在系统 PATH 中

3. Windows: 重新打开终端，或重启电脑

4. Mac/Linux: 执行 source ~/.bashrc 或 source ~/.zshrc

5. 如果还不行，尝试使用 npx deepseek-tui 临时运行

┌─ 错误信息 ─

$ deepseek

✗ Error: Invalid API key

Pleasecheck your API key configuration

# 或者

✗ Error: API key not found

Run:deepseek auth set --provider deepseek --api-key YOUR_KEY

└────────────────────────

🔧 解决方法

1. 确认 API Key 已正确配置：deepseek config list

2. 检查 API Key 是否输入正确（不要有多余空格）

3. 重新配置：deepseek auth set --provider deepseek --api-key 你的密钥

4. 确认 API Key 没有过期（在 DeepSeek 控制台查看）

5. 检查网络连接是否能访问 platform.deepseek.com

┌─ 错误信息 ─

✗ Error: Network error

Unableto connect to DeepSeek API

Pleasecheck your internet connection

# 或者

✗ Error: Timeout

Requesttimed out after 30000ms

└────────────────────────

🔧 解决方法

1. 检查网络连接是否正常

2. 尝试访问 https://platform.deepseek.com 确认服务状态

3. 如果是公司网络，可能需要配置代理

4. 增加超时时间：deepseek config set timeout 60000

5. 检查防火墙设置是否阻止了连接

┌─ 错误信息 ─

$ npm install -g deepseek-tui

✗ Error: EACCES: permission denied

access/usr/local/lib/node_modules

# 或者

✗ Error: EPERM: operation not permitted

└────────────────────────

🔧 解决方法

Windows: 以管理员身份运行终端（右键点击终端图标，选择"以管理员身份运行"）

Mac/Linux: 在命令前加 sudo，如 sudo npm install -g deepseek-tui

或者更改 npm 默认目录（推荐）：npm config set prefix ~/.npm-global

然后添加 export PATH=~/.npm-global/bin:$PATH 到 ~/.bashrc

┌─ 错误信息 ─

$ npm install -g deepseek-tui

✗ Error: deepseek-tui requires Node.js >= 18.0.0

Currentversion: v16.20.0

# 或者安装后运行报错

$ deepseek

✗ SyntaxError: Unexpected token

└────────────────────────

🔧 解决方法

1. 检查当前 Node.js 版本：node --version

2. 如果版本低于 18，需要升级 Node.js

3. 访问 nodejs.org 下载最新 LTS 版本并安装

4. 安装后重新打开终端，再次检查版本

5. 如果使用了 nvm，可以运行 nvm install 20 && nvm use 20

$ 终端命令

> 请帮我检查 @main.py 中的代码是否有错误

┌─ 文件引用示例 ─

> 请帮我检查 @main.py 中的代码是否有错误

我来检查 main.py 文件...

✓ 已读取文件: main.py (256 行)

发现以下问题：

1. 第 15 行: 缺少 import 语句

2. 第 42 行: 变量名拼写错误 "usename" → "username"

3. 第 78 行: 建议添加异常处理

需要我帮你修复这些问题吗？

└────────────────────────

$ 终端命令

> 将当前目录下所有 .txt 文件转换为 .md 文件，并在文件名前加上 "note_"

┌─ 批量操作示例 ─

[模式: YOLO]

> 将当前目录下所有 .txt 文件转换为 .md 文件

✓ 已处理: readme.txt → note_readme.md

✓ 已处理: todo.txt → note_todo.md

✓ 已处理: ideas.txt → note_ideas.md

完成！共处理 3 个文件。

└────────────────────────

$ 终端命令

> 根据 git diff 生成一个清晰的提交信息

┌─ Git 配合示例 ─

> 根据 git diff 生成一个清晰的提交信息

我来分析代码变更...

建议的提交信息：

feat(auth): 添加用户登录功能

- 实现 JWT token 验证

- 添加登录/登出接口

- 增加密码加密存储

是否使用这个提交信息？ [Y/n]

└────────────────────────

$ 终端命令

# 设置默认模型

deepseek config set model deepseek-chat

# 设置超时时间（毫秒）

deepseek config set timeout 60000

# 设置默认工作模式

deepseek config set mode agent

# 启用/禁用语法高亮

deepseek config set syntaxHighlight true

🎯 下一步建议

尝试用 DeepSeek TUI 完成一个小任务，比如创建一个新项目或重构一段代码

探索不同的工作模式，找到最适合你的使用方式

查看官方文档了解更多高级功能

加入社区与其他用户交流使用心得