DEEPSEEK HARNESS TUI v0.39.0 macOS

不离开终端,
把活干完。

fx-tui 是 DeepSeek Harness 的终端界面。一个 fx 命令,接着你正在用的 shell、项目目录和快捷键——模型就在你敲命令的地方读代码、跑测试、改文件。

审批长在命令下方 ! 命令直通,输出自动进上下文 退出净屏,fx --resume 续上
界面示意 · 按 v0.39.0 的真实渲染复刻,非截图 TERMINAL · 1440 × 900
01它解决什么

代码在终端里,
聊天不该在另一个窗口。

编码 agent 的回答已经够长,但你真正要跑的命令、要看的报错、要确认的权限,全在终端里。把两边接起来,比多开一个窗口更省事。

BEFORE以前
  • 浏览器里聊代码,终端里跑命令——两边对不上
  • 报错复制出来,再粘进对话框
  • 审批弹到网页上,回来忘了自己刚才在干嘛
  • 一条长命令就把对话冲出屏幕
  • 关掉窗口,会话就断在那里
AFTER现在
  • 模型就在同一块屏幕、同一个工作目录里
  • ! 跑完,输出自动跟着下一条消息进上下文
  • 审批卡片长在命令下面,按一个键
  • 工具卡默认一行,Ctrl+O 才展开全文
  • 退出即净屏,fx --resume <id> 原样续上
02一次回合

从敲下 fx,
到明天接着聊。

四步都发生在同一个终端里:没有切换,没有复制粘贴,也没有「刚才那步」的回忆成本。

01

起

fx 启动:横幅钉在顶缘、输入框钉在最后一行,中间空白是弹性的;会话不满一屏也不滚动。

02

说

多行输入、@ 引用工作区文件、/ 唤命令与技能、从 Finder 拖图或 Ctrl+V 贴截图。

03

干

工具调用是一行卡,审批按 y/s/a/n;跑到一半想改方向,Enter 注入当前轮、Tab 排队下一轮。

04

收

/export 导出 Markdown 时间线;退出时清屏并打印恢复提示,明天 fx --resume 接着聊。

03shell 直通

先跑,再问。
结果它自己看得见。

输入 !npm test,命令在你自己的 shell 里执行,不经过模型、也不触发回复。输出自动暂存进输入框上方的托盘,随你下一条消息进入上下文——所以你只要打「怎么修」,它已经看过报错了。

  • 不惊动模型。! 是本地 shell;退出码、耗时、输出头尾原样成卡,!! 只给你自己看。
  • 输出会跟着你走。暂存块随下一条消息进上下文,头尾各截断到 8KB;空输入框 ⌫ 撤销最后一条、⌥⌫ 清空。
  • 有兜底。超过 10 分钟连同进程树一起杀掉;命令进 ↑ 历史;首词补 PATH 命令名,其余补真实路径。
SHELL PASS-THROUGH
跑一条,再问一句
示意
!npm test
● bash npm test 2.4s · exit 1 · 输出 38 行
🧾 暂存 · npm test 输出38 行 · 头尾截断 8KB
这个报错怎么修
托盘里的输出随这条消息一起进入上下文,不需要复制粘贴。
04审批

不弹窗,
也不等于放行。

审批卡片就长在命令下面:y 允许一次、s 本会话不再问、a 总是允许、n 拒绝。选过的同类动作按语义签名记住——bash 按命令原文、文件工具按路径,a 才写进本地 allowlist。

  • 默认「自动允许」。工具调用不逐个询问;想恢复逐次确认,/config permission ask 写进启动默认,或 Shift+Tab 只切当前会话。
  • 模式看得见。输入框下方一直显示当前权限模式,不用猜这次会不会问你。
  • 记忆是本地文件。$DSH_HOME/fx-tui-allowlist.json,删掉即清空全部「总是」授权。
APPROVAL
沙箱升级时的一次确认
示意
◆ 需要授权 · bash
rm -rf node_modules/.cache
沙箱升级:要写工作区之外的路径
y 允许一次 s 本会话不再问 a 总是允许 n 拒绝
同样的命令下次直接放行;换一条命令,就再问一次。
05转录收纳

屏幕只有一屏,
长输出得学会折叠。

命令卡默认一行:命令截断、耗时、退出码、输出行数都在,完整命令与全文收进 Ctrl+O 面板。思考默认一行摘要,Ctrl+T 实时尾随、定稿内联、空闲时把上一步全文打成面板。

  • 默认单行。长管道命令不再把转写冲出视口;要看全文再展开,不是一开始就铺满。
  • 一个键一层。Ctrl+O 工具详情、Ctrl+T 思考、Ctrl+R 注入的隐藏上下文。
  • 状态栏是心跳。spinner、思考字数、token 与缓存命中、输出速度、上下文水位(≥80% 琥珀、≥95% 红)、推理等级、重试可视化。
  • 窄终端先降级,不先乱。先丢推理等级、再丢用量,上下文水位永远保留。
