前言¶
DSH 的插件化思路，是把擴展能力拆成可安裝、可啓用的插件。對於希望在終端裏使用 DeepSeek Harness 的開發者來說，dsh-tui 解決的是一個具體問題：把 DSH 包裝成一個 minimal TUI，也就是一個 interactive terminal surface for DeepSeek Harness。它由 xiaoshihou514 維護，許可證爲 MIT。
這裏需要區分一下：社區插件目錄是獨立站點，不等於官方應用商店；本文也不把 dsh-tui 寫成 DeepSeek / 幻方的官方組件。下面基於已覈實事實介紹它是什麼、怎麼裝、怎麼啓用，以及安裝前需要看哪些東西。
這是什麼¶
dsh-tui 的一句話定位是：
A minimal TUI for DSH.
在已覈實資料裏，它的另一個描述是：
An interactive terminal surface for DeepSeek Harness
也就是說，它不是另一個獨立聊天客戶端，而是給 DSH 提供終端交互形態的插件。維護者是 xiaoshihou514，許可證是 MIT。
核心功能¶
已覈實的能力比較直接：
- 爲 DSH 提供 minimal TUI。
- 作爲 DeepSeek Harness 的交互式終端界面。
- 插件通過 DSH profile 啓用，示例命令是
dsh --profile tui。 - 插件包含
dsh bundle patch配置，指向./cordis.patch.yml。
這裏的 dsh bundle patch 可以理解爲插件對 DSH bundle 的補丁聲明。已覈實資料中的配置爲：
{
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}
安裝與啓用¶
已覈實資料給出的命令序列是：
npm i -g @deepseek-ai/dsh
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
第一條命令用於全局安裝 @deepseek-ai/dsh。已覈實資料沒有明確說明這條命令是否是安裝 dsh-tui 的必要前置步驟；如果本機已經具備可用的 DSH CLI，可以直接執行第二條。
第二條命令在 tui profile 下添加插件：
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
添加完成後，用下面的命令啓用這個 profile：
dsh --profile tui
典型用法¶
典型路徑很短：
1、全局安裝 DSH CLI（如果尚未安裝）：
npm i -g @deepseek-ai/dsh
2、在 tui profile 中添加 dsh-tui：
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
3、以 TUI profile 啓動 DSH：
dsh --profile tui
這個用法的關鍵在於 --profile tui。它不是普通的一次 dsh 調用，而是把 dsh-tui 放到一個獨立的 profile 裏運行，便於和其他 DSH 插件或配置分開。
環境與依賴¶
已覈實資料裏能確認的運行環境信息如下：
"engines": {
"node": "^22.19.0 || >=24"
}
這意味着 Node.js 版本建議落在 ^22.19.0 或 >=24。另外，package.json 聲明瞭包管理器：
"packageManager": "pnpm@11.19.0"
以及發佈訪問配置：
"publishConfig": {
"access": "public"
}
在 peerDependencies 方面，已覈實資料確認包含以下版本約束：
{
"@deepseek-ai/cordis": "^4.0.0",
"@deepseek-ai/cordis-plugin-loader": "^1.0.2",
"@deepseek-ai/dsh-agent": "^0.1.0-rc.5"
}
完整 peerDependencies 列表在已覈實資料中被截斷，不能據此判斷全部依賴。安裝前建議直接查看倉庫裏的 package.json。
適用場景與注意¶
適合這些場景：
- 你已經在用 DSH，但希望有一個 terminal TUI 的交互入口。
- 你希望在
tuiprofile 下單獨啓用終端界面，不直接影響其他 profile。 - 你想找一個 MIT 許可、由社區維護的 DSH 插件。
安裝前建議做三件事：
1、檢查源碼。插件以當前 dsh 進程權限運行，代碼能影響該進程內的行爲。
2、檢查許可證和依賴。本文已覈實許可證爲 MIT；peerDependencies 列表存在截斷，需要以倉庫 package.json 爲準。
3、確認 DSH 版本兼容性。npm i -g @deepseek-ai/dsh 出現在已覈實用法示例中，但是否爲必要前置步驟未明確說明，建議根據本機 DSH 安裝狀態判斷。
社區目錄鏈接只表示該插件有一個目錄頁入口，不代表它是官方應用商店中的組件。
