# dsh-task-router

> English | [简体中文](README.md)

> **This plugin was made with substantial participation from AI tools.**
> GLM, DeepSeek, Qwen and other AI tools were heavily involved in design, coding, testing, and documentation.

`dsh-task-router` is a [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) plugin that turns the main model into a **planner, verifier, and occasional hands-on problem solver**, delegating web search, browsing summaries, image description, image generation, coding, and verification to sub-models or external APIs.

## Features

- `task_search` / `task_browse` — Tavily-backed search and page summarization without exposing raw web content to the main model.
- `task_image_describe` / `task_image_generate` — image understanding and generation through OpenAI-compatible APIs or custom REST templates.
- `task_code` / `task_verify` — delegate implementation and verification to sub-agents with a built-in retry loop for mechanical issues.
- Settings UI in DSH with presets, provider/model selection, credential storage, global enable/disable, dark mode, and responsive layout.
- Default security boundaries: sub-agents cannot recursively call `task_*`, and code/verify roles get pinned sandbox modes.

## Install

Requirements: Node.js `>= 20.3`, a DSH environment, and the relevant API keys.

```bash
npm install
npm run build
```

Then register the plugin through DSH's bundle/injection mechanism, e.g. via `cordis.patch.yml`:

```yaml
- insert:
    - id: dsh-task-router
      name: '@dsh-external/dsh-task-router'
      config: {}
```

## Known limitations

- `allowed_paths` / `allowed_commands` are advisory prompt text, not enforced system-level sandbox restrictions.
- `task_image_describe` accepts DSH attachment JSON references only; local file paths are not supported yet.
- Real-time model-call logs and the real-time task status indicator have been removed (they had stability issues).

## Development

```bash
npm run typecheck
npm test
npm run build
npm run check
```

## License

[BSD-3-Clause](LICENSE)

You are free to modify, redistribute, and use this project commercially, as long as you retain the original project attribution and this notice. There is no non-commercial restriction.

## AI participation

This project is **highly AI-native**:

- Initiated by **TIKO**.
- Design, coding, testing, and documentation were heavily assisted by **GLM, DeepSeek, Qwen and other AI tools**.
- **Even the project commits were performed by DeepSeek.**
- This is not a purely hand-written project; it is an open-source project collaboratively generated and released through AI-driven workflows.

If you modify or redistribute this project, please retain:

- The original project name `dsh-task-router`
- The original author attribution **TIKO**
- This AI participation notice
- The project license and copyright notice