前言¶

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