openma-ai/deepseek-harness-tui
272最近提交 2026年8月15日
deepseek-harness-tui DSH 插件
dsh-tui 是一个基于 Rust/ratatui 构建的终端 UI，用于 DeepSeek Harness。它提供实时流式推理、工具调用、subagent 生命周期、token 用量和持久化会话管理。可以作为 dsh profile 插件运行，也可以独立连接 JSON-RPC runtime。
如何安装 deepseek-harness-tui DSH 插件
dsh plugin --profile tui add @openma/deepseek-harness-tui复制不会执行命令。安装 deepseek-harness-tui DSH 插件前请核对仓库和版本。
deepseek-harness-tui DSH 插件数据来源
deepseek-harness-tui DSH 插件快照日期：2026年8月16日
discovered
deepseek-harness-tui DSH 插件能做什么
- 实时 agent 时间线，展示推理、工具调用、插件上下文、subagent 生命周期和 token/cache 指标。
- 多图 prompt：支持从文件、剪贴板或粘贴暂存最多 8 张图片，以可编辑的 [image n] chip 内联在草稿中。
- 高密度工具视图，清晰呈现进行中、成功和失败状态，结果可折叠，长输出拥有独立滚动视窗。
- 适合长对话的控制：可排队 follow-up、打断并立即发送；通过 /new、/resume 和 --session-id 管理持久化 JSONL 会话。
- 跨平台输入体验：readline 编辑、上下文快捷键，macOS 物理 ⌘/⌥ 修复，Linux/Windows ctrl 组合键。
- 终端原生界面：深浅主题、窄屏布局、鼠标选择、剪贴板支持（原生/tmux/OSC 52），以及可选的 kitty graphics protocol 图片预览。
- 斜杠命令菜单：内置命令与 host skills 共享可搜索、可滚动的菜单，通过 / 触发。
deepseek-harness-tui DSH 插件适合哪些场景
- 在终端中与 AI agent 交互，实时查看流式推理和工具调用。
- 调试和监控 agent 行为，包括子 agent 生成、权限提示和 token 用量。
- 管理多图对话，通过内联图片 chip 和预览处理视觉任务。
- 运行持久的 agent 会话，支持 JSONL 存储和会话恢复。
- 在便捷的终端 UI 中开发和测试 DeepSeek Harness 的 skills 和插件。
deepseek-harness-tui DSH 插件适合谁
- 偏好终端界面的 DeepSeek Harness 开发者和高级用户。
- 希望使用键盘驱动的原生 agent UI 的 AI 爱好者，支持流式和工具调用。
deepseek-harness-tui DSH 插件的限制
- 插件模式需要已安装并配置好的 dsh（当前基线 0.1.0-rc.6）以及 Node.js 18+ 和 pnpm 10+。
- 官方包仅覆盖 macOS Apple Silicon、macOS Intel、Linux x64 和 Windows x64；其他平台可能没有原生二进制。
- 独立模式需要单独安装 DeepSeek Harness SDK（Python 虚拟环境）或指定 runtime 二进制路径。
- 图片预览功能（kitty graphics protocol）仅限于兼容终端；其他终端退化为半块字符。
- 该插件仍处于早期开发阶段（版本 0.2.x），某些功能可能不稳定或会发生变化。
deepseek-harness-tui DSH 插件的仓库 README 摘录
以下文字摘自 deepseek-harness-tui DSH 插件的上游仓库 openma-ai/deepseek-harness-tui 的 README，版权归原作者，仅作引用。
在终端里运行 DeepSeek Harness：流式推理、工具调用、Skills、多图 prompt 与持久会话。 </p> <p align="center"> <a href="README.md">中文</a> · <a href="README.en.md">English</a> </p> <p align="center"> <a href="https://www.npmjs.com/package/@openma/deepseek-harness-tui"><img src="https://img.shields.io/npm/v/%40openma%2Fdeepseek-harness-tui?logo=npm&color=cb3837" alt="npm version" /></a> <a href="https://www.npmjs.com/package/@openma/deepseek-harness-tui"><img src="https://img.shields.io/npm/dm/%40openma%2Fdeepseek-harness-tui" alt="npm downloads" /></a> <a href="https://github.com/openma-ai/deepseek-harness-tui/actions/workflows/package-npm.yml"><img src="https://github.com/openma-ai/deepseek-harness-tui/actions/workflows/package-npm.yml/badge.svg" alt="CI" /></a> <img src="https://img.shields.io/node/v/%40openma%2Fdeepseek-harness-tui" alt="Node.js 18+" /> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT" /></a> </p> --- `dsh-tui` 是 DeepSeek Harness 的终端原生 agent UI：在一个 Rust/ratatui 界面里查看流式推理、工具调用、subagent、token 用量和持久化会话。它既可以 作为官方 `dsh` profile 插件运行，也可以直接连接 SDK JSON-RPC runtime。  ## 快速开始 #
阅读完整 README仓库许可: MIT
deepseek-harness-tui DSH 插件常见问题
如何将 dsh-tui 作为 DSH 插件安装？
首先确保已安装 dsh（基线 0.1.0-rc.6 或更高版本）以及 Node.js 18+ 和 pnpm 10+。然后运行 `dsh plugin --profile tui add @openma/deepseek-harness-tui`，接着运行 `dsh --profile tui`。插件会挂载 TUI 二进制并连接到你的 dsh profile 的 agent、工具和 provider。
可以在没有 API key 或 runtime 的情况下试用 dsh-tui 吗？
可以。你无需 API key 或 runtime 即可运行演示模式。全局安装包：`npm install --global @openma/deepseek-harness-tui`，然后运行 `dsh-tui --demo`。演示会模拟对话以展示 UI 功能。
支持哪些平台？
官方 npm 包包含 macOS Apple Silicon (darwin-arm64)、macOS Intel (darwin-x64)、Linux x64 和 Windows x64 的原生二进制。如果看到 'no native binary for ...' 错误，说明你的平台可能不受支持。你可以通过 Rust stable 和 Node.js 18+ 从源码构建。
如何在插件模式和独立模式之间切换？
插件模式是通过 `dsh plugin` 安装并使用 `dsh --profile tui` 运行时的默认模式。独立模式是直接运行 `dsh-tui`（不带 dsh）。在独立模式下，你需要 DeepSeek Harness SDK runtime（Python venv）或通过 `--runtime-bin` 或 `DSH_RUNTIME_BIN` 指定 runtime 二进制。会话目录也不同：插件模式使用 `~/.dsh/sessions`，独立模式使用 `~/.dsh-tui/sessions`。
有哪些键盘快捷键？
快捷键在 README 中有详细说明。常用快捷键：Enter 发送，Ctrl+X 打断并立即发送下一条，Esc 打断（保留草稿），Ctrl+C 清空草稿再打断。斜杠 `/` 打开命令菜单。Readline 编辑：Ctrl+A/E 行首/尾，Ctrl+K/U 删除到行尾/行首，Ctrl+W 删除单词。macOS 还支持物理 ⌘←/→ 和 ⌥←/→。在 TUI 中运行 `/keys` 可查看完整列表。