前言¶

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 倉庫。