DSH SSH Control Center

English | 中文

A unified, non-intrusive SSH control center plugin for DeepSeek Harness (DSH) (@dsh-external/dsh-ssh-control).

This plugin equips DSH with cross-platform (Linux & Windows), encoding self-healing (UTF-8 & GBK), stateless, and multi-host concurrent dispatch capabilities. AI agents can seamlessly interact with remote Linux, NAS, Windows, and container hosts in the same session without hijacking or breaking the native local development environment.

---

📸 Settings & Dashboard Preview

---

🌟 Key Features

• Unified Composite Hub (ssh_control): Consolidates remote command execution, file IO, file transfer (upload/download), container inspection (docker), dynamic logs (tail), and port tunnels into a single tool, reducing Tool Schema token overhead by 85%+.
• Cross-Platform Dual-Dialect (Linux POSIX + Windows PowerShell): Automatically senses remote OS types. Uses standard POSIX syntax for Linux hosts and PowerShell commands/paths for Windows hosts.
• Intelligent Encoding Self-Healing (UTF-8 + GBK/CP936): Native multi-encoding detection and auto-transcoding for Windows Chinese systems, eliminating broken characters and garbled output.
• Bi-Directional File Transfer (SCP Stream): Supports single file and directory upload (upload) and download (download), with multi-host batch dispatch.
• Batch Multi-Host Concurrent Dispatch: Natively supports comma-separated targets (e.g. server: "nas-server, app-node, web-cluster"). Powered by Promise.all concurrent SSH pipes for parallel batch execution and aggregated reporting.
• Structured Container Inspection (Docker): Real-time structured extraction of container states, images, ports, and health status.
• Dynamic Log Tail & Filter (Tail + Grep): Fast bounded log inspection from the end of files with regex error filtering (ERROR|FATAL).

---

🏛️ Architecture Overview

---

🛠️ Tool Specification (ssh_control)

DSH exposes a single compound tool ssh_control:

Action	Parameters	Description
exec	server, command, workdir?, timeoutMs?	Execute shell commands on single or multiple hosts in parallel (cross-platform)
read	server, path, offset?, limit?	Read remote files bounded by lines
write	server, path, content	Write remote file content via stdin stream (zero quoting loss)
upload	server, localPath, remotePath, recursive?	Upload local file or directory to remote host(s)
download	server, remotePath, localPath, recursive?	Download remote file or directory to local machine
tail	server, path, lines?, pattern?	Tail end of logs with optional regex/keyword filtering
docker	server, command?	Structured Docker container inspection or docker commands
status	server?	Probe target host uptime, memory, OS, and all disk mount watermarks
tunnel	server, port, targetPort?, tunnelAction	Manage background SSH port-forwarding tunnels
list	none	Parse local ~/.ssh/config to discover available SSH hosts
attach / detach	server?, path?	(Optional) Bind or unbind default server for active session

---

🚀 Getting Started

1. Installation

# Option A: One-click install from GitHub (prebuilt bundles included)
dsh plugin --profile web add github:pipipigu/dsh-ssh-control

# Option B: Local development via link
dsh plugin --profile web add link:/path/to/dsh-ssh-control

# Launch DSH Web
dsh web

2. Usage Examples

Scenario 1: Status & Multi-Mount Disk Watermarks

{
  "action": "status",
  "server": "nas-server"
}

Scenario 2: Batch Upload to Multiple Servers

{
  "action": "upload",
  "server": "app-node-01, app-node-02",
  "localPath": "dist",
  "remotePath": "/srv/web"
}

Scenario 3: Log Extraction with Error Filtering

{
  "action": "tail",
  "server": "web-cluster",
  "path": "/var/log/app.log",
  "lines": 100,
  "pattern": "ERROR|FATAL"
}

---

🧪 Testing & Verification

# Run typecheck and all 24 unit test suites
pnpm run check

# Run automated isolated port boot check & health probe in DSH root
./test-boot.sh

---

📄 License

Licensed under the Apache-2.0 License.