English | 中文
DSH-Next is an independent community-maintained source repository based on DeepSeek Harness. It is not an official DeepSeek release and is not affiliated with or endorsed by DeepSeek.
main integrates the official DeepSeek Harness master each week. The workflow uses the upstream SHA in .github/next-upstream-base as the base for a three-way integration of the current community main and a pinned official target. After validation, it advances main with a single-parent commit that records the new upstream SHA and dispatches the Windows release for that commit. Weekly sync workflow
For SSH pushes to the upstream mirror upstream-main, use a deploy key dedicated to the DSH-Next repository. Store its private key as the NEXT_MIRROR_DEPLOY_KEY secret in the next-upstream-mirror GitHub Actions environment. Restrict that environment to the main branch.
A blocked sync with a recovery artifact opens or reuses a GitHub issue for the upstream range. The issue gives the commit SHAs, the failure, and the workflow run that holds the artifact. A maintainer takes over from the issue. In a complete clone, node scripts/next-upstream-sync.mjs --help lists the recovery commands. For failures after dispatch, the maintainer uses the Windows release run.
The source-import tag records the initial source import. DSH-Next preserves the original MIT license, third-party notices, and author attribution.
The Windows release workflow runs on pushes to main and also accepts dispatch for the validated sync commit. It publishes the installer, checksums, and update feeds in public GitHub Releases. Choose win-x64-unsigned.exe from the latest Next release. Download DSH Next for Windows x64
The Next desktop app includes a Session mailbox, conversation and file-tree drag references, and per-Session directory selections. Open Manage directories in a Session header to edit its selection or save defaults for new Sessions in the Workspace. The Windows ACL backend accepts confirmed reference folders and refuses extra write requests from this dialog. The optional personal extension installer adds separately maintained plugins.
DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.
It is built on an everything-is-a-plugin architecture and powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.
Documentation: https://deepseek-harness.github.io/deepseek-harness/
DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.
Review the safety notice before running the project.
Install Node.js, then run:
pnpm dlx @deepseek-ai/dsh webThe command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. See Web UI guide.
To run from a repository checkout:
git clone https://github.com/xue-ding-e/DSH-Next.git
cd DSH-Next
pnpm install
pnpm run build
pnpm dsh webpnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.
After installing DSH Next, fully quit it, including the tray process. Run this command in Windows PowerShell to install the latest published Profile. The same command updates the extensions later.
$d = Join-Path ([IO.Path]::GetTempPath()) ('dsh-profile-' + [guid]::NewGuid().ToString('N') + '.ps1'); try { Invoke-WebRequest -UseBasicParsing 'https://github.com/xue-ding-e/DSH-Next-Profile/releases/latest/download/Install-Latest.ps1' -OutFile $d -ErrorAction Stop; powershell.exe -NoProfile -ExecutionPolicy Bypass -File $d } finally { Remove-Item -LiteralPath $d -ErrorAction SilentlyContinue }The Profile verifies the downloaded archive and installs the locked plugins using the desktop app’s bundled runtime. To install manually, download and extract the latest Windows ZIP, then run Install.cmd. Configure your accounts, Qoder PAT and optional Magpie privacy model on the new device. The installer and version locks live in DSH-Next-Profile, and plugin source lives in DSH-Next-Plugins.
- Submit feedback or bug reports through GitHub Discussions.
- Add the
dsh-plugintopic to your plugin repository for discoverability. - Join DeepSeek Harness Discord community.
See CONTRIBUTING.md.
Start with the development guide and architecture documentation.
pnpm run dev:web builds, serves, and rebuilds client bundles on source edits in one terminal, and make help lists the matching Make targets for Web and Desktop; the guide's application commands section owns the full table.
For agents, follow AGENTS.md.
@misc{deepseek-harness2026,
title={DeepSeek Harness: Everything is a Plugin},
author={DeepSeek-AI},
year={2026},
publisher={GitHub},
howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.