ccch1mneyyy/dsh-TUI

dsh‑TUI – DeepSeek Harness 的 Claude 风终端 UI

是什么

• 一个插件，为官方 dsh CLI（DeepSeek Harness）添加了一个丰富、具有图形感的文本用户界面（TUI）。它不修改核心引擎，仅在现有 DSH 服务之上叠加一个 UI 层。
• UI 模仿 Claude Code 的外观：像素艺术鲸鱼横幅、发光标题、实时状态栏、进度条、TPS（每秒令牌数）仪表、支持流式 Markdown、工具卡片和图像附件。

为何重要

• 使长时间运行的 AI 代理会话可在终端中使用——你可以实时查看模型令牌数、缓存命中率和当前“代理”状态。
• 提供完整的命令集（/new、/resume、/model、/audit 等），与 DeepSeek Harness 的功能一致，包括工具执行、子代理、审批流程等，全部在同一个窗口内完成。
• 针对低资源环境设计：虚拟滚动确保即使在极长对话中，渲染成本也保持在 O(可见窗口) 级别。

主要功能（如 README 所述）

功能	你将获得
原生终端交互	流式 Markdown、结构化工具卡片、命令/文件补全（含 @-文件引用）、图像附件处理、历史搜索、内联/备用屏幕渲染、语言切换（/lang）。
可观测的代理状态	实时工作状态行、上下文段进度条、TPS 仪表、缓存命中率、推理级别、令牌数、Git/会话信息。
完整的会话工作流	新建/恢复/压缩/导出会话命令，侧边问题（/btw）、模型切换、双 Esc 时间回溯/分叉。
DeepSeek Harness 集成	访问代理预设、技能、MCP（远程工具服务器）、目标、待办事项、子代理，以及 ask_user_question 问卷流程。
长会话设计	事件驱动投影、基于差分的终端输出、消息虚拟化、有界缓存，防止内存爆炸。
主题系统	自动检测终端背景，内置亮色/暗色/ANSI 主题，以及放置在 ~/.dsh‑tui/themes/ 中的自定义 JSON 主题。
键盘与鼠标快捷键	完整的热键列表（Enter、Ctrl‑C、Esc、Ctrl‑O、Ctrl‑R 等）以及鼠标拖拽复制、滚动、点击选择功能。
插件生态系统	扩展开发文档、社区仓库（dsh‑tui‑ecosystem）和模板启动器。

安装与快速入门

# 安装核心 DSH CLI 和 TUI 插件（全局）
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 启动 – 首次运行会自动创建配置文件
dsh-tui

• 需要 TTY 终端、pnpm 10+，以及用于模型调用的 DEEPSEEK_API_KEY。
• Windows 用户可运行捆绑的 dsh-tui.cmd。
• 命令 dsh-tui --resume 可恢复上一次会话；/update 可就地更新插件。

内部工作原理

1. dsh 加载一个 配置文件，链式调用基础 DSH 实现 → dsh‑TUI Cordis 补丁 → 选定的代理预设。
2. 会话事件通过进程内事件流从 DSH 后端流向 TUI。
3. UI 使用移植的 Ink/Yoga 渲染器，通过增量差分更新和布局虚拟化，保持性能恒定。
4. 所有持久化（聊天记录、工具结果等）仍由 DSH 服务负责；TUI 仅负责状态显示。

典型工作流

• 启动 dsh-tui → 观察鲸鱼横幅和状态行。
• 输入提示（Enter 发送，Shift-Enter 换行）。模型流式返回 Markdown；工具卡片内联显示。
• 使用 /model 选择不同模型，/preset 切换代理模式，或 /new 开始全新对话。
• 在空行上按双 Esc 可 回溯 会话（从之前某点分叉出新分支）。
• 使用 /export 导出整个对话（Markdown）或使用 / 搜索历史。

社区与支持

• 在 DeepSeek Harness 公测 WeChat 频道中正式推荐。
• 提供专用 QQ 群（572549239）和 WeChat 群组，用于快速帮助。
• 文档涵盖安装、配置、主题自定义、交互细节、架构、VS Code 集成、插件开发和贡献指南。

许可证

• MIT – 可自由使用、修改和再分发。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。