MIT のコミュニティ移植（Shell）。公式 DSH デスクトップのパッケージングを Linux に移し、AppImage / deb / rpm / Arch パッケージをトレイ、グラス、フレームレスのパッチ付きで提供します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-10
ライセンス
MIT
01どんなタスクに使えるのか？
上流が明確にサポートしていない Linux で公式 DeepSeek Harness デスクトップを動かす
公式 Electron アプリ自体の AppImage / deb / rpm / Arch パッケージ。レンダラーは独自の dsh-app:// プロトコルを使い、Node / pnpm / Python ランタイムを同梱し、専用の desktop プロファイルを持つ
CLI やブラウザーのタブではなくデスクトップクライアントを使いたい Linux 利用者
ウィンドウを閉じたあとでも取り戻せるようにする（閉じる操作は隠すだけ）
メニュー付きの常駐トレイアイコン（パッチ 0013）。ウィンドウを開き直せるほか、トレイ、Application → Quit、Ctrl+Q から完全終了できる
ウィンドウを閉じたらアプリが終了したと思っている利用者
ウィンドウを macOS 版に近い見た目にする、あるいはシステムのタイトルバーを外す
任意で有効にするグラスモード（メニューバー自動非表示、サイドバーの濃度調整可）とフレームレスモード（40px のページ内キャプションと Electron 描画のボタン）
KDE、Hyprland、niri でウィンドウの見た目を指定したい Wayland 利用者
プラグインマーケットで「ホストバージョン不明」ではなく実際のバージョンを読めるようにする
パッチ 0017 がパッケージ済みの resources ルートを Linux のホストプロセスに渡すため、互換性フィルタと「互換バージョンへ更新」が機能する
Linux でマーケットからプラグインを入れる利用者
02DeepSeek Harness への導入方法
前提条件
- Releases のビルド済みパッケージ、またはソースビルドの場合は TypeScript の型ストリッピングに対応した Node 24.9 以降、npm か corepack で入れた pnpm 11、git、rpm には rpmbuild
- AppImage は FUSE 2（libfuse.so.2）が必要で、現在の主要ディストリビューションは既定で FUSE 3 しか入れていない
- GNOME のトレイには AppIndicator 拡張が必要で、新しく入れた拡張は再ログインしないと読み込まれない
インストール手順
- 01
ビルド済みパッケージを入れる: AppImage は chmod +x して実行、deb は `sudo apt install ./deepseek-harness-*.deb`、rpm は `sudo dnf install ./deepseek-harness-*.rpm`、Arch は `sudo pacman -U ./dsh-desktop-linux-*.pkg.tar.zst`
- 02
ソースからビルドする場合: `./scripts/fetch-upstream.sh`、`./scripts/apply-patches.sh`、続いて `./scripts/build.sh --all`（--dir / --appimage / --deb / --rpm も可）
- 03
Arch パッケージは `./scripts/pkgbuild-dir.sh` でツリーを展開し、./pkgbuild 内で `makepkg -si` を実行
- 04
`./scripts/verify.sh --runtime` でビルドしたランタイムのマトリクスを検証
導入成功の確認
- 成果物は `upstream/apps/desktop/.desktop-build/targets/linux-x64/unsigned-artifacts/` に出力されます（arm64 機では linux-arm64）
- `./scripts/verify.sh --runtime` が linux-unpacked に対して実機マトリクスを実行します
ロールバック
- 導入に使ったパッケージマネージャーで削除します（apt / dnf / pacman -R）。Arch パッケージは未パッケージのツリーを /opt/deepseek-harness-desktop に置き、/usr/bin にシンボリックリンクを作るだけです
03DSH 統合と能力の範囲
プラグインではありません。公式デスクトップのパッケージングパイプラインを Linux に移植するもので、パッチシリーズを使って上流ソースから公式 Electron アプリ自体をビルドし、AppImage / deb / rpm / Arch パッケージを出力します。
Linux パッケージングパイプライン
PKGBUILD で固定した上流タグのソースとパッチシリーズ→AppImage / deb / rpm / Arch パッケージ。build.sh が uname -m から linux-x64 か linux-arm64 を選ぶ
クロスビルドは非対応。上流の monorepo を取得して pnpm workspace のビルドを回すため、プラグイン導入よりはるかに重い実 Node で動くホストプロセス
パッケージに同梱した primary-runtime の Node→Electron の node モード（sharp のデコードがセグメンテーション違反になる）を避けたホストプロセス。代わりに dsh のディレクトリツリーを asar に入れない
dsh のディレクトリツリーを asar に入れないため、linux-unpacked は約 1.1 GB になるサンドボックスの選択
非特権ユーザー名前空間へのカーネル対応→対応していれば seccomp 付きの名前空間サンドボックス、なければ setuid の chrome-sandbox。AppImage は AppRun が実行時に判定し、deb / rpm / Arch は postinst で判定する
選択は設定項目ではなく、インストール時か起動時に行われるグラスモードとフレームレスモード
起動時の DSH_DESKTOP_GLASS=1 と DSH_DESKTOP_FRAMELESS=1、サイドバー濃度は DSH_DESKTOP_GLASS_TINT=0..100→macOS 版に近いレイアウト（メニューバー自動非表示、半透明のサイドバー）、またはページ内キャプションと Electron 描画ボタンだけのウィンドウ
2 つのモードは排他で、フレームレスが優先されグラスモードは stderr に警告を出して無効になる。ぼかしの有無はコンポジター次第
04誰に向いているのか？使うべきでない場面は？
向いている用途
- CLI やブラウザーのタブではなくデスクトップクライアントを使いたい Linux 利用者
- ウィンドウを閉じたらアプリが終了したと思っている利用者
- KDE、Hyprland、niri でウィンドウの見た目を指定したい Wayland 利用者
- Linux でマーケットからプラグインを入れる利用者
不向きな用途
- ソースビルドには TypeScript の型ストリッピングに対応した Node 24（ディストリビューション版の Node は非対応のことがあり、build:official の最初で失敗する）と、npm か corepack で入れた pnpm 11 が必要です。公式の standalone インストーラーや Homebrew のバイナリでは上流スクリプトが SyntaxError で落ちます。
- AppImage は FUSE 2（libfuse.so.2）を要求しますが、Debian 13、Ubuntu 26.04、Fedora 44 は既定で FUSE 3 しか入っていません。対応パッケージを入れるか、APPIMAGE_EXTRACT_AND_RUN=1 で回避します（/tmp に展開され、約 1.2 GB 余分に必要）。
- 自動更新はありません。上流の強制更新ポリシーのチャネルは desktop-win / desktop-mac のクライアント識別しか受け付けず、Linux ビルドには更新チャネルもないため、ポリシーを埋め込まず、ポーリングも自己更新もしません。
- Linux には「コマンドラインツールをインストール」のメニューがありません。ターミナルで dsh を使うには自分で入れるか、同梱の lib/bin.js をパッケージ内の primary-runtime の node で直接実行します。
- 上流のクライアント識別マッピングは Linux を desktop-mac に落とすため、Platform 側は Linux クライアントを macOS として扱います。一方 device_model は linux-x64 か linux-arm64 のままです。これは上流の挙動で、このプロジェクト由来ではありません。
- 成果物は unsigned ビルドです。
05互換性・メンテナンス・セキュリティ上の注意
- ソースビルドには TypeScript の型ストリッピングに対応した Node 24（ディストリビューション版の Node は非対応のことがあり、build:official の最初で失敗する）と、npm か corepack で入れた pnpm 11 が必要です。公式の standalone インストーラーや Homebrew のバイナリでは上流スクリプトが SyntaxError で落ちます。
- AppImage は FUSE 2（libfuse.so.2）を要求しますが、Debian 13、Ubuntu 26.04、Fedora 44 は既定で FUSE 3 しか入っていません。対応パッケージを入れるか、APPIMAGE_EXTRACT_AND_RUN=1 で回避します（/tmp に展開され、約 1.2 GB 余分に必要）。
- 自動更新はありません。上流の強制更新ポリシーのチャネルは desktop-win / desktop-mac のクライアント識別しか受け付けず、Linux ビルドには更新チャネルもないため、ポリシーを埋め込まず、ポーリングも自己更新もしません。
- Linux には「コマンドラインツールをインストール」のメニューがありません。ターミナルで dsh を使うには自分で入れるか、同梱の lib/bin.js をパッケージ内の primary-runtime の node で直接実行します。
- 上流のクライアント識別マッピングは Linux を desktop-mac に落とすため、Platform 側は Linux クライアントを macOS として扱います。一方 device_model は linux-x64 か linux-arm64 のままです。これは上流の挙動で、このプロジェクト由来ではありません。
- 成果物は unsigned ビルドです。
- 実機検証は Arch 上の KDE Plasma 6、Hyprland、niri と、Wayland x86_64 上の Ubuntu 26.04、Debian 13、Fedora 44 に限られます。aarch64 は CI のビルドと起動スモークのみで、他のディストリビューション、デスクトップ環境、X11 は未検証です。
README は MIT 表記（GitHub の判定は NOASSERTION）· 最新リリース v0.2.2rc1（2026-11-04）。文書化されたパッチシリーズで上流ソースからビルドする独立したコミュニティ移植で、DeepSeek 公式製品ではありません
06よくある質問
導入方法は？
Releases からダウンロードし、ディストリビューションに合うパッケージを使います。AppImage は chmod +x、deb は `sudo apt install ./deepseek-harness-*.deb`、rpm は `sudo dnf install ./deepseek-harness-*.rpm`、Arch は `sudo pacman -U ./dsh-desktop-linux-*.pkg.tar.zst` です。ソースビルドには型ストリッピング対応の Node 24 と pnpm 11 が必要です。
ウィンドウを閉じてもアプリが終了しないのはなぜですか？
上流の設計です。main.ts がウィンドウの close を横取りして非表示にするため、ホストと実行中のタスクは動き続けます。パッチ 0013 が常駐トレイを追加するので、トレイメニューの「開く」で戻すか、トレイの「終了」、Application → Quit、Ctrl+Q で完全終了できます。
Debian 13 や Fedora 44 で AppImage が起動しません。
これらのディストリビューションは FUSE 3 しか入れておらず、AppImage は libfuse.so.2 を必要とします。Fedora は fuse-libs、Debian 13 / Ubuntu 24.04 以降は libfuse2t64 を入れるか、APPIMAGE_EXTRACT_AND_RUN=1 で実行します（/tmp に展開され約 1.2 GB 余分に必要）。
GNOME でトレイアイコンは出ますか？
AppIndicator 拡張を入れた場合だけです。GNOME 本体は StatusNotifierItem のホストを提供しません。新しく入れた拡張はホットロードされないため、ログアウトして入り直す必要があります。トレイホストがないとアイコンは現れず、2 回目の起動でウィンドウを取り戻すしかありません。
自動更新はありますか？
ありません。上流の強制更新ポリシーのチャネルは desktop-win と desktop-mac のクライアント識別しか受け付けず、Linux ビルドには更新チャネルもないため、ポリシーを埋め込まず、ポーリングも自己更新もしません。
07関連する DSH ワークフロー
open-design
by nexu-io
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create motion, prototypes, websites, apps, dashboards, presentations, images, and videos with your team and AI agents. Share work, exchange feedback, and iterate together in one workspace.
mole
by tw93
🐹 Open-source Mac and PC cleaner. Keep your machine clean, light, and running like new. Fast CLI, plus native Mac and Windows apps.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
08データと出典
把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 官方桌面端 （`apps/desktop` 的 Electron 应用）的**打包流水线**移植到…
上游目前明确不支持 Linux（`apps/desktop/packaging/README.md`：*"Linux is not a supported Desktop release target."*）。
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-11-10。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。