0lidaxiang/dsh-plugin-greet
51Last commit Aug 16, 2026
dsh-plugin-greet DSH plugin
This plugin registers a `greet` tool that the model can call to generate personalized greetings. It showcases plugin configuration, argument validation, structured output, and a text renderer. It is designed as a learning resource for new plugin authors.
How to install the dsh-plugin-greet DSH plugin
dsh plugin --profile web add dsh-plugin-greet@0.2.0Copying does not run this command. Review the repository and version before installing the dsh-plugin-greet DSH plugin.
dsh-plugin-greet DSH plugin data source
dsh-plugin-greet DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-plugin-greet DSH plugin can do
- Registers a model-callable `greet` tool with required and optional arguments.
- Supports English and Chinese greetings with friendly and formal styles.
- Validates input arguments (name length, supported languages, styles) and returns clear error messages.
- Produces structured canonical output with a text renderer (`output.render`).
- Customizable via plugin configuration (greeting, punctuation, default language, style).
Where the dsh-plugin-greet DSH plugin fits
- Learning how to structure a DSH plugin from scratch, including configuration, tool registration, and testing.
- Testing tool schemas and validation in a minimal environment before building complex plugins.
- Demonstrating structured output separation for multi-plugin workflows or policy integration.
- Experimenting with plugin configuration and profile composition in DeepSeek Harness.
Who the dsh-plugin-greet DSH plugin is for
- Plugin developers new to DeepSeek Harness who want a complete, minimal example.
- Developers wanting to understand tool registration, argument schemas, and structured output in DSH.
dsh-plugin-greet DSH plugin limitations
- The plugin has no network, filesystem, shell, or credential access; it depends only on the official `@deepseek-ai/schemastery` package.
- Chinese and formal wording use built-in examples; only friendly English greeting and punctuation are configurable via plugin settings.
- The model must be explicitly instructed to use the `greet` tool; it does not trigger on keywords like 'Hello'.
- DeepSeek Harness is currently in Developer Preview, so future releases may require compatibility updates.
dsh-plugin-greet DSH plugin: from the repository README
Quoted from the 0lidaxiang/dsh-plugin-greet README, the upstream source of the dsh-plugin-greet DSH plugin. Copyright remains with the original authors.
English | [简体中文](docs/README.zh-CN.md) A beginner-friendly, installable DeepSeek Harness plugin that demonstrates bundle distribution, profile composition, plugin configuration, tool schemas, structured output, validation, testing, and a real model-driven tool call. > This is a community example, not an official DeepSeek AI plugin. DeepSeek Harness is currently in Developer Preview, so future releases may require compatibility updates.  ## What you will learn This repository keeps the implementation in one small entry file so that a new plugin author can follow the complete path: ```text User prompt → model chooses the greet tool → argument schema checks the shape → execute validates and normalizes values → the tool returns structured data → output.render creates model-facing text → the model writes its final response ``` The example covers: - exporting a validated plugin `Config` - injecting and using the Harness `tools` service - required and optional tool arguments - English and Chinese greetings - friendly and formal styles - structured canonical output with a text renderer - actionable validation errors -
Read the full READMERepository license: MIT
dsh-plugin-greet DSH plugin questions
How do I install dsh-plugin-greet into DeepSeek Harness?
Stop any running DeepSeek Harness instance, then run `npx @deepseek-ai/dsh plugin --profile web add dsh-plugin-greet@0.2.0`. This command installs the package into the 'web' profile and adds its declared bundle. After installation, verify with `npx @deepseek-ai/dsh --profile web --dump-config` and then start the web UI with `npx @deepseek-ai/dsh web`.
Why doesn't the model call the greet tool when I say 'Hello'?
The plugin does not listen for keywords like 'Hello'. It only makes the `greet` tool available to the model. You must explicitly instruct the model to use the tool, for example: 'You must use the greet tool to greet Ada in a friendly English style.' Otherwise, the model may respond without invoking the tool.
How can I change the default greeting text or punctuation?
Override the plugin configuration in a later patch layer (e.g., your profile's `cordis.patch.yml`). Restate the plugin row with the same `id` (`greet-tool`), the package `name`, and the complete `config` object. For example, set `greeting: Hi` and `punctuation: "!"` to change the friendly English output. Note that Chinese and formal wording are built-in and not customizable.
I installed the plugin via 'npm install dsh-plugin-greet', but the tool is missing. What went wrong?
A regular `npm install` only adds a dependency to the current Node.js project. You must use the `dsh plugin --profile <name> add ...` command to install and compose the bundle into a Harness profile. Follow the official installation instructions in the README.
Is dsh-plugin-greet safe to use in production?
The plugin has no network, filesystem, shell, or credential access. It runs inside the host process, so you should review its source code before installation. The README recommends preferring a pinned release tag or commit SHA for stability. Additionally, DeepSeek Harness is in Developer Preview, so compatibility updates may be needed for future releases.