Kimi CLI Tools

DeepSeek TUI

DeepSeek V4的终端编码代理。它从 deepseek 命令、流式推理块、编辑具有批准门的本地工作区，并包括一个自动模式，该模式可按轮次选择模型和思维水平。

简体中文 README

安装

deepseek 以Rust二进制文件的形式分发：dispatcher命令 (deepseek)以及配套的TUI运行时(deepseek-tui).选择其中之一 您已经使用的安装路径；他们都对你的 PATH. npm包是发布二进制文件的安装程序/包装器，而不是 代理运行时本身。

# 1. npm — easiest if you already use Node. The package downloads the
#    matching prebuilt Rust binaries from GitHub Releases.
npm install -g deepseek-tui

# 2. Cargo — no Node needed.
cargo install deepseek-tui-cli --locked   # `deepseek` (entry point)
cargo install deepseek-tui     --locked   # `deepseek-tui` (TUI binary)

# 3. Homebrew — macOS package manager.
brew tap Hmbown/deepseek-tui
brew install deepseek-tui

# 4. Direct download — no package manager or toolchain.
#    https://github.com/Hmbown/DeepSeek-TUI/releases
#    Prebuilt for Linux x64/ARM64, macOS x64/ARM64, Windows x64.

# 5. Docker — prebuilt release image.
docker run --rm -it \
  -e DEEPSEEK_API_KEY \
  -v "$PWD:/workspace" \
  ghcr.io/hmbown/deepseek-tui:latest

