0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

dsh-Go で DeepSeek Harness をスマホ運用する:よくある疑問 8 つで分かるローカル/リモート方式・API 設定・セキュリティ(v1.1.0)

0
Posted at

概要
dsh-Go はコミュニティ製の非公式 Android クライアントで、DeepSeek Harness(DSH)をスマホに載せる。モデルではなく harness を動かすのが肝だ。スマホ内の Ubuntu + Node.js で DSH エンジンを動かす(ローカル)か、SSH / DSH Remote で PC・サーバー上の DSH をつなぐ(リモート)。推論は常に自分で設定した API 先へ行く。確認バージョン v1.1.0(2026-11-15)。本記事は公式ドキュメント・README・Releases に基づき、dsh-Go 内での実機操作テストは行っていない。確認日 2026-11-17。

スマホで AI コーディング、と聞いて最初に湧く疑問を 8 つ並べ、順に答えていく形で進める。導入手順を頭から並べるより、引っかかる所から読めるはずだ。

Q1. そもそも何者で、どの dsh-Go を入れればいい?

dsh-Go は DeepSeek Harness の非公式 Android クライアント。本家は ccch1mneyyy/dsh-go、AGPL-3.0(sdk/・examples/ は MIT)。README は「コミュニティ製の非公式、DeepSeek とは無関係」と明記する。

「dshgo」検索で同名リポジトリが複数出るのが厄介で、別物を入れるのが最多の失敗だ:

リポジトリ 何か
ccch1mneyyy/dsh-go 本記事の Android クライアント
just-a-FA-for-name/DSHgo 別のスマホ版。Tailscale 内蔵 + PC 側 dsh プラグイン
@xiazhi88/dshgo DSH プラグイン。ローカル Web UI を LAN に公開
JopenChen/dsh-go 純 Go のインプロセス Agent 実装。バックエンド向け
項目 値(2026-11-17 確認)
バージョン v1.1.0、2026-11-15 公開
対応 Android 8.0(API 26)以上。iOS は開発中、公開ビルドなし
APK dsh-go-1.1.0-arm64.apk、221 MB。32bit ARM・x86_64 はこの版になし
配布 APK サイドロード

dsh-Go v1.1.0 Releases ページ

同名・同説明の fork も複数あるので、取得は本家 Releases か公式ダウンロードページのみから。

Q2. スマホで大規模モデルが動くの?

動かない。そこが誤解の核心だ。DeepSeek Harness(コマンド dsh)は DeepSeek のオープンソース Agent フレームワーク(MIT・TypeScript・「テクニカルプレビュー」)で、思想は「Agent = Model + Harness」。モデル自体は最適化せず、セッション・ツール・権限・Agent ループを差し替え可能なプラグインとして組み、モデル非依存にする。

スマホで動くのはこの harness エンジン だけ。エンジンはツール承認・ワークスペース読み書き・API 通信を担い、どれも計算資源を要しない。だからモデルの重みは端末に落ちない。代償として、DSH はプレビューなのでクライアントは追従が要る——v1.1.0 のノートは、音声・フローティングバー・サイレントモード・proot 更新を自動テストとビルド確認のみで実機未通過と明記している。

Q3. ローカルとリモート、どっちにすべき?

違いは どの端末でエンジンが動くか だけ。会話・ワークスペース・プラグインは各ホストに属す。

観点 ローカル リモート
エンジン位置 スマホ内蔵の Ubuntu + Node.js PC・サーバー上の DSH
前提 約 1 GB、root 不要、Termux 不要 遠隔に DSH、SSH 開放かリモートプラグイン
スマホ操作 対応(ローカル・通常モードのみ) 非対応
向き 軽いテキスト・小スクリプト PC 上の長時間タスク・コード調査

常時起動の PC・サーバーがあればリモート(容量・メモリが厳しいときも公式はリモート推奨)。スマホ単体で軽作業したいときだけローカルを入れる。注意 2 点:ローカル実行はオフライン実行ではなく、どちらも推論を設定先へ送り課金される。設定はホストに紐づくので、切替後は再確認が要る。

接続は 2 通り。SSH はホストに DSH(npm i -g @deepseek-ai/dsh)を入れ SSH 開放、マネージド起動は dsh web、初回フィンガープリント照合。DSH Remote はネットワーク設定不要・エンドツーエンド暗号化で別ネットワーク向き、ホストでリモートプラグインを入れログインし、スマホで同アカウントログイン。これは別 OSS の ds-harness-remote(github.com/liguobao/ds-harness-remote)で dsh-Go とプロトコル互換。DSH Remote 経由では画像のみ送信可、Web 表示・DS Bot・ログ書き出し不可、プラグインは開閉のみ。

Q4. インストールは安全? ハッシュはどう確認する?

  1. Releases か公式ダウンロードページから arm64 APK を取り、インストール元を許可。
  2. ハッシュ検証:dsh-go-1.1.0-arm64.apk の公開 SHA-256 は ec7d9ffbfb6cf3d5d8b0c19cd34a5933df00b9290cfe9d6dbdc05337308b3037、リリース内 SHA256SUMS と一致。PC では PowerShell の Get-FileHash で照合。ハッシュは版ごとに変わるので当日のページの値を使う。
  3. 署名が異なる APK は上書き不可。先にアンインストールが要り、会話・Linux 環境・設定が消える。

