DeepSeek Harness: プラグインの公開

# TypeScript をコンパイル
pnpm build

# 出力を確認
ls dist/
# index.js  index.d.ts  ...

# 初回公開
npm publish --access public

# バージョン更新後の公開
npm version patch  # 1.0.0 → 1.0.1
npm publish

# .npmignore
src/
tests/
tsconfig.json
*.tsbuildinfo
.git/
.vscode/

# 別のプロジェクトでインストール
pnpm add @dsh-plugin/my-tool

# インポートを確認
node -e "console.log(require('@dsh-plugin/my-tool'))"

{
  "name": "@dsh-plugin/my-tool",
  "version": "1.0.0",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "dsh": {
    "name": "my-tool",
    "description": "A custom tool for DSH",
    "services": ["tools"],
    "inject": ["tools"],
    "capabilities": [],
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0"
    },
    "permissions": [
      "fs.read",
      "network.outbound"
    ],
    "config": {
      "apiKey": {
        "type": "string",
        "required": true,
        "description": "API key for the service"
      }
    }
  }
}

Repository Settings → Topics → Add topic：dsh-plugin

# GitHub CLI 検索
gh search repos --topic dsh-plugin --sort stars

# GitHub Web 検索
https：//github.com/topics/dsh-plugin

dsh-plugin        ← 必須
deepseek-harness  ← 推奨、発見性向上
ツールタイプ       ← 例：database, search, devops

PATCH を更新するケース：
  - ツールのバグ修正
  - 設定バリデーションの修正
  - ドキュメント更新

MINOR を更新するケース：
  - 新しいツールの追加
  - 設定オプションの追加（デフォルト値あり）
  - ケイパビリティ実装の追加
  - オプショナル依存関係の追加

MAJOR を更新するケース：
  - ツールの削除
  - ツールパラメータ形式の変更
  - 設定オプションの削除
  - inject リストの変更
  - Capability インターフェースの変更

# PATCH を更新
npm version patch -m "fix：resolve timeout issue"

# MINOR を更新
npm version minor -m "feat：add batch query tool"

# MAJOR を更新
npm version major -m "breaking：change tool parameter format"

# Alpha 版
npm version prealpha --preid alpha
# 1.0.0 → 1.1.0-alpha.0

# Beta 版
npm version prebeta --preid beta
# 1.0.0 → 1.1.0-beta.0

# RC 版
npm version prerelease --preid rc
# 1.1.0-beta.0 → 1.1.0-rc.0

{
  "dsh"：{
    "compatibility"：{
      "dsh"：">=0.5.0",
      "cordis"：">=1.0.0",
      "node"：">=18.0.0"
    }
  },
  "peerDependencies"：{
    "@deepseek-ai/dsh"：">=0.5.0",
    "@deepseek-ai/cordis"：">=1.0.0"
  }
}

# DSH 内蔵チェック
dsh plugin check @dsh-plugin/my-tool

# 出力
✅ Compatible with dsh@0.5.0
✅ Compatible with cordis@1.0.0
⚠️ Requires Node.js >= 18.0.0 (current：16.20.0)

# @dsh-plugin/my-tool

> DSH plugin for [機能説明]

## インストール

\```bash
dsh plugin add @dsh-plugin/my-tool
\```

## 設定

\```yaml
plugins：
  '@dsh-plugin/my-tool'：
    config：
      apiKey：sk-xxx
      maxRetries：3
\```

## 提供ツール

| Tool | Description |
|：-----|：-----------|
| `my_tool` | 何か便利なことをする |

## 依存関係

- DSH >= 0.5.0
- Cordis >= 1.0.0

## パーミッション

- fs.read
- network.outbound

### ▽ サンプル

\```text
👤 Alice：Analyze project with my_tool

🤖 Agent：
🔧 Using tool：my_tool
  → Result：...
\```

## ライセンス

MIT

# Changelog

## 1.1.0 (2026-08-20)

### Added
- batch_query tool for querying multiple paths
- Config option `maxDepth` for recursive analysis

### Fixed
- Timeout handling for large directories

## 1.0.0 (2026-08-01)

### Breaking
- Changed parameter format from `dir_path` to `path`

### Added
- Initial release with file_info tool