deepseek doctor 诊断通过但 deepseek run 无法运行

[grey219114-cyber]

问题描述

运行 deepseek doctor 全部检查通过，但 deepseek run 无法正常工作（没有输出 / 不启动对话）。

deepseek doctor 输出

DeepSeek TUI Doctor
==================

Version Information:
  deepseek-tui: 0.8.10
  rust: rustc 1.94.1 (e408947bf 2026-03-25)

Configuration:
  ✓ config.toml found at ~/.deepseek/config.toml
  workspace: ~

API Keys:
  ✓ deepseek: env=yes, config=no
  · nvidia-nim: env=no, config=no
  · openrouter: env=no, config=no
  · novita: env=no, config=no
  · fireworks: env=no, config=no
  · sglang: env=no, config=no
  · credential sources: env, ~/.deepseek/config.toml
  ✓ active provider key resolved

API Connectivity:
  ✓ API connection successful (model: deepseek-v4-pro)

MCP Servers:
  ✓ MCP feature flag enabled
  · MCP config not found at ~/.deepseek/mcp.json
    Run deepseek mcp init or deepseek setup --mcp.

Skills:
  · local skills dir not found at ~/skills
  ✓ .agents skills dir found at ~/.agents/skills (7 items)
  ✓ global skills dir found at ~/.deepseek/skills (2 items)
  ✓ .claude skills dir found at ~/.claude/skills (8 items)
  · selected skills dir: ~/.agents/skills

Tools:
  · tools dir not found at ~/.deepseek/tools
    Run deepseek-tui setup --tools to scaffold a starter dir.

Plugins:
  · plugins dir not found at ~/.deepseek/plugins
    Run deepseek-tui setup --plugins to scaffold a starter dir.

Storage:
  · tool-output spillover dir not yet created at ~/.deepseek/tool_outputs
  · composer stash empty (Ctrl+S in the composer to park a draft)

Platform:
  OS: linux
  Arch: x86_64
  ✓ sandbox available: linux-landlock

All checks complete!

预期行为

deepseek run 应该正常启动 TUI 对话界面。

实际行为

deepseek run 执行后输入消息一直卡在了working.....

环境信息

• OS: Linux x86_64
• deepseek-tui: 0.8.10
• rustc: 1.94.1
• API Provider: deepseek (model: deepseek-v4-pro)
• API Connectivity: ✅ 通过

附加说明

MCP、Tools、Plugins 等未初始化，但不应该影响 deepseek run 的基本功能。

[grey219114-cyber]

一直卡在了woking.........

[merchloubna70-dot]

Several things to check:

1. Terminal compatibility

deepseek run launches the full TUI which requires a proper terminal. Try:

deepseek run --no-alt-screen

If that works, your terminal doesn't support alternate screen mode. Add to ~/.deepseek/config.toml:

[tui]
alternate_screen = "never"

2. Check for a crash log

RUST_LOG=deepseek_tui=debug deepseek run 2>debug.log
cat debug.log | head -50

3. SSH / headless environment

If you're running over SSH without a TTY, TUI won't start. Try:

deepseek -p "hello" --no-alt-screen

Or use exec mode:

deepseek-tui exec --auto "hello"

4. Note: you're on v0.8.10 — v0.8.11 just released

cargo install deepseek-tui-cli --force
# or
npm install -g deepseek-tui

v0.8.11 includes scroll and YOLO fixes that might be related.

What does RUST_LOG=debug deepseek run --no-alt-screen 2>&1 | head -20 output?

---

wangfengcsu@qq.com

[grey219114-cyber]

排查结果

按照建议逐一检查了，以下是详细发现：

1️⃣ Terminal / TTY 环境

$ echo $TERM
dumb
$ tty
not a tty
$ test -t 0
stdin is NOT a TTY

当前 shell 没有真正的 TTY（TERM=dumb），所以 deepseek run 根本无法启动 TUI：

$ deepseek run --no-alt-screen
Error: Failed to enable raw mode: No such device or address (os error 6)

这不仅仅是 alternate screen 的问题——raw mode 本身就需要一个真正的 TTY。在真实终端中运行应该没问题。

2️⃣ Debug 日志

$ RUST_LOG=deepseek_tui=debug deepseek run --no-alt-screen 2>&1 | head -50
Error: Failed to enable raw mode: No such device or address (os error 6)

没有 crash trace，直接报 raw mode 错误就退出了。

3️⃣ CLI / Exec 模式

• deepseek -p "hello" --no-alt-screen
  Hello! How can I help you today?
• deepseek-tui exec --auto "hello" → 运行 30 秒后超时

4️⃣ v0.8.11 发布状态

npm 和 crates.io 上最新都是 0.8.10，v0.8.11 尚未发布。

🔍 根因结论

问题出在 运行环境没有真正的 TTY：

• $TERM = dumb
• tty 返回 not a tty
• stdin is NOT a TTY

deepseek run 需要 raw mode 来渲染 TUI，没有 TTY 就无法工作。建议在真实终端（iTerm2, GNOME Terminal, tmux with proper TERM, Windows Terminal 等）中运行。

如果在真实终端中仍出现此问题，请提供：

• 使用的终端模拟器名称
• 是否通过 SSH 连接
• echo $TERM 的输出

[merchloubna70-dot]

完美的自我排查！根因完全正确：TERM=dumb + not a tty = 无法启动 TUI raw mode，这是预期行为，不是 bug。

结论：在真实终端里运行没问题。如果你需要在无 TTY 环境（CI、脚本、SSH pipe）中使用，用非交互模式：

# 单次对话
deepseek -p "your question" --no-alt-screen

# Agent 模式（自动执行工具）
deepseek-tui exec --model deepseek-v4-flash --auto "your task"

关于 v0.8.11 — npm/crates.io 延迟发布是正常的，通常 push 后几小时到一天内更新。可以从源码安装：

cargo install --git https://github.com/Hmbown/DeepSeek-TUI.git --force

可以关闭这个 issue 了，不是 bug。

---

wangfengcsu@qq.com

[merchloubna70-dot]

deepseek run is not a valid subcommand — that's likely why nothing happens. Here's how to actually start it:

# Interactive TUI (main mode)
deepseek

# One-shot / non-interactive
deepseek exec --model deepseek-v4-flash "your prompt here"

# Auto/agentic mode
deepseek exec --model deepseek-v4-flash --auto "your task"

If deepseek (no args) also fails to start the TUI despite doctor passing, please share:

• Your terminal emulator and OS
• Output of deepseek --version
• Any error output when running just deepseek

The TUI requires an alternate-screen-capable terminal (most modern terminals work).

[qwas982]

为啥不设计成 x64dbg 那样的静态调试工具?
能把 x64dbg 有价值的部分学到吗

[qinxianyuzou]

我也遇到相同的问题，我使用“& "deepseek-tui-windows-x64.exe" --prompt "你好，回复一句话就行"”这个命令，是能返回内容的，但是打开tui就会卡住工作中，而且镜像超大