バックグラウンド維持は不確実で、省電力ポリシーが背面プロセスを止める。「バックグラウンド動作」で電池最適化を切っても OS が終了させ得る。

Q5. モデルはどうつなぐ?

4 つを分ける:互換プロトコル、Base URL、API Key、モデル ID。プロバイダ名はラベルで、送り方はこの 4 つが決める。

公式直結:DeepSeek オープンプラットフォーム(platform.deepseek.com)で Key を作り、設定 › モデルの公式 DeepSeek カードに入れる(Base URL 不要)。一覧は公式の公開リストに追従。例に出るモデル名は deepseek-flash・deepseek-v4-pro だが、口座で見える一覧に従う。

アグリゲータ(例:Crazyrouter):1 エンドポイント・1 Key で複数ベンダーを切り替えたいとき。

  • 登録ページ を開く(口座があればログイン)。
  • トークン管理 で Key を作り端末ごとに命名。完全な Key は一度だけ表示——コピー後はスクショやチャットに貼らない。
  • 有効期限・枠・モデル制限を確認(Key 作成と残高は別)。
  • モデル広場からモデル ID をコピー。例は deepseek-v4.1-flash・qwen3.8-flash。これはこのプラットフォーム独自名で、DeepSeek 公式のモデル名とは別物、混在させない。

Crazyrouter コンソール API Keys ページ、Key 値はマスク済み

dsh-Go で追加(設定 › モデル › チャネル追加):OpenAI 互換なら互換プロトコルに OpenAI(通信フォーマットであって OpenAI のモデル限定ではない)。Base URL と API Key を入れ、Base URL は /v1 まで(/chat/completions を足さない)、本例は https://api.crazyrouter.com/v1。モデル取得 で選択、無ければ 手動追加 でモデル ID をそのまま入力し、最低 1 つで保存。

dsh-Go:カスタムチャネル追加の 4 手順

DSH 公式プロバイダ設定:カスタムモデル API フォーム

つまずき所:チャネルは現在のホストに属し切替で付いて来ない。Provider ID は変更不可(リクエスト・保存セッション・既定モデル・認証参照が使う)、改名は新規+旧削除。1 プロバイダ 1 プロトコル。v1.0.16 からカスタムヘッダー対応。ランタイム初期化でカスタムチャネルは消え、保存済み DeepSeek Key だけ復元される。

Q6. 「保存」したのに動かない、どう切り分ける?

「保存成功」は「使える」ではない。3 段階で確認する:

  1. モデル一覧取得(「モデル取得」か「接続テスト」)。ガイドは接続テストを「保存済み Key でモデル一覧を読む、トークン非消費」と明記。アドレスと Key の整合しか示さない。
  2. 短い返答 1 回 で基本リクエストの疎通確認。
  3. ツールを伴う小タスク 1 件:読むファイルを先に列挙 → TODO 抽出 → その後に書き込み判断。これでストリーミング・ツール呼び出し・承認フローが通る。

dsh-Go ガイド:接続テストの説明

失敗時はまずターミナルから直接叩き、チャネル側かクライアント側かを切り分ける。下は OpenAI 互換の一般形。dsh-Go 内で未検証なので初回は少額で確認し、Key は環境変数に置きコマンドラインに書かない(PowerShell は $env:CRAZYROUTER_API_KEY):

curl -s https://api.crazyrouter.com/v1/models \
  -H "Authorization: Bearer $CRAZYROUTER_API_KEY"
症状 まず確認
モデル取得が 401 Key が完全か、現在の Base URL に属すか。検出は GET /models
形式不一致 / 一覧が空 検出範囲外の形式。モデル ID を手動追加(効果同じ)
UNKNOWN_MODEL 設定済みを選ぶ、または欠けたモデルを追加
MISSING_CREDENTIAL モデルページで Key 保存、または参照環境変数を用意
Key もアドレスも正しいのに全拒否 リクエスト形が OpenAI と異なる。ホストの cordis.patch.yml に compat.supportsDeveloperRole: false と compat.maxTokensField: max_tokens
アプリは会話可だが headless が MISSING_CREDENTIAL dsh --profile headless はアプリ保存 Key を使わない。環境変数か .env で別途設定

DSH 公式プロバイダ設定:トラブルシュート一覧

コスト:Agent は多段ループでツール出力を繰り返しコンテキストに戻すため、1 タスクの消費トークンは通常チャットより多くなりがち。端末ごとに上限枠付き Key を作り、小さく試し、コンソールで照合する。

Q7. 使う前に何に注意すべき?

