DeepSeek Harness (DSH)’s plugin mechanism allows developers to extend agents with specific capabilities. For scenarios that require entertainment-oriented content or specific image generation, the vikasranax/dsh-plugin-cats plugin provides a ready-to-use toolkit.

This is a DeepSeek Harness plugin maintained by vikasranax, designed to provide AI agents with the ability to retrieve random cat facts and cat images. It runs by relying on free public APIs.

Core Features

The plugin provides the following two tools:

  1. get_cat_fact
    Retrieves a random cat fact. This tool accepts an optional parameter maxLength, used to limit the length of the fact in characters.

  2. get_cat_image
    Retrieves a random cat image URL and displays it directly in the message as a Markdown image.

Installation and Enablement

To enable this plugin in a local development environment, follow these steps:

git clone https://github.com/vikasranax/dsh-plugin-cats.git

cd dsh-plugin-cats

pnpm install

pnpm dsh web --patch ./cordis.yml

Typical Usage

When calling tools, an agent can use the two functions above. For example, to enrich the reply content, these two tools can be used together.

Applicable Scenarios and Notes

This plugin depends on the following free public APIs: catfact.ninja and thecatapi.com. The project is open-sourced under the MIT License.

Before installing any external plugin, it is recommended to review the source code and license to ensure compliance with your security and compliance requirements.

Conclusion

For developers who want to integrate fun content into DeepSeek Harness agents, this is a lightweight reference implementation.