DeepSeek Harness

DeepSeek Harness (dsh) is a plugin-based agent harness where everything is a plugin — models, tools, skills, sessions, storage, the agent loop, and even the UI are all replaceable Cordis plugins, freely recomposed per profile. It ships both as a CLI/Web harness and as a native desktop app (deepseek-harness-desktop).

Community fork: this repository is a community derivative of deepseek-ai/deepseek-harness, maintained by PineSound, adding a desktop app, plugin marketplace, image recognition, and a release channel on top of the unchanged core harness. This is not the official DeepSeek repository. Full list of changes: MODIFICATIONS.md · MODIFICATIONS.zh.md.

---

Proof

---

What it is

An agent harness assembled from plugins. Instead of a monolithic binary, every capability lives behind a documented seam — Service Definition / Provider / Consumer — so you swap tools, skills, storage, terminal, web, or sandbox without touching the loop. Runs are traceable: everything a model sees is reconstructable from the session log.

Why it is different

• Everything is a plugin — models, tools, skills, sessions, storage, loop, and UI are replaceable, recomposable units.
• Traceable by default — model-visible input is reconstructable from the session log, not a black box.
• A native desktop, not just a browser tab — zero-dependency installers for macOS and Windows.
• Open & extensible — a documented seam for every capability; the plugin ecosystem is growing.

Features

Desktop app (native)

• Double-click to launch — no browser tab or URL needed. The Electron shell spawns the real dsh on loopback and opens a native window.
• Zero external dependencies — the installer bundles the full harness runtime, vendored pnpm, and a platform Node.
• Cross-platform — macOS (.dmg) and Windows (.nsis) installers, Chinese menus, branded icons.
• Update mechanism — the About page checks an online releases.json; desktop and publish site share one manifest.

Plugin marketplace

• Visual plugin list with search, status, and enable/disable; required system plugins are guarded.
• Install from npm / tarball / GitHub via the built-in pnpm, with multi-mirror fallback and no-restart hot reload.

Image recognition

• An OpenAI-compatible vision provider (e.g. Alibaba DashScope) fills the gap for text-only models; the vision key / endpoint / model are configured independently of the chat model.

Skill manager

• Manage local skills from the settings UI: list, install, uninstall, enable/disable, and edit descriptions.

---

How it works

The desktop is a thin launcher: it spawns the real dsh (web profile) as a separate system-Node child, parses the readiness URL, and opens a window at that address. Native addons keep their system Node ABI and are never loaded under Electron.

---

Get started

1. Desktop (recommended)

Download the installer for your platform from the publish site — https://deepseek.pinesound.cn/. No install steps; on first open, unsigned builds may need right-click → Open.

2. CLI / Web (npm)

Install Node.js, then run:

npx @deepseek-ai/dsh web

The Web UI is served at http://127.0.0.1:3080 by default.

3. From source

git clone https://github.com/PineKings/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Desktop development

pnpm install
pnpm run build          # builds lib + the web frontend dist
pnpm desktop:dev        # opens the desktop window

Packaging a release

pnpm desktop:pack                                          # build lib+web, assemble the self-contained harness, then electron-builder: .dmg / .nsis
pnpm desktop:verify                                        # prove the packaged app's harness is self-contained and boots
pnpm --filter @deepseek-ai/dsh-desktop run stage-release   # copy installers + manifest into the publish site

Quality gates

pnpm run typecheck
pnpm run lint
pnpm run test
pnpm run test:coverage
pnpm run test:snapshot     # keyless replay of assembled transcripts

---

Repository layout

apps/        cli, web, desktop (Electron shell)
packages/    @deepseek-ai/dsh-<pkg> plugin workspaces
vendor/      vendored Cordis source
docs/        architecture, user guide, cookbook
assets/      readme visuals

---

Community and support

• Publish site: https://deepseek.pinesound.cn/
• Desktop repo: https://github.com/PineKings/deepseek-harness-desktop
• Upstream: https://github.com/deepseek-ai/deepseek-harness
• Tag plugins with the dsh-plugin topic for discoverability.

---

License

MIT. This project is a derivative of deepseek-harness (MIT); the original copyright is preserved. Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.