dsh-TUI - DeepSeek Harness 终端界面插件
为 DeepSeek Harness 提供 Claude Code 风格的终端 UI，含像素鲸鱼顶栏、实时状态、流式思考和回滚等功能。
- Star 数
- ★ 5.2k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者使用 DeepSeek Harness 在终端中编程，希望在保留功能的同时获得更美观、信息更丰富的界面。
- 不适合
- 只使用 Claude Code、Codex 等其他 Agent 的用户，本插件仅适配 DeepSeek Harness
- 在敏感凭据或不可信仓库旁使用 Windows 默认配置的用户，默认 danger-full-access 且审批为 never
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
dsh-TUI 是一款专为 DeepSeek Harness 设计的 TUI 插件，采用 Claude Code 风格，提供像素鲸鱼顶栏、双流光标题、实时工作状态行、流式思考展开、双击 Esc 时间回溯、蓝白上下文进度条和 TPS 仪表等功能。它通过纯插件方式挂载，无需修改核心，安装启用、卸载无损。插件已被 DeepSeek Harness 官方公众号及 dshfind 目录收录，并曾登上 GitHub Trending 日榜。核心交互包括鼠标/键盘快捷键、图片预览（支持 Kitty/Sixel）、会话管理（/resume、/agentview）、多主题切换以及 VS Code 集成。安装简单，通过 npm 即可一键完成。
安装后，dsh-TUI 作为 DeepSeek Harness 的插件启动，提供完整的终端交互界面。它实时显示工作状态、TPS、缓存命中率、推理等级、token 消耗和 Git/会话信息。支持终端图片显示：在 Kitty或 Sixel 协议下，将用户附图和工具结果渲染为缩略图，点击可查看大图预览并支持缩放、平移、切换。会话管理方面，提供 /resume 列历史会话、/agentview 总览以及 /new、/compact、/export、/btw 命令。模型可热切换，支持 vim 编辑模式、鼠标选区和全屏草稿编辑。权限方面，遵守 DSH profile 的权限设置，不实现独立沙箱。
- 开发者使用 DeepSeek Harness 在终端中编程，希望在保留功能的同时获得更美观、信息更丰富的界面。
- 喜欢 Claude Code 风格界面的用户，想在不更换工具的前提下获得类似体验。
- 需要频繁查看图片附件的用户，比如查看截图或设计图，利用终端图片预览功能。
- 管理多个历史会话的开发者，使用 /resume 和 /agentview 快速切换和操作。
- 对终端美学有要求的极客，想要像素鲸鱼娘等趣味元素。
- 需要与 VS Code 集成的开发者，可以在集成终端中运行 dsh-TUI。
如何安装或部署这个 Agent？
前置条件：安装 Node.js 和 deepseek-harness，并注册 DEEPSEEK_API_KEY。安装命令：npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui。启动：运行 dsh-tui 或 dst。若手动安装，可运行仓库根目录的 install.sh 或使用 dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui。
如何使用这个 Agent？
安装完成后，在终端输入 dsh-tui 或 dst 即可启动。首次使用需确保 DEEPSEEK_API_KEY 已配置。启动后界面会展示开屏动画（像素鲸鱼），点击可交互（如点击冒爱心）。输入 / 可查看命令列表，例如 /resume、/agentview、/new 等。支持鼠标操作，如点击卡片、拖选等。按 Ctrl+Shift+E 进入全屏草稿编辑。快捷键请在 /settings 中查看，或参考 docs/interaction.md。
这个 Agent 有哪些优点和局限？
- 零核心改动，纯插件挂载，卸载不留补丁，安全性高。
- 功能丰富：实时状态、图片预览、会话管理、vim 模式等一应俱全。
- 被 DeepSeek Harness 官方公众号收录，并支持 VS Code Marketplace，获得官方背书。
- 视觉效果出色，像素鲸鱼娘动画带来独特愉悦感。
- 支持多种主题切换和终端图片协议（Kitty/Sixel）。
- 仅适配 DeepSeek Harness，不通用其他模型或工具。
- 需要 Node.js 和 deepseek-harness 环境，并提供 API key，部署依赖较重。
- Windows 下默认权限为 danger-full-access，用户需谨慎配置以保安全。
- 作为第三方插件，稳定性可能受上游 Cordis/DSH 演进影响。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| dsh-TUI - DeepSeek Harness 终端界面插件 当前 | 58 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.2k | 今天 | TypeScript | — |
| wcgw 本地编码终端 | 45 · 缺口较多 | MCP 服务器免费 + 模型费 | ★ 678 | 1 个月前 | Python | Claude.ai |
| DeepSeek Harness for GitHub | 77 · 表现良好 | 聊天机器人免费 + 模型费 | ★ 46 | 今天 | TypeScript | — |
| Codewhale 终端编码助手 | 75 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 41k | 今天 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 明确说明使用 DSH profile 的权限策略，不实现独立沙箱，并警告 Windows 默认 danger-full-access 和 approval never，建议用户检查配置。这体现了最小权限原则的考虑，但具体权限授予由 DSH 控制，插件自身未展示最小权限实现。用户确认方面，提到 approval 策略和 /permission 命令，但未详细说明用户确认流程。数据流透明度：README 提到状态行显示 TPS、缓存命中率等，但未说明数据流向何处。敏感数据处理：提到凭证和不可信仓库环境，但未说明如何处理敏感数据。依赖安全：package.json 列出大量依赖，但未提供安全审计或漏洞报告。外部影响：插件会修改终端显示、可能调用系统看图程序，但未说明具体影响范围。回滚：明确支持双击 Esc 时间回溯和卸载不留核心补丁，但未说明回滚机制细节。来源归属：明确致谢 dsh-ui-whale 作者，但未说明其他代码来源。
证据显示：README 描述功能丰富，但未提供自洽性测试结果。依赖可用性：依赖大量 @deepseek-ai 包，但未说明这些包的可用性。失败消息：提到错误处理如 ERR_PNPM_IGNORED_BUILDS，但未提供用户友好的失败消息示例。
证据显示：README 明确目标用户为 TUI 爱好者，场景包括终端交互、图片预览等。能力边界：说明不预装通用技能，技能归 DSH 管理。触发精度：提到快捷键和命令，但未详细说明触发条件。环境适配：支持 Windows Terminal、Kitty、Sixel 等，但未说明所有环境。
证据显示：信息架构清晰，有文档索引。安装说明详细，包括 npm 和 install.sh。命名稳定：提供 dsh-tui 和 dst 命令。示例和 FAQ：有文档链接，但未提供具体示例。已知限制：在架构文档中提及，但未在 README 中详细列出。许可证：MIT 许可证文件存在。版本变更日志：package.json 有版本号，但未提供 CHANGELOG。维护责任：有社区和 issue 链接，但未明确维护者。
证据显示：输出可用性：提供丰富的终端交互功能，输出格式美观。边际价值：作为插件，提供额外功能，但未与现有工具对比。成本效益：安装简单，但依赖较多，可能增加复杂性。
证据显示：声明可追溯性：README 声称官方收录，但未提供可验证的链接。跨来源佐证：提到 dshfind 和 GitHub Trending，但未提供具体证据。事实与推断分离：README 区分了功能描述和致谢，但部分声明如“官方收录”未明确区分。
- 发布者身份未经验证，需谨慎对待。
- 依赖大量 @deepseek-ai 包，需确认其安全性和可用性。
- Windows 默认权限配置危险，用户需自行收紧。
- README 中的官方收录声明缺乏可验证证据。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.16.1 v0.16.1 — 独立入口启动回归与更新包体修复
发布说明摘录
这是 v0.16.0 的补丁发版，修两个会影响启动和更新体积的问题。 修复 - 独立入口在装有第三方 bundle 的 profile 上启动失败 — #1577 把后端装配放到了延迟根守卫之前。profile 的 dsh.profile.bundles 里有 @deepseek-ai/* 和 dsh-tui 之外的包时，装配会提前解析组合根，根能力守卫立刻装上且撤不掉；DSH 0.2.0-rc.2 的基础行在 ctx.root.accessor('invocation') 处被拒，plugin-manager、llm、commands 等 9 个必需插件无法激活，agent-loop 等不到 llm。现在延迟紧跟在入口绑定根之后，排在装配和内核选择之前，恢复 0.15.0 的守卫时序。([#1598](https://github.com/ccch1mneyyy/dsh-TUI/pull/1598) by @MomentDerek；维护者修复 by @ccch1mneyyy) …在 GitHub 查看 ↗ -
v0.16.0 v0.16.0 — 实验性 Agent Teams、Auto review 与 DSH 0.2.1 适配
发布说明摘录
自 v0.15.0 以来，dsh-TUI 跟进 DSH 0.2.1 版本线，加入实验性 Agent Teams 与 Auto review 权限预设，并继续完善插件安装、Codex/Claude 后端与终端交互。 亮点 - DSH 0.2.1 版本线 — 主适配线升到 0.2.1-rc.2（同时支持 0.2.1-alpha.5、0.2.0-rc.1/rc.2 等已验证版本）；启动时按已装 DSH 报告版本线，契约漂移会在 CI 失败。([#1593](https://github.com/ccch1mneyyy/dsh-TUI/pull/1593)、[#1580](https://github.com/ccch1mneyyy/dsh-TUI/pull/1580) by @CikeSeven) …在 GitHub 查看 ↗ -
v0.15.0 v0.15.0 — 独立入口、原生光标、模型与侧问改版
发布说明摘录
自 v0.14.0 以来，dsh-TUI 有了自己的启动入口，带来重做的模型选择器、终端原生光标动画、任务完成通知、侧问面板改版和跨内核会话预加载。本版同时扩展插件查询命令、发布第一版冻结的插件契约，并补齐启动页图片输入、侧栏拖拽、樱花粉主题、权限记忆与上游断链重试。 升级与行为变化 - 插件命令改名：/plugins 改为 /plugin，本版已移除旧命令，没有保留弃用别名。手动命令、快捷调用和自动化请改用 /plugin，例如 /plugins check … 改为 /plugin check …。（#1504 by @Lucas2011wastaken） - TUI 设置迁移：/settings 的 dsh-tui 分区改存 ~/.dsh-tui/settings.json，DSH、Claude、Codex 共用。首次启动自动导入 profile 补丁和旧 ~/.dsh/settings.yaml 中的可编辑字段；!!js 表达式不导入。旧 profile 中残留的字段仍可能在 DSH 内核下提供部署默认值，建议迁移后清理重复配置。（#1441 by @MomentDerek；#1483 by @ccch1mneyyy） …在 GitHub 查看 ↗