涌现 DeepSeek TUI (Emergence DeepSeek TUI)

在您的智能体工作流中使用 DeepSeek TUI CLI (v0.8.16) 作为代码助手。本技能教导 OpenClaw / Hermes 智能体如何通过两种模式将编程任务委派给 DeepSeek。

版本信息

deepseek (npm 封装) v0.8.16
二进制版本: v0.8.16
代码仓库: https://github.com/Hmbown/DeepSeek-TUI.git

安装方式：

• Homebrew: brew install hmbown/tap/deepseek-tui
• npm: npm install -g deepseek-tui

两种运行模式

DeepSeek TUI 具有两种本质不同的模式，每种模式具有不同的能力：

模式 1：deepseek exec — 无头模式（智能体委派）

deepseek exec <PROMPT> 以纯文本输入/输出模式调用 DeepSeek API。模型可能会在 思维链 (CoT) 输出中生成工具调用语法（例如 <function_calls><invoke name="list_files">），但这些永远不会被实际执行 —— 它们仅作为模型推理文本的一部分显示。没有文件系统访问权限，也没有工具执行能力。

┌─────────────────────────────────────┐
│  您的智能体 (Hermes/OpenClaw)       │
│  ┌───────────────────────────────┐  │
│  │ 1. 读取文件 (理解)            │  │
│  │ 2. 构建带有上下文的提示词    │  │
│  │ 3. deepseek exec "<prompt>"   │  │
│  │ 4. 验证输出                  │  │
│  │ 5. 应用更改                  │  │
│  └───────────────────────────────┘  │
└─────────────────────────────────────┘

您必须在提示词中提供所有文件上下文 —— DeepSeek exec 模式对文件系统完全处于“盲视”状态。

模式 2：deepseek run — 交互模式（直接编程）

deepseek run 启动具有实际工具调用能力的完整 TUI：

• list_files — 浏览目录
• read_file — 读取文件内容
• write_file / edit_file — 修改文件
• terminal / bash — 执行 shell 命令
• grep / search — 搜索代码库
• 以及更多...

在工作区目录中调用时，它可以读取整个项目。适用于您希望 DeepSeek 自主探索、编辑和构建的直接编程会话。

如何使用（无头 Exec 模式）

步骤 1 — 首先理解代码库

在调用 DeepSeek 之前，先由您自己读取所有相关文件。您需要了解：

• 现有的模式和规范
• 所用组件的接口、类型和签名
• 精确的插入点和文件结构

DeepSeek exec 无法看到您的文件系统，因此 您必须在提示词中提供上下文。

步骤 2 — 构建精简的提示词

不要倾倒整个文件。按以下结构组织您的提示词：

[关于项目的一行背景说明]
[正在使用的组件接口]
[现有使用模式的示例]
[编号的修改清单 —— 具体且可操作]
[重要的约束条件]

步骤 3 — 调用 DeepSeek

# 选项 A：从文件管道输入
deepseek exec "$(cat /path/to/prompt.txt)" 2>&1

# 选项 B：内联输入（较短的提示词）
deepseek exec "在首页添加一个显示 '点我' 的蓝色按钮。" 2>&1

步骤 4 — 验证输出

DeepSeek 的无头模式可能会在响应中显示工具调用，将其作为模拟推理文本 —— 请忽略这些。实际输出是文本内容。需注意以下情况：

步骤 5 — 自行应用更改

使用针对性的文件编辑工具（如 patch 或 write_file），仅应用已确认的片段。永远不要盲目信任 exec 模式输出的完整文件内容。

步骤 6 — 构建与验证

cd /path/to/project
npm run build  # 或 npx next build, cargo build 等

如何使用（交互式 Run 模式）

当您希望 DeepSeek 直接探索和编辑文件时：

cd /path/to/project
deepseek run

或者直接传递目标：

deepseek run "添加一个类似于悬赏页面的 CommandBlock 到技能页面"

在此模式下，DeepSeek 拥有完整的工具访问权限，可以自主读取/写入文件、搜索并执行命令。这就是用户发现的“它会读取当前工作区中的所有文件”的模式。

最佳实践

1. 委派用 exec，自主用 run —— 如果您拥有自己的读取文件工具并希望进行严格控制，请使用 exec。如果您希望 DeepSeek 自行探索并解决问题，请使用 run。
2. 在 exec 模式下保持外科手术般的精确 —— 告诉 DeepSeek 精确的行号、锚点注释和导入路径。
3. 通过构建进行验证 —— 在应用 DeepSeek 的输出后，始终进行编译/类型检查。
4. 使用针对性编辑 —— 优先使用 patch（查找并替换）而非重写整个文件。
5. exec 模式下的提示词保持在 10KB 以下 —— 过长的提示词可能会降低输出质量；如有需要，请拆分为多个调用。
6. exec 模式将工具调用显示为文本 —— 不要被误导。exec 输出中的 <function_calls> 块是模拟推理，而非实际执行。

真实案例

在一个真实的会话中，DeepSeek exec 生成了代码，为涌现科学 (Emergence Science) 的技能详情页添加了 CommandBlock 安装组件：

1. 读取现有的悬赏页面以理解 CommandBlock 模式。
2. 读取目标技能页面以找到插入点。
3. 构建提示词，包含：CommandBlock 接口、现有使用示例、精确的插入指令。
4. 运行 deepseek exec → 获得了确认的导入和 JSX 片段（输出中包含模拟工具调用）。
5. 使用 patch 应用更改，使用 npx next build 构建 → ✅ 顺利通过。

故障排除