What is dshfind?

dshfind is a community site built around DeepSeek Harness (DSH):

• 📖 Learn DSH principles — structured lessons from the basics up to a chapter-by-chapter deep dive of the Cordis paper: monads, coeffects, revertible effects, effect composition, spatiotemporal composability, and more.
• 🧩 Plugin marketplace — a live index of DSH plugins, automatically aggregated from the GitHub topic dsh-plugin.
• 🏆 Best practices — plugin development guides, a glossary, and community rankings of authors and projects.

Tech stack

• Next.js 16 (App Router) + React 19
• next-intl for site i18n (English, 简体中文, 日本語 and 한국어 UI)
• MDX for lesson content (src/content/lessons)
• Tailwind CSS · deployed on Vercel

Documentation

English

• Vercel + Railway production deployment
• Public API and query guide

简体中文

• Vercel + Railway 生产部署手册
• 公开 API 与查询指南

Getting started

pnpm install
pnpm dev

Then open http://localhost:3000.

Regenerating plugin & ranking data

Plugins from the GitHub topic dsh-plugin are synced daily into the project database; the static snapshots (plugin library, homepage rails, rankings) are generated from it. To regenerate the snapshots only (needs database credentials in .env.local; rankings also need the GitHub CLI):

pnpm gen:data

To run a full refresh — GitHub sync, download counts, install methods, snapshots, build check — and commit only the generated files:

pnpm refresh

Submit your plugin

Add the dsh-plugin topic to your public GitHub repository. A scheduled job syncs the topic every day at 02:17 UTC, so a newly tagged repo shows up in the marketplace within about a day — no issue or PR needed.

If it still isn't listed after two syncs, open an issue: the repo may have been filtered as off-topic, or it may be private/archived.

Contributing

Issues and PRs are welcome:

• Lessons live in src/content/lessons as MDX.
• UI strings live in messages/.

Friend links

• DSH Desktop — a modern desktop app for the DeepSeek Harness (DSH) plugin ecosystem (GitHub)
• MZYAI GEO (妙智云) — an open-source GEO platform that gets your site accurately cited and recommended in AI answers from DeepSeek, Kimi, Doubao, GLM, Hunyuan and more (GitHub)