⚡ dsh-fleet

Pool every idle machine — friends' PCs, LAN servers, cloud ECS — into your own distributed AI compute fleet.

One machine can dispatch to any machine in the fleet. One person, many Harnesses, parallel projects.

🧠 Every idle machine's compute is your distributed AI pool.

💻 Cross-platform — any machine that can run DSH can join the fleet
Windows · Linux · macOS · Cloud ECS · Raspberry Pi — no OS limit, any machine joins

---

🌏 简体中文 README: README.md · 中文版本请见 README.md

---

✨ Features

Feature	Notes
🪪 Machine Identity	Auto-generates machineId + permanent SK on install, zero-config
🃏 Machine Card	One-line copyable string (ID/name/IP:port/CPU/mem/NAT/SK), one-click join
🧑‍🤝‍🧑 Multi-Team	One machine can belong to many teams, each with an isolated roster
🔐 Trusted Handshake	challenge-response + HMAC-SHA256 proves SK possession; SK never crosses the wire
💓 Heartbeat	Long-lived connection + RTT/memory reporting, auto-reconnect
🚀 Task Dispatch	fleet_dispatch sends a task to any online member; results flow back
📦 Sessions Retained	Worker session auto-mounts to workspace; GUI-visible and traceable
💻 Cross-platform	Windows / Linux / macOS as master or worker
🧰 Zero Deps	Node built-ins only, no runtime dependencies
🖥️ One-click Installer	Offline harness + plugin setup for Windows / Linux

🏗️ Four-Layer Model

Layer	Contents	Impl
Identity	machineId + permanent SK, listens on a port	identity.js, listener.js
Trust	Manual add via card or IP+SK, removable both ways	card.js, roster.js
Authorization	Temp taskToken (HMAC-verified), worker holds veto	protocol.js
Control Plane	Session/workspace directives, heartbeat reporting	peer.js

Trust basis: knowing someone's permanent SK = authorized to call them. SK never travels in plaintext; the handshake proves possession via challenge-response.

📦 Install

As a DSH plugin (recommended)

# Local path install
dsh plugin --profile web add "E:\DeepSeekHarness\dsh-fleet"

# From GitHub
dsh plugin --profile web add https://github.com/scriptsnet/dsh-fleet

# From npm (recommended)
dsh plugin --profile web add dsh-fleet

Restart harness after install. On plugin start:

1. Auto-generates machine identity (data\fleet\identity.json, portable)
2. Listens on port 47900 (worker role)
3. Registers 12 model tools (below)
4. Registers /fleet/api/* routes (loopback-only)
5. Sidebar "Compute Fleet" panel appears

One-click installer (no harness on target)

File	OS	Usage
install.ps1	Windows	powershell -ExecutionPolicy Bypass -File install.ps1 -HarnessZip "D:\DeepSeek-Harness-便携版.zip"
install.bat	Windows	Double-click, or same args
dsh-fleet-agent-installer.exe	Windows	Double-click (ps2exe)
install.sh	Linux / macOS	bash install.sh [<plugin-dir>] (systemd autostart)

🛠️ Tools (12)

Tool	Purpose
fleet_card	Show local machine card
fleet_teams	List teams: members, online, compute, mem, RTT
fleet_team_create	Create a team
fleet_team_delete	Delete a team
fleet_add	Join via card or IP+SK, auto-handshake
fleet_remove	Remove a member
fleet_test	Connectivity test + handshake
fleet_memberships	List my memberships (worker view)
fleet_leave	Leave a team
fleet_refuse / fleet_resume	Refuse / resume calls (DND)
fleet_dispatch	Dispatch a task to a member

🚀 Quick Start

Join a team

"show my machine card"          → fleet_card
"add this card to team XX"       → fleet_add
"which teams? who's online?"     → fleet_teams

Or use the sidebar panel.

Dispatch a task

Use fleet_dispatch to send the task to a member of "XX fleet":
- prompt: "use bash to run echo hello and output the result"
- provider / model: deepseek-official / deepseek-v4-flash
- keyHint: inherit (use master's key) or self (use worker's own key)

Returns: member / task ID / workspace / session ID / answer / logs. Worker session auto-mounts to workspace, full transcript in GUI.

Plugin config (cordis.patch.yml)

- id: dsh-fleet
  name: dsh-fleet
  config:
    port: 47900        # listen port
    # home: <path>     # identity/roster dir, default $DSH_HOME/fleet
    # listen: true     # false = master-only, no listen

Env vars

Var	Default	Notes
DSH_FLEET_HOME	$DSH_HOME/fleet or ~/.dsh/fleet	Identity & roster dir; set per-machine for local multi-machine sim
DSH_FLEET_DISPOSE_AFTER_TASK	0	1 = dispose session after task (recovers on refresh); default keeps it GUI-visible

🔌 Protocol

JSON-lines over TCP. Handshake:

server → challenge { nonce, machineId, name }     server self-identifies + challenge
client → auth     { machineId, name, proof }      proof = HMAC(serverSK, nonce)
server → welcome | error(AUTH_FAILED)             local verify, SK never leaves
then periodic ping / pong (pong carries mem stats)

Task dispatch: submit_task { taskId, token, prompt, provider, model } → worker verifies → new workspace → agent session → execute → task_result back. token = HMAC(workerSK, taskId), anti-forgery.

🗺️ Roadmap

Implemented

• Identity / card / multi-team / connectivity / heartbeat
• Secure handshake (challenge-response), bad SK rejected
• DSH plugin: 12 tools + fleet Service + /fleet/api/* routes
• One-click installer (ps1 / bat / exe / sh)
• Task dispatch / execute / result back, worker sessions mounted
• keyHint dual mode (inherit / self), fail/timeout paths
• Per-task provider / model / preset / workspace
• Public IP / NAT detection (STUN with fallback tiers)

Planned

• Streaming task logs / artifact return
• UDP hole-punching; invite codes
• npm publish, standard dsh plugin add install

---

📄 License

MIT

---

☕ About This Project

dsh-fleet began as a spark: "pool every idle machine's compute."
Then... actually burned ~200M tokens building it.

If you build AI agents / full-stack, let's talk — collab, contract, or just chat.
📮 3292957@qq.com  ·  GitHub: @scriptsnet

💡 Built for fun, not for profit. If it helps, a ⭐ is the best support.