dsh-TUI：DSH 终端交互界面插件

项目简介

dsh-TUI 是 DeepSeek Harness（DSH）的交互式终端界面插件，使用 TypeScript 编写，基于 Ink / React 渲染。它为 DSH 带来像素鲸鱼头图、实时工作状态、流式思考、双击 Esc（Esc 两次）时间回溯、上下文进度条与 TPS 仪表等界面元素。它不修改 DSH 核心代码，只使用 DSH 的公开导出；安装即启用，卸载不会留下补丁。

主要功能

• 像素鲸鱼宠物：三种启动动画，点击唤醒；首个任务开始后静止。
• 启动页与首次引导：普通启动会进入带真实输入框的落地页（大号文字、鲸鱼与快捷操作）；首次运行会走四步向导（账号与模型、语言与主题、模型与工作区、快捷键），可用 /setup 重新运行。第一步可以直接登录订阅账号，或通过 /provider 向导添加 API key。
• 终端原生 UI：流式 Markdown、工具卡、/ 与 @ 补全、#L12-14 行号范围、历史搜索、中英文界面。
• 任务完成通知：DSH、Claude、Codex 的实时任务结束后会发送通知，标题为 dsh-TUI · Task complete，正文是最近一条回复的纯文本预览（最多 200 字符）。/settings 中可设置 taskNotifications 与 notificationMethod；Windows 本地可改用系统原生通知（toast）。
• 原生光标：聚焦的文本输入框会沿用终端的形状、颜色、闪烁与动画效果。
• 图片：Kitty/Sixel 缩略图、居中预览与缩放平移、粘贴时自适应、文本降级方案。
• Mermaid 与 LaTeX：mermaid 代码块绘制为 Unicode 图；$…$、$$…$$ 公式输出为 Unicode 文本，mathRendering: image 可在图形终端中把公式排成终端图片。
• 时间线栏：每一轮对话都可点击，支持时间线、滚动条、隐藏三种形态。
• 侧边栏：终端足够宽时，Ctrl+B 会把聊天界面分为两栏，可拖动分隔条调整宽度；八个内置面板默认开启，后注册的插件面板也默认开启。
• 实时状态：活动动画、上下文进度条、TPS、缓存命中率、effort、token 数、会话成本估算、Git 与会话元数据。
• 会话管理：/resume /home /agentview /bg；另有 /new /compact /export /btw、模型热切换、fork、回溯、vim、全屏草稿编辑器。
• IDE 选区通道：VS Code 中的选区可直接落入输入框。
• DSH 集成：presets、skills、MCP、goals、todos、subagents、问卷。
• 账号登录：标准 profile 提供 pi-ai OAuth（ChatGPT/Codex、Claude、Grok），并在 DSH 0.2.0-rc.1+ 上提供由 Host 负责的 DeepSeek 浏览器登录。

安装与使用

通过 npm 安装后即可在 DSH 中启用，卸载不会残留补丁。插件要求 DSH 版本落在其声明的兼容范围内：v0.18.0 起验证线为 DSH 0.2.1-rc.5，0.2.1-rc.4 列为兼容线。侧边栏、通知、启动页等行为都可以在 /settings 中调整。完整按键与命令见 交互与命令文档。

注意事项

• 项目不修改 DSH 核心，只使用 DSH 的公开导出；它正从挂载式插件迁移为拥有自己入口与组合根的应用，由 DSH 以进程内第一方后端的方式加载。
• 终端通知受终端设置影响：tmux 需要 set -g allow-passthrough on 才能收到 OSC 通知，set -g focus-events on 才能上报焦点；不支持焦点上报的终端需要把通知设为 always。
• 官方 Git 工作树实验包不会自动清理，创建的分支需要另行删除；Minimal 与 liangshen 预设不提供该工具。
• 许可证为 MIT，项目目前处于 public beta 阶段。

本作品整理自 GitHub 开源项目 ccch1mneyyy/dsh-TUI，原作者 @ccch1mneyyy，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。