dsh-TUI - DeepSeek Harness 终端界面插件
为 DeepSeek Harness 提供 Claude Code 风格的终端 UI,含像素鲸鱼顶栏、实时状态、流式思考和回滚等功能。
证据显示: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 中的官方收录声明缺乏可验证证据。
这个 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 有哪些优点和局限?
- 零核心改动,纯插件挂载,卸载不留补丁,安全性高。
- 功能丰富:实时状态、图片预览、会话管理、vim 模式等一应俱全。
- 被 DeepSeek Harness 官方公众号收录,并支持 VS Code Marketplace,获得官方背书。
- 视觉效果出色,像素鲸鱼娘动画带来独特愉悦感。
- 支持多种主题切换和终端图片协议(Kitty/Sixel)。
- 仅适配 DeepSeek Harness,不通用其他模型或工具。
- 需要 Node.js 和 deepseek-harness 环境,并提供 API key,部署依赖较重。
- Windows 下默认权限为 danger-full-access,用户需谨慎配置以保安全。
- 作为第三方插件,稳定性可能受上游 Cordis/DSH 演进影响。
如何安装或部署这个 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。