插件市场 justlearner010/dsh-plugin-market

dsh-plugin-market

DeepSeek Harness 的推荐插件目录 —— 一个双包能力，通过 search_plugins 工具向模型暴露，用实时 GitHub star 数据、基于快照的趋势以及任务意图排序来回答“我应该使用哪些 DSH 插件？”。

- @justlearner010/dsh-plugin-market —— 目录服务（ctx.pluginMarket）：精选种子目录（20+ 条目，包括 harness 本身和社区插件）、用于运行时添加的 register()、并发 GitHub star 抓取、本地快照持久化、7/30 天趋势计算，以及
score = 2·(matched tags) + (text match) + log10(stars+1) + 7d-trend 排序。
启动预热和后台刷新间隔可保持缓存温热。
- @justlearner010/dsh-tool-plugin-search —— 面向模型的 search_plugins 工具：schema、查询校验、结果格式化、结果上限以及 UI 卡片展示。自身不进行网络访问。

安装

dsh plugin add @justlearner010/dsh-plugin-market-bundle

或者分别添加这两个包：

dsh plugin add @justlearner010/dsh-plugin-market
dsh plugin add @justlearner010/dsh-tool-plugin-search

然后向 agent 提问类似“推荐几个 DeepSeek Harness 插件” —— 它会调用 search_plugins 并返回带有安装命令的推荐。

配置

使用选项挂载服务（显示默认值）：

- id: plugin-market
name: '@justlearner010/dsh-plugin-market'
config:
githubToken: '' # raises the anonymous 60/hour GitHub limit
cacheTtlMs: 3600000 # freshness window for cache + persisted snapshots
snapshotDir: ~ # defaults to /plugin-market
prewarm: true # fetch all repositories once at startup
refreshIntervalMs: 21600000 # background refresh; 0 disables

工作原理

search_plugins(query)
└─ ctx.pluginMarket.search(query, { maxResults })
├─ resolveMetrics(repos) # concurrent GitHub fetch (Promise.all)
│ ├─ in-memory cache hit (< TTL) → instant
│ ├─ persisted snapshot fresh (< TTL) → instant, no fetch
│ └─ live GET /repos/{owner}/{repo} → append snapshot, persist once
├─ computeDeltas(history) # 7d / 30d star trend from local snapshots
└─ rank & cap # relevance + stars + trend, top-N

延迟：热缓存 ≈ 1 ms；冷启动（无缓存、无快照）≈ 一次并发往返（约 300–600 ms）；GitHub 宕机/限流 → 立即使用陈旧快照。

维护目录

种子位于 packages/plugin-market/src/index.ts（SEED_ENTRIES）；添加一个仓库时需包含其 id、name、owner/name、description、tags、安装命令以及 installTrust（verified 声明 dsh.bundle，reference 为 clone/docs， unverified 为未确认）。趋势需要几天的快照后才会出现 7d/30d 增量。

状态：依赖发布待定

@deepseek-ai/ 包已在 npm 上以 0.0.1-rc.x / 4.0.1（cordis）/ 形式发布 3.18.1（schemastery），但上游发布正在进行中：已发布的 rc.1 版本所引用的一些传递依赖包尚未出现在注册表中（例如 @deepseek-ai/dsh-type-meta、@deepseek-ai/dsh-util）。在这些包出现之前，pnpm install 会失败，CI 无法变绿。

跟踪上游的发布进展（deepseek-ai/deepseek-harness，feat/npm-public）——缺失的包一经发布，本仓库即可按发布状态构建和测试。如果某个被引用的包仍然缺失，请在此处或上游提交 issue。

发布

1. 将每个 @justlearner010 替换为你的 npm scope（以及 bundle/仓库名称）。
2. pnpm install && pnpm build && pnpm test。
3. 在每个包中执行 pnpm publish，然后发布 bundle（bundle 最后）。
4. 发布后，按上文所示从注册表安装。

免责声明

第三方条目为精选收录，并非官方内容。Star 数按仓库统计，实时来自 GitHub REST API（无 token 时匿名限制为 60 次/小时；后台预热/刷新会消耗配额，因此对于大型目录请配置 githubToken）。对 @deepseek-ai/ 的依赖为预发布版本（0.1.0-rc.x）。

许可证

MIT