dsh-webui-m3e
日本語 | English | 简体中文
DeepSeek Harness（DSH）を、スマートフォンで使いやすい Material 3 Expressive の画面で操作するためのプラグインです。
セッションの一覧
会話のチャット
ツールの承認
対応待ち
[!NOTE]
個人のプロジェクトで、DeepSeek の公式のものではありません。開発中であり、不具合がある可能性があります。ご利用には十分ご注意ください。
Quick Start
DSH が動いている端末で実行します。
dsh plugin --profile web add https://github.com/AliceSaikawa/dsh-webui-m3e/releases/download/v0.0.8/dsh-webui-m3e-0.0.8.tgz
npm レジストリには公開していないため、名前だけの add dsh-webui-m3e では導入できません。
web は例です。実際に Web 画面を動かしているプロファイルを指定してください。間違った名前でも新しいプロファイルが作られるため、追加成功だけでは接続先が正しいとは限りません。
対応版は DSH 0.2.0-rc.2 のみです。通常の npm インストール版 DSH CLI は PATH 上の pnpm を使います。DSH 自身には Node の下限宣言がありませんが、CLI が使う commander 15 は Node >=22.12.0、pnpm 11.17.0 は >=22.13 を要求します。DSH と使用する pnpm の両方の要件を満たす Node を用意してください。
動作確認環境は macOS 27.2、Node.js 26.7.0、pnpm 11.17.0 で、依存側の下限宣言を M3E の動作保証の下限とはしていません。
M3E には追加で導入する実行時の依存パッケージはありません。M3E のソース取得・ビルド・開発依存の導入は不要です。
追加後、いつもの標準画面（http://<host>/?ui=classic）でログインしてから、http://<host>/m3e/ を開きます。更新・旧版への復帰では Host のコードを切り替えるため、必ずそのプロファイルの Host を再起動してください。
Desktop 版には 上流で同梱 pnpm を使う経路の説明があります。Desktop はこの版・この環境では確かめていません。通常 CLI の確認結果と区別してください。
できること
- 会話：AI とのやり取り、ツールの実行結果、考えた内容を、スマートフォンの幅で読めます。記録を時間の順に並べた「トレース」にも切り替えられます。
- 返事：ツールの承認、AI からの質問、プランの確認に、どの画面にいても下からのシートで答えられます。
- 対応待ち：返事が必要な会話と、終わった会話をまとめて見られます。
- 入力：画像の添付、ファイルやコマンドの候補、モデルや権限の切り替えができます。
- そのほか：会話の検索、DSH の設定と API キーの登録、ホーム画面に追加して使う Web アプリ
今の DSH の画面はそのまま残ります。端末ごとに、どちらの画面を使うかを選べます。
必要なもの
- DeepSeek Harness 0.2.0-rc.2
- DSH と pnpm の要件を満たす Node.js、および PATH 上の pnpm（通常 CLI）。版の前提は上の Quick Start を参照してください。
更新・版の確認・削除
入っている版は JSON の dependencies.dsh-webui-m3e.version、取得元は resolved で確認します。
dsh plugin --profile web list dsh-webui-m3e --depth 0 --json
更新は、リリースの一覧から対応する版を選び、その添付 tgz の URL で追加し直します。URL の形は https://github.com/AliceSaikawa/dsh-webui-m3e/releases/download/v<version>/dsh-webui-m3e-<version>.tgz です。次は 0.0.8 への移行例です。ローカル tgz 版を使っている人も、同じプロファイルで実行し、Host を再起動して上の一覧を確認してください。利用者による版番号の手編集は不要です。
dsh plugin --profile web add https://github.com/AliceSaikawa/dsh-webui-m3e/releases/download/v0.0.8/dsh-webui-m3e-0.0.8.tgz
将来の新版から戻す場合も、リリースの一覧から確認済みの互換版の URL を選んで追加し直し、Host を再起動します。0.0.8 に戻す場合は同じコマンドです。以前配布した 0.0.7 と DSH 0.2.0-rc.2 の組合せは復帰先にしないでください。手元に保管した互換版の tgz に戻す形は次のとおりです。
dsh plugin --profile web add file:/path/to/dsh-webui-m3e-<version>.tgz
削除する前に http://<host>/?ui=classic を開きます。削除後は /m3e/ が 404 になるので、同じ標準画面を使います。
dsh plugin --profile web remove dsh-webui-m3e
取得時に 404 ならリリースの一覧でタグ・添付ファイル名・URL、pnpm が見つからない場合は PATH、画面に現れない場合はプロファイルと Host の再起動を確認してください。失敗時には CLI が診断ログの場所も表示します。
ソースからビルドする場合は 開発・配布の手順を参照してください。
使い方
- いつもの DSH の画面（
http://<host>/）で、一度ログインします。
http://<host>/m3e/ を開きます。- iPhone では、Safari の共有メニューから「ホーム画面に追加」すると、アプリのように開けます。
画面を切り替える
この端末でどちらの画面を使うかは、次のどれかで選べます。選んだ内容は端末ごとに保存されます。
- いつもの画面の「設定 → 一般 → この端末で M3E の画面を使う」
- この画面の「設定 → 今の画面に戻す」
- URL に
?ui=m3e か ?ui=classic を付けて開く
どちらかの画面がうまく開かないときは、http://<host>/?ui=classic を開くと、いつもの画面に戻れます。
注意
- 画面の文言は日本語だけです。
- DSH の内部のライブラリ（
@deepseek-ai/cordis、@deepseek-ai/dsh-client-store）を同梱しているので、DSH の版によっては動かないことがあります。
- 画面の試験は主に偽のデータで行い、DSH とのつながりは隔離した実物の DSH と偽の LLM で確かめています。この対応版では、本物の LLM と iPhone の Safari・ホーム画面に追加した Web アプリでの動作は未確認です（確認の範囲の詳細は docs/dsh-compatibility.md）。
- 開発の方法と仕組み、検証の記録は docs/development.md にあります。
ライセンス
MIT です。LICENSE を見てください。
