前言¶

DeepSeek Harness 允许通过插件扩展模型可调用能力。dsh-plugin-greet 是一个面向初学者的社区插件，用于注册一个名为 greet 的工具，并展示参数校验、结构化输出、插件配置和模型调用工具的基本路径。

它不是官方 DeepSeek AI 插件。DeepSeek Harness 目前处于 Developer Preview，后续版本可能需要兼容性更新。

这是什么¶

dsh-plugin-greet 由 0lidaxiang 维护，采用 MIT 许可证。

它是一个可安装的 DeepSeek Harness 插件，核心功能是向模型暴露一个 greet 工具。这个工具支持必填的 name 参数，以及可选的 language 和 style 参数，可用于生成英文或中文、友好或正式风格的问候语。

核心功能¶

dsh-plugin-greet 提供以下能力：

• 注册一个模型可调用工具，名称为 greet。
• 支持必填参数 name，以及可选参数 language、style。
• 支持英文和中文问候，支持友好风格和正式风格。
• 返回规范的结构化输出，并渲染面向模型的文本。
• 校验参数值，并返回可操作的错误信息。
• 导出经校验的插件配置 schema。
• 不访问网络、文件系统、shell 或凭证。

版本与环境¶

安装命令中使用的是 dsh-plugin-greet@0.3.0。

0.3.x 要求 Node.js ^22.19.0 或 >=24.0.0，并面向 DeepSeek Harness 0.1.1 release-candidate 线。

安装与启用¶

先使用 DSH 插件命令把包安装到 web profile：

npx @deepseek-ai/dsh plugin --profile web add dsh-plugin-greet@0.3.0

这个命令不是普通 npm install。普通 npm install 只会把依赖加到当前 Node.js 项目；这里使用 dsh plugin --profile，是把插件安装到指定 Harness profile，并组成对应 bundle。

安装后，可以查看最终配置，确认插件已出现在配置中：

npx @deepseek-ai/dsh --profile web --dump-config

然后启动 Web UI：

npx @deepseek-ai/dsh web

典型用法¶

打开 http://127.0.0.1:3080，发送：

You must use the greet tool to greet Ada in a friendly English style.

预期结果是：

Hello, Ada!

再发送：

You must use the greet tool to greet 小明 in formal Chinese.

预期结果是：

您好，小明。

配置覆盖¶

插件会导出一个经校验的配置 schema。

如果需要覆盖配置，后续 patch 层会整行替换插件配置，而不是对单个 key 做深合并。因此覆盖时建议保留完整配置项，而不是只改单个字段。

适用场景与注意¶

这个插件适合用于学习 DeepSeek Harness 插件的基本形态：工具注册、参数 schema、结构化输出、配置 schema 和模型调用工具。

需要注意：

• 它是社区示例，不是官方 DeepSeek AI 插件。
• DeepSeek Harness 处于 Developer Preview，未来版本可能需要兼容更新。
• 许可证为 MIT。
• 稳定使用时，建议固定 release tag 或 commit SHA。
• 安装前可以查看仓库源码和许可证。
• 该插件没有网络、文件系统、shell 或凭证访问。

链接¶

GitHub 仓库：

https://github.com/0lidaxiang/dsh-plugin-greet