README の原文は「ツールは実影響を与え、確認・遮断でも全リスクは消せない、既定の保護を残し必要な権限だけ与える」。要点 8 つ:

  1. ダウンロード:公式経路のみ・ハッシュ検証。サイドロードは審査なし。
  2. Key:端末ごと上限付き、チャット・Issue・スクショに出さない。診断バンドルは共有前に自分で確認。漏洩疑いは失効→利用量確認。
  3. データの行き先:ローカル実行はオフラインではない。プロンプトと読んだファイルはプロバイダへ、アグリゲータ利用時はその先も経由。
  4. スマホ操作:画面テキストはモデルへ、画像対応モデルにはスクショも(カード・身分証番号は先にマスク)。パスワード・認証コード・支払いは既定であなたに戻る——支払情報のある端末で制限解除しない。消灯で停止、3 分無操作で終了。Android Shell は個別許可+コマンド毎確認。
  5. 最小権限・プロンプトインジェクション:AI は Web・メッセージ・ファイル内の悪意ある指示に誘導され得る。リモートは権限限定の専用アカウント、root 不使用。高リスク操作は承認後。不可逆タスクを無人で走らせない。
  6. プラグイン:市場のリスク表示は安全保証ではない。インストールスクリプトは対象ホストで走るのでパッケージ一覧を見てから許可。初回の入力欄・クリップボード・返答読取は確認が出て、許可後は個別取消不可。
  7. 送信統計:匿名統計は既定オン(バージョン・機種・カウント類、1.0.17 からトークン合計。アカウント・Key・会話・ホストアドレス・使用モデルは含まない)、「プライバシーと共有」で無効化可。スマホ操作の Google ML Kit は独自 SDK 統計、「自動障害分析」は既定オフ。
  8. 接続と共有:SSH / DSH Remote 初回はフィンガープリント照合。認証情報はスマホのセキュア領域のみ。Web 公開前に公式「公開デプロイ」章を読む。共有リンクはエンドツーエンド暗号化だが完全リンク保持者は読める。初期化・アンインストールはローカルデータを不可逆消去。

dsh-Go README:リスク告知と免責

dsh-Go FAQ:アプリが送るデータ

Q8. 結局、誰向け? 機能と限界は?

v1.1.0 はモデルと思考深度の切替、画像、音声入力、ツール承認、割り込みとキュー送信、1 会話をミラーする Web モード、エンドツーエンド暗号化の再生リンク、スマホ操作、v1.1.0 新規の音声通話、ペット・酒場・定期タスク・ターミナル・ワークスペースを備える。

プラグイン は内蔵市場(公式/DSH Go 対応/全部)から。コミュニティ選定リスト(awesome-dsh-plugin、github.com/bruc3van/awesome-dsh-plugin など)では dsh-web-ui / DSH-better-sidebar(UI)、dsh-at-file(@ファイル)、modlens(視覚)、dsh-websearch(検索)、dsh-layered-memory(記憶)、dsh-api-dashboard(使用量)、dsh-plugin-gate(導入前走査)がよく挙がる。プラグインのネイティブ UI はホストの dsh-go ブリッジを要する(ローカルは内蔵、リモートは通常なし)ので「DSH Go 対応」表示を見る。

dsh-Go ガイド:プラグイン市場のリスク表示

向く人:既に DSH を使い机を離れても承認・引き継ぎたい開発者、常時起動マシンを SSH / DSH Remote で使う人、読み取り専用の小タスクから段階的に権限を広げられる初心者。今は控える人:支払・銀行情報のある端末の人(制限解除は不可)、不可逆タスクを無人で走らせたい人、オフライン・ローカルでモデルを動かすと期待する人、iOS のみの人。

限界:非公式でプレビュー版 DSH 依存、版間で挙動が変わり得る。一部新機能は自動テストとビルド確認のみ。DSH Remote は機能制限。バックグラウンド維持は非保証。コードは AGPL-3.0 だが名称・ロゴ・マスコットはオープンソース許諾の外で、fork は本家と作者の明記が要る。本記事は dsh-Go 内で未検証、UI と流れは公式ドキュメントとガイドに準拠、サードパーティ製プラグイン説明はコミュニティリスト由来で個別未検証。

結論:dsh-Go の価値は「ポケットの中の大規模モデル」ではなく、DeepSeek Harness の入口と承認をスマホに移すこと。安全な開始順は、APK 検証 → リモートか読み取り専用の小タスクから → 端末ごと上限付き Key → 3 段階確認 → その後にプラグインと強い権限。

参考

確認日 2026-11-17。バージョン・ハッシュ・モデル ID・ページ内容は随時変わるので当日の公式ページに従う。

  • dsh-Go リポジトリ・README・Releases・SECURITY.md:github.com/ccch1mneyyy/dsh-go
  • dsh-Go ガイド(同リポジトリ docs/guide/):モデルとチャネル、エンジンとリモートホスト、スマホ操作、プラグイン、トラブルシュート
  • DeepSeek Harness リポジトリ github.com/deepseek-ai/deepseek-harness、公式「モデル設定」deepseek-harness.github.io/deepseek-harness/guide/providers
  • DSH Remote:github.com/liguobao/ds-harness-remote
  • awesome-dsh-plugin 選定リスト:github.com/bruc3van/awesome-dsh-plugin
  • Crazyrouter 公式:crazyrouter.com。登録・トークン・モデル広場の入口は 2026 年 11 月確認
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?