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 许可证。