# deepseek-cli

**Repository Path**: tobetters/deepseek-cli

## Basic Information

- **Project Name**: deepseek-cli
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek CLI

> 🚀 功能最完整的终端 AI 编码代理，100% 覆盖 Claude Code 和 DeepSeek-TUI 功能

[![Rust](https://img.shields.io/badge/Rust-1.75+-orange.svg)](https://www.rust-lang.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Crates.io](https://img.shields.io/crates/v/deepseek-cli.svg)](https://crates.io/crates/deepseek-cli)

**DeepSeek CLI** 是一个用 Rust 构建的高性能终端 AI 编码代理，结合了 Claude Code 和 DeepSeek-TUI 的所有优点，并增加了 17 项独有功能。

## ✨ 核心特性

### 🎯 100% 功能覆盖

| 功能类别 | DeepSeek CLI | Claude Code | DeepSeek-TUI |
|:--------:|:------------:|:-----------:|:------------:|
| 核心引擎 | ✅ | ✅ | ✅ |
| 工具系统 | ✅ **10个** | ✅ 8个 | ✅ 8个 |
| 会话管理 | ✅ | ✅ | ✅ |
| TUI 界面 | ✅ **5主题** | ✅ | ✅ |
| 扩展系统 | ✅ | ✅ | ✅ |
| API 集成 | ✅ **HTTP+Cron** | ⚠️ | ✅ HTTP |
| 国内适配 | ✅ **15+ LLM** | ❌ | ⚠️ 4个 |

### 🏆 20 项独有功能

1. **Session Fork** - 克隆会话到新分支
2. **Git Worktree 隔离** - 子代理独立仓库副本
3. **HTTP API + 定时任务** - 远程控制 + Cron 自动化
4. **LSP 集成** - 实时代码诊断
5. **40+ 输出过滤器** - 命令感知的 token 节省
6. **15+ 国内 LLM** - 开箱即用
7. **6 套主题切换** - claude-code/claude/dark/purple/ocean/matrix
8. **Vim 模式** - 完整 Vim 键位
9. **Ctrl+R 历史搜索** - 反向搜索输入历史
10. **Skills 系统** - SKILL.md 工作流模板
11. **Agent Teams** - 4 角色团队并发执行
12. **UI 本地化** - 4 语言支持
13. **PDF 阅读** - 直接读取 PDF 文件
14. **Slack 集成** - 通知推送
15. **GitHub Actions** - 工作流触发
16. **Web 浏览** - 网页内容提取
17. **国内镜像** - 加速下载
18. **智能滚动** - 长消息自动滚动到底部
19. **消息队列** - 运行时消息排队处理
20. **空参数兜底** - 智能处理工具调用异常

---

## 📦 安装

### 前置要求

- [Rust](https://www.rust-lang.org/tools/install) 1.75+
- Git

### 从源码安装（推荐）

```bash
# 1. 克隆项目
git clone https://gitee.com/tobetters/deepseek-cli.git
cd deepseek-cli

# 2. 全局安装（安装到 ~/.cargo/bin/deepseek）
cargo install --path crates/cli

# 3. 确认安装成功
deepseek --version
```

> **注意**：需要确保 `~/.cargo/bin` 在你的 `PATH` 中。Rust 安装时通常会自动配置。

### 仅编译不安装

```bash
git clone https://gitee.com/tobetters/deepseek-cli.git
cd deepseek-cli
cargo build --release

# 直接运行
./target/release/deepseek
```

### 更新

```bash
cd deepseek-cli
git pull
cargo install --path crates/cli --force
```

---

## 🆕 最近更新

### v0.2.0 (2025-01)

**🐛 Bug 修复**
- ✅ 修复长消息（如销量表格）无法滚动到底部的问题
- ✅ 修复第三次对话无回复的问题
- ✅ 修复空参数工具调用导致的异常
- ✅ 修复 TurnComplete 事件被忽略的问题

**✨ 新功能**
- 🎨 新增 `claude-code` 主题（默认）
- 📜 智能滚动：长消息自动滚动到最新内容
- 📝 消息队列：运行时消息排队处理
- 🛡️ 空参数兜底：智能处理工具调用异常

**🔧 改进**
- 优化状态管理，使用 `turn_handle` 作为唯一状态源
- 增加消息渲染限制（MAX_MSG_LINES: 1000, MAX_TOTAL_LINES: 5000）
- 改进错误处理和日志记录

---

## 🚀 快速开始

### 1. 设置 API Key

```bash
# DeepSeek（默认）
deepseek auth set sk-xxxxxxxxxxxxxxxx

# 或通过环境变量
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
```

### 2. 启动 TUI

```bash
deepseek
```

### 3. 单次对话

```bash
deepseek "你好"
deepseek "写一个 Rust 排序算法"
deepseek --model deepseek-coder "优化这段代码"
```

### 4. YOLO 模式

```bash
deepseek --yolo "重构这个项目"
```

---

## 📖 命令参考

```
deepseek [OPTIONS] [PROMPT] [COMMAND]

Commands:
  auth       管理 API 密钥
  doctor     环境检查
  sessions   查看历史会话
  resume     恢复会话
  export     导出会话

Options:
  --model <MODEL>        模型名称
  --mode <MODE>          交互模式 (plan/agent/yolo)
  --provider <PROVIDER>  提供商
  --yolo                 自动批准所有工具
  --sandbox              启用沙箱模式
```

---

## 🎨 交互模式

| 模式 | 说明 | 快捷键 |
|:----:|------|:------:|
| **Plan** 🔍 | 只读探索，拒绝写操作 | Tab |
| **Agent** 🤖 | 写操作需审批 | 默认 |
| **YOLO** ⚡ | 自动批准所有工具 | `--yolo` |

---

## ⌨️ 快捷键

### 基础操作

| 按键 | 功能 |
|:----:|------|
| `Enter` | 发送消息 |
| `Shift+Enter` | 换行 |
| `Tab` | 切换模式 / 接受建议 |
| `Esc` | 退出 / 取消 / 关闭菜单 |
| `Esc` (双击) | 打开 Rewind 菜单 |

### 生成控制

| 按键 | 功能 |
|:----:|------|
| `Ctrl+C` | 取消当前生成 |
| `Ctrl+B` | 将当前任务移到后台 |

### 导航与搜索

| 按键 | 功能 |
|:----:|------|
| `↑` / `↓` | 浏览输入历史 |
| `←` / `→` | 移动光标 |
| `Home` / `End` | 行首 / 行尾 |
| `PageUp` / `PageDown` | 翻页浏览消息 |
| `Ctrl+R` | 历史搜索模式 |
| `Ctrl+O` | 转录查看器 |

### 功能开关

| 按键 | 功能 |
|:----:|------|
| `Ctrl+V` | Vim 模式开关 |
| `Ctrl+L` | 重绘屏幕 |
| `F1` / `?` | 帮助覆盖层 |
| `Ctrl+T` | 工具详情开关 |

---

## 🔧 斜杠命令

| 命令 | 功能 |
|:-----|------|
| `/help` | 显示帮助 |
| `/compact` | 压缩上下文 |
| `/clear` | 清除对话 |
| `/mode` | 切换模式 |
| `/cost` | Token 统计 |
| `/checkpoint` | 创建快照 |
| `/undo` | 回滚快照 |
| `/rename` | 重命名会话 |
| `/export [md\|json]` | 导出会话 |
| `/sandbox [on\|off]` | 沙箱模式 |
| `/worktree <cmd>` | Git Worktree 管理 |
| `/skills` | 列出 Skills |
| `/skill <name>` | 激活 Skill |
| `/skill new <name>` | 创建 Skill |
| `/config` | 配置编辑器 |
| `/theme <name>` | 切换主题 |

---

## 🛠️ 内置工具（10个）

| 工具 | 功能 | 能力 |
|:-----|------|:----:|
| `shell` | Shell 命令执行 | 执行 |
| `read_file` | 读取文件 | 只读 |
| `write_file` | 写入文件 | 写入 |
| `edit_file` | 编辑文件 | 写入 |
| `git` | Git 操作 | 写入 |
| `glob` | 文件搜索 | 只读 |
| `grep` | 内容搜索 | 只读 |
| `web_search` | 网络搜索 | 网络 |
| `web_browse` | 网页浏览 | 网络 |
| `pdf_read` | PDF 阅读 | 只读 |

---

## 🌐 支持的 LLM 提供商（15+）

### 国内 LLM（15+）

| 提供商 | 模型 | 说明 |
|:-------|------|------|
| DeepSeek | deepseek-chat, deepseek-coder, deepseek-reasoner | 默认 |
| 阿里云 | qwen-turbo, qwen-plus, qwen-max | 通义千问 |
| 百度 | ernie-bot-4, ernie-bot | 文心一言 |
| 智谱 | glm-4, glm-3-turbo | ChatGLM |
| 月之暗面 | moonshot-v1-8k, moonshot-v1-32k, moonshot-v1-128k | Kimi |
| 讯飞 | spark-v3.5, spark-v4 | 星火 |
| 字节 | doubao-pro, doubao-lite | 豆包 |
| MiniMax | abab6.5-chat, abab6-chat | |
| 百川 | Baichuan2-Turbo, Baichuan2-53B | |
| 360 | 360gpt-pro, 360gpt-turbo | |
| 澜舟 | mengzi-gpt, mengzi-gpt-lite | |
| 商汤 | sensechat, sensechat-5 | |
| 昆仑 | 天工, 天工-2 | |
| 零一万物 | yi-large, yi-medium | |
| 阶跃星辰 | step-1, step-2 | |

### 国际 LLM

| 提供商 | 模型 | 说明 |
|:-------|------|------|
| OpenAI | gpt-4o, gpt-4-turbo | |
| Anthropic | claude-3-opus, claude-3-sonnet | |
| Ollama | 本地模型 | 开源 |
| vLLM | 自定义 | 本地部署 |

---

## 📁 配置

配置文件位于 `~/.deepseek/config.toml`：

```toml
# 基础配置
default_provider = "deepseek"
default_model = "deepseek-chat"
default_mode = "agent"
locale = "zh"  # en/zh/ja/pt

# API 密钥
[api_keys]
deepseek = "sk-xxx"

# 提供商配置
[providers.deepseek]
base_url = "https://api.deepseek.com"
model = "deepseek-chat"

# MCP 服务器
[mcp_servers.github]
command = "npx"
args = ["-y", "@anthropic/mcp-github"]

# 沙箱规则
[sandbox]
enabled = false
allowed_dirs = ["~/projects/**"]
denied_paths = ["~/.ssh/**", "~/.env"]

# 权限规则（自动批准/拒绝）
[permissions]
# 自动批准的工具调用规则（通配符支持）
auto_approve = [
    "read_file(*)",
    "Bash(npm test *)",
    "Bash(git status *)"
]
# 自动拒绝的工具调用规则（优先级高于 auto_approve）
auto_deny = [
    "write_file(./secret/*)",
    "Bash(rm -rf /)"
]

# HTTP API 配置（可选）
[http_api]
enabled = false
port = 8080
host = "127.0.0.1"

# 调度器配置（可选）
[scheduler]
enabled = false
```

### 环境变量

| 变量 | 说明 |
|:-----|------|
| `DEEPSEEK_API_KEY` | API 密钥 |
| `DEEPSEEK_BASE_URL` | API 地址 |
| `DEEPSEEK_MODEL` | 默认模型 |
| `DEEPSEEK_PROVIDER` | 默认提供商 |
| `SLACK_WEBHOOK_URL` | Slack Webhook |
| `GITHUB_TOKEN` | GitHub Token |

---

## 🎨 主题

6 套内置主题：

| 主题 | 说明 |
|:-----|------|
| `claude-code` | Claude Code 风格（默认）|
| `claude` | 经典橙色主题 |
| `dark` | 深色主题 |
| `purple` | 紫色主题 |
| `ocean` | 海洋蓝主题 |
| `matrix` | 黑客帝国绿 |

切换主题：
```bash
/theme dark
```

---

## 🌍 UI 本地化

支持 4 种语言：

| 语言 | 代码 |
|:-----|:----:|
| English | `en` |
| 中文 | `zh` |
| 日本語 | `ja` |
| Português | `pt` |

自动检测系统语言，或手动设置：
```toml
locale = "zh"
```

---

## 📚 文档

- [安装指南](docs/INSTALLATION.md)
- [配置参考](docs/CONFIGURATION.md)
- [工具系统](docs/TOOLS.md)
- [Skills 开发](docs/SKILLS.md)
- [MCP 集成](docs/MCP.md)
- [API 参考](docs/API.md)

---

## 📊 项目统计

| 指标 | 数值 |
|:-----|:----:|
| 功能总数 | 75 |
| 独有功能 | 20 |
| 工具数量 | 10 |
| 测试用例 | 280+ |
| 代码行数 | 8,500+ |
| Rust 文件 | 52 |

---

## 🤝 贡献

欢迎贡献！请查看 [GITEE_SETUP.md](GITEE_SETUP.md) 了解项目设置。

---

## 📄 许可证

MIT License

---

## 🙏 致谢

- [Claude Code](https://github.com/anthropics/claude-code) - 设计灵感
- [DeepSeek-TUI](https://github.com/Hmbown/DeepSeek-TUI) - 架构参考
- [ratatui](https://github.com/ratatui-org/ratatui) - TUI 框架