haveanote06 / dsh-plugin-advisor

dsh-plugin-advisor

一个"插件顾问"：DeepSeek Harness 插件，自动分析你的需求 → 先查本地已装插件 → 不够再去社区生态搜索 → 按多信号质量打分推荐最优插件 → 你确认后一键安装。

再也不用自己去 github.com/topics/dsh-plugin 翻找、纠结哪个好、手动敲安装命令。

用法

安装后重启 dsh web，然后正常对话即可。当 agent 发现你的需求超出当前工具能力时，会自动：

1. plugin_inventory — 先看本地已装插件能不能覆盖（能用就不装新的）
2. plugin_search — 搜社区生态，返回质量打分排序的候选（含得分拆解）
3. 向你展示候选 + 风险说明，你确认后用 plugin_install 一键安装

也可以直接让它干活："我想在任务完成时收到微信通知，有什么插件推荐吗？"

安装

# 从 GitHub（构建产物已随仓库提交）
dsh plugin --profile web add github:haveanote06/dsh-plugin-advisor

# 从 npm（发布后）
dsh plugin --profile web add dsh-plugin-advisor

质量打分（"怎么知道哪个插件好"）

插件只计算客观硬信号（可复现），语义匹配由 agent 在候选里完成——每个候选都带得分拆解，可解释：

信号	权重	说明
awesome-dsh-plugin 精选收录	+35	人工策展，最强信号
Stars	+0~20	对数缩放，约 3000★ 封顶（防头部垄断）
npm 周下载量	+0~15	对数缩放，真实使用量（仅 npm 包）
活跃度	+0~15	30 天内 push 满分，90 天 ⅔，180 天 ⅓
结构完整	+0~15	dsh.bundle 清单 / LICENSE / 描述 各 +5

数据源：GitHub dsh-plugin topic 搜索 + awesome-dsh-plugin 精选清单 + npm 下载量。目录缓存在本地（默认 6 小时），刷新失败自动回退旧缓存。

配置（均可选）

# ~/.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

安全

• 绝不静默安装：agent 被提示守则约束，安装前必须展示候选与风险、征得确认
• 安装命令限定为 npm 包名或 github:owner/repo，其他一律拒绝
• 目录数据只读抓取，不外发任何本地信息

开发

npm install
npm test      # 28 个单测（打分公式 / 目录合并与缓存 / 工具行为）
npm run build