前言¶

DeepSeek Harness 插件基於 Cordis 擴展模型構建。對於開發者而言，直接閱讀源碼或理解 API 細節往往需要一定的門檻。dsh-learning-plugin 提供了一個最小化的示例，演示瞭如何在 Harness 生態中註冊工具、聲明依賴以及配置插件。

項目定位¶

這是一個由 fengyufengzi 維護的開源插件。它向模型註冊了一個名爲 learning_greet 的工具，用於演示 Harness 擴展點的四個核心用法：聲明服務依賴、校驗部署配置、註冊隨插件生命週期自動撤銷的能力，以及從同一份 schema 推導參數和輸出類型。

核心功能¶

• 註冊 learning_greet 工具。
• 通過 inject = ['tools'] 聲明服務依賴。
• 使用 Config 進行部署配置校驗（基於 Schemastery）。
• 通過 ctx.tools.register() 註冊工具。
• 使用 defineTool() 推導類型。
• 包含完整的類型檢查、測試和發佈構建流程。

環境要求¶

• Node.js ^22.19.0 || >=24.0.0
• Corepack
• pnpm 11.7.0
• DeepSeek Harness 0.1.0-rc.6 系列

安裝與啓用¶

先構建插件，然後從本項目目錄安裝到 web profile：

corepack pnpm run build
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh --profile web

在 package.json 中配置了 dsh.bundle 後，DSH 會自動應用 cordis.patch.yml。啓動後，可以在對話中輸入以下指令：

Use learning_greet to greet Ada.

若要移除插件：

npx @deepseek-ai/dsh plugin --profile web remove dsh-learning-plugin

適用場景與注意¶

這是一個學習項目，用於演示 Harness 插件開發機制，並非診斷或生產運維插件。

Harness 目前處於開發者預覽階段，插件 API 可能發生破壞性變化。在安裝使用前，請確認當前環境版本及源碼內容。

摘要¶

該插件通過具體的代碼示例，展示了 Harness 插件開發的四個關鍵擴展點。完整源碼與目錄信息可查看 GitHub 倉庫。