这几天,GitHub 上一个小项目突然被中文 AI 圈围观。
项目名叫 DeepSeek-TUI。
先解释一下,TUI 是 Terminal User Interface,可以理解成“终端里的可视化界面”。
所以 DeepSeek-TUI 大白话讲就是:
一个跑在终端里的 DeepSeek 编程智能体。
它不是 DeepSeek 官方项目,而是开发者 Hunter Bown 做的开源工具。项目 README 也明确写着:它和 DeepSeek Inc. 没有关联。
但它有意思的地方在于:
它不是把 DeepSeek 接到一个普通聊天框里。它是让 DeepSeek 模型直接进入你的项目文件夹,能读文件、改文件、跑命令、查网页、管理 Git、调用子智能体,还能通过终端界面实时显示过程。项目中文 README 里也写到,它可以让 DeepSeek 前沿模型直接访问工作区,完成读取编辑文件、运行 shell 命令、网页搜索、Git 管理、调度子智能体等任务。
这就很像 Claude Code、Codex、Cursor 那类工具,只不过它围绕 DeepSeek 模型做了一套终端工作流。
一、这个项目为什么突然有热度?这件事本身还有个小插曲。
作者 Hunter Bown 在 X 上发中文求助,说自己是做 DeepSeek-TUI 的美国人,很想和国内的 DeepSeek 用户一起交流,但中文能力有限,微信也没搞定。
他还用一种很努力、但有点机器味的中文写了句:
“鲸鱼兄弟们好……”
结果中文区网友先是被这个称呼逗乐了。
有网友吐槽:“笑死,才反应过来鲸鱼兄弟啥意思。”
也有人指出:这大概是把 “whale bros” 之类的网络称呼硬翻过来了。
这个段子好笑的地方在于:
作者是真想进入中文社区。DeepSeek 也确实帮他把英文润色成了中文。但 AI 翻译一不小心,就把“亲切感”翻成了“海洋生物团建”。
不过也正因为这个小插曲,项目被更多人看到。
项目 Star 曲线在 5 月前后突然拉升。GitHub 仓库已经显示约 2.5k Star、146 Fork,而且侧栏显示最新版本为 v0.8.8,发布时间是 2026 年 5 月 4 日。
一个外国开发者做了个 DeepSeek 终端工具,想找中文用户反馈,结果先因为“鲸鱼兄弟”被中文圈记住了。
这件事其实挺有互联网味。
二、DeepSeek-TUI 到底能做什么?简单说,它是一个面向 DeepSeek V4 的终端编程智能体。
项目中文 README 里写到,它面向 deepseek-v4-pro 和 deepseek-v4-flash 构建,默认支持 100 万 token 上下文窗口 和原生思考模式流式输出。
这几个词拆开讲:
100 万 token 上下文,就是它能塞进去很长的项目内容、文件信息和对话历史。
思考模式流式输出,就是模型推理过程会在终端里一边跑一边显示。
工具调用,就是它不只会聊天,还能真的操作项目。
它能做的事包括:
读项目文件;编辑文件;运行终端命令;搜索网页;管理 Git;打补丁;调度子智能体;连接 MCP 工具;保存和恢复会话;做成本统计;在任务前后保存快照,必要时回滚。
所以你不能把它理解成:
“终端版 DeepSeek 聊天窗口。”
更准确地说,它是:
让 DeepSeek 在你的本地项目里干活的一套终端工作台。
三、它和 Claude Code、Codex 有什么区别?这篇可以这样讲。
Claude Code 强在 Claude 自家模型和项目执行体验。Codex 强在 OpenAI 生态、云端任务、目标工作流。Cursor 强在编辑器体验和本地开发环境。Hermes、OpenClaw 更偏多智能体和个人工作台。
DeepSeek-TUI 的特点很直接:
它围绕 DeepSeek V4 模型做优化。
它不是一个“什么模型都随便接”的通用壳子。
README 里明确写到,它默认面向 DeepSeek V4 模型,并列出了 deepseek-v4-pro、deepseek-v4-flash 等模型、上下文和成本信息。
这就给它一个很清楚的位置:
如果你平时就想用 DeepSeek 做编程任务,又不想每次都绕一层别的工具,这个项目就值得看。
尤其是它已经支持:
Plan 模式;Agent 模式;YOLO 模式;Skills;MCP;会话恢复;工作区回滚;成本跟踪;中文界面切换。
这些都是现在 Agent 工具里很关键的能力。
四、最值得关注的 5 个功能1. Plan 模式:先看项目,再动手DeepSeek-TUI 有三种模式:
Plan:只读探索,先分析和拆计划;Agent:默认交互模式,带审批;YOLO:可信工作区内自动批准工具。
这点很重要。
很多 Agent 工具翻车,不是因为不会写代码,而是太急。
一上来就改文件。改完才发现需求没问清。最后项目被改得一团乱。
所以第一次用 DeepSeek-TUI,我建议先用 Plan 模式。
可以这样问:
请先分析当前项目。告诉我这个项目是做什么的、入口文件在哪里、怎么运行、如果要改功能应该先看哪些文件。先不要修改任何文件。
等它说清楚计划,再让它执行。
2. 终端里直接操作项目DeepSeek-TUI 可以读写文件、执行 shell 命令、管理 Git。
这意味着它不是只给建议。
它可以真的帮你改项目。
比如你可以问:
请检查当前项目启动失败的原因。先读 README,再看 package.json 或 Cargo.toml。不要直接删除文件。
它可以自己查看文件、运行命令、总结问题。
但这里也要提醒:
能操作项目,就代表有权限风险。
第一次不要开 YOLO。
尤其不要在重要项目里直接让它自动执行全部命令。
3. 支持 100 万上下文DeepSeek-TUI 默认面向带 100 万 token 上下文窗口的 DeepSeek V4 模型。
这对项目分析很有意义。
因为很多真实项目不是一个文件。
它可能有:
README;配置文件;前端文件;后端文件;测试文件;日志;Git 记录;历史会话。
上下文越大,模型越有机会看完整。
当然,上下文大不等于一定做得好。
但对于“理解整个项目”这类任务,它有天然优势。
4. Skills:把常用流程做成技能DeepSeek-TUI 也支持 Skills。
项目文档里写到,它会从工作区 .agents/skills、当前目录 ./skills、以及全局目录 ~/.deepseek/skills 发现技能;每个技能目录里放一个 SKILL.md 文件。你可以用 /skills 列出技能,用 /skill 激活技能,也可以用 /skill new 创建技能。
这对我们之前写过的 Skill 工作流很关键。
比如你可以给它做一个“交付前检查”技能:
检查功能是否真的可用;检查边界输入;检查是否泄露 API Key;检查是否需要 README;检查怎么运行和验收。
以后每次做完项目,不用重复复制一大段提示词。
直接调用 Skill。
5. 中文界面已经能切换这个点和作者的小插曲刚好呼应。
DeepSeek-TUI 的中文 README 里写到,如果界面是英文,可以在 TUI 里输入 /config,进入配置面板,把 locale 改成 zh-Hans;也可以在 ~/.deepseek/settings.toml 里设置 locale = "zh-Hans"。
这说明作者确实在重视中文用户。
虽然“鲸鱼兄弟”那句翻译有点喜感,但项目本身已经开始认真做中文使用体验了。
五、怎么安装?最简单的安装方式是 npm:
npm install -g deepseek-tui
然后启动:
deepseek
这是 README 里的快速开始命令。
第一次启动时,它会提示你输入 DeepSeek API Key,并保存到:
~/.deepseek/config.toml
这样以后从任意目录启动都能读到。
你也可以提前配置:
deepseek auth set --provIDEr deepseekdeepseek
检查它到底有没有读到配置:
deepseek doctor
如果你不想保存到配置文件,也可以用环境变量:
export DEEPSEEK_API_KEY="YOUR_DEEPSEEK_API_KEY"deepseek
不过 zsh 用户要注意,如果你希望脚本、IDE 终端也能读到环境变量,README 里提醒要区分 ~/.zshrc 和 ~/.zshenv。
六、如果国内 npm 或 GitHub 慢怎么办?这正好呼应作者在 X 上说的那句:
“作为交换,我发誓死守 cargo install 这条安装路径,绝不让任何一个兄弟受 npm 的苦。”
项目 README 里确实写了“中国大陆 / 镜像友好安装”路线。
如果 GitHub 或 npm 下载慢,可以配置清华 TUNA 的 Cargo 镜像:
# ~/.cargo/config.toml[source.crates-io]replace-with = "tuna"[source.tuna]registry = "sparse https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"
然后安装两个包:
cargo install deepseek-tui-cli --lockedcargo install deepseek-tui --lockeddeepseek --versiondeepseek doctor --json
这里要注意:两个包都要装。
deepseek-tui-cli 提供推荐入口 deepseek。deepseek-tui 提供交互式 TUI 运行时。
这点很重要。
只装一个,可能会运行失败。
七、常用命令速查启动交互界面:
deepseek
一次性提问:
deepseek "explain this function"
指定模型:
deepseek --model deepseek-v4-flash "summarize"
保存 API Key:
deepseek auth set --provider deepseek
检查配置和连接:
deepseek doctor
机器可读诊断:
deepseek doctor --json
查看安装状态:
deepseek setup --status
创建本地工具和插件目录:
deepseek setup --tools --plugins
列出可用模型:
deepseek models
列出保存会话:
deepseek sessions
恢复最近会话:
deepseek resume --last
启动 HTTP/SSE 服务:
deepseek serve --http
列出 MCP:
deepseek mcp list
校验 MCP:
deepseek mcp validate
启动 MCP stdio server:
deepseek mcp-server
这些命令都在项目中文 README 的使用方式里列出。
八、几个快捷键也很实用终端工具好不好用,快捷键很关键。
DeepSeek-TUI 里常用这些:
Tab 补全 / 或 @;运行中可把草稿排队Shift Tab 切换推理强度:off → high → maxF1 帮助Esc 返回 / 关闭Ctrl K 命令面板Ctrl R 恢复旧会话Alt R 搜索提示历史和恢复草稿@path 附加文件或目录上下文Alt ↑ 编辑最后一条排队消息
README 里也列出了这些快捷键。
这里最值得记住的是三个:
Ctrl K:命令面板。Ctrl R:恢复旧会话。@path:把文件或文件夹加到上下文里。
九、中文界面怎么开?如果你装完以后界面还是英文,可以在 TUI 里输入:
/config
然后找到 locale,把它改成:
zh-Hans
也可以直接改配置文件:
locale = "zh-Hans"
配置文件通常在:
~/.deepseek/settings.toml
可选语言包括:
autoenjazh-Hanspt-BR
项目中文 README 里也写到,UI 语言和模型输出语言是分开的;也就是说,界面可以是中文,模型回答也可以按你的提示来。
这点对中文用户很友好。
十、它适合谁?这类工具适合几类人:
第一,已经在用 DeepSeek API,希望把 DeepSeek 用到本地项目里的人。
第二,喜欢终端操作,不想打开一堆网页和编辑器的人。
第三,想找 Claude Code、Codex、Cursor 之外的 DeepSeek 原生路线的人。
第四,愿意折腾 npm、Cargo、API Key、终端配置的人。
第五,想研究 Agent 工具怎么围绕单个模型做深度优化的人。
它不太适合这些人:
完全不想碰终端;没有 DeepSeek API Key;只想聊天,不想做项目;不愿意理解权限风险;看到报错就不想继续。
如果你只是想随便问两句 DeepSeek,网页端就够了。
如果你想让 DeepSeek 进入项目现场,DeepSeek-TUI 才有意义。
十一、一定要注意:它不是官方 DeepSeek这点要单独说。
DeepSeek-TUI 是开源社区项目。
README 里明确写了它不隶属于 DeepSeek Inc.。
所以你要清楚:
它需要你的 DeepSeek API Key;它能操作本地文件;它能执行 shell 命令;它能接 MCP;它能改项目。
这些能力很强,也意味着要谨慎。
第一次使用建议:
先在测试文件夹里试;先用 Plan 模式;不要一上来 YOLO;不要给它真实生产项目;不要把 API Key 放进项目文件;不要让它随便执行删除命令。
可以先这样问:
请先分析当前项目,不要修改文件。告诉我你准备看哪些文件、可能需要运行哪些命令、风险是什么。我确认后再继续。十二、最小测试路线
如果你想试,建议按这个顺序:
第一步,安装:
npm install -g deepseek-tui
第二步,启动:
deepseek
第三步,配置 Key:
deepseek auth set --provider deepseek
第四步,检查:
deepseek doctor
第五步,找一个测试文件夹:
mkdir deepseek-tui-testcd deepseek-tui-testecho "# Test Project" > README.mddeepseek
第六步,让它只读分析:
请先阅读当前文件夹,告诉我这里有什么。不要修改文件。
第七步,再让它创建一个最小文件:
请创建一个 index.html,只显示一句“DeepSeek-TUI 测试成功”。创建前先告诉我你会改哪个文件。
第八步,看它有没有按你的要求来。
第一次不用做大项目。
先确认它能启动、能读目录、能按权限工作、能让你看懂过程。
十三、这篇真正值得讨论的地方DeepSeek-TUI 的爆点,不只是一个外国开发者写中文求助,也不只是“鲸鱼兄弟”这个段子。
真正值得关注的是:
DeepSeek 生态开始出现更多围绕模型原生能力打造的 Agent 工具。
以前很多工具都是:
先做一个通用 Agent 壳子;再把不同模型接进去;DeepSeek 只是其中一个选项。
DeepSeek-TUI 的思路更直接:
我就围绕 DeepSeek V4 来做。我就针对它的大上下文、推理流、成本结构、工具调用来设计终端体验。
这会带来一个新的问题:
未来的 AI 编程工具,会不会分成两类?
一类是通用工具:什么模型都能接。一类是模型原生工具:围绕某个模型的特点深度优化。
Claude Code 是 Claude 原生路线。Codex 是 OpenAI 原生路线。DeepSeek-TUI 也许是在试探 DeepSeek 原生路线。
这才是这个项目真正有意思的地方。
最后说一句DeepSeek-TUI 现在还很年轻,版本更新也很快。
但它已经有几个明显亮点:
终端原生;面向 DeepSeek V4;支持 100 万上下文;有 Plan / Agent / YOLO 三种模式;有 Skills;有 MCP;有会话恢复;有工作区回滚;有中文界面;还认真补了国内镜像安装路线。
再加上作者在 X 上那段“鲸鱼兄弟”式求助,项目突然有了点社区故事感。
如果你已经在用 DeepSeek API,又想试试本地编程 Agent,这个项目可以收藏。
最小命令就三条:
npm install -g deepseek-tuideepseek auth set --provider deepseekdeepseek
如果 npm 不顺,就走 Cargo 镜像路线:
cargo install deepseek-tui-cli --lockedcargo install deepseek-tui --lockeddeepseek --version
最后提醒一句:
先 Plan。再执行。别上来 YOLO。API Key 别乱放。重要项目先备份。
至于“鲸鱼兄弟”这个称呼,倒也不用太较真。
有时候,一个项目被看见,正是从一句不太完美的中文开始的。
相关文章









猜你喜欢
成员 网址收录40418 企业收录2986 印章生成263660 电子证书1157 电子名片68 自媒体107542