本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

deepseek-harness-tui

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:openma-ai/deepseek-harness-tui

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Rust/ratatui 编写的高性能程序界面.
• 100% 基于Deepseek Harness官方AI能力.
• 完整的 agent 时间线：实时呈现推理、回复、工具参数与结果、plugin 上下文、
• ACP 能力原生接入：读取 agent 广告的模型、composition、权限、认证方式和
• 多图 prompt：从文件、剪贴板或粘贴操作暂存最多 8 张图片，图片以可编辑的

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好后还需要额外配置吗？

不需要。安装命令会自动创建 profile 并把 TUI、ACP 依赖一并装上，直接 dsh --profile tui 就能用；只有调试本地 Rust 编译产物时才需要 DSH_TUI_BIN 环境变量。

没装 DSH Harness 也能跑吗？

可以。独立入口 dsh-tui 可以 --agent dsh-acp 或 --agent dsh --agent-arg --profile --agent-arg acp 接任意支持 ACP 协议的 agent；--demo 模式则不需要任何 agent 或 API key 就能看 UI。

支持哪些操作系统？

macOS（arm64 / x64）、Linux（arm64 / x64）、Windows（x64）。Linux x64 包从 0.2.x 起改为静态 musl 链接，能直接在老发行版（如 Ubuntu 20.04）上跑，不需要 glibc 兼容层。

不支持 DSH 私有扩展的 ACP agent 也能用吗？

可以。当 agent 在 initialize 的 _meta.dsh.cordis 里没声明该扩展时，TUI 只走标准 ACP（prompt、session、auth、update），不会出现兼容性问题。

输入框旁边的小难梁宠物不显示怎么办？

只有 Ghostty、Kitty、WezTerm 等支持 kitty graphics protocol 的终端才会显示 RGBA 像素精灵；其他终端退回半块字符鲸鱼，且宽度低于 60 列时会自动隐藏。主界面功能不受影响。

怎么卸载？

通过 dsh plugin --profile tui remove @openma/deepseek-harness-tui 即可，会同时撤销 profile 里的 TUI bundle 与配套的 ACP/Host rows。

报 spawn dsh-acp ENOENT 怎么办？

没找到默认 agent 二进制。可以装 DSH 官方 ACP 客户端（dsh-acp），或者用 --agent 显式指向另一个 ACP server，例如 --agent <其它 ACP 命令>。

安装包提示 no native binary for ... 怎么办？

当前安装版本没覆盖你的平台（darwin-arm64/x64、linux-arm64/x64、win32-x64 之外）。确认装的是最新版，或在本地跑 scripts/build-npm.sh 自己编译打包。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=18
• Platforms: macOS-arm64, macOS-x64, Linux-arm64, Linux-x64, Windows-x64

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则