huguangyu666/dsh-store

dsh-store

已收录于 awesome-dsh-plugin 精选列表（Development & Runtime）

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

与社区其他商店的差异

功能

• 聚合目录：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" }

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

数据源与质量

质量验证：安装前后台逐个 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