前言¶

DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在構建智能體時，開發者常面臨從 GitHub 或 npm 等生態中篩選合適插件的難題。手動翻閱 github.com/topics/dsh-plugin、對比評分、編寫安裝命令效率低下且容易出錯。

DeepSeek Harness 插件顧問解決了這個問題。它是一個工作流插件，由 haveanote06 維護，旨在自動化需求分析、生態搜索和插件分發流程。

插件簡介¶

haveanote06/dsh-plugin-advisor 是一個插件顧問工具。它的核心流程是：自動分析需求 → 檢查本地已裝插件 → 搜索社區生態 → 按多信號質量打分推薦最優插件 → 用戶確認後一鍵安裝。

許可證：MIT

核心能力：
* 自動分析需求
* 檢查本地已裝插件
* 搜索社區生態
* 多信號質量打分
* 一鍵安裝

安裝與啓用¶

使用官方命令安裝。支持 GitHub 格式和 npm 包名兩種來源。

# 從 GitHub 安裝
dsh plugin --profile web add github:haveanote06/dsh-plugin-advisor

# 從 npm 安裝（發佈後）
dsh plugin --profile web add dsh-plugin-advisor

安裝完成後，重啓 dsh web，進入正常對話模式即可使用。

使用方式¶

插件會在 Agent 發現需求超出當前工具能力時自動觸發，也可以直接在對話中詢問。

自動觸發流程：
1. plugin_inventory：Agent 先檢查本地已裝插件能否覆蓋需求。
2. plugin_search：若本地不足，Agent 搜索社區生態，返回按質量打分排序的候選插件。
3. Agent 展示候選與風險說明，用戶確認後執行 plugin_install 一鍵安裝。

直接詢問示例：

“我想在任務完成時收到微信通知，有什麼插件推薦嗎？”

質量打分機制¶

插件基於客觀硬信號計算得分，語義匹配由 Agent 完成。每個候選插件都包含得分拆解。

評分維度與權重：

數據源：GitHub dsh-plugin topic 搜索、awesome-dsh-plugin 精選清單、npm 下載量。

配置¶

插件支持部分配置項，位於 ~/.dsh/profiles/web/cordis.patch.yml。以下配置均爲可選：

- id: dsh-plugin-advisor
  config:
    catalogTtlHours: 6          # 目錄緩存有效期
    githubTokenEnv: GITHUB_TOKEN  # 提高 GitHub API 限流（60→5000/h）
    profile: web                # 安裝目標 profile
    weights:                    # 打分權重覆蓋
      curated: 35
      stars: 20
      downloads: 15
      recency: 15
      structure: 15

安全與注意事項¶

• 絕不靜默安裝：安裝前必須展示候選與風險、徵得用戶確認。
• 命令格式限制：安裝命令限定爲 npm 包名或 github:owner/repo，其他格式一律拒絕。
• 數據隱私：目錄數據只讀抓取，不上傳任何本地信息。
• 緩存策略：目錄緩存默認 6 小時。

生態背景¶

該插件依賴的目錄數據來源於獨立站點 skillhub.cn，與 DeepSeek 或幻方無官方從屬關係。

更多資源¶

• GitHub 倉庫
• 社區目錄