Back to directory

deepseek-harness-studio

Maintenance: Active

fufankeji/deepseek-harness-studio

Zero-code desktop studio for DeepSeek Harness on Windows and macOS — plugin discovery, trending picks, one-click install and management, plus AI recommendations.

View on GitHubHomepage
$ git clone https://github.com/fufankeji/deepseek-harness-studio.git

619

stars

62

forks

TypeScript

Language

MIT

License

2026-08-15

Created

2026-09-01

Last push

MIT-licensed Electron desktop client that hosts DeepSeek Harness locally — it starts `dsh web` in-app for zero-code sessions, plugin discovery/install, Preset Square and vision routing on macOS arm64 and Windows x64.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Run DeepSeek Harness as a zero-code desktop app on macOS and Windows, without touching the command line

    A local desktop workspace keeping DeepSeek Harness sessions, workspaces, models, tools, Skills and plugin capabilities, hosted by a `dsh web` service the app starts and manages

    Users who want a DeepSeek Harness desktop experience with no Node.js setup or terminal commands

  • Discover, install and manage DSH plugins and Agent Presets from a visual plugin center

    Verified plugin installs from the public npm registry with enable/disable/update/uninstall management, plus one-click Agent Preset installs usable in new sessions

    DeepSeek Harness users who want to browse, verify and install ecosystem plugins without memorizing package names or CLI flags

  • Give DeepSeek image understanding in desktop conversations via vision enhancement

    Images routed to the exact model's native image input, or to a verified Bailian/OpenRouter-compatible vision path, covering screenshots, error dialogs, design mocks and charts

    Users who paste product screenshots, error screens or design files into DeepSeek Harness chats and want the agent to actually see them

02How to install into DeepSeek Harness

Prerequisites

  • macOS arm64 or Windows x64 machine — preview installers are published only for these platforms
  • No Node.js or pnpm needed for the packaged desktop app
  • For source development only: Node.js `^22.19.0 || >=24.0.0` and pnpm `11.7.0`

Installation steps

  1. 01

    Download the macOS arm64 preview ZIP or the Windows x64 Setup.exe from this repo's GitHub Releases (desktop installers are not distributed via third-party download sites)

  2. 02

    macOS: unzip the preview, drag `DeepSeek Harness.app` into Applications, then run `xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"` and `open "/Applications/DeepSeek Harness.app"` because the preview is not Apple-notarized yet

  3. 03

    Windows: run `DeepSeek-Harness-Desktop-Windows-x64-0.1.0-rc.14-Setup.exe` directly to install

  4. 04

    From source instead: `git clone https://github.com/fufankeji/deepseek-harness-studio.git`, then `pnpm install` and `pnpm run dev:desktop` to build the required modules and launch the desktop dev environment

    $ git clone https://github.com/fufankeji/deepseek-harness-studio.git

Verify the integration

  • After the first successful open on macOS, the app can be launched like a normal application from Finder or the Dock

03DSH integration and capability boundaries

DSH integrationNative runtime

Native desktop host: the Electron main process starts and manages a local `dsh web` service, wrapping the DeepSeek Harness core and Web workspace in a zero-code desktop app

  • Local Harness Host (`dsh web` lifecycle)

    the bundled DeepSeek Harness core and Web workspacea local `dsh web` service started by the desktop main process, kept ready in the app window and shut down when the app exits

    starts and manages a local `dsh web` host process on your machine
  • Plugin discovery & public plugin center

    the online public `dsh-plugin` catalog and published npm packages (short name, full npm name, or mapped GitHub repo)curated/recent/trending plugin feeds, natural-language `/find-plugins` search, verified installs, and enable/disable/update/uninstall management

    reads the online plugin catalog and downloads packages from the public npm registryinstalls plugins locally and restarts the Harness Host after installuninstall keeps config and plugin data by default; data cleanup requires separate confirmation
  • Vision enhancement with auto routing

    images attached in the chat input (screenshots, error screens, design mocks, charts, photos)the original image sent to the model's native image input, or a verified Bailian/OpenRouter-compatible vision path — one path per image

    when enabled, images enter the model-visible context and are sent to the selected model/vision provider; compatible vision requires a verified provider
  • Preset Square & Application Center

    Fufan-official and community Agent Presets (7 built-in real-scenario workflows) and built-in AI applications such as FF–LLM Wikione-click preset installs usable directly in new sessions, and full AI apps with their own UI, data directory and runtime flow

    preset installs are verified (source, size, digest, archive path) and written to the local user Preset directoryFF–LLM Wiki writes documents, Wiki, knowledge graph and SQLite data to an app-specific directory under DSH Home

