DeepSeek Harness: コミュニティプラグイン

npm パッケージ名：@dsh-plugin/plugin-name
GitHub リポジトリ名：dsh-plugin-name
設定参照名：plugin-name

npm: @dsh-plugin/database    → GitHub: dsh-plugin-database
npm: @dsh-plugin/git-enhanced → GitHub: dsh-plugin-git-enhanced
npm: @dsh-plugin/docker      → GitHub: dsh-plugin-docker

# dsh-plugin トピックのリポジトリを検索
gh repo list --topic dsh-plugin --limit 20

# スター数でソート
gh search repos "dsh-plugin" --sort stars --limit 20

# dsh プラグインパッケージを検索
npm search @dsh-plugin

# 特定のプラグインの詳細を表示
npm info @dsh-plugin/database

# npm からインストール
dsh plugin add @dsh-plugin/database

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

Available tools:
  - database.query: Execute SQL queries
  - database.migrate: Run database migrations
  - database.schema: Inspect database schema

# GitHub リポジトリからインストール
dsh plugin add github:alice/dsh-plugin-redis

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

# 特定のバージョンタグをインストール
dsh plugin add github:alice/dsh-plugin-redis#v2.1.0

# インストール済みプラグインの一覧
dsh plugin list

# 出力
📦 Installed Plugins:
  @dsh-plugin/database   v1.2.0  ✅ enabled
  @dsh-plugin/redis      v2.1.0  ✅ enabled
  @dsh-plugin/git-enhanced v0.8.0 ⚠️ disabled

# プラグインの無効化（アンインストールせず）
dsh plugin disable @dsh-plugin/redis

# プラグインの有効化
dsh plugin enable @dsh-plugin/redis

# プラグインのアンインストール
dsh plugin remove @dsh-plugin/database

# プラグインの更新
dsh plugin update @dsh-plugin/database

# dsh.config.yaml
plugins:
  # npm プラグイン
  - name: "@dsh-plugin/database"
    version: "^1.2.0"
    enabled: true
    config:
      default_connection: "postgresql://localhost/mydb"
  
  # GitHub プラグイン
  - name: "@dsh-plugin/redis"
    source: "github:alice/dsh-plugin-redis"
    version: "v2.1.0"
    enabled: true
    config:
      host: "localhost"
      port: 6379
  
  # ローカルプラグイン
  - name: "my-custom-tool"
    source: "./plugins/my-custom-tool"
    enabled: true

# dsh.config.yaml
plugins:
  - name: "@dsh-plugin/database"
    config:
      connections:
        main: "postgresql://localhost/myapp"
        analytics: "postgresql://localhost/analytics"

👤 Alice：users テーブルから最新の10人の登録ユーザーをクエリして

🤖 Agent：
🔧 Using tool: database.query
  → Connection: main
  → Query: SELECT * FROM users ORDER BY created_at DESC LIMIT 10
  → Results: 10 rows

👤 Bob：src/ ディレクトリのコード品質をチェックして

🤖 Agent：
🔧 Using tool: linter.check
  → Directory: src/
  → Config: .eslintrc.json
  → Results: 12 warnings, 3 errors
  
  Errors:
  - src/utils/format.ts:45 — Unexpected any type
  - src/routes/api.ts:128 — Missing return type
  - src/models/user.ts:23 — Unused import

# プラグインリポジトリをクローンしてレビュー
git clone https://github.com/user/dsh-plugin-example.git
cd dsh-plugin-example

# メインエントリファイルの確認
cat src/index.ts

# 依存関係の確認
cat package.json | grep -A 20 "dependencies"

# 不審なネットワークリクエストの確認
grep -r "fetch\|http\|axios\|request" src/

# ファイルシステム操作の確認
grep -r "fs\.\|readFile\|writeFile\|exec\|spawn" src/

# 環境変数アクセスの確認
grep -r "process\.env" src/

// Plugin permission declaration
export default definePlugin({
  name: 'dsh-plugin-example',
  permissions: [
    'fs.read',        // Read files
    'fs.write',       // Write files
    'network.outbound', // Outbound network requests
    'shell.execute',  // Execute Shell commands
    'env.read'        // Read environment variables
  ],
  // ...
});

📦 Installing @dsh-plugin/example@1.0.0

⚠️ This plugin requests the following permissions:
  ✅ fs.read        — Read files in workspace
  ⚠️ network.outbound — Make outbound HTTP requests
  🔴 shell.execute  — Execute shell commands

Continue installation? (y/n)

# 公式テンプレートを使用
npx @deepseek-ai/create-dsh-plugin my-plugin

# 出力
📁 Creating plugin: my-plugin
  ├── src/
  │   └── index.ts
  ├── package.json
  ├── tsconfig.json
  └── README.md

✅ Plugin scaffolded! Run:
  cd my-plugin
  npm install
  npm run dev

dsh-plugin-my-plugin/
├── src/
│   ├── index.ts          # プラグインメインエントリ
│   ├── tools/            # ツール定義
│   │   └── my-tool.ts
│   └── services/         # サービス定義
│       └── my-service.ts
├── package.json
├── tsconfig.json
├── dsh-plugin.yaml       # プラグインメタデータ
└── README.md

# ビルド
npm run build

# 公開
npm publish --access public

# GitHub Topic の追加
# GitHub リポジトリ設定で topic: dsh-plugin を追加

name: dsh-plugin-my-plugin
version: 1.0.0
description: "A custom DSH plugin for database operations"
author: "Alice"
license: "MIT"
repository: "https://github.com/alice/dsh-plugin-my-plugin"
keywords:
  - dsh-plugin
  - database
  - tools
permissions:
  - fs.read
  - network.outbound
compatibility:
  dsh: ">=0.5.0"