终端工作区 MassimoYildirim88/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 工作流。它会提出针对性的问题，每回答一次就更新一份可审阅的草稿，再把确认后的草稿送回输入框。之后由 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 是可选组件，不是默认依赖；它们历史上的联合验收记录列在兼容性一节。

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 的 preset/forms/tool-result 处理、过期目标、审批显示、watcher 清理，以及有界关闭。保留原生 Harness 归属和现有终端工作流。

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

界面

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

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

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

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

Clarify 与 Plan

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

| 组件 | 职责 |
| SeekTTY | 检测 Clarify Remote，添加 /clarify，渲染终端交互，提供当前会话和草稿，并把接受的 Draft 返回给输入区。 |
| 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、Todo 与压缩 | 原生 /plan、/goal 和 /compact，带方案评审、目标状态、Todo 计数和记录归档 |
| 工具与文件 | 实时工具耗时、高亮参数与结果、带源码行号的文件读取、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 密钥设置

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

当前配置档没有可用的模型服务商时，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 按产品意图组织，不再直接暴露