终端工作区 MomoHedlund/seektty

版本兼容性： 当前测试通过的 Host 是官方 0.2.0-rc.2。SeekTTY 1.3.0 与该 Host 配对。变更与安装说明见版本说明，确切的包证据见验证记录。

SeekTTY

DeepSeek Harness 的终端工作区。

概览

快速开始

澄清与规划

功能

兼容性

English · 中文

概览

在项目目录里运行 deepseek，就能在一个终端工作区中使用 DeepSeek Harness 原生的智能体、会话、模型、权限、设置、配置档、插件与持久化服务。SeekTTY 是终端界面，运行时状态仍由 Harness 掌管。

模型、服务商、智能体预设、权限、命令、工具、设置、技能、MCP 服务器与市场源都从运行中的 Harness 发现。因此上游或第三方 Bundle 新增的能力会自动出现，无需硬编码进 SeekTTY。

对于仍需明确的需求，可选的 Clarify Host 插件提供引导式 /clarify 工作流。它会提出聚焦的问题，每答一题就更新一份可审阅的 Draft，并把通过审阅的 Draft 送回输入框。随后 Harness 原生的 /plan 可以把提交的需求转成实施计划。

开发检出

在仓库根目录构建并安装本地 SeekTTY 包：

pnpm add --global --config.enable-global-virtual-store=false @deepseek-ai/dsh@0.2.0-rc.2
pnpm install --frozen-lockfile
pnpm run build
pnpm pack
dsh plugin --profile tui add --config.enable-global-virtual-store=false ./seektty-1.3.0.tgz
dsh --profile tui

源码开发与测试请用本地 tarball。使用已发布的包时，请用下面给出的确切 npm 版本。

快速开始

在已验证的官方 DeepSeek Harness 0.2.0-rc.2 上安装已发布的 SeekTTY 版本：

pnpm add --global --config.enable-global-virtual-store=false @deepseek-ai/dsh@0.2.0-rc.2

dsh plugin --profile tui add --config.enable-global-virtual-store=false seektty@1.3.0

dsh --profile tui

这些命令通过原生 dsh plugin 协调机制安装预构建的 Bundle。每条命令都带上 pnpm 选项，是为了避开 pnpm 11 的 Global Virtual Store 布局——在当前测试过的 dsh 版本里，Cordis 加载器无法可靠加载这种布局。SeekTTY 从不改动全局 pnpm 配置。Clarify 和 Auxiliary Runtime 是可选项，不是默认依赖；它们历史上的联合验收记录列在 Compatibility 下。

seektty@1.3.0 这个确切的 npm 包记录在发布说明、PR 审计和验证记录中。

裸 deepseek 启动器

装好 dsh 之后，全局安装同一个 SeekTTY 版本，并把 Profile 协调锁定到它确切的 npm 版本：

pnpm add --global --config.enable-global-virtual-store=false seektty@1.3.0
export SEEKTTY_SPEC=seektty@1.3.0
deepseek

PowerShell 使用同样的确切 npm spec：

pnpm add --global --config.enable-global-virtual-store=false 'seektty@1.3.0'
$env:SEEKTTY_SPEC='seektty@1.3.0'
deepseek

deepseek 要求 dsh 在 PATH 上，或者用 DSH_BIN 指向它的可执行文件。常见启动形式包括：

deepseek "check this project"
deepseek --cwd ../project
deepseek --resume
deepseek --resume <sessionId>
deepseek --profile team-tui
deepseek --version
deepseek --update

deepseek --update 先更新自己：它先检查 SeekTTY，再检查 dsh，每次运行最多安装一个兼容组件，绝不安装未经验证的版本缺口或未来的 Host。DSH_BIN、本地安装和 SEEKTTY_SPEC 覆盖都保持原样。更新失败不会阻塞启动。设置 SEEKTTY_UPDATE=check 可在会话结束后收到提示，设置 SEEKTTY_UPDATE=0 可关闭检查。

SeekTTY 1.3.0 支持官方 dsh 0.2.0-rc.2，把更多原生工作流带进终端。参见双语发布说明、完整 PR 审计和验证记录。

1.3.0 的新内容

