Beidou Platform

English | 中文

Beidou Platform is a Windows desktop edition of the open-source agent framework DeepSeek Harness (dsh): the command-line tool is packaged into a single-file installer that works out of the box with no development environment required.

• Single-file installer, double-click to install
• Desktop shortcut + one-click uninstall via "Add or remove programs"
• Bundled Node.js runtime and self-contained .NET 8 launcher (no Node / pnpm / .NET needed on the target machine)
• Automatically starts the backend service and opens a desktop window loading the Web UI
• Pre-installed dsh-web-ui skin/feature plugin suite (including the "custom skin" feature)

---

How to use the desktop edition

Install

1. Obtain the installer BeidouPlatform-Setup.exe.
2. Double-click it and follow the wizard ("Next").
3. A "Beidou Platform" desktop shortcut is created automatically.

Install location: %LOCALAPPDATA%\Programs\BeidouPlatform; app data (DSH home): %LOCALAPPDATA%\BeidouPlatform\dsh.

Launch

Double-click the "Beidou Platform" desktop shortcut. The program will automatically:

1. Start the bundled Node.js backend service (listening on 127.0.0.1:3080).
2. Open a desktop window (Microsoft Edge WebView2) loading the Web UI.

The first launch takes a few extra seconds (backend readiness waits up to 60 seconds), which is normal.

Use

• Chat with agents and use tools in the Web UI.
• Go to Settings → Plugins → Skin Center to:
  • switch between built-in skins;
  • create a custom skin (upload wallpaper / set theme colors / adjust layout), which can be saved, applied with one click, and takes effect immediately.

Uninstall

Open "Control Panel → Programs and Features (Add or remove programs)", find "Beidou Platform", and click Uninstall. The desktop shortcut and program files are cleaned up.

---

Pre-installed plugins (dsh-web-ui suite)

The following plugins are pre-installed into the DSH profile and available right after install:

• Skin center @linxin666/dsh-client-ui-skin-center (with custom skin support)
• 10 built-in skins: qq98, ths, xp, blue-fantasy, dragon-heir, harbor, miku, minecraft, trading, whale-song
• Feature plugins: task-board, git-graph, pet, live-stats, remote-web-ui, ssh, tool-describe-image, liangshen, aionui-panel, web-ui-settings
• Aggregate bundle: @linxin666/dsh-web-ui-all (mounts all of the above in one go)

---

Changes and improvements over upstream DSH

This repository modifies the original DeepSeek Harness to support desktop packaging and out-of-the-box use:

1. Single-file installer

   • Packages into a single BeidouPlatform-Setup.exe via Inno Setup, replacing the previous npx / source-run workflow.
   • The installer writes a desktop shortcut and an uninstall registry entry for one-click uninstall.

2. Bundled runtimes, zero-dependency deployment

   • Bundles a Node.js runtime (runtime/node/node.exe); the backend no longer depends on a system-installed Node.
   • The launcher is published self-contained on .NET 8, so the target machine needs no .NET runtime.

3. Desktop launcher

   • Adds apps/desktop-dotnet (WinForms + WebView2) as a desktop shell, replacing manually opening 127.0.0.1:3080 in a browser.
   • The launcher starts the backend, waits for readiness, loads the page, and stops the backend on exit.
   • Backend readiness timeout extended from 30 seconds to 60 seconds, fixing intermittent startup failures.

4. Pre-installed plugin suite

   • Pre-seeds the web profile via the DSH profile mechanism ($DSH_HOME/profiles) and mounts @linxin666/dsh-web-ui-all as the default bundle.
   • Provides a schemastery shim so plugins' bare schemastery dependency resolves to the bundled @deepseek-ai/schemastery.

5. Build pipeline improvements

   • pnpm-workspace.yaml switches to nodeLinker: hoisted + injectWorkspacePackages: true, so pnpm deploy produces a flat node_modules and avoids symlink / junction permission issues on Windows.

6. Branding and icon

   • Renamed to "Beidou Platform" with a unified icon for the installer and the app executable (a 16–256 multi-size .ico is generated from the source image at build time).

---

Rebuilding from source (for developers)

Run the following on the build machine (it needs the full toolchain; the produced installer remains zero-dependency on target machines).

Prerequisites:

• Windows
• Inno Setup 6 or 7
• .NET 8 SDK
• Node.js + pnpm

Run:

powershell -ExecutionPolicy Bypass -File build-installer.ps1

The script: installs dependencies and builds the backend → runs pnpm deploy to produce a flat deploy directory → downloads and bundles the Node runtime → generates the icon and builds the desktop launcher → pre-installs plugins into the DSH home → verifies critical files → compiles the single-file installer with Inno Setup.

The final artifact is at setup\BeidouPlatform-Setup.exe in the working directory.

---

License

Based on DeepSeek Harness, released under the MIT license.