前言¶

在 DeepSeek Harness（DSH）里跑 Agent，常见入口是 Web UI 或命令行里的 dsh。如果你更习惯待在终端里写代码、看工具输出、切会话和改权限，原生 CLI 往往缺少一块完整的交互界面：流式回复、斜杠命令、会话管理和插件市场都要自己拼。

SeekTTY 是面向这一场景的客户端插件。它在项目目录里提供 deepseek 启动器，把 Harness 的 Agent、Session、模型路由、权限、Settings、Profile、插件与持久化能力收进一个 DeepSeek 配色的全屏 TUI。下面介绍它是什么、能做什么，以及如何安装和上手。

这是什么¶

SeekTTY（仓库 Hilbert-beinghappy/seektty）由维护者 Hilbert-beinghappy 发布，当前版本 1.2.1，MIT 许可证。一句话定位：可插拔的、DeepSeek 配色的终端界面，作为 DeepSeek Harness 的键盘优先工作台。

进入项目目录运行 deepseek，即可在同一套 Harness 状态上完成提问、代码修改、工具调用、会话管理、模型切换、权限审批、子 Agent 观察和插件操作。插件声明的 Harness 兼容范围为最低 0.1.0-rc.6，当前已测 Host 为 0.1.1-rc.2；运行环境要求 Node.js ^22.19.0 || >=24，支持 macOS、Linux 和 Windows。

核心功能¶

Harness 原生能力的一体化终端面¶

SeekTTY 不另起一套 Agent 运行时，而是读取当前 Harness 运行时目录，动态展示模型、Provider、Agent Preset、权限、Host 命令、工具、Settings、Skills、MCP 和插件来源。README 列出的已接入能力包括：

• 对话与运行：流式回复、Markdown/GFM、语法高亮代码块、工具卡片、推理显示切换、Ctrl+C 停止当前轮次
• 会话：新建、恢复、搜索、重命名、Fork、归档、导出 ZIP 或 Markdown
• 工作区：多工作区注册、排序，移除注册不删目录或日志
• Agent 模式：Standard、Code/PTC、Minimal、Cordis/Create，以及插件注册的 Preset
• 模型与权限：/model、/permission，Shift+Tab 循环权限并在高风险前确认
• 输入队列与 Steer：Agent 运行时排队、编辑、转引导
• 图片附件：粘贴或 /attach，按 Host 的 imageLimits 检查
• Plan、Goal、压缩：Harness 原生 /plan、/goal、/compact
• 插件与市场：/plugin 支持 npm、Git、tarball、本地路径安装与诊断
• 状态与诊断：/status、/doctor，展示 Harness、Profile、插件运行状态

Clarify 与 Plan 的衔接工作流¶

想法尚未写清时，可选插件提供的 /clarify 工作流。Clarify Host 插件（dsh-plugin-clarify）持有绑定 Session 的澄清进程；SeekTTY 探测其 Remote 后动态加入 /clarify，把当前 Session 和输入区草稿交给插件，逐题生成问题、选项和 live Draft preview。采用后，完整 Draft 回到普通输入框，由你审阅、修改并自行按 Enter 发送。需求明确后，再用 Harness 原生 /plan 生成实施方案。

Clarify 的模型调用经 dsh-plugin-auxiliary-runtime 执行，用量记入 auxiliary_runtime 账本；官方 Agent 循环仍走 tokenUsage。快照合同健康时，/status 分别展示 Official、Auxiliary 和派生 Combined 总量。

要在同一 Profile 里启用完整 /clarify，需同时激活 SeekTTY、Auxiliary Runtime 和 Clarify 三个组件。

主题与界面语言¶

界面主题与代码块主题可独立配置。/theme 支持 DeepSeek 亮/暗色、命名自定义主题、3–16 色自动生成，以及 /theme import 导入本地 VS Code JSON/JSONC 主题并保留 TextMate Token 配色。/language 可在中文与英文间切换，显式偏好写入官方 locale.preference，与 Harness Web 共用。

安装与启用¶