- 在终端里访问原生 Session 操作、计划与产物、MCP 资源、Team 信息、日程、定时/连续提问，以及账号/模型信息。
- 浏览 Host 工作区文件，支持文本/二进制视图和可用的文件监听。插件可以添加终端 Session 操作，以及带撤销功能的受保护草稿输入活动。
- 需要时安装可选的 Creator、Browser 或 Computer 配套 Bundle。启用官方语音输入 Bundle 后，/speech wav 提供经过审核的 WAV 转写；它不会从麦克风录音。
修复当前 Host 的预设、表单、工具结果处理，以及过期目标、审批显示、监听器清理和有界关闭。保留原生 Harness 归属和现有终端工作流。

发行说明还补齐了 1.2.6 摘要中的缺口：Agent Tree 导航、语义化转录复制、按目标区分的上下文菜单、Provider 配置、VS Code 主题发现、独立外观控制、原生回滚缓冲，以及长会话渲染修复。这些功能早已发布；审计文档列出了它们最初的 PR 和版本。

界面

| DeepSeek 浅色 | DeepSeek 深色 |
| SeekTTY DeepSeek 浅色启动界面 | SeekTTY DeepSeek 深色启动界面 |

| 浅色界面中的 TypeScript | 深色界面中的工具、文件读取和 Diff |
| SeekTTY 浅色 TypeScript 语法高亮 | SeekTTY 深色工具与 Diff 语法高亮 |

完整模式使用固定的备用屏幕视口，输入框和状态栏固定在底部。鼠标支持用来浏览历史、选择文本，以及点击 SeekTTY 内已有的控件。空闲时按 F3 或输入 /mouse native 可切换到终端原生模式：SeekTTY 退出备用屏幕，把已加载的完整对话写入普通终端回滚缓冲，关闭鼠标上报，由终端或 tmux 接管滚动、搜索和选择。回填按顺序进行并报告进度；按 Esc 可停止回填，但不会停止会话，而 Ctrl+L 只刷新当前活动尾部。/transcript 打开转录浏览，/transcript replay 则显式重新写入可用对话。原生模式下图片以文本附件行的形式呈现。SeekTTY 不会对已写入的历史重新着色或重排；那段历史归终端所有。

空会话现在打开时显示响应式的 Fastfetch 风格欢迎页，而不是可发送的任务建议。默认使用打包的、原色 DeepSeek 像素鲸鱼，加上来自当前配置档的运行时信息；它不会执行 Fastfetch。首次 API 密钥提示的优先级更高，会在可选的 Fastfetch 信息收集开始前完成。

Clarify 与 Plan

Clarify 和 Plan 覆盖同一工作流的连续阶段：Clarify 帮你决定要做什么；Harness 原生 Plan 则提出怎么做。

| 组件 | 职责 |
| SeekTTY | 检测 Clarify Remote，添加 /clarify，渲染终端交互，提供当前会话和草稿，并把已接受的草稿返回给输入框。 |
| dsh-plugin-clarify | 负责临时澄清流程，并通过 clarify.wire/1 发布 start、answer、accept、refine、cancel 和 fetchDraft。 |
| dsh-plugin-auxiliary-runtime | 通过当前模型路由运行 Clarify 模型调用，带限额、取消和独立用量账本。 |

用以下任意方式启动 Clarify：

- 从命令面板选择 /clarify，把整个输入框内容作为种子。
- 输入 /clarify some text，把它的参数作为种子。
- 在已有草稿末尾加上独立的 /clarify token 或单独一行，把前面的文本作为种子。

Clarify 一次只问一个聚焦问题，把已接受的决策带到后续，并在每次回答后刷新 Draft 预览。你可以回答、细化、接受或取消。接受只会把 Draft 写入普通输入框；发送仍由 Enter 显式触发。提交后如果需要实现方案，再运行 /plan。

问题、选项、预览和细化反馈都留在 Host 内存中，默认 15 分钟无交互后失效。主会话只会收到你显式提交的 Draft。辅助用量存放在官方 storageDomain 下的 auxiliary_runtime；提示词、回答、模型输出、凭据和文件系统路径都不包含在内。/status 显示经过校验的 Official、Auxiliary 和派生的 Combined 总计，不改动官方 Agent 的 tokenUsage。

可接受的发布栈和当前候选边界见兼容性与验证。

功能

