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
export DEEPSEEK_API_KEY="YOUR_KEY"      # 环境变量替代方案；非交互式 shell 使用 ~/.zshenv
deepseek
deepseek doctor                         # 验证设置

要轮换或删除已保存的密钥：

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 会显示所选路由，成本跟踪也按实际运行的模型计费。如果路由调用失败或返回无效答案，应用会回退到本地启发式规则。

子代理会继承自动模式，除非你为它们指定了显式模型。当你需要可重复的基准测试、严格的成本上限或特定的提供商/模型映射时，请使用固定模型或固定思考级别。

Linux ARM64（Raspberry Pi、Asahi、Graviton、HarmonyOS PC）

从 v0.8.8 开始，npm i -g deepseek-tui 可在基于 glibc 的 ARM64 Linux 上运行。你也可以从 Releases 页面下载预构建二进制文件。