DSH (DeepSeek Harness) 的默認交互方式通常基於命令行。對於習慣圖形化界面或需要同時查看對話、代碼、任務和會話列表的開發者,單一終端窗口可能難以滿足複雜場景的需求。dsh-tvision 插件引入了 Turbo Vision 風格的字符單元窗口管理器,旨在爲 DSH 智能體提供一個結構清晰、支持重疊窗口的交互環境。
功能定位¶
這是一個爲 DeepSeek Harness 智能體設計的字符界面窗口管理器。它具備以下核心特性:
- 窗口管理:在紋理桌面上顯示重疊的邊框窗口。
- 交互控件:包含 Borland 風格的菜單欄、功能鍵條以及鼠標拖拽功能。
- 皮膚系統:內置五種不同的界面皮膚。
- 插件形式:作爲標準的 DSH 配置包安裝,而非對主程序的分支 fork。
安裝與啓用¶
使用此插件前,需確保環境滿足以下條件:
* Node.js 版本 ^22.19 或 >=24
* 已安裝 dsh CLI 工具
- 克隆倉庫並安裝依賴
git clone https://github.com/hongxin/dsh-tvision
cd dsh-tvision
npm install
npm run build
- 將其添加到 DSH 配置文件中
dsh plugin --profile tvision add "$(pwd)"
典型用法¶
安裝完成後,可以通過以下命令啓動或使用該插件。
本地演示¶
如果僅想查看界面效果,無需配置 API Key,可以直接運行演示腳本:
# 啓動默認皮膚(Turbo Vision 藍)
node lib/demo.js
# 列出所有可用皮膚
node lib/demo.js --list-skins
# 使用特定皮膚(如琥珀色 CRT)
node lib/demo.js --skin amber
啓動 DSH 會話¶
通過 --profile tvision 參數啓動智能體交互:
# 啓動交互
dsh --profile tvision
# 恢復指定會話
dsh --profile tvision --resume <session-id>
# 啓動時禁用鼠標
dsh --profile tvision --skin amber --no-mouse
更新插件¶
dsh plugin --profile tvision up dsh-tvision
配置說明¶
API 配置¶
在使用前,必須配置 DeepSeek 的 API 密鑰。
- 環境變量:設置
DEEPSEEK_API_KEY。 - 文件配置:在啓動目錄或
$DSH_HOME下創建.env文件。 - 自定義端點:若使用本地或自託管端點,可設置環境變量
DEEPSEEK_BASE_URL,或在$DSH_HOME/settings.yaml中設置llm-deepseek.baseURL。
更新檢查¶
插件啓動時會自動檢查更新。如需禁用此檢查,可在配置文件的 tvision 行中設置 updateCheck: false。
許可證¶
本項目採用 MIT 許可證。