在中国大陆，加快npm路径 --registry=https://registry.npmmirror.com，或使用 载货镜 在......下面

 ](https://www.npmjs.com/package/deepseek-tui)  DeepWiki项目索引

DeepSeek TUI screenshot

______________________________________________________________________

它是什么？

DeepSeek TUI是一个在您的终端中运行的编码代理。它可以从键盘驱动的TUI读取和编辑文件、运行shell命令、搜索网络、管理git和协调子代理。

它是围绕DeepSeek V4构建的(deepseek-v4-pro / deepseek-v4-flash)，包括1M令牌上下文窗口、流式推理块和前缀缓存感知成本报告。

主要特点

• 自动模式 — --model auto / /model auto 为每个回合选择模型和思维水平
• 思维模式流 --在模型工作时查看DeepSeek推理块
• 全套工具 --文件操作、shell执行、git、web搜索/浏览、应用补丁、子代理、MCP服务器
• 1M令牌上下文 --上下文跟踪、手动或配置压缩以及前缀缓存遥测
• 三种模式 --计划（只读探索）、代理（与批准交互）、YOLO（自动批准）
• 推理努力层次 --循环通过 off → high → max 随着 Shift + Tab
• 会话保存/恢复 --检查点并恢复长时间运行的会话
• 工作区回滚 --附带git转弯前后快照 /restore 和 revert_turn，无需触碰您的仓库 .git
• 持久任务队列 --后台任务可以在重启后继续运行
• HTTP/SSE运行时API — deepseek serve --http 用于无头代理工作流
• MCP协议 --连接到模型上下文协议服务器以进行扩展工具；请看 docs/MCP.md
• 本地RLM (rlm_query)--通过廉价软件运行批量分析 deepseek-v4-flash 使用相同API客户端的儿童
• LSP诊断 --每次编辑后，通过锈分析器、版权、打字语言服务器、gopls、cland显示内联错误/警告
• 用户内存 --可选的持久注释文件注入到系统提示符中，用于跨会话首选项
• 本地化UI — en, ja, zh-Hans, pt-BR 具有自动检测功能
• 实时成本跟踪 --每回合和会话级别的令牌使用和成本估算；缓存命中/未命中细分
• 技能体系 --来自GitHub的可组合、可安装的指令包，无需后端服务

______________________________________________________________________

它是如何连接的

deepseek （调度员CLI）→ deepseek-tui （伴随二进制）→ ratatui接口↔ 异步引擎↔ 兼容OpenAI的流媒体客户端。工具调用通过类型化注册表（shell、文件操作、git、web、子代理、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   # saves to ~/.deepseek/config.toml
deepseek auth status                    # shows the active credential source

export DEEPSEEK_API_KEY="YOUR_KEY"      # env var alternative; use ~/.zshenv for non-interactive shells
deepseek

deepseek doctor                         # verify setup

如果 deepseek doctor 说被拒绝的钥匙来自 DEEPSEEK_API_KEY，删除 从shell启动文件中导出过时的内容，打开一个新的shell，或运行 deepseek auth set --provider deepseek.使用 deepseek auth status 看看 config、keyring和env-var源状态，而不打印密钥。已保存配置 键优先于键环和环境，更容易旋转。

要旋转或删除已保存的密钥，请执行以下操作： deepseek auth clear --provider deepseek.

自动模式

使用 deepseek --model auto 或 /model auto 当你想让DeepSeek TUI决定转弯需要多少模型和推理能力时。

自动模式同时控制两个设置：

• 型号： 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）

npm i -g deepseek-tui 从v0.8.8开始，它可以在基于glibc的ARM64 Linux上运行。您还可以从以下网址下载预构建的二进制文件 发布页面 把它们并排放在你的 PATH.

中国/镜像友好安装

如果GitHub或npm在中国大陆的下载速度较慢，请使用Cargo注册表镜像：

# ~/.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   # provides `deepseek`
cargo install deepseek-tui     --locked   # provides `deepseek-tui`
deepseek --version

预构建的二进制文件也可以从以下网址下载 .使用 DEEPSEEK_TUI_RELEASE_BASE_URL 用于镜像发布资产。

窗户（独家新闻）

勺子 是一个Windows包管理器。DeepSeek TUI已上市 在Scoop的主桶中，但该清单会独立更新，并可能滞后于 GitHub/npm/Cargo发布。跑 scoop update 首先，然后验证已安装 版本与 deepseek --version:

scoop update
scoop install deepseek-tui
deepseek --version

需要最新版本时，使用npm或直接下载GitHub版本 在Scoop的清单赶上之前。

Install from source

适用于任何一级Rust目标，包括musl、riscv64、FreeBSD和较旧的ARM64发行版。

# Linux build deps (Debian/Ubuntu/RHEL):
#   sudo apt-get install -y build-essential pkg-config libdbus-1-dev
#   sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel

git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI

cargo install --path crates/cli --locked   # requires Rust 1.88+; provides `deepseek`
cargo install --path crates/tui --locked   # provides `deepseek-tui`

这两个二进制文件都是必需的。交叉编译和平台特定注释： docs/INSTALL.md.

其他API提供商

# NVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
deepseek --provider nvidia-nim

# Fireworks
deepseek auth set --provider fireworks --api-key "YOUR_FIREWORKS_API_KEY"
deepseek --provider fireworks --model deepseek-v4-pro

# Generic OpenAI-compatible endpoint
deepseek auth set --provider openai --api-key "YOUR_OPENAI_COMPATIBLE_API_KEY"
OPENAI_BASE_URL="https://openai-compatible.example/v4" deepseek --provider openai --model glm-5

# Self-hosted SGLang
SGLANG_BASE_URL="http://localhost:30000/v1" deepseek --provider sglang --model deepseek-v4-flash

# Self-hosted vLLM
VLLM_BASE_URL="http://localhost:8000/v1" deepseek --provider vllm --model deepseek-v4-flash

# Self-hosted Ollama
ollama pull deepseek-coder:1.3b
deepseek --provider ollama --model deepseek-coder:1.3b

______________________________________________________________________

v0.8.27的新增功能

一个抛光版本：17个社区PR加上一次重点用户问题扫描 在v0.8.26发布后的24-48小时内。 完整更新日志.

• 跨终端闪烁已修复 在Ghostty/VSCode终端上/

Win10 conhost（最有报道的v0.8.26回归--#1119、#1260、#1260）， #1295, #1352, #1356, #1363, #1366).掉落具有破坏性 2J/3J 从视口重置序列中；alt屏幕+diff渲染 手柄会无闪烁地重新绘制。

• 长输出文本不再溢出右边缘 (#1344,

#1351).段落和代码块硬断超长单词 字符边界——与v0.8.25表单元格修复相匹配。

• 寻呼机复制出来 通过 c 或 y （#1354）——每个全屏寻呼机

(Alt+V 工具细节， Ctrl+O 思考，外壳作业/任务/MCP 管理员）接受应用内复制密钥绑定。

• 上下文相关的Ctrl+C （#1337、#1367）——选择→复制到

Windows（符合操作系统惯例），启用→取消，闲置→手臂出口 带有2s确认窗口。 Cmd+C / Ctrl+Shift+C 继续 原封不动地复制。

• MCP池自动重新加载 mcp.json 改变 （#1267第2部分）--

不再手动 /mcp reload 编辑配置后。便宜的mtime+ 对每次工具调用进行内容哈希检查；网络文件系统 具有较粗的mtime粒度，不要搅拌。

• 模型可调用 notify 工具 （#1322）--桌面通知

对于“长任务完成”ping。尊重您现有的 [notifications].method 配置；关闭时静音无操作。

• 车载屏幕以所选语言呈现 --挑

简体中文 / 日本語 / Português (Brasil) at step 2 and the rest of 流程如下。特别适合CJK-IME用户避免 设置过程中输入英语。

• 粘贴UX重建 --大糊得到 @paste-…md

立即处理（提交前可见，无“自动发送” @提到我没有授权“惊喜”）；粘贴爆裂自动禁用 在括号内粘贴的终端上；短CJK粘贴否 尾部换行符上的较长自动提交（#1302，谢谢 @雷德利乌41 PR#1342）。

• **`/skills

` 筛选本地技能列表（#1318）--on v0.8.26的行间距顶部（#1328从 @雷德利乌41**).

• /skills --remote 诊断提示 （#1329）--取数时

注册表失败，错误链现在以一行结束 指向最可能原因的提示（DNS/TLS/拒绝/ 4xx/429/超时）。

• 17个社区公关登陆 — /mode 统一， /status

诊断， /feedback，会话工件元数据，子代理 自我报告压缩、全球AGENTS.md回退、， --yolo CLI→TUI传播， composer_arrows_scroll，会话成本 持久性、提供者感知模型选择器+持久性、HTTP 用户代理标头、HTTP-400配额重试、显式隐藏文件 完成，Windows鼠标捕获文档，README zh-CN同步， 工具输出渲染perf+卡轨，扩展测试覆盖范围。 多亏了 @雷德利乌41, @仅限思考者, @马纳斯卡拉, @富林主义者, @lbcheng888, @imkingjh999, @dst1213, @李, @刘, @whtis, @陀海666.

______________________________________________________________________

用法

deepseek                                         # interactive TUI
deepseek "explain this function"                 # one-shot prompt
deepseek --model deepseek-v4-flash "summarize"   # model override
deepseek --model auto "fix this bug"             # auto-select model + thinking
deepseek --yolo                                  # auto-approve tools
deepseek auth set --provider deepseek            # save API key
deepseek doctor                                  # check setup & connectivity
deepseek doctor --json                           # machine-readable diagnostics
deepseek setup --status                          # read-only setup status
deepseek setup --tools --plugins                 # scaffold tool/plugin dirs
deepseek models                                  # list live API models
deepseek sessions                                # list saved sessions
deepseek resume --last                           # resume the most recent session in this workspace
deepseek resume                      # resume a specific session by UUID
deepseek fork                        # fork a session at a chosen turn
deepseek serve --http                            # HTTP/SSE API server
deepseek serve --acp                             # ACP stdio adapter for Zed/custom agents
deepseek run pr                               # fetch PR and pre-seed review prompt
deepseek mcp list                                # list configured MCP servers
deepseek mcp validate                            # validate MCP config/connectivity
deepseek mcp-server                              # run dispatcher MCP stdio server
deepseek update                                  # check for and apply binary updates

Docker镜像发布到GHCR进行发布构建：

docker volume create deepseek-tui-home

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v deepseek-tui-home:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:latest

Zed/ACP

DeepSeek可以作为编辑器的自定义代理客户端协议服务器运行 通过stdio产生本地ACP代理。在Zed中，添加一个自定义代理服务器：

{
  "agent_servers": {
    "DeepSeek": {
      "type": "custom",
      "command": "deepseek",
      "args": ["serve", "--acp"],
      "env": {}
    }
  }
}

第一个ACP切片支持新会话，并通过您的 现有的DeepSeek配置/API密钥。工具支持的编辑和检查点回放 尚未通过ACP暴露。

键盘快捷键

完整快捷方式目录： docs/KEYBINDINGS.md.

______________________________________________________________________

模式

______________________________________________________________________

配置

用户配置： ~/.deepseek/config.toml.项目覆盖： /.deepseek/config.toml （否认： api_key, base_url, provider, mcp_config_path). config.example.toml 有各种选择。

关键环境变量：

集 locale 在 settings.toml，使用 /config locale zh-Hans，或依赖 LC_ALL/LANG 选择UI chrome和发送给V4型号的回退语言。最新的用户消息在自然语言推理和回复方面仍然获胜，因此即使在英语系统环境中，中国用户也会保持中文状态。看 docs/CONFIGURATION.md 和 docs/MCP.md.

______________________________________________________________________

型号和定价

DeepSeek平台默认为 https://api.deepseek.com/beta 在v0.8.16中，因此可以在没有额外设置的情况下测试β-门控API功能。集 base_url = "https://api.deepseek.com" 选择退出。

遗留别名 deepseek-chat / deepseek-reasoner 映射到 deepseek-v4-flash 2026年7月24日后退休。NVIDIA NIM变体使用您的NVIDIA帐户条款。

*DeepSeek Pro价格目前反映了75%的限时折扣，有效期至2026年5月31日15:59 UTC。在此之后，TUI成本估算将恢复到基本Pro费率。*

\[！注意\] 有关DeepSeek-V4-Pro的最新定价，包括当前75%的折扣，有效期至2026年5月31日15:59 UTC，请咨询官方 DeepSeek定价页面README中列出的所有费率均与官方公布的值相对应。

______________________________________________________________________

发布自己的技能

DeepSeek TUI从工作区目录中发现技能(.agents/skills → skills → .opencode/skills → .claude/skills → .cursor/skills)全球目录(~/.agents/skills → ~/.claude/skills → ~/.deepseek/skills).每个技能都是一个目录，其中包含 SKILL.md 文件：

~/.agents/skills/my-skill/
└── SKILL.md

需要前台：

---
name: my-skill
description: Use this when DeepSeek should follow my custom workflow.
---

# My Skill
Instructions for the agent go here.

命令： /skills （列表）， /skill 激活 /skill new （脚手架）， /skill install github:/ （社区）， /skill update / uninstall / trust.从GitHub进行社区安装不需要后端服务。已安装的技能出现在模型可见的会话上下文中；代理可以通过自动选择相关技能 load_skill 当您的任务与他们的描述相匹配时，使用该工具。

______________________________________________________________________

文档

完整变更日志： 更改日志.md.

______________________________________________________________________

谢谢

• 深度求索 — thank you for the models and support that power every turn. 感谢 DeepSeek 提供模型与支持，让每一次交互成为可能。
• DataWhale 🐋 — thank you for your support and for welcoming us into the Whale Brother family. 感谢 DataWhale 的支持，并欢迎我们加入“鲸兄弟”大家庭。

该项目得到了越来越多的贡献者社区的帮助：

• 水星70点 --28个PR，涵盖功能、修复和VS代码扩展脚手架（#645–#681）
• WyxBUPT-22 --表格、粗体/斜体和水平规则的Markdown渲染（#579）
• 龙庙像素 --Windows+中国安装文档（#578）
• 20字节 --用户记忆文档和帮助抛光（#569）
• 星克申 --glibc兼容性预检（#556）
• 毗湿奴1837 --glibc兼容性改进（#565）
• 神通蒙新 --壳牌 cwd 边界验证（#524）
• toi500 --Windows粘贴修复报告
• x造口术 --终端启动重新涂漆报告
• 梅洛迪0709 --Slash前缀输入激活报告
• 代理技能-007 --README清晰通行证（#685）
• woyxiang --Windows安装文档（#696）
• 王峰 --定价/折扣信息更新（#692）
• 身份0116 --代码_OF_CONDUCT.md（#686）
• dfwqdyl ui --型号ID病例敏感性兼容性报告（#729）
• 刘 --陈旧 working... 状态错误报告和Windows剪贴板回退（#738、#850）
• 雷德利乌41 --简历提示、工作区信任持久性、Ollama提供商支持和思维块流最终确定（#863、#870、#921、#1078）
• 谢树陶 --简单的Markdown技能回退（#869）
• GK012 --npm包装器 --version 回退（#885）
• y0sif --直接子代理完成后父循环唤醒（#901）
• 哑铃 / 浩淼的mac --命令安全空字节强化（#706、#918）
• macworkers --使用新会话id进行分叉确认（#600，#919）
• 零 和 zerx实验室 --通知条件配置和更丰富的OSC 9通知体（#820、#920）
• 陈杰姆斯 --缓存@提及完成、配置恢复抛光和Windows UTF-8 shell输出（#849、#927、#982、#1018）
• 昂兹ii --配置安全、异步清理、Docker强化和命令安全修复（#822、#824、#827、#831、#833、#835、#837）
• 埃洛温53 --UTF-8解码和确定性测试覆盖率（#825、#840）
• wdw8276 — /rename 自定义会话标题命令（#836）
• 班基 — .cursor/skills 发现路径支持（#817）
• 琼斯凯德 --动态 max_tokens API请求的计算（#826）
• 哈菲兹 Pizofreude --SSRF保护 fetch_url 和恒星历史图
• 尤尼克大学 --模式驱动的配置UI（TUI+web）
• 杰森 --SSRF安全强化
• 答案001 --快照孤儿清理、npm安装保护、会话遥测修复、模型作用域缓存清除、符号链接技能支持和npm镜像逃逸孵化指导（#975、#1032、#1047、#1049、#1052、#1019、#1051、#1056）
• 孟Z超级 — /theme 用于暗/亮切换和SSE gzip/brotli解压缩的命令（#1057、#1061）
• 狄华明 --计划模式只读沙盒安全修复（#1077）
• 王 --精确粘贴进入自动提交复制器（#1073）
• ArronAI007 --修复macOS Terminal.app和ConHost的窗口调整工件（#993）
• 仅限思考者 --OpenRouter和自定义端点模型ID保存（#1066）
• 杰夫斯基 --DeepSeek端点校正报告（#1079、#1084）
• wlon -NVIDIA NIM提供商API-key首选项诊断（#1081）

______________________________________________________________________

贡献

技术支持： 给我买杯咖啡.

\[！注意\] *不隶属于DeepSeek股份有限公司。*

许可证

麻省理工学院

明星历史