DeepSeek Harness: Community Plugins

npm package name: @dsh-plugin/plugin-name
GitHub repository name: dsh-plugin-name
Configuration reference 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

# Search repos with dsh-plugin topic
gh repo list --topic dsh-plugin --limit 20

# Sort by stars
gh search repos "dsh-plugin" --sort stars --limit 20

# Search dsh plugin packages
npm search @dsh-plugin

# View specific plugin details
npm info @dsh-plugin/database

# Install from npm
dsh plugin add @dsh-plugin/database

# Installation output
📦 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

# Install from GitHub repository
dsh plugin add github:alice/dsh-plugin-redis

# Install specific branch
dsh plugin add github:alice/dsh-plugin-redis#feature/cluster-support

# Install specific version tag
dsh plugin add github:alice/dsh-plugin-redis#v2.1.0

# List installed plugins
dsh plugin list

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

# Disable plugin (without uninstalling)
dsh plugin disable @dsh-plugin/redis

# Enable plugin
dsh plugin enable @dsh-plugin/redis

# Uninstall plugin
dsh plugin remove @dsh-plugin/database

# Update plugin
dsh plugin update @dsh-plugin/database

# dsh.config.yaml
plugins:
  # npm plugin
  - name: "@dsh-plugin/database"
    version: "^1.2.0"
    enabled: true
    config:
      default_connection: "postgresql://localhost/mydb"
  
  # GitHub plugin
  - name: "@dsh-plugin/redis"
    source: "github:alice/dsh-plugin-redis"
    version: "v2.1.0"
    enabled: true
    config:
      host: "localhost"
      port: 6379
  
  # Local plugin
  - 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: Query the 10 most recently registered users from the users table

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

👤 Bob: Check code quality in the src/ directory

🤖 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

# Clone plugin repository for review
git clone https://github.com/user/dsh-plugin-example.git
cd dsh-plugin-example

# Check main entry file
cat src/index.ts

# Check dependencies
cat package.json | grep -A 20 "dependencies"

# Check for suspicious network requests
grep -r "fetch\|http\|axios\|request" src/

# Check for filesystem operations
grep -r "fs\.\|readFile\|writeFile\|exec\|spawn" src/

# Check for environment variable access
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)

# Use the official template
npx @deepseek-ai/create-dsh-plugin my-plugin

# Output
📁 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          # Plugin main entry
│   ├── tools/            # Tool definitions
│   │   └── my-tool.ts
│   └── services/         # Service definitions
│       └── my-service.ts
├── package.json
├── tsconfig.json
├── dsh-plugin.yaml       # Plugin metadata
└── README.md

# Build
npm run build

# Publish
npm publish --access public

# Add GitHub Topic
# In GitHub repository settings, add 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"