前言¶
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 完成。每个候选插件都包含得分拆解。
评分维度与权重:
| 信号 | 权重 | 说明 |
|---|---|---|
| awesome-dsh-plugin 精选收录 | +35 | 人工策展,最强信号 |
| Stars | +0~20 | 对数缩放,约 3000★ 封顶 |
| npm 周下载量 | +0~15 | 对数缩放,真实使用量 |
| 活跃度 | +0~15 | 基于 30 天/90 天/180 天的 push 频率 |
| 结构完整 | +0~15 | dsh.bundle / LICENSE / 描述 |
数据源: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 或幻方无官方从属关系。