dsh-tools-plugins

Readme

# DSH Tools Plugins

English | [中文](README.zh.md)

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) bundle that adds practical Agent tools. Install it into a profile to extend the tool catalog.

## Plugins included

| Plugin | Tool | Category |
| --- | --- | --- |
| **prompt-enhancer** | `optimize_prompt` | Tool integration / Agent enhancement |

`optimize_prompt` rewrites a short or vague instruction into a structured prompt (Role, Task, Constraints, Output Format) using the profile's default LLM.

## Install

```sh
dsh plugin --profile web add github:lizhi00001/dsh-tools-plugins
```

For a local checkout:

```sh
dsh plugin --profile web add /path/to/dsh-tools-plugins
```

Restart `dsh` after installation.

### Git install and build scripts

This package ships TypeScript source and builds on install via the `prepare` script. If pnpm blocks lifecycle scripts, add to your profile's `pnpm-workspace.yaml`:

```yaml
allowBuilds:
  dsh-tools-plugins: true
```

Then run `add` again.

## Usage

After installation, ask the Agent in the Web UI:

```text
Use optimize_prompt to rewrite: "help me write a weekly report"
```

Or let the Agent call the tool when it detects a vague instruction.

## Configuration

Edit the plugin row in your profile `cordis.patch.yml`, or override via patch:

```yaml
- id: dsh-prompt-enhancer
  config:
    provider: deepseek
    model: deepseek-chat
    maxTokens: 1200
```

Omit `provider` and `model` to use the profile default model.

## Ecosystem discovery

To appear in the [DSH plugin ecosystem](https://github.com/topics/dsh-plugin):

1. This repository declares `dsh.bundle.patch` in `package.json` (required).
2. Add the GitHub topic **`dsh-plugin`** to the repository.
3. Optional rich metadata lives under `dsh.market` in `package.json`.

## Development

Requires Node `^22.19 || >=24` and pnpm.

```sh
pnpm install
pnpm run build
pnpm run typecheck
```

Test locally:

```sh
dsh plugin --profile web add .
dsh --profile web --dump-config
```

## License

MIT — see [LICENSE](LICENSE).