Hmbown DeepSeek-TUI

Hmbown DeepSeek-TUI

DeepSeek TUI 是一个面向 DeepSeek V4 的终端编码代理。它通过 deepseek 命令运行，流式传输推理块，在审批机制下编辑本地工作区，并包含一个自动模式，可在每次交互中选择模型和思考级别。

简体中文 README

安装

deepseek 以 Rust 二进制文件形式分发：调度命令 (deepseek) 和配套的 TUI 运行时 (deepseek-tui)。选择你已有的安装方式；它们都会将相同的命令添加到你的 PATH 中。npm 包是发布版二进制文件的安装器/包装器，而非代理运行时本身。

# 1. npm — 如果你已使用 Node，这是最简单的方式。
# 该包从 GitHub Releases 下载匹配的预构建 Rust 二进制文件。
npm install -g deepseek-tui

# 2. Cargo — 无需 Node。
cargo install deepseek-tui-cli --locked   # `deepseek` (入口点)
cargo install deepseek-tui --locked       # `deepseek-tui` (TUI 二进制文件)

# 3. Homebrew — macOS 包管理器。
brew tap Hmbown/deepseek-tui
brew install deepseek-tui

# 4. 直接下载 — 无需包管理器或工具链。
# https://github.com/Hmbown/DeepSeek-TUI/releases
# 预构建支持 Linux x64/ARM64、macOS x64/ARM64、Windows x64。

在中国大陆，可通过 --registry=https://registry.npmmirror.com 加速 npm 路径，或使用下方的 Cargo 镜像。

DeepWiki 项目索引

这是什么？

DeepSeek TUI 是一个运行在终端中的编码代理。它可以读取和编辑文件、运行 shell 命令、搜索网络、管理 git，并通过键盘驱动的 TUI 协调子代理。它基于 DeepSeek V4（deepseek-v4-pro / deepseek-v4-flash）构建，支持 100 万 token 的上下文窗口、流式推理块以及前缀缓存感知的成本报告。

主要特性

• 自动模式 — --model auto / /model auto 为每次交互自动选择模型和思考级别
• 思考模式流式传输 — 在模型工作时查看 DeepSeek 的推理块
• 完整工具套件 — 文件操作、shell 执行、git、网络搜索/浏览、应用补丁、子代理、MCP 服务器
• 100 万 token 上下文 — 上下文跟踪、手动或配置的压缩、以及前缀缓存遥测
• 三种模式 — Plan（只读探索）、Agent（交互式审批）、YOLO（自动审批）
• 推理努力级别 — 通过 Shift + Tab 在 off → high → max 之间循环切换
• 会话保存/恢复 — 对长时间运行的会话进行检查点和恢复
• 工作区回滚 — 通过 /restore 和 revert_turn 实现回合前后的侧边 git 快照，不影响仓库的 .git
• 持久化任务队列 — 后台任务可在重启后继续运行
• HTTP/SSE 运行时 API — deepseek serve --http 用于无头代理工作流
• MCP 协议 — 连接到 Model Context Protocol 服务器以扩展工具集；详见 docs/MCP.md
• 原生 RLM（rlm_query） — 通过同一 API 客户端使用廉价的 deepseek-v4-flash 子模型进行批量分析
• LSP 诊断 — 每次编辑后通过 rust-analyzer、pyright、typescript-language-server、gopls、clangd 显示内联错误/警告
• 用户记忆 — 可选的持久化笔记文件，注入到系统提示中，用于跨会话偏好设置
• 本地化界面 — 支持 en、ja、zh-Hans、pt-BR，并具备自动检测功能
• 实时成本追踪 — 每回合和会话级别的 token 使用量和成本估算；缓存命中/未命中明细
• 技能系统 — 来自 GitHub 的可组合、可安装的指令包，无需后端服务

工作原理

deepseek（调度 CLI）→ deepseek-tui（配套二进制文件）→ ratatui 界面 ↔ 异步引擎 ↔ 兼容 OpenAI 的流式客户端。工具调用通过类型化注册表（shell、文件操作、git、网络、子代理、MCP、RLM）进行路由，结果流式传输回对话记录。引擎管理会话状态、回合跟踪、持久化任务队列，以及一个 LSP 子系统，该子系统在下一次推理步骤之前将编辑后的诊断信息反馈到模型的上下文中。详见 docs/ARCHITECTURE.md。

快速开始

npm install -g deepseek-tui
deepseek --version
deepseek --model auto

预构建的二进制文件已发布，支持 Linux x64、Linux ARM64（v0.8.8+）、macOS x64、macOS ARM64 和 Windows x64。对于其他目标平台（musl、riscv64、FreeBSD 等），请参见“从源码安装”或 docs/INSTALL.md。

首次启动时，系统会提示你输入 DeepSeek API 密钥。该密钥会保存到 ~/.deepseek/config.toml，因此你可以在任何目录下使用，无需操作系统凭据提示。你也可以提前设置：

deepseek auth set --provider deepseek   # 保存到 ~/.deepseek/config.toml
deepseek auth status                     # 显示当前活动的凭据来源
export DEEPSEEK_API_KEY="YOUR_KEY"       # 环境变量替代方案；非交互式 shell 使用 ~/.zshenv
deepseek
deepseek doctor                          # 验证设置

如果 deepseek doctor 提示被拒绝的密钥来自 DEEPSEEK_API_KEY，请从你的 shell 启动文件中移除过期的导出语句，打开一个新的 shell，或运行 deepseek auth set --provider deepseek。使用 deepseek auth status 查看配置、密钥环和环境变量的来源状态，而不会打印密钥。保存的配置密钥优先级高于密钥环和环境变量，且更易于轮换。要轮换或移除已保存的密钥：deepseek auth clear --provider deepseek。

自动模式

当你希望 DeepSeek TUI 自行决定每次交互所需的模型和推理能力时，使用 deepseek --model auto 或 /model auto。自动模式同时控制两个设置：

• 模型：deepseek-v4-flash 或 deepseek-v4-pro
• 思考：off、high 或 max

在发送实际交互之前，应用会使用关闭思考模式的 deepseek-v4-flash 进行一次小型路由调用。该路由器会查看最新的请求和最近的上下文，然后为实际请求选择一个具体的模型和思考级别。简短/简单的交互可以保持在 Flash 且关闭思考模式；编码、调试、发布工作、架构、安全审查或模糊的多步骤任务可以升级到 Pro 和/或更高的思考级别。

auto 是 DeepSeek TUI 的本地特性。上游 API 永远不会收到 model: "auto"；它收到的是为该次交互选择的具体模型和思考设置。TUI 会显示所选的路由，成本追踪也按实际运行的模型计费。如果路由器调用失败或返回无效结果...