dsh-pet-ja 🐾🇯🇵
DeepSeek Harness(DSH)のデスクトップペットプラグイン dsh-pet を日本語化した、非公式のフォークです。
元プロジェクト: https://github.com/PC2005-cloud/dsh-pet (作者: PC2005-cloud) ベースバージョン: dsh-pet 0.4.8
本リポジトリは原作者・DeepSeek のいずれからも公認されたものではありません。非公式の二次創作物です。
これは何か
dsh-pet は、DSH の画面に透明アニメーションのペットを住まわせるプラグインです。非常に完成度が高いのですが、UI の文言が中国語で統一されています(設定ページとチャットパネルは 8 言語対応、日本語も含まれます)。
本フォークは、日本語ロケールでは日本語化されない部分(右クリックメニュー、吹き出し、通知、コマンドなど)を日本語に置き換えたものです。
日本語化した範囲
| 対象 | 内容 |
|---|---|
| 右クリックメニュー | アクション / 表示位置 / 残高を見る / やること / ひとりごと / おしゃべり / 画像 / 寝る・起きる / 初期位置に戻る / その他 |
| メニュー内の分類 | 小ワザ / 遊び / 食べもの / 季節行事 / 文字もの、待機 / 方向転換 / ドラッグ / クリック反応 / 移動 |
| アニメーション名 | 114 種すべて(例: 悠闲哼歌 → のんびり鼻歌) |
| 表情画像名 | 27 種(例: 可爱 → かわいい) |
| 吹き出し | 作業ステータス 6 段階、寝る / 起きる / 拒否の台詞 |
| 残高バブル | 残高 / ピーク・オフピーク / 枠の使用率 / リセット済み / 今期 など |
| 待办リマインド | 「◯◯の時間だよ、忘れずにね」など |
| 天気・環境バブル | 天気 / 体感 / 湿度 / 風速 / 観測 / いまは天気を取得できません |
| システム通知 | 会話が完了しました / 生成に失敗しました / 出力が打ち切られました / 権限を要求しています など |
| スラッシュコマンド | /pet /chat /balance の説明と結果メッセージ |
| 「白ごはん」機能 | 台詞プール 6 場面 × 3 句、トースト、エラー文 |
残っている中国語
以下は未対応です(いずれも画面に出ないか、異常時のみ表示されます)。
- 開発者向けのコンソールログ
- 一部のエラー・フォールバック文言
- 設定ページ内の未訳キー(上流の
zh辞書由来。日本語ロケールではja辞書が優先されます)
インストール
前提
- Node.js 22.12 以上
- DSH 0.2.2-rc.3(
dsh --versionで確認) - Windows / macOS / Linux
手順
git clone https://github.com/hosimitu/dsh-pet-ja.git
cd dsh-pet-ja/dsh-pet
# 依存導入とビルド(lib/ はリポジトリに含まれないため必須)
npm install
npm run build
DSH のプロファイルへ導入します(--profile は使用中の環境に合わせてください)。
# ブラウザ版(dsh web)
dsh plugin --profile web add link:/path/to/dsh-pet-ja/dsh-pet
# デスクトップアプリ版
dsh plugin --profile desktop add link:/path/to/dsh-pet-ja/dsh-pet
導入後、DSH を再起動してください(ホスト側のコードはプロセスに常駐します)。
link:の代わりにfile:を使うと、パッケージがプロファイル配下へコピーされます。編集の反映を即座に試したい場合はlink:が便利です。
元に戻す
dsh plugin --profile web add dsh-pet@0.4.8
このコマンドは npm 版へ切り替えるため、本フォークの日本語化は無効になります(設定と素材は残ります)。詳しくは「アップデートと上流への追随」を参照してください。
アップデートと上流への追随
本フォークは profile に link: で登録されているため、npm 版の更新は自動では降ってきません。更新の方法によって結果が変わります。
⚠️ npm 版に戻すとフォークの改修は失われます
dsh plugin --profile web add dsh-pet@0.4.8
このコマンドは profile の依存を npm レジストリ版に差し替えるため、本フォークの日本語化(ソース改修)はすべて無効になります。node_modules の中身が npm 版に置き換わるためです。
ただし、以下はプラグインの外にあるユーザーデータなのでそのまま残ります。
| 残るもの | 場所 |
|---|---|
| 吹き出し文言・アニメ名・配图名 | $DSH_HOME/dsh-pet/main-config.jsonc |
| 日本語名のアニメ素材(114 本) | $DSH_HOME/dsh-pet/main-animation/webm/ |
| 日本語名の表情画像(27 枚) | $DSH_HOME/dsh-pet/memes/ |
つまり npm 版に戻すと、メニューや通知は中国語に戻りますが、ペットの設定と素材名は日本語のままという状態になります。
✅ 上流に追随する場合は upstream を pull する(推奨)
フォークを維持したまま上流の更新を取り込みたい場合は、npm ではなく git で追随してください。
cd /path/to/dsh-pet-ja
git fetch upstream
git rebase upstream/main # 競合があれば解消
cd dsh-pet
npm install
npm run build
その後、DSH を再起動すると反映されます。
upstream= 本家(https://github.com/PC2005-cloud/dsh-pet)、`origin` = 本フォーク- 競合は主に
src/**の文言部分です。日本語を残す側で解消してください - ビルド(
npm run build)を忘れると、lib/が古いままになります
どれを選ぶか
| 目的 | 方法 |
|---|---|
| 上流の新機能・修正を取り込みたい | git fetch upstream && git rebase upstream/main(推奨) |
| 日本語化をやめて本家の挙動に戻したい | dsh plugin --profile web add dsh-pet@<version> |
| 特定バージョンに固定したい | dsh plugin --profile web add dsh-pet@0.4.8 |
設定
設定は上流と完全に同じです。$DSH_HOME/dsh-pet/main-config.jsonc を編集するか、DSH の「設定 → ペット設定」から変更します。
本フォークの日本語化では、素材をユーザーディレクトリへ日本語名でコピーする方式も併用しています(プラグインを更新しても日本語名が維持されます)。
$DSH_HOME/dsh-pet/
├─ main-config.jsonc # animations / memes を日本語キーで記述
├─ main-animation/webm/*.webm # 日本語ファイル名のアニメ素材(114 本)
└─ memes/*.png # 日本語ファイル名の表情画像(27 枚)
上流の詳しい設定項目は CONFIG.md を参照してください。
上流との差分
dsh-pet/src/** の文字列を日本語化しています(上流 main との差分は 28 ファイル / 約 460 行)。
| 対象 | 内容 |
|---|---|
| メニュー | アクション / 表示位置 / 各項目 / 分類ラベル |
| 吹き出し | 作業ステータス・寝る/起きる/拒否・ツール実況(131 件) |
| 通知 | 会話完了・生成失敗・出力截断・権限要求・回答待ち |
| コマンド | /pet /chat /balance の説明と結果 |
| LLM プロンプト | ひとりごと・寝言・ペルソナ・動作/配図連動の指示文 |
| 環境情報 | 天気 28 種・時間帯 9 種・曜日・祝日 29 種・環境バブル |
| 音声 | 音色の表示名とタグ |
ロジック・API・設定スキーマは上流と同一(変更は文字列のみ)。
なお API のエラーメッセージ(failResult が返す文言)は上流のまま(中国語)です。異常時のみ表示される内部向けの文言のため、意図的に変更していません。
テストは日本語の期待値に更新済みです(time-context.test.ts など)。上流由来のテストのうち、中国語の文言を固定しているものは未更新です。
差分は git log -p で確認できます。上流の README は README.upstream.md に保存してあります。
ライセンス
本フォークは 2 種類のライセンスが混在しています。利用前に必ずご確認ください。
1. コード — MIT
LICENSE を参照してください。著作権表示は原作者 PC2005-cloud に帰属します(Copyright (c) 2026 PC2005-cloud)。
本フォークの日本語化差分も MIT で提供します。
2. 素材(アニメーション・画像・プロンプト・キャラクター) — CC BY-NC-SA 4.0
ペットのキャラクター「大肥魚(鯨娘)」およびアニメーション素材は CC BY-NC-SA 4.0(表示 · 非営利 · 継承)で提供されています。
- 非営利:商用利用・販売はできません
- 表示:原作者のクレジットと GitHub URL の明記が必要です
- 継承:改変した素材を配布する場合も同じライセンスを適用する必要があります
原作者による二次創作の規定(dsh-pet README より):
基于本项目的衍生 / 改版 / 换皮作品,在 GitHub 仓库、产品官网等公开渠道上须附上原作者 GitHub 地址: https://github.com/PC2005-cloud/dsh-pet
本リポジトリはこの規定に従い、原作者の GitHub URL を明記しています。
キャラクターの出典:DeepSeek「大肥魚(鯨娘)」はコミュニティによる二次創作であり、DeepSeek 公式のキャラクターではありません。原型「溟月」は Bilibili @上善无形、DeepSeek 版(メイド鯨娘)のデザインは Bilibili @ZipZipPipe によるものです。
3. 本フォークについて
- 非公式であり、原作者・DeepSeek による承認・保証はありません
- 不具合はまず本フォークの Issues へ。上流固有の問題は 上流の Issues へお願いします
謝辞
- dsh-pet — PC2005-cloud 氏によるオリジナル実装。本フォークの土台です
- キャラクター原案・デザイン — @上善无形 / @ZipZipPipe
- DeepSeek Harness
No comments yet. Be the first to write one.