DeepSeek Harness: プラグインインストールと設定読み込み順序

# 最新版をインストール
pnpm add @dsh-plugin/database

# 特定バージョンをインストール
pnpm add @dsh-plugin/database@1.2.0

# devDependency としてインストール
pnpm add -D @dsh-plugin/debug-tools

# cordis.yml
plugins：
  '@dsh-plugin/database'：
    config：
      connection：'postgresql：//localhost/mydb'

# インストールして自動登録
dsh plugin add @dsh-plugin/database

# 設定付きでインストール
dsh plugin add @dsh-plugin/database --config.connection='postgresql：//localhost/mydb'

# インストール出力
📦 Installing @dsh-plugin/database@1.2.0...
✅ Plugin installed and registered!

// package.json
{
  "dependencies"：{
    "@dsh-plugin/database"："^1.2.0",
    "@dsh-plugin/redis"："~2.1.0"
  }
}

# デフォルトブランチをインストール
pnpm add github：alice/dsh-plugin-redis

# 特定ブランチをインストール
pnpm add github：alice/dsh-plugin-redis#feature/cluster

# 特定タグをインストール
pnpm add github：alice/dsh-plugin-redis#v2.1.0

# 特定コミットをインストール
pnpm add github：alice/dsh-plugin-redis#abc1234

dsh plugin add github：alice/dsh-plugin-redis

{
  "dependencies"：{
    "@dsh-plugin/redis"："github：alice/dsh-plugin-redis#v2.1.0"
  }
}

# リモート tarball からインストール
pnpm add https：//example.com/dsh-plugin-custom-1.0.0.tgz

# ローカル tarball からインストール
pnpm add ./packages/dsh-plugin-custom-1.0.0.tgz

# プラグインプロジェクト内
cd dsh-plugin-my-tool
npm pack
# 生成：dsh-plugin-my-tool-1.0.0.tgz

# DSH プロジェクト内
pnpm add ../dsh-plugin-my-tool/dsh-plugin-my-tool-1.0.0.tgz

Bundle デフォルト：  plugins：[core, llm, tools], port：5173
Profile (web)：     plugins：[+web-ui]
プロジェクト設定：  plugins：[+my-tool], port：8080
Patch：            plugins：[+debug-tools], debug：true
CLI：              port：3000

最終結果：         plugins：[core, llm, tools, web-ui, my-tool, debug-tools]
                   port：3000, debug：true

Bundle：       llm → deepseek-adapter
プロジェクト設定： llm → openai-adapter（上書き）
Patch：        llm → custom-adapter（さらに上書き）

最終：llm → custom-adapter

pnpm dsh web --patch --dump-config

# cordis.patch.yml
plugins：
  debug-tools：
    $insert：./dev-plugins/debug-tools
  llm：
    config：
      debug：true

# --patch を追加してパッチファイルをロード
pnpm dsh web --patch

# cordis.patch.prod.yml — 問題のあるプラグインを緊急無効化
plugins：
  problematic-plugin：
    enabled：false
  llm：
    config：
      maxRetries：5  # 一時的にリトライ回数を増やす

# ホットパッチを適用
cp cordis.patch.prod.yml cordis.patch.yml
pnpm dsh web --patch

# ホットパッチをロールバック（パッチファイルを削除）
rm cordis.patch.yml
pnpm dsh web

# .gitignore
cordis.patch.yml           # 現在のパッチを除外
cordis.patch.prod.yml      # 本番パッチを除外
# cordis.patch.dev.yml    # 開発パッチはコミット（チーム共有）

Plugin A：register tool 'search'
Plugin B：register tool 'search'
→ 最終：Plugin B の search が有効

# 片方を無効化
plugins：
  plugin-a：
    config：
      tools：
        disabled：['search']

# 1. 最終設定を確認
pnpm dsh web --patch --dump-config > dump.yml

# 2. 競合する設定項目を検索
grep "my-plugin" dump.yml

# 3. パッチで上書きされていないか確認
diff cordis.yml cordis.patch.yml

# プラグインの互換性を確認
dsh plugin check @dsh-plugin/database

# 出力
✅ @dsh-plugin/database@1.2.0 is compatible with dsh@0.5.0
⚠️ Requires：dsh >= 0.4.0