终端工作区 serkanandre/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 要求 PATH 上有 dsh，或者用 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 新增内容

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

| 深色 | 浅色 |
| 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 按产品意图组织，不再直接暴露