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 topic 的仓库
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/

// 插件的权限声明
export default definePlugin({
  name: 'dsh-plugin-example',
  permissions: [
    'fs.read',        // 读取文件
    'fs.write',       // 写入文件
    'network.outbound', // 出站网络请求
    'shell.execute',  // 执行 Shell 命令
    'env.read'        // 读取环境变量
  ],
  // ...
});

📦 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"