04Who is it for? When not to use it?

Good for

  • Users who want a DeepSeek Harness desktop experience with no Node.js setup or terminal commands
  • DeepSeek Harness users who want to browse, verify and install ecosystem plugins without memorizing package names or CLI flags
  • Users who paste product screenshots, error screens or design files into DeepSeek Harness chats and want the agent to actually see them

Not for

  • The macOS preview package is not Apple-notarized yet, so first launch requires removing the quarantine attribute via `xattr`; previews are only macOS arm64 and Windows x64, distributed exclusively through this repo's GitHub Releases.
  • Current downloads are development preview assets (rc.14); signed official releases (macOS `.dmg`, Windows `.exe`) will only arrive later, so preview behavior may change.

05Compatibility, maintenance and safety notes

  • The macOS preview package is not Apple-notarized yet, so first launch requires removing the quarantine attribute via `xattr`; previews are only macOS arm64 and Windows x64, distributed exclusively through this repo's GitHub Releases.
  • Current downloads are development preview assets (rc.14); signed official releases (macOS `.dmg`, Windows `.exe`) will only arrive later, so preview behavior may change.
  • Source development requires pinned runtimes — Node.js `^22.19.0 || >=24.0.0` and pnpm `11.7.0`; actual model calls additionally need user-configured credentials in settings.
2026-08-152026-08-19desktop-preview-v0.1.0-rc.14

MIT · actively maintained (latest release desktop-preview-v0.1.0-rc.14, 2026-08-20)

06Frequently asked questions

How does Studio integrate with DeepSeek Harness?

It is a native desktop host, not an MCP add-on: Studio is built on the deepseek-ai/deepseek-harness Harness core, Cordis plugin system and Web UI, and the Electron main process starts a local `dsh web` service, waits until it is ready, and shuts the Host down when the app exits. Studio 0.1.0-rc.14 integrates DeepSeek Harness 0.1.0-rc.8 core and Web capabilities.

Which platforms are supported, and where should I download?

Preview builds ship for macOS arm64 (ZIP) and Windows x64 (Setup.exe) exclusively via this repo's GitHub Releases — no third-party download sites. On macOS the preview is not Apple-notarized yet, so run `xattr -dr com.apple.quarantine` on the app before first launch.

Do I need Node.js, pnpm or an API key?

The packaged desktop app needs no Node.js or pnpm. Downloading, installing and launching requires no API key up front; you only configure model services and credentials in settings when you actually call models (FF–LLM Wiki's generative RAG additionally needs your own `DEEPSEEK_API_KEY`).

How does online plugin installation work?

The plugin center locates packages published to the public npm registry by short name, full npm name, or a mapped GitHub repo. It downloads a pinned version, verifies package identity, integrity, Bundle declaration and local compatibility, then installs and restarts the Harness Host to confirm it runs. Uninstall keeps config and data by default.

Where do images and data go when vision enhancement is on?

If the exact model declares image support, the original image is sent natively; otherwise a verified Bailian or OpenRouter-compatible vision path is used — the two paths are mutually exclusive and each image is processed once. Turning the switch off keeps images out of the model context. Custom background images are cropped locally and never uploaded.

08Data and sources

  • Author-claimedgithub.com8000674e0e67…

    DeepSeek Harness Studio 使用 Electron 承载 DeepSeek Harness 的 Web 工作区,并由桌面主进程启动和管理本地 `dsh web` 服务。

  • Author-claimedgithub.com8000674e0e67…

    **本地 Harness Host**:桌面主进程启动 `dsh web`,等待本地服务就绪,并在应用退出时关闭 Host 进程。

  • Author-claimedgithub.com8000674e0e67…

    本项目基于 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) 的 Harness 核心、Cordis 插件体系和 Web 界面继续…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.