它是什么
SeekTTY 是一套 Claude Code 风格的 DeepSeek Harness 终端工作台：流式 Markdown/GFM、语法高亮代码、会话与工作区管理、设置中心、插件中心、Provider 管理、主题系统和 /doctor，全部在终端里完成。
README 反复强调的架构要点是：SeekTTY 是架在 dsh Host 之上的界面层，不是另一套运行时。 启动之后你用的是 harness 原生的 Agent、Session、模型、权限、设置、Profile、插件与持久化服务，运行时状态的所有者仍是 Harness。模型、Provider、agent preset、权限、命令、工具、skill、MCP server 与市场源都从正在运行的 Host 发现，其它 bundle 新增的能力会自然出现，不需要 SeekTTY 硬编码。
工作台里有什么
- 对话 —— 流式 Markdown/GFM、推理可见性、多档工具卡片展示、重试、压缩、取消。
- 高亮与主题 —— VS Code 级别的 TextMate 高亮（依赖树里是 Shiki），导入的 VS Code
tokenColors作为权威规则，另有调色板生成、对比度检查、尊重NO_COLOR、终端透明与背景继承。 - 各类中心 —— 会话与工作区（新建/恢复/搜索/重命名/fork/归档/导出）、Profile、按用途组织的设置中心，以及与原生
dsh plugin调和同一份 Profile 依赖与 lockfile 的插件中心（/plugin）。 - Provider 管理 —— 凭据输入全程掩码，直接交给 Harness 的
credentials.set；README 明确密钥不会被读回，也不会进入设置、日志、截图或会话数据。 - 交互 —— 运行中排队/steer、plan/goal/compact、图片粘贴、子 agent 树浏览、鼠标模式（全屏 alternate-screen，或按 F3 切回终端原生滚动）、可搜索的斜杠菜单、右键菜单、语义化的 transcript 复制。
- 可选的 Clarify 工作流 —— 配套的
dsh-plugin-clarify加辅助运行时提供引导式/clarify；它是可选项，不是默认依赖。 - 包内自带
deepseek启动器二进制，支持裸启动器用法，并配有一套谨慎的、先查自身的更新器。
版本现状——安装前必读
本次来源的状态不同寻常，你应当知道自己在跟哪一份：
- npm 发布线（撰写时为 1.2.6）在清单里声明
dsh.compatibility: { minimum: "0.1.5-rc.1", tested: "0.1.5-rc.1" }。上面的dshTarget记录的就是这条声明，它是当前安装的权威依据。 - 仓库里检出的 README 是开发分支，正在适配 dsh
0.1.5-rc.1，并且它自己写明了：它不是已发布的1.2.5制品。 - 同一份 README 的徽章与快速上手钉的却是上一个版本：
seektty@1.2.5，在 harness0.1.1-rc.2上测试。
结论是：在 0.1.5-rc.1 上，按下方命令安装当前 npm 版本；在更旧的 harness 上，改走 README 钉住的说明（seektty@1.2.5 搭配 @deepseek-ai/dsh@0.1.1-rc.2）——不要假定当前发布线还支持旧内核。
运行要求
- Node 需满足
^22.19.0 || >=24（engines字段）；系统为 macOS、Linux 或 Windows（os字段）。 - Harness：当前发布版要求
>=0.1.5-rc.1，依据是已发布清单的 compatibility 块。低于声明下限的 Host 会被拒绝；高于已测版本的 Host 可能带着提示启动。 - pnpm 与 GVS 开关。 每一条包变更命令都要带
--config.enable-global-virtual-store=false——pnpm 11 的全局虚拟存储布局（store/v11/links）在已测试的 dsh/Cordis 加载器下可能以plugin tree failed to load之类的错误失败。README 明确该开关逐命令生效，从不改动全局 pnpm 配置。 - 安装足迹刻意做薄。 所有
@deepseek-ai/*peer 依赖都是可选的：README 说明发布的 bundle 不会把 Cordis 或带身份的 dsh 包装进 Profile——运行时导入经由官方 Harness 安装解析。它自己的运行依赖很短（Shiki、commander、cross-spawn、immer、js-yaml、jsonc-parser、zod、zustand），且没有安装期生命周期脚本。 - 遥测： 未记录。凭据处理有详细记录（见上）；除此之外没有任何说明。按「未说明」而不是「安全」理解。
已知限制
- 最大的问题是上面的版本漂移：徽章、快速上手、开发分支声明与 npm 清单，当前描述的是三个不同基线。
- 高亮是语言语法感知的，但刻意停留在视觉层面，不是 LSP 语义。
- 像素鲸鱼欢迎页是终端文本——不使用 Kitty/iTerm/Sixel 图片协议。
- 可选 Clarify 组合的联合验收是历史记录：README 说明 1.2.5 没有延续这些可选工作流的验收。
- README 自己指出：注入 PTY 与合成渲染器测试并不等价于真实 GUI 终端的鼠标或剪贴板测试；平台级签收是人工的。
- 插件中心的变更需要重启（变更会跨重启恢复工作区、会话、草稿与附件）。
什么时候用它、什么时候不要用
如果你想要一个 Claude Code 形状的终端会话、又不想离开 dsh 运行时——同一个 Host、同一批会话、同一份设置、同一套插件——并且你的 harness 是 0.1.5-rc.1（或愿意钉住旧的 1.2.5 组合），用它。Provider 管理与权限处理是它最用心的部分：带修订检查的设置写入、掩码凭据、失败留在界面上而不是盲目重试。
不要指望它是独立的 agent——按设计，离开可用的 dsh 安装它就无法工作。跑不了 Node 22.19+/24、harness 偏旧又不想钉 1.2.5、或需要图片协议终端图形的，请跳过。用 pnpm 11 的话，每次插件变更都要带上那个逐命令的 GVS 开关——那是受支持的路径，不是可以省略的变通。
安装
dsh plugin --profile tui add seektty --config.enable-global-virtual-store=false然后用 dsh --profile tui 启动。在早于 0.1.5-rc.1 的 harness 上，README 的快速上手改为钉住 seektty@1.2.5 与 @deepseek-ai/dsh@0.1.1-rc.2 的组合——那种情况请按钉住的命令执行，而不是上面这行。