01 · 安装

安装 Install

cargo install deepseek-tui-cli --locked

deepseek

编译并安装 deepseek 到 ~/.cargo/bin。需要 Rust 1.88+——如未安装可访问 rustup.rs。下方「其他安装方式」列出了不用 Rust 工具链、国内镜像、Homebrew、预编译二进制等替代选项。

02 · 验证

deepseek --version
deepseek doctor

deepseek doctor 检查 API 密钥、网络、沙箱可用性、 MCP 服务器，并将完整报告写入 ~/.deepseek/doctor.log。

03 · 更新

deepseek update

检查 GitHub Releases 是否有新版本并就地替换二进制。通过 Homebrew 或 npm 安装的话，使用包管理器升级更稳：brew upgrade deepseek-tui 或 npm update -g deepseek-tui。 Cargo 安装的可以重跑 cargo install deepseek-tui-cli --locked --force。

04 · 首次运行

① 获取 API 密钥
在 platform.deepseek.com 注册并创建密钥，格式为 sk-...。

② 设置密钥

export DEEPSEEK_API_KEY=sk-...

或保存到 ~/.deepseek/config.toml：

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

③ 在项目目录中运行
```
cd path/to/project
deepseek
```
默认 Plan 模式（只读调查）。按 Tab 切换到 Agent 模式（执行工具，按需审批）。再按一次进入 YOLO 模式（自动批准）。

05 · 其他安装方式

其他安装方式

如果上面的 Cargo 路径不适合你，从下面找到匹配你情况的一条。每条都安装同一个 deepseek 二进制。

没有 Rust 工具链

npm install -g deepseek-tui

npm 包装器会从 GitHub Releases 下载对应平台的预编译二进制。需要 Node 18+。安装后会同时提供 deepseek 和 deepseek-tui 两个命令。

中国大陆网络

Cargo 经清华 Tuna 镜像——添加到 ~/.cargo/config.toml：

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

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

cargo install deepseek-tui-cli --locked

npm 经 npmmirror 镜像：

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

npm 包装器仍会从 github.com/Hmbown/deepseek-tui/releases 下载二进制，国内可能较慢。Cargo + Tuna 完全绕开 GitHub。 DeepSeek API（api.deepseek.com）在国内直连，无需代理。

Homebrew · macOS / Linux

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

预编译二进制 · 已自动检测

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/

校验 SHA256

curl -fsSL -O https://github.com/Hmbown/deepseek-tui/releases/latest/download/deepseek-artifacts-sha256.txt
shasum -a 256 -c deepseek-artifacts-sha256.txt --ignore-missing

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

支持 multi-arch buildx。目前没有发布到镜像仓库，需要本地构建。

从源码编译

git clone https://github.com/Hmbown/deepseek-tui
cd deepseek-tui
cargo build --release --locked

# Install both binaries from the local checkout
cargo install --path crates/cli --locked   # deepseek
cargo install --path crates/tui --locked   # deepseek-tui

适合本地修改 workspace 或贡献补丁。

06 · 配置文件位置

配置文件位置

~/.deepseek/
├── config.toml      API 密钥、模型、钩子、配置集
├── mcp.on         MCP 服务器定义
├── skills/          用户技能（每个含 SKILL.md）
├── sessions/        检查点 + 离线队列
├── tasks/           后台任务存储
└── audit.log        凭证 / 审批 / 提权审计日志

./.deepseek/         项目级配置（可选，每个仓库）

所有用户配置存放在 ~/.deepseek/。仓库根目录下的 .deepseek/ 用于项目级覆盖。完整字段参考文档。