| 领域 | 可用操作 |
| 对话 | 流式 Markdown/GFM、语法高亮代码、链接、表格、推理可见性、工具卡片显示模式、重试、压缩、取消和错误状态 |
| 会话与工作区 | 创建、恢复、搜索、重命名、分叉、归档、重排、复制、导出和切换工作区，不删除项目文件或日志 |
| 智能体、模型与权限 | 动态 Agent Presets、服务商、模型、推理强度和权限预设，支持按会话切换和诊断 |
| 队列与交互 | 运行期间排队或引导提示词；编辑队列条目；回答单选、多选、自定义、跳过、取消和方案评审提示 |
| 图片 | 粘贴或附加 PNG、JPEG、GIF 或 WebP；执行实时 Host 限额；恢复待处理附件；终端支持时内联渲染 |
| 方案、目标、待办与压缩 | 原生 /plan、/goal 和 /compact，带方案评审、目标状态、待办计数和记录留痕 |
| 工具与文件 | 实时工具耗时、高亮参数和结果、带源码行号的文件读取、Shell/JSON/Diff 视图、产物文件浏览、路径复制和确认后外部打开 |
| 子代理与后台工作 | 浏览所属根会话的嵌套 Agent Tree，打开子记录，返回时恢复父视口、草稿、附件和树状态；Host 缺少证据时，生命周期和延续标签保持保守 |
| 配置档与设置 | 创建、复制、切换、诊断配置档；编辑每个已注册的设置命名空间，支持 Schema 回退、修订检查、只写密钥 |
| 插件、技能与 MCP | 插件中心、原生 Bundle 对账、动态技能命令、MCP 实例、加载状态、设置与风险信息 |
| 主题与语言 | 界面/代码主题相互独立、终端背景特效、调色板生成、VS Code 主题导入、对比度检查、NO_COLOR、中英文实时切换 |
| 欢迎页 | 响应式 DeepSeek 像素鲸鱼终端 Logo、自定义行、可选 Fastfetch 信息、实时草稿预览、受修订保护的配置档设置 |
| 诊断与反馈 | 运行时状态、可操作的 /doctor 检查、会话反馈、助手消息评分、反馈删除 |

SeekTTY 从当前 Harness 配置档读取这些目录。不支持的可选能力会安全降级，同时专用终端视图持续演进。

权限变更使用原生 Host 命令及其执行结果。成功时菜单关闭；失败时错误保留在菜单中，可重试。完全访问和未知预设仍需确认，切换会话会使已打开的权限选择失效。命令适配器使用经过测试的 dsh 0.2.0-rc.2 契约；未知契约会被拒绝，不会重试可能已执行的命令。

首次运行的 API key 设置

| 深色 | 浅色 |
| SeekTTY 深色首次运行 API key 提示 | SeekTTY 浅色首次运行 API key 提示 |

当前配置档没有可用的模型服务商时，SeekTTY 会提供官方 DeepSeek 快速设置、共享服务商管理器，或稍后配置。已有的环境凭据、已存储的 Harness 凭据，以及当前生效的环境或免密钥服务商，都会跳过这一步。保存通用服务商后，你需要明确选择当前会话模型，挂起的请求才会继续。

输入会被遮蔽，并直接传给 Harness credentials.set。SeekTTY 不会读回，也不会写入设置、日志、截图或会话数据。保存不会发起付费验证请求；认证错误会在首次真实请求时走正常的服务商路径。

按 Escape 可推迟设置，不会阻塞 /settings 或 /plugin 等本地界面。待发送文本和附件会保留，设置成功后请求自动继续。如果无法检查服务商状态，SeekTTY 会指向 /settings 和 /doctor，而不是显示无法使用的表单。

服务商管理

从 /model 打开 Manage Providers…，或从 /settings 里的 Models and Agent 打开。两个入口和首次运行设置都走同一条 Harness 支撑的流程。它会合并 llm.providers、settings.describe 和无值的 credentials.describe 结果；先写入受修订保护的 Settings 变更，再执行可选的 credentials.set；然后重新读取 Settings、凭据元数据、llm.providers 和 llm.models，确认全部成功后才报告成功。传输结果如果无法通过回读确认，就报告为未知，不会盲目重试。保存配置永远不会悄悄改动当前会话，也不会改动新会话的默认值。

