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 网页搜索
https://github.com/topics/dsh-plugin

dsh-plugin        ← 必须
deepseek-harness  ← 可选，增加发现率
工具类型           ← 如 database, search, devops

什么情况下升 PATCH:
  - 修复工具的 bug
  - 修复配置校验问题
  - 文档更新

什么情况下升 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
\```

## 提供的工具

| 工具 | 描述 |
|:-----|:-----|
| `my_tool` | Does something useful |

## 依赖

- DSH >= 0.5.0
- Cordis >= 1.0.0

## 权限

- fs.read
- network.outbound

### ▶ 示例

\```text
👤 Alice: 用 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