huguangyu666/dsh-store

项目介绍Project Overview

dsh-store 是 DeepSeek Harness 的上游插件商店与基础设施。它聚合 npm registry、awesome 精选与 GitHub 星标,通过 dsh 字段后台验证剔除噪声,支持官方 dsh plugin add/remove 一键安装卸载、停用启用、版本更新与详情查看。在 dsh 中需要集中发现、安装和管理插件时使用。需注意:部分功能依赖 GitHub API,国内网络环境需配置 proxy;安装后改动通常需重启生效。

dsh-store is the upstream plugin marketplace and infrastructure for DeepSeek Harness. It aggregates the npm registry, awesome curated lists, and GitHub stars, filtering noise via background validation of the dsh field, and supports official dsh plugin add/remove for one-click install/uninstall, disable/enable, version checks, and detail viewing. Use it when you need a centralized way to discover, install, and manage plugins inside dsh. Note: some features depend on the GitHub API and require configuring a proxy in mainland China network environments; installation changes generally require a restart to take effect.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:huguangyu666/dsh-store

huguangyu666/dsh-store 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-store

Awesome DSH Plugin

已收录于 awesome-dsh-plugin 精选列表(Development & Runtime)

DeepSeek Harness 插件商店:上游基础设施。聚合 npm registry + awesome 精选 + GitHub 星标的 dsh 插件目录,质量验证 + 分类 + 星标排序,在 dsh 内一键安装 / 卸载(走官方 dsh plugin add/remove),装完重启即生效。

与社区其他商店的差异

能力 dsh-store 社区其他商店(dsh-market / plugin-hub / workshop 等)
数据源 npm registry 权威源(插件实际安装处)+ awesome 精选 + GitHub 星标 多为 GitHub topic / awesome 目录(二手源、含蹭话题噪声)
质量验证 dsh 字段后台验证,自动剔除噪声(250→222 实测)
安装 官方 dsh plugin add/removedsh.profile.bundles 层,与命令行等价),失败自动回退 pnpm + patch 多为 clone / 手改 patch
可安装性 目录里每个 npm 条目都能真的装上 GitHub-only 列表装上即报错
已安装识别 三源合并(bundles + dependencies + patch) 大多无
客户端 侧边栏按钮 + 设置页分区 + 完整页面 部分有设置页

功能

  • 聚合目录:npm registry 关键词精确搜索(keywords:dsh-plugin)+ awesome-dsh-plugin 精选(324 个,11 分类)+ AdamPlatin123 自动雷达(运行级验证)+ GitHub 星标合并,750+ 插件
  • 精选叠加:awesome 人工精选插件打「精选」徽章 + 分类;雷达验证通过的显示「雷达验证」徽章;未上 npm 的精选显示 GitHub 跳转
  • 质量过滤:后台验证每个包的 package.json 是否有 dsh 字段(真插件标记),剔除噪声
  • 一键安装:官方 dsh plugin add(自动 reconcile dsh.profile.bundles),失败回退 pnpm add + patch 合并
  • 一键卸载:官方 dsh plugin remove,自动清理 patch 残留
  • 已安装管理:已安装插件可一键「停用 / 启用」(写 cordis.patch.yml 的 disabled,HMR 实时生效,无需重启)
  • 更新检查:一键检查所有已安装插件是否有新版本,列出可更新项,一键更新
  • 详情 README:点插件详情异步加载 README 摘要(本地优先,npm 兜底)
  • 一键重启:装完需要重启的改动提供一键重启
  • 命令/plugin-store(摘要)、/plugin-install <包名>(直接安装)

安装

npm i dsh-plugin-store

profile patch(~/.dsh/profiles/<profile>/cordis.patch.yml):

- insert:
    - id: plugin-store
      name: 'dsh-store'

或者官方命令:dsh plugin --profile web add dsh-store

重启 dsh,打开 http://<dsh地址>:<端口>/plugin-store

使用

  • 浏览:搜索 / 分类筛选 / 按星标·最新·名称排序,卡片显示精选徽章、描述、作者、版本、星标
  • 安装:点「安装」→ 官方 dsh plugin add → 点「立即重启」生效
  • 已安装管理:已安装插件显示「停用 / 启用」按钮(写 cordis.patch.yml 的 disabled,HMR 实时生效,无需重启)
  • 更新检查:顶部「检查更新」按钮 → 列出可更新插件 → 一键更新
  • 详情:点卡片看完整描述、分类、README 摘要与仓库链接;未上 npm 的精选跳 GitHub
  • 命令行/plugin-install dsh-plugin-xxx

配置

~/.dsh/plugin-store/config.json

{ "proxy": "http://127.0.0.1:7892", "profile": "web" }
字段 说明
proxy GitHub API 代理(国内环境需要);环境变量 DSH_PLUGIN_STORE_PROXY 可覆盖
profile 安装目标 profile(默认 web);环境变量 DSH_PLUGIN_STORE_PROFILE 可覆盖

目录缓存 24h(~/.dsh/plugin-store/catalog.json),页面「刷新目录」强制更新。

数据源与质量

用途
registry.npmjs.org/-/v1/search?text=keywords:dsh-plugin 插件清单(权威,可安装)
awesome-dsh-plugin 精选列表 分类 + 精选徽章(324 个,人工审核)
api.github.com/search/repositories?q=topic:dsh-plugin 星标 / 仓库 / 更新信息合并
AdamPlatin123/awesome-dsh-plugins 雷达 运行级验证状态(✅ 运行级可用等,194+ 条目)

质量验证:安装前后台逐个 GET 每个包的 /latest 检查 dsh 字段(缓存 7 天),无该字段的剔除——npm 关键词搜索会混入蹭关键词的包,这个过滤保证目录里都是真插件。

架构

┌─ dsh-store ─────────────────────────────────────────────┐
│ host:catalog 引擎(npm + awesome + 雷达 + GitHub → 合并 → 验证 → 缓存)│
│       安装引擎(官方 dsh plugin add/remove → 回退 pnpm + patch)│
│       API:/plugin-store/api/{catalog,refresh,install,uninstall,restart} │
│ client:侧边栏「插件商店」按钮 + 设置页分区(--dsw-* 变量) │
└────────────────────────────────────────────────────────┘

无外部运行时依赖(curl 为 Windows 自带;pnpm 走 PowerShell shim 解析;官方 dsh plugin 路径自动注入代理)。

开发

npm run build      # esbuild 构建 lib/index.js + lib/client.js
node test-mock.mjs # mock + 集成测试(隔离 profile,真实 pnpm 安装/卸载,22 项)

许可

MIT

上一个 Prev dsh-research-report 下一个 Next agent-guild