前言¶

在 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