MIT 许可的键盘优先 TUI，面向 DeepSeek Harness——通过官方 `dsh plugin` CLI 安装、以 `deepseek` 运行，提供原生的 Agent/Session/模型/权限服务、`/clarify` → `/plan` 工作流、主题/语言切换与插件中心。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-08-27
许可证
MIT
01它能帮你完成什么？
在键盘优先的终端工作区中运行完整的 DeepSeek Harness agent 工作流
在实时 TUI 中提供原生的 Agent、Session、模型、权限、Settings、Profile、插件与持久化服务，支持 Markdown/GFM 流式渲染、语法高亮代码、工具/文件视图、原生回滚浏览与会话恢复
使用 DeepSeek Harness（dsh）的开发者，希望用键盘驱动的终端界面替代 Web 或 GUI 客户端
在不离开终端的情况下，通过 Clarify 和 Plan 把想法推进为方案
`/clarify` 引导式工作流：每次回答后提出聚焦问题并更新可审阅的 Draft，确认后的 Draft 回写到输入框；随后由 Harness 原生的 `/plan` 提出实现方案
希望在写代码前锁定需求并获取实现方案的 DeepSeek Harness 用户
在 TUI 中管理插件、Skills、MCP 服务器、Profiles 与 Settings
插件中心提供 list/search/info/install/remove/update/reorder/source/doctor 子命令、动态 Skill 命令、MCP 实例、Profile 与 Settings 编辑，以及实时主题/语言切换
希望不离开终端就能配置和诊断 DeepSeek Harness agent 的运维人员
02如何接入 DeepSeek Harness？
前置条件
- 官方 DeepSeek Harness CLI——README 快速开始执行 `pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8`，且 `deepseek` 需要 `dsh` 位于 `PATH` 或通过 `DSH_BIN` 指定
- Node.js `^22.19.0 || >=24`，且 Harness Host 不低于声明的最低版本 `0.1.0-rc.6`
安装步骤
- 01
安装官方 dsh CLI：`pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8`
- 02
通过原生插件协调将 SeekTTY 加入 Profile：`dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`
$ dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz
- 03
可选：添加启用 `/clarify` 的两个 host 插件，然后启动：`dsh plugin --profile tui add .../dsh-plugin-auxiliary-runtime-0.1.0.tgz` 与 `dsh plugin --profile tui add .../dsh-plugin-clarify-0.2.1.tgz`，随后运行 `dsh --profile tui`
$ dsh plugin --profile tui add .../dsh-plugin-auxiliary-runtime-0.1.0.tgz
- 04
改用独立的 `deepseek` 启动器：`pnpm add --global https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`，设置 `export SEEKTTY_SPEC=https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`，然后运行 `deepseek`
验证接入成功
- 运行维护检查：`pnpm run check`
- 针对真实 dsh 二进制运行标准生命周期测试：`DSH_BIN=/path/to/dsh SEEKTTY_SPEC=/path/to/seektty.tgz pnpm test:stock`
回滚
- 仅从目标 Profile 移除 SeekTTY（不影响 dsh 安装）：`dsh plugin --profile tui remove seektty`
03DSH 适配与能力边界
通过官方 `dsh plugin` CLI 安装为原生 DeepSeek Harness 插件；SeekTTY 是终端界面，而 Harness 拥有运行时状态（Agent、Session、模型、权限、Settings、Profile、插件、持久化）。
键盘优先的终端工作区
在项目目录中运行的 DeepSeek Harness（dsh）→实时 TUI：输入框与状态栏固定底部、原生回滚浏览、Markdown/GFM 流式渲染、语法高亮代码、工具卡片视图、重试、压缩（compaction）、取消与错误状态
Clarify 与 Plan 工作流
通过 `/clarify` 传入的种子文本（整个输入框、某个参数，或尾部 draft token）→每次只提一个聚焦问题，每个回答后刷新 Draft 预览，接受的 Draft 回写到输入框，并由 Harness 原生的 `/plan` 生成实现方案
辅助使用情况存储在官方 `storageDomain` 下的 `auxiliary_runtime` 中；提示词、回答、模型输出、凭据与文件系统路径均不包含在内。首次运行 API key 设置
当活动 Profile 没有可用模型 Provider、且官方 DeepSeek Provider 暴露了可写入的缺失凭据时→居中的只写凭据提示框，输入直接传给 Harness 的 `credentials.set`
SeekTTY 不会回读该凭据，也不会将其写入 Settings、日志、截图或 Session 数据。保存不会发起付费的校验请求。主题与实时语言切换
`/theme` 与 `/language` 命令；通过 `/theme import` 导入本地 VS Code JSON/JSONC 主题文件→独立的界面/代码主题、从 3–16 色板生成的浅色/深色候选、对比度检查，以及实时中英文切换
定义保存在受版本保护的 Harness Settings 命名空间 `seektty-appearance` 中。显式语言偏好由官方 locale 插件以 `locale.preference` 存储，并与 Harness Web 共享。插件中心与 Bundle 协调
npm 包名、Git URL、tarball、文件 URL、本地目录、JSON/HTTP 目录源→带预检检查的 list/search/info/install/remove/update/reorder/source/doctor 子命令；重启后恢复工作区、Session、草稿与附件
TUI 的 `/plugin` 与原生 `dsh plugin` 协调同一份 Profile 依赖、Bundle 顺序与 pnpm lockfile。
04适合谁？何时不该用？
适合
- 使用 DeepSeek Harness（dsh）的开发者，希望用键盘驱动的终端界面替代 Web 或 GUI 客户端
- 希望在写代码前锁定需求并获取实现方案的 DeepSeek Harness 用户
- 希望不离开终端就能配置和诊断 DeepSeek Harness agent 的运维人员
不适合
- Node.js 必须为 `^22.19.0 || >=24`，Harness Host 不得低于声明的最低版本 `0.1.0-rc.6`——低于最低版本的 Host 会被拒绝。高于已测试版本的 Host 可以带提示启动，但自动更新只会安装明确兼容的范围。
- 目前没有 npm Registry 发布。SeekTTY `1.2.1` 目前只是源码候选版本，未发布 `v1.2.1` 的 release tarball；安装使用附加在对应 GitHub Release 上的预构建 tarball，也可以执行 `pnpm run build && pnpm pack` 自行构建，并将 `SEEKTTY_SPEC` 指向生成的 tarball。
05兼容性、维护与安全提示
- Node.js 必须为 `^22.19.0 || >=24`，Harness Host 不得低于声明的最低版本 `0.1.0-rc.6`——低于最低版本的 Host 会被拒绝。高于已测试版本的 Host 可以带提示启动，但自动更新只会安装明确兼容的范围。
- 目前没有 npm Registry 发布。SeekTTY `1.2.1` 目前只是源码候选版本，未发布 `v1.2.1` 的 release tarball；安装使用附加在对应 GitHub Release 上的预构建 tarball，也可以执行 `pnpm run build && pnpm pack` 自行构建，并将 `SEEKTTY_SPEC` 指向生成的 tarball。
- `deepseek --update` 以自身优先：先检查 SeekTTY 再检查 dsh，每次运行最多安装一个兼容组件，且绝不安装未经测试的 gap 或未来版本的 Host。`DSH_BIN`、本地安装与 `SEEKTTY_SPEC` 覆盖不会被改动，更新失败也不会阻塞启动。
- Clarify 的问题、选项、预览与 refine 反馈默认保存在 Host 内存中，15 分钟无交互后失效。主 Session 只会收到你显式提交的 Draft；辅助使用不包含提示词、回答、模型输出、凭据与文件系统路径。
MIT · 活跃维护中（最新版本 v1.2.1，2026-08-22）
06常见问题
如何为 DeepSeek Harness 安装 SeekTTY？
快速开始先用 `pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8` 安装官方 CLI，再通过原生插件协调添加 SeekTTY：`dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`。如需 `/clarify`，可选安装 Auxiliary Runtime 与 Clarify host 插件，然后用 `dsh --profile tui` 启动。
有没有比 dsh 更简单的启动方式？
有——独立的 `deepseek` 启动器。安装 dsh 后，用 `pnpm add --global https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz` 全局安装同一个 SeekTTY 版本，把 `SEEKTTY_SPEC` 指向该 tarball，再运行 `deepseek`。`deepseek` 要求 `dsh` 位于 `PATH`，或通过 `DSH_BIN` 指定其可执行文件。
对 Node.js 和 Harness 版本有什么要求？
Node.js 必须为 `^22.19.0 || >=24`。声明的最低 Harness Host 版本是 `0.1.0-rc.6`，当前测试的 Host 为官方 `0.1.1-rc.2`。低于最低版本的 Host 会被拒绝；高于已测试版本的 Host 可以带提示启动，但自动更新只会安装明确兼容的范围。
SeekTTY 如何处理我的 API key？
当活动 Profile 没有可用的模型 Provider、且官方 DeepSeek Provider 暴露了可写入的缺失凭据时，SeekTTY 会打开一个居中的只写提示框。输入会被掩码处理并直接传给 Harness 的 `credentials.set`——不会回读，也不会存入 Settings、日志、截图或 Session 数据。
之后如何卸载 SeekTTY？
移除 SeekTTY 只会改动目标 Profile，不会影响 dsh 安装：运行 `dsh plugin --profile tui remove seektty`。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
dsh-damage-pulse
作者 wssfk12138
DeepSeek Harness Token 余额监控插件：鲸鱼娘待机/扣费/复苏动画、峰谷计费、连续扣费飘字与会话费用统计。
08数据与来源
SeekTTY is the terminal surface; Harness remains the owner of runtime state.
These commands install prebuilt tarballs through native `dsh plugin` reconciliation.
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-27。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。