前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。开发者可以通过编写插件来扩展工具链，从而增强模型的能力。dsh-plugin-hello 是一个社区维护的最小化插件示例，它展示了如何向模型注册一个可调用的工具。这个插件适合作为入门参考，或者作为构建复杂工具链的起点。

插件概况¶

该插件由用户 xu1132 维护，归类于「模型推理」类别，开源协议为 MIT。它的核心功能是在 Harness 加载时，向上下文注册名为 hello 的工具。该工具接受一个必填的字符串参数 name，并返回格式化的问候语。

核心功能¶

• 工具注册：注册名为 hello 的模型可调用工具。
• 输入参数：接收 name 参数，为必填字符串，指定问候对象。
• 输出结果：返回格式化问候语，默认格式为 Hello, <name>!。
• 配置项：支持通过配置自定义问候语前缀，默认前缀为 Hello。

安装与启用¶

使用官方命令将插件安装到指定的 profile 中：

dsh plugin --profile demo add github:you/dsh-plugin-hello

dsh plugin 命令会在 profile 目录内执行 pnpm 操作。安装过程中，插件会自动被链接到 dsh.profile.bundles，并构建 lib/ 目录下的代码。如果使用 pnpm 10+ 版本，需要确保 prepare 构建脚本已加入 allowlist，否则加载会失败。

典型用法¶

安装并启动 Harness 后，在模型提示词中调用该工具。例如，让模型使用 hello 工具问候名为 Ada 的用户：

Use the hello tool to greet Ada.

模型将调用工具并返回 Hello, Ada!。

若需修改默认问候语前缀，需编辑 profile 下的 cordis.patch.yml 文件：

- id: hello
  name: dsh-plugin-hello
  config:
    greeting: Howdy

注意事项¶

该插件适合需要快速验证工具注册逻辑的开发者。使用时需注意：
1. 配置无效会导致插件加载失败。
2. 插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。

结尾¶

这是一个极简的插件实现，涵盖了注册工具、参数定义、返回格式化字符串以及配置层挂载的基本流程。了解其源码有助于掌握 DeepSeek Harness 的插件开发规范。更多细节可参考 GitHub 仓库。