dsh-plugin-leaderboard

[English](#install) | 中文

Community plugin leaderboard for DeepSeek Harness. It reads the public GitHub topic dsh-plugin and shows three boards inside the Web UI:


Install

dsh plugin --profile web add github:shaoxia20240902/dsh-plugin-leaderboard

Or from a local checkout:

dsh plugin --profile web add /path/to/dsh-plugin-leaderboard

Restart dsh web. The sidebar foot shows 插件榜. You can also type /leaderboard in a session, or ask the agent to show the hottest / newest / on-fire plugins.

What you get

• Sidebar panel — three tabs, star/fork counts, copy-install, copy an interpret prompt, open the repo.
• Interpret prompt — paste it into the Harness composer. The agent clones the repo and explains it in plain language: what it is, what pain it removes, what you see after install, how to start, who should skip it.
• Slash command /leaderboard [hot|new|fire].
• Tool list_dsh_plugin_leaderboard so the agent can answer ranking questions.
• HTTP GET /dsh-plugin-leaderboard on the host (used by the panel).

These repositories are third-party code. Review the source and pin a commit (github:owner/repo#<sha>) before you install one.

Boards load first from the hosted API http://101.34.27.122:3091 (MySQL), then fall back to GitHub. The recommend list lives only in that database.

When GitHub is blocked

Default access: auto: try api.github.com first, then public HTTPS proxies (for example ghfast.top).

• Board data — the host retries through a proxy so the sidebar still fills in.
• Open repository — official https://github.com/owner/repo. Host-swap sites such as kkgithub.com 404 on most repos, so they are not used.
• Details — a page on the hosted API (/r/owner/repo) with description plus a working clone-via-proxy command.
• Copy install / Explain — include a “clone via proxy, then dsh plugin add <dir>” command.

A GitHub token is sent only to the official API, never through a public proxy. Public mirrors are third-party and can vanish; override them when you have a stable one:

- id: dsh-plugin-leaderboard
  config:
    access: auto
    githubApiBase: https://your-proxy.example/https://api.github.com
    githubHtmlBase: https://github.com
    githubCloneProxy: https://ghfast.top/

Ranking

• Hottest — ln(1+stars) + 0.55 ln(1+forks) + 0.6×freshness + 0.4×DSH relevance − stale penalty.
• Newest — recency of creation raised to 1.8, times a traction term so empty shells lose to same-week repos that already have stars.
• On fire — HN-style gravity (stars + 0.65 forks) / (age+2)^1.55, times recent motion. Top 10.
• Picks — curated in MySQL.

The catalog merges a few GitHub search pages (stars + recently updated), then drops deepseek-ai/deepseek-harness, forks, and archived repos. The hosted API stores that catalog in MySQL, refreshes it every 30 minutes, and serves the sidebar from the database. Opening the panel never waits on GitHub. A manual refresh asks the origin to sync under GET_LOCK; concurrent clicks join or keep the last snapshot. The host process also keeps a short in-memory copy (stale-while-revalidate).

Configuration

Optional cordis.yml / profile patch on the dsh-plugin-leaderboard row:

- id: dsh-plugin-leaderboard
  config:
    githubToken: # or set GITHUB_TOKEN / GH_TOKEN
    topic: dsh-plugin
    cacheTtlMs: 300000
    starPages: 3
    updatedPages: 2
    excludes:
      - deepseek-ai/deepseek-harness
    originUrl: http://101.34.27.122:3091

Unauthenticated GitHub search is enough for a personal install. A token raises the rate limit if you refresh often.

Develop

pnpm install
pnpm test
pnpm build

lib/ is the runtime. The client bundle is lib/client.js and loads through the Web GUI module table.

License

MIT