自定义服务商路径就是已安装的 llm-pi-ai 适配器用 schema 描述的 providers 字典；路由 ID 遵循该字典的 schema。这个界面会去掉首尾空白，并排除空 ID、终端控制字符和 SeekTTY 保留的菜单 ID。可选协议列表遵循已安装的服务商适配器 schema。任何协议都可以手动添加模型，也可以在已安装适配器支持发现时使用 llm.discoverModels。模型列表拉取成功只能证明配置发现成功；第一次真实请求才是认证与推理的检验。

API 密钥用掩码控件收集，只通过 Harness Credentials 存储。凭据 Ref 使用官方语法 [A-Za-z_][A-Za-z0-9_]*。只读的环境变量/文件凭据显示为外部管理，元数据读不到时密钥更新按失败关闭处理。任何新挂接的 Ref 如果要接收新密钥，在改动 Settings 之前必须仍处于未配置且可写状态。已配置的 Ref 只有在展示其端点和 Ref 之后才能显式复用；它的值既不会被读取，也不会被覆盖。更新当前已挂接的已配置 Ref 中的密钥属于仅密钥保存，不能与其他 Settings 变更合并。同时改端点和密钥时，一律使用另一个未配置、可写的 Ref，这样 Settings 变更会先切到一个不可能含有旧密钥的 Ref，然后才写入新密钥。Settings 和 Credentials 始终是两次独立的官方调用，不是原子事务。模型编辑会保留 schema 描述的完整模型条目，包括模态、推理强度档位和兼容性开关。
删除服务商仅限于用户自有的自定义 Settings 条目，且该条目既不是当前会话路由，也不是默认路由——即使当前路由未出现在所显示的模型目录中，也同样如此。确认后会重新读取引用与归属，变更后再读取一次被移除的配置档以及当前/默认引用。预检与 Settings 变更不是原子操作：并发选择仍可能在两者之间创建引用，此时 SeekTTY 会报告这一竞态，而不会声称删除已完全验证。凭据会被有意保留，历史会话保持原样。已保存的服务商 ID 无法原地重命名。目录服务商与专有认证仍仅限于已安装 Harness 适配器实际描述的能力——此 UI 不是协议转换器，也不声称每个厂商专属 API 都已通过认证。

斜杠命令

输入 / 会打开可搜索菜单，其中合并了 SeekTTY 命令、当前智能体的 Host 命令，以及用户可调用的技能。

| 类别 | 命令 |
| 会话 | /new、/resume、/sessions、/rename、/fork、/archive、/export、/export md、/copy |
| 工作环境 | /workspace、/profile |
| 智能体 | /mode、/model、/permission、/plan、/goal、/compact |
| 运行时交互 | /queue、/steer、/attach、/attachments、/pending |
| 运行时内容 | /tools、/files、/jobs、/subagents、/trajectory |
| 扩展 | /plugin、/plugins、/skills、/mcp |
| 插件工作流 | 当兼容的 Clarify Remote 与 Auxiliary Runtime 处于活动状态时，会出现 /clarify |
| 配置与诊断 | /settings、/language、/theme、/welcome、/status、/doctor、/feedback、/restart |
| 帮助与退出 | /help、/quit、/exit |

/plugin、/workspace 和 /profile 提供交互式中心与直接子命令。未知命令会留在命令界面内，并显示附近的建议。

自动补全与浮层列表会保持滚动位置：滚轮浏览时不会移动选中项，点击可见行不会将其重新居中，方向键仅在选中项越过可见边缘时才滚动。悬停仅用于预览。第一次点击即选中；之后点击同一个已激活条目没有双击时限。按 Enter 或安全地第二次点击会完成并运行一次斜杠命令；Tab 只会补全。文件与路径补全永不自动提交，滚动位置页脚不可点击。

浮层页脚有单击即可用的 Select/Confirm/Save 与 Back/Close 按钮，悬停样式随主题变化。它们共用键盘校验与导航；危险确认仍仅限键盘操作。启动后普通鼠标操作立即可用，无需最小化终端。在可用时，焦点上报会在重新获得焦点后的 250 ms 内防止误激活。
完整模式复制剪贴板时，文本按 UTF-8 编码一次。Windows 用固定的 PowerShell Set-Clipboard 写入，macOS 在 UTF-8 locale 下运行 pbcopy，Wayland 声明 text/plain;charset=utf-8，X11 请求 UTF8_STRING；终端、SSH 和 tmux 路径仍可用 OSC 52。

设置中心

/settings 按产品意图组织，而不是暴露一个