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 预构建。

# 5. Docker — 预构建的发布镜像。
docker run --rm -it \
  -e DEEPSEEK_API_KEY \
  -v "$PWD:/workspace" \
  ghcr.io/hmbown/deepseek-tui:latest

在中国大陆，使用 --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 上下文 — 上下文跟踪、手动或配置的压缩以及前缀缓存遥测
三种模式 — 计划（只读探索）、代理（交互式，需审批）、YOLO（自动审批）
推理努力级别 — 通过 Shift + Tab 在 off → high → max 之间循环
会话保存/恢复 — 检查点并恢复长时间运行的会话
工作区回滚 — 使用 /restore 和 revert_turn 进行侧 git 回合前/后快照，不影响您仓库的 .git
持久任务队列 — 后台任务可在重启后继续存在
HTTP/SSE 运行时 API — deepseek serve --http 用于无头代理工作流
MCP 协议 — 连接到模型上下文协议服务器以扩展工具；请参阅 docs/MCP.md
原生 RLM (rlm_query) — 通过使用相同 API 客户端的廉价 deepseek-v4-flash 子进程运行批量分析
LSP 诊断 — 每次编辑后通过 rust-analyzer、pyright、typescript-language-server、gopls、clangd 内联显示错误/警告
用户记忆 — 可选的持久笔记文件，注入到系统提示中，用于跨会话偏好
本地化 UI — 支持 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 会显示实际使用的模型和思考级别。

注意： 原文在“The TU”处截断，翻译已处理至该处。如果后续有补充内容，可以继续提供。