SeekTTY 通过 GitHub Releases 附带的预构建 tarball 分发，当前没有 npm Registry 发布。最近一次联合验收的 Release 组合为：官方 dsh 0.1.0-rc.8、SeekTTY 1.2.0、Auxiliary Runtime 0.1.0、Clarify 0.2.1。SeekTTY 1.2.1 已在壳层面对官方 0.1.1-rc.2 完成测试，但 README 注明截至文档撰写时尚无 v1.2.1 Release 资产；若要用 1.2.1，需本地 pnpm pack 后安装 tarball，或等待 Releases 发布。

作为 DSH 插件安装（含 Clarify 三件套）¶

先做全局 dsh，再向目标 Profile 添加三个 tarball：

pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8

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/dsh-plugin-auxiliary-runtime/releases/download/v0.1.0/dsh-plugin-auxiliary-runtime-0.1.0.tgz
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/dsh-plugin-clarify/releases/download/v0.2.1/dsh-plugin-clarify-0.2.1.tgz

dsh --profile tui

第一项安装 SeekTTY 终端壳，第二项提供 Auxiliary 模型执行，第三项提供 Clarify Host 服务。两个 Host 插件在同一 Profile 激活后，SeekTTY 会发现 Remote 并把 /clarify 加入命令目录。

裸 deepseek 启动器¶

若只需全局 deepseek 命令、由启动器管理 Profile，可执行：

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

deepseek 需要 PATH 上的 dsh，也可用 DSH_BIN 指向可执行文件。SEEKTTY_SPEC 让 Profile 固定使用同一份预构建 tarball。

移除插件不修改 dsh 本体：

dsh plugin --profile tui remove seektty

典型用法¶

进入项目并启动¶

cd /path/to/your-project
deepseek

带初始任务、指定工作区或恢复会话：

deepseek "检查这个项目"
deepseek --cwd ../project
deepseek --resume
deepseek --resume <sessionId>
deepseek --profile team-tui

斜杠命令与 Clarify¶

在输入框键入 / 打开可搜索的命令菜单。常用分类包括会话（/new、/resume）、Agent（/mode、/model、/plan）、扩展（/plugin、/skills、/mcp）和诊断（/status、/doctor）。

Clarify 激活后，可用以下方式启动：

• 命令面板执行 /clarify，保留整个输入区作为 seed
• 输入 /clarify some text，以参数文本作为 seed
• 在现有草稿末尾单独加入 /clarify token

每答一题会刷新 live Draft preview；采用后 Draft 写回输入框，你确认无误再按 Enter 发送。需要实施方案时运行 /plan。

常用快捷键¶

首次无可用 Provider 时，SeekTTY 会在首帧前弹出居中的 API Key 掩码输入框；按 Esc 可稍后配置，草稿与附件不丢失。

适用场景与注意¶

适合谁： 已在用 DeepSeek Harness、希望把 Agent 工作流留在终端里的开发者；需要键盘优先操作会话、权限、插件和 Clarify→Plan 需求澄清链路的团队。

生态背景： DSH 的理念是「一切皆插件」。社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系，安装前请以 GitHub 源码与 Releases 为准。

权限与安全： 插件以当前 dsh 进程权限运行，可访问该 Profile 下的工作区、凭证和插件配置。安装前应阅读源码与 MIT 许可证，Secret 类设置只写不回显；Clarify 的辅助模型调用记录在 auxiliary_runtime 账本，prompt 与消息正文不进入账本。

版本注意： README 区分了「最近一次联合验收 Release」与「未发布三件套候选」（SeekTTY 1.2.1 + Auxiliary Runtime 0.1.1 + Clarify 0.2.2）。后者有 PTY 与 live-provider 观察记录，但不是正式 Release，也不等于完整联合验收。升级时关注 deepseek --update 与 /doctor 输出。

结尾¶

SeekTTY 把 DeepSeek Harness 的原生 Agent 能力装进一个可插拔、可主题的终端工作台，并在 Clarify、Auxiliary Runtime 配套插件就绪时，补上从模糊想法到可审阅 Draft、再到 /plan 的键盘优先路径。

• 社区目录：skillhub.cn/plugins/Hilbert-beinghappy/seektty
• 源码与文档：github.com/Hilbert-beinghappy/seektty