DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

lql341 /

lql341/deepseek-harness-linux-desktop

Topic repository only

Unofficial Linux x64 (AppImage/deb) port patch set for the DeepSeek Harness desktop app, aiming at macOS-like behaviour

★ 0 Stars1 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@2c3b964b

English | 中文

DeepSeek Harness Linux Desktop

Unofficial Linux x64 desktop port of DeepSeek Harness. This repository maintains an ordered patch series and Linux build, verification and release tools. It is not affiliated with or endorsed by DeepSeek.

The default upstream base is read from ci/upstream-base-tag. The recorded verification baseline here is dsh-v0.2.2-rc.1. Linux packages bundle dsh-scnet@0.6.13. Use Actions to check the result for an exact commit.

Install a published package

The current release is v0.2.2-rc.1-linux.1, built from this repository's six patches against upstream dsh-v0.2.2-rc.1. Every release here becomes GitHub's latest, because this repository publishes one Linux line; a tag that carries -rc. only means its upstream base is a release candidate. Download its deb, SHA256SUMS and SHA256SUMS.sig, or use the installer below. The installer checks the checksum and amd64 architecture before asking apt to reinstall the package. It needs curl, Node, sha256sum, dpkg and sudo/apt on the installation host. Verify the signed manifest with node ci/verify-release-signature.mjs --manifest SHA256SUMS.

git clone https://github.com/lql341/deepseek-harness-linux-desktop.git
cd deepseek-harness-linux-desktop
bash ci/install-latest-linux.sh --tag v0.2.1-rc.5-linux.2

Without --tag, the script installs GitHub's latest release, which is the newest build here. Source changes on main and CI artifacts are separate from published releases. The series in patches/ is re-based on dsh-v0.2.2-rc.1 and reduces to six patches: the Linux port, the update gates, the SCNet setup actions, the settings-owned update and SCNet actions, the signed release trust path, and the packaged operation-report worker fix. The plugin operation history, the recovery menus and the update views are upstream in that base and no longer carried as backports.

Desktop capabilities

Area Linux behavior
Window and background work Custom caption, optional native frame, tray/Show Window, and tasks kept running after the last window closes
System integration dsh launcher, single-instance routing and registered dsh:// links
Runtime Linux target payload and bundled WASM Office conversion
Updates Settings- and menu-owned check/update actions, verified Linux package download and PolicyKit installation; client and Harness are delivered together
SCNet Fixed offline Bundle/Skill, default Desktop profile activation, preserved explicit disable/custom profile state, and local diagnostics
Developer tools Visible English/Chinese menu and native shortcuts including F12
Recovery Retrieve a saved crash report, including delayed writes and visible reveal failures
Update dialogs Owner-attached isolated views, Linux caption/fullscreen handling, cancellation and mandatory-view recovery
SCNet setup repair External Python uses unpacked files; completion/errors remain visible in the terminal and spawn failures reject the action
Plugin history Correlated manager events, a bounded local journal and an isolated report Worker for crash diagnostics
Linux menu actions Check for Updates uses the release package feed and asks before installing; Manage dsh Command is available
Release trust SHA256SUMS carries an Ed25519 signature verified before a privileged install; a published support floor reports required updates

The final seven rows describe the source patch series. See desktop follow-up for evidence and remaining differences. Real SCNet OAuth2 login is still blocked on its formal service contract and sandbox credentials. Local diagnostics and an installed Bundle do not establish authorization.

Build from source

Build on Linux x86_64, with Node >=24.9.0, pnpm 11.28.5, Git, build-network access and at least 15 GB free disk. The current upstream workspace may select its own pinned pnpm via package-manager management. Cross-building this Linux target from macOS and linux-arm64 releases are not supported by this series.

export PATCH_REPO="$HOME/src/deepseek-harness-linux-desktop"
export SRC="$HOME/src/deepseek-harness"
git clone https://github.com/lql341/deepseek-harness-linux-desktop.git "$PATCH_REPO"
sh "$PATCH_REPO/apply.sh" "$SRC"
cd "$SRC"
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run build:lib:host
pnpm --dir apps/desktop run build
pnpm --dir apps/desktop run check:package
pnpm --dir apps/desktop run package:linux:x64

Use a fresh $SRC. apply.sh checks out the pinned upstream tag, creates the Linux branch, applies every patches/*.patch in filename order with git apply --3way, and creates .env.linux. Changes are staged; they are not one commit per patch. Record the patched source with git -C "$SRC" write-tree; HEAD still names the upstream base. Build details, paths and troubleshooting are in the Linux guide.

Verification and release

PRs and relevant main pushes apply the series, typecheck the full workspace, run focused desktop regressions, build the deb, audit the SCNet payload, and install/start that same candidate on Ubuntu 24.04 under Xvfb. Draft pull requests do not start that job, and a newer push cancels an in-flight pull-request run, so work in progress cannot mail a failure for a commit that was already replaced. The ordinary second-launch window assertion is skipped in this headless session; it needs a real desktop. Published-byte verification, upgrades, AppArmor, Wayland and Debian 13 are separate manual jobs. A skipped job is not a passed platform check.

PR #5 passed 254 desktop regressions, full typecheck, packaging and installed-session checks in run 41273560891; the merged main was also verified in run 41274912984. The SCNet setup repair and bilingual docs then passed run 41278271808 with 268 desktop tests and documentation run 41278271805. The dsh-v0.2.2-rc.1 series needs its own green publish run before it becomes a release; the evidence recorded so far is in the desktop follow-up.

Publishing is manual through publish-linux-desktop.yml. It pins the build commit, records the staged patched tree, audits and installs the built bytes, signs the checksum manifest with the release key and publishes the deb, the signed manifest, the support policy and the checksums. Verify published bytes with node ci/verify-release-signature.mjs --manifest SHA256SUMS. Upstream synchronization creates reviewable PRs and never merges or publishes; a fresh upstream patch conflict is recorded as an issue instead of a failed scheduled run. See sync operations.

Documentation and project layout

English is the default documentation language. Every page has a Chinese counterpart and a language switch at the top; update both together. Documentation maintenance describes the checks.

  • Linux build and acceptance guide
  • Desktop feature follow-up
  • Desktop platform parity
  • Living TODO
  • SCNet roadmap and handoff
  • Android/HarmonyOS offline scaffold
  • patches/: active upstream diffs; patches-legacy-dsh-v0.2.0-rc.2/: historical series
  • apply.sh, verify.sh, ci/: source preparation, diagnostics, audits and installation tools

Only Linux x64 deb delivery is currently maintained here. macOS Dock/vibrancy, Windows installers and Linux permissions/compositors require distinct implementations. Native CUA, newer file interactions and macOS-only integrations are outside release parity; the parity page records the verdict and the excluded scope.

License

MIT. Upstream copyright (c) 2026 DeepSeek is retained. The project is an unofficial patch set; upstream is evolving and newer tags may require conflict resolution.

—/ 5

No ratings yet

Manifest verification required

Commit 2c3b964bba38

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout