v0.8.10 现已发布

# 面向 DeepSeek V4
的终端原生编程智能体

100 万 token 上下文。思考模式推理流。单一二进制，零依赖——开箱自带 MCP 客户端、沙箱和持久化任务队列。

bash — zsh
$ npm i -g deepseek-tui
在 GitHub 上查看 赞助支持

## ▸核心功能

### 100 万上下文

为 DeepSeek V4 构建，支持智能压缩和前缀缓存感知成本优化。

### 思考流式输出

实时观察模型思维链展开，在最终答案到达前看到推理过程。

### 原生 RLM

并行调度 1–16 个低成本子任务，用于批量分析和并行推理。

### 完整工具集

文件操作、Shell、Git、网页搜索、补丁应用、子智能体和 MCP 服务器。

### 三种模式

Plan（只读探索）、Agent（交互审批）、YOLO（自动批准），适配任意工作流。

### 持久化会话

保存、恢复、回滚工作区状态，不影响项目自身的 .git 仓库。

## ◎中国大陆镜像安装指南

如果从 GitHub 或 npm 下载较慢，请按以下方式选择最适合你的安装路径：

npm + 淘宝镜像（推荐，最简单）

设置 npm 镜像后全局安装：

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

npm 包在安装时会通过 `postinstall` 从 GitHub Releases 下载对应平台的二进制文件。如果这一步也很慢，可以设置二进制下载镜像地址：

    DEEPSEEK_TUI_RELEASE_BASE_URL=https://your-mirror.example.com \
      npm install -g deepseek-tui

Cargo + 清华 TUNA 镜像

在 `~/.cargo/config.toml` 中添加镜像配置：

    [source.crates-io]
    replace-with = "tuna"

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

然后安装两个二进制文件（调度器在运行时会自动调用 TUI）：

    cargo install deepseek-tui-cli --locked   # 提供入口命令 deepseek
    cargo install deepseek-tui     --locked   # 提供交互式 TUI 二进制
    deepseek --version

从源码构建（Rustup 镜像）

如果还没有安装 Rust，先通过清华镜像安装 rustup：

    export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
    export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

配置 Cargo 镜像后从源码构建：

    git clone https://github.com/Hmbown/CodeWhale.git
    cd CodeWhale
    cargo install --path crates/cli --locked
    cargo install --path crates/tui --locked

手动下载预编译二进制

直接从 GitHub Releases 下载对应平台的二进制文件，放到 `PATH` 目录即可：

    mkdir -p ~/.local/bin
    curl -L -o ~/.local/bin/deepseek \
      https://github.com/Hmbown/CodeWhale/releases/latest/download/deepseek-linux-x64
    curl -L -o ~/.local/bin/deepseek-tui \
      https://github.com/Hmbown/CodeWhale/releases/latest/download/deepseek-tui-linux-x64
    chmod +x ~/.local/bin/deepseek ~/.local/bin/deepseek-tui

macOS 用户将 `linux-x64` 替换为 `macos-arm64` 或 `macos-x64`，并将 `sha256sum` 替换为 `shasum -a 256`。

完整平台安装指南：docs/INSTALL.md · 简体中文 README