文档 · DeepSeek TUI

模式 Modes

三种运行模式——与审批系统正交。按 Tab 切换。

Plan 计划

只读调查。可以 grep、读文件、列目录、抓取 URL——不能写入或执行 shell。

Agent 代理

默认模式。多步工具调用。Shell 和有副作用的工具需按 approval_mode 设置审批。

YOLO 全权

自动批准所有操作并启用信任模式。工作区边界解除。请谨慎使用。

工具 Tools

精选工具集——设计思路详见 docs/TOOL_SURFACE.md。

文件操作

read_file · list_dir · write_file · edit_file · apply_patch

搜索

grep_files · file_search · web_search · fetch_url

Shell

exec_shell · exec_shell_wait · exec_shell_interact

Git / 诊断 / 测试

git_status · git_diff · diagnostics · run_tests

子 Agent

agent_spawn · agent_wait · agent_result · agent_cancel · agent_list · agent_send_input · agent_resume · agent_assign

递归 LM

rlm——沙箱 Python REPL，内置 llm_query()/rlm_query() 用于长文本分块处理

MCP

mcp_<server>_<tool>——从 ~/.deepseek/mcp.json 自动注册

审批与沙箱 Approval

模式与审批是两个独立的维度。通过 /config 设置。

suggest · 建议

默认——按模式规则执行。危险操作前询问。

auto · 自动

自动批准所有工具调用。等同于无信任的 YOLO。

never · 拒绝

阻止任何非安全/非只读操作。仅限调查。

沙箱：landlock (Linux)、seatbelt (macOS)、AppContainer / restricted tokens (Windows)。工作区边界默认为 --workspace。/trust 可解除边界限制。

配置 Configuration

# ~/.deepseek/config.toml
[api]
key = "sk-..."
base_url = "https://api.deepseek.com"
model = "deepseek-v4-pro"      # 默认模型；deepseek-v4-flash 用于快速 / 子智能体

[ui]
default_mode = "agent"                      # plan | agent | yolo
approval_mode = "suggest"                   # suggest | auto | never
reasoning_effort = "high"                   # off | high | max

[hooks]
enabled = true
default_timeout_secs = 30

[[hooks.hooks]]
event = "session_start"                     # 也支持: tool_call_before / tool_call_after
command = "~/.deepseek/hooks/pre.sh"        # / message_submit / mode_change / on_error / shell_env

完整参考：config.example.toml。

MCP 服务器 MCP

deepseek 双向支持模型上下文协议（Model Context Protocol）：作为客户端从~/.deepseek/mcp.json 加载服务器，同时也可作为服务器暴露工具（deepseek mcp）。工具以 mcp_<server>_<tool> 形式呈现。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me"]
    },
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "./data.db"]
    }
  }
}

技能 Skills

技能是 ~/.deepseek/skills/<name>/ 下的一个文件夹，根目录包含 SKILL.md。Agent 启动时加载技能名称和描述，在需要时通过 Skill 工具拉取完整内容。

提供商 Providers

使用 deepseek auth set --provider <id> 切换。下表为crates/tui/src/config.rs 中 ApiProvider 枚举的实时投影，目前共 10 个。

DeepSeek

deepseek

DEEPSEEK_API_KEY

DeepSeek (CN)

deepseek-cn

DEEPSEEK_API_KEY

NVIDIA NIM

nvidia-nim

NVIDIA_API_KEY

OpenAI

openai

OPENAI_API_KEY

OpenRouter

openrouter

OPENROUTER_API_KEY

Novita

novita

NOVITA_API_KEY

Fireworks

fireworks

FIREWORKS_API_KEY

sglang

SGLANG_API_KEY

vLLM

vllm

VLLM_API_KEY

Ollama

ollama

OLLAMA_API_KEY

快捷键 Shortcuts

Tab切换模式（Plan / Agent / YOLO）

Shift+Tab切换推理强度

Ctrl+L清屏，保留会话

Ctrl+C取消当前轮次

Ctrl+D退出

/help斜杠命令面板

/config交互式编辑配置

/trust解除本会话的工作区边界

文档 Documentation