d3cker/dsh-open-terminal

用于 DeepSeek Harness 的 OpenTerminal

用于 DeepSeek Harness 的 OpenTerminal 为 DSH Web 配置文件中的每个工作区添加了交互式终端、文件管理器和 OpenTerminal 工具。它连接到现有的 Open Terminal 服务器，无需 MCP 配置。

mainwindow

功能

- 交互式终端 —— 由 WebSocket 支持的 xterm.js 终端，带滚动回看功能。
- 浮动窗口 —— 终端在聊天上方打开，保持聊天可交互，且仅通过 × 按钮关闭。
- 响应式布局 —— 窗口自适应浏览器视口，并在窄屏显示器上使用可用的屏幕区域。
- 文件管理器 —— 浏览目录、上传多个文件、下载和删除文件、编辑文本文件，以及预览图片或 PDF。
- 代理工具 —— DSH 代理可以通过 open_terminal_ 工具管理进程并操作文件。
- 配置文件级访问 —— 侧边栏按钮和工具在使用已安装 DSH 配置文件的每个工作区中均可用。
- 受保护的凭据 —— Open Terminal API 密钥存储在 DSH Credentials 中，不会暴露给浏览器。

filebrowse

要求

- DeepSeek Harness 0.1.1-rc.2，或兼容版本；
- Node.js ^22.19.0 或 >=24；
- 从源代码构建包时需要 pnpm；
- 一个正在运行的 Open Terminal 服务器及其 API 密钥；
- 一个 DSH Web 配置文件，默认名为 web。

构建安装包

在插件目录中，安装依赖、验证包并创建 tarball：

pnpm install
pnpm run check
pnpm pack

pnpm pack 会根据包名和 package.json 中的 version 字段创建一个文件：

dsh-open-terminal-.tgz

要在不解压的情况下检查包内容：

tar -tzf dsh-open-terminal-.tgz

安装

安装附加到当前 GitHub 发行版的预构建包：

dsh plugin --profile web add "https://github.com/d3cker/dsh-open-terminal/releases/download/v0.1.4/dsh-open-terminal-0.1.4.tgz"

或使用 pnpm 版本：

pnpm dsh plugin --profile web add "https://github.com/d3cker/dsh-open-terminal/releases/download/v0.1.4/dsh-open-terminal-0.1.4.tgz"

使用名为 dsh-open-terminal-.tgz 的发行版资源。仓库 URL 和 GitHub 自动生成的 Source code 归档包含源文件，并且在安装期间需要权限才能运行构建脚本。

重启 DSH Web 配置文件，然后刷新浏览器。该插件适用于使用该配置文件的所有会话和工作区。对于应使用该插件的每个其他 DSH 配置文件，请分别安装。

要验证该插件是配置文件配置的一部分：

dsh --profile web --dump-config

输出应包含：

- id: open-terminal
name: dsh-open-terminal

配置

1. 在 DSH Web 中打开 设置 → 插件 → OpenTerminal。
2. 设置 OpenTerminal URL。打包的默认值为
http://192.168.0.74:7000；必要时将其替换为你的服务器地址。
3. 将凭据引用保留为 OPEN_TERMINAL_API_KEY，或输入另一个
DSH 凭据引用。
4. 在只写的 API key 字段中输入 API 密钥。
5. 可选地调整请求超时、工具输出限制以及上传/代理
请求体大小限制。默认上传限制为 8 MiB，最大为 64 MiB。
6. 点击 保存设置，然后点击 测试连接。

通过回环 DSH 地址（例如
http://127.0.0.1:3080）打开设置页面。DSH 不允许远程页面修改全局
设置或凭据。

configuration

使用终端

点击左侧边栏中的 OpenTerminal。终端会在聊天
右侧的浮动窗口中打开。

- 使用鼠标滚轮或触控板滚动终端。
- 终端打开时继续使用聊天。
- 在 Terminal 和 Files 之间切换，而无需关闭窗口。
- 使用窗口右上角的 × 按钮关闭窗口。

窗口会随视口缩放。在窄屏幕上，它会使用可用的
屏幕区域，以便终端及其控件保持可访问。

使用文件管理器

在 OpenTerminal 窗口中打开 Files 标签页。

- 使用 Up 移动到父目录。
- 使用 Refresh 重新加载当前目录。
- 使用 Upload… 选择并上传一个或多个文件。
- 选择一个文件并点击 Download 将其保存到本地。
- 选择一个文本文件进行编辑，然后点击 Save。
- 选择图像或 PDF 进行预览。
- 点击 Delete 并确认提示以删除文件。

文件操作是在运行 Open
Terminal 的机器或容器上执行的，而不是在运行浏览器的机器上执行。

代理工具

DSH 代理会自动获得 open_terminal_ 工具。它们可以：

- 列出、启动、检查、交互和停止进程；
- 列出、读取、写入、替换、搜索和检查文件。

无需选择 MCP 服务器或进行单独的 MCP 配置。

更新

从当前 README 运行安装命令，然后重启 DSH Web
配置文件。该命令指向附加到相应 GitHub
发布版本的软件包。

卸载
bash
dsh plugin --profile web remove dsh-open-terminal

移除插件后重启 DSH Web 配置文件。

安全说明

Open Terminal API 密钥允许在 Open
Terminal 服务器上执行命令和访问文件。使用可信、隔离的服务器，将 DSH Web 限制为
可信用户，并在连接跨越不受信任的
网络时使用 TLS 或 VPN。

许可证

MIT