DeepSeek Harness 交互式終端包：dsh-tui

前言¶

DeepSeek Harness (DSH) 採用了模塊化插件架構。在終端中直接與 DSH 交互需要特定的集成方案。dsh-tui 提供了一個獨立的交互式終端包，通過 OSC 序列進行終端集成，並支持本地或遠程 Web Host，無需修改 DSH 核心源碼。

這是什麼¶

zhangweiii/dsh-tui 是 DeepSeek Harness 的獨立交互式終端包，由 zhangweiii 維護。

作爲一個自包含的 npm 包，它不修改 DSH 核心源碼工作區。在啓動時，渲染器會嘗試連接到 http://127.0.0.1:3080 的 Web Host；如果該地址不可用，則回退到使用其自身的 InProcessApiClient。該包通過 cordis.patch.yml 爲 dsh-base 層疊終端 Host 服務和代理預設列表。

核心功能¶

獨立終端交互：提供獨立的交互式終端界面，不包含 DSH 核心模塊的副本。
終端集成：通過 OSC 序列進行終端集成，支持窗口標題更新和狀態通知。
Web Host 支持：支持本地和遠程 Web Host，也可在無 Web Host 的情況下獨立運行。
會話管理：支持持久化會話管理，可通過 ID 恢復或繼續會話。
文件引用索引：支持 @file 提及的文件引用索引，便於在對話中引用本地文件。
模糊搜索選擇器：內置帶模糊搜索的模型、會話和設置選擇器，無需滾動即可快速定位。
Markdown 渲染：支持 Markdown 語法高亮和代碼摺疊。

安裝與啓用¶

安裝該插件需要已安裝的 dsh 0.1.1-rc.2 或兼容主機。

1、安裝插件：

dsh plugin --profile tui add @zhangweiii/dsh-tui

安裝命令會直接從 npm 註冊表拉取包（本地檢出也可以使用 add .）。安裝後，dsh 命令將使用 tui 配置文件初始化，該配置文件默認記錄了此包聲明的 dsh.bundle。

典型用法¶

安裝完成後，使用 --profile tui 啓動終端交互：

1、初始化交互：

dsh --profile tui

2、執行初始指令：

dsh --profile tui "explain this repository"

3、繼續最近的會話：

dsh --profile tui --continue

4、恢復特定會話：

dsh --profile tui --resume <session-id>

5、指定工作目錄：

dsh --profile tui --cwd <path>

6、連接遠程 Web Host：

dsh --profile tui --connect http://127.0.0.1:8080

7、獨立模式（無 Web Host）：

dsh --profile tui --standalone

適用場景與注意¶

運行環境：應用需要交互式 TTY。
依賴要求：
- 需要 Node.js 版本 ^22.19.0 || >=24.0.0。
- 需要 dsh 0.1.1-rc.2 或兼容主機。
網絡限制：純 HTTP 僅限於 localhost、*.localhost、127.0.0.0/8 和 [::1]。其他 Host 必須使用 HTTPS。
終端兼容性：OSC 終端通知沒有通用的跨終端標準，不支持該標準的終端會忽略相關序列。
互斥參數：
- --resume 和 --continue 互斥。
- --connect 和 --standalone 互斥。

結語¶

dsh-tui 爲 DeepSeek Harness 提供了原生的終端交互能力，支持會話持久化和文件引用索引。對於需要在命令行環境中進行智能體開發的用戶，這是一個直接、獨立的解決方案。