TRANSCRIPT
折叠态与展开态
示意
● bash pnpm test --filter store 2.4s · exit 1 · 输出 38 行
✻ 思考:先看失败用例 · 6.2s · 1,284 字 Ctrl+T
● read src/store.ts 214 行
Ctrl+O · 完整输出
$ pnpm test --filter store
FAIL src/store.test.ts > thinking > 结算用时
expected 1284 to be 1280
… 35 more lines
● 就绪上下文 12%32 tok/s
06还有一些

主卖点之外,
天天会用的那几件。

不是功能清单,是三个月后你还会按的那几个键。

/btw 侧问

复用当前上下文做一次无工具单轮提问:不写会话历史、不计 token、不打断正在跑的回合,答案以面板呈现。

/theme 主题

内置浅/深,外带 14 款 Ghostty 热门主题;启动时探测终端背景色自动选深浅,界面 chrome 始终是品牌 teal。

/update 自我升级

在 TUI 里完成 fetch → 快进合并 → 装依赖 → 重建;脏工作区先拦,只快进、不产生 merge 提交。

还有 /sessions 活体切换会话、/doctor 逐项环境自检、/context 上下文明细、/image 附加图片,以及 @ 文件补全和技能菜单——都在 /help 里。

07界面

它借了终端的壳,
没跟终端抢戏。

fx-tui 没有自己的窗口,也不接管你的终端配置:主屏保留 scrollback,历史可搜索、可复制,退出时再把屏幕擦干净。

  • 钉顶钉底。启动横幅钉在顶缘、输入框钉在最后一行,中间的空白是弹性的——会话不满一屏也零滚动。
  • 颜色分两个域。界面 chrome(横幅、边框、状态)固定品牌 teal-cyan;代码、diff、markdown 跟随所选主题。
  • 主题不换 app。14 款主题只染内容,不染 chrome——换来换去还是同一个工具。
  • 该降级就降级。窄终端先截断事实值、再隐藏 logo;状态栏先丢推理等级,再丢用量。
fx-tui 在 macOS 终端里的启动画面:FX ASCII 横幅、模型与版本信息、状态栏、输入框和自动允许模式提示
实际界面 · 启动画面(仓库内 v0.9.0 截图) 1448 × 1642
08安装

三件事,
然后就有 fx 了。

只支持 macOS,需要 Node.js 与 dsh CLI。装完第一次启动会看到横幅与「自动允许」模式提示——那是默认值,不是唯一选择。

1

备齐运行时

Node.js ≥ 24.9.0、pnpm,以及 dsh CLI 本体(0.2.2-rc.1 或更高)——没有它 fx 无法启动。DeepSeek API key 写进 ~/.dsh/.credentials.yaml。

node -v && pnpm -v && dsh --version
2

两条命令,从 npm 装

dsh-tui-fx 已发布到 npm;dsh plugin 是官方树外插件机制,会自动把它登记进 fx profile 的 bundles。npm 包页 · 源码安装见安装指南。

npm install -g dsh-tui-fxdsh plugin --profile fx add dsh-tui-fxfx
3

或者交给终端 agent

把这句话复制给 Claude Code、ZCode 等编码 agent,它会读安装指南、装好并验证。

请读取 https://raw.githubusercontent.com/xianglifei/dsh-tui-fx/main/docs/install.md,严格按其中的步骤帮我把 fx-tui 完整装好并验证可用;任何一步失败就停下,把错误原文完整告诉我,不要自行猜测或跳过。
09边界

它不假装
什么都能做。

以下每一条都能在 README、安装指南或代码里找到出处。装之前先看清楚,比装完再踩坑省时间。

LIMIT 01

只有 macOS

开发和验证都在 macOS 上完成。Windows 适配调研过但暂缓,暂时请用 dsh 自带的 Web UI。

LIMIT 02

不是独立应用

必须先有 dsh CLI 运行时和 DeepSeek API key。peer 依赖精确锁在 dsh 的 0.2.2-rc.1;版本对不上时 dsh 会打印一行 warning 并跳过整个 bundle——fx 进去没有界面,升级 dsh 时请同步升级 fx-tui。

LIMIT 03

默认自动允许

装完工具调用不逐个询问。请自己判断:Shift+Tab 切到逐次确认,或 /config permission ask 写进默认。

LIMIT 04

没有图形面板

它是终端界面:图片可以输入给模型,但不在终端里渲染预览;文档、表格也没有可视化视图。

LIMIT 05

自动更新要重启

后台更新只在启动约两分钟后检查、每 24 小时最多联网一次;新版本落盘后,当前进程仍是旧代码。

LIMIT 06

审批记忆不是安全边界

「总是允许」是本地 JSON,按命令原文/路径匹配,不区分项目、不加密;删文件即清空,别把它当权限系统。

GET STARTED

下一轮,
就在终端里开。

装好之后,敲一个 fx。剩下的活,它就在你旁边干。

本地运行NODE ≥ 24.9.0macOSMIT