DeepSeek-TUI 真机实测：从 npm 安装到第一个命令
今天翻 GitHub Trending，DeepSeek-TUI 又涨了 5799 星。之前看过几篇介绍文章，决定亲自装一下——掘金的技术文章，代码不跑过不写。
安装
一条命令：
npm install -g deepseek-tui
耗时 53 秒，装完 v0.8.17。没有 native module 编译，纯 JS 封装，Windows/Mac/Linux 通吃。
装完第一件事看版本：
$ deepseek-tui --version
deepseek-tui (npm wrapper) v0.8.17
binary version: v0.8.17
repo: git+https://github.com/Hmbown/DeepSeek-TUI.git
Terminal-native TUI and CLI for DeepSeek models.
先跑 doctor，别急着写代码
新手容易装完直接跑 deepseek 进 TUI，然后卡在 API key。doctor 命令能省掉这个坑：
$ deepseek-tui doctor
输出比我想的详细——版本信息、配置文件路径、API key 状态、API 连通性测试、MCP 服务器状态、Skills 目录、Tools 目录、Plugins 目录、存储路径、平台信息。
我的环境检测结果：DeepSeek API key 已配置在 ~\.deepseek\config.toml，连接 api.deepseek.com/beta 成功，模型 deepseek-v4-pro。MCP 未配置，Skills 目录在 ~\.agents\skills。
第一个坑：models 命令 404
$ deepseek-tui models
Error: Failed to list models: HTTP 404 Not Found:
这个命令调的是 /models 端点，但 DeepSeek API 的 beta 端点可能没暴露这个路由。不算大问题——模型列表在文档里能查到，不影响实际使用。但如果你是那种"装完先跑 help 看全貌"的人，这个 404 会让你愣一下。
exec 模式：快但没上下文
exec 是非交互模式，适合单次问答。试了一条：
$ deepseek-tui exec "Read scripts/hot_scraper.py and list data sources"
返回结果说它没有文件系统访问权限。这说明 exec 模式下 Agent 不加载当前工作目录的上下文——跟 TUI 模式的行为不同。如果你想用 exec 做代码相关的事，需要把代码贴进 prompt 里，或者进 TUI。
review 模式：需要 git 仓库
$ deepseek-tui review
Error: git diff failed: Not a git repository.
review 依赖 git diff，项目不在 git 仓库里会直接报错。报错信息里带了完整的 git diff --help 输出，还算友好。
整体感受
几个印象深刻的设计：
- doctor 命令是杀手级的。很多 CLI 工具把诊断分散在文档各处，DeepSeek-TUI 一条命令告诉你所有状态——API key 有没有配、连不连得上、MCP 有几个 server、Skills 在哪。
- 多 provider 支持。config.toml 里可以配 deepseek、nvidia-nim、openrouter、novita、fireworks、sglang、vllm、ollama 八个 provider。不是只能连 DeepSeek 官方的 API。
- Plan / Agent / YOLO 三档模式。Plan 只读不写、Agent 每步确认、YOLO 全自动。这个设计跟今天的 HN 热帖 "Agents need control flow, not more prompts"（310 票）说的是同一个逻辑——控制流比 prompt 长度重要。
几个瑕疵：
models命令 404，建议官方修一下或者至少在 help 里标为实验性功能exec模式没有工作目录上下文，建议加一个--workspace或自动加载当前目录- Windows 下
~\.deepseek\路径不如直接输出绝对路径直观
适合什么人
如果你已经在用 Claude Code 或 Codex，DeepSeek-TUI 不是替代品——是低成本补充。DeepSeek V4 API 价格是 Claude 的 1/10，对 CRUD、文档生成、代码审查这类高频但不需要最强推理的场景，性价比极高。今天 GitHub 上 5799 个人给了 star，不只是看热闹。
实测环境：Windows 11, Node.js, DeepSeek-TUI v0.8.17, DeepSeek V4 Pro API
