# Contributing to Awesome DeepSeek Harness

Thanks for considering a contribution! This list is a **hand-curated selection** — the full index lives in [dsh-external/hub](https://github.com/dsh-external/hub) (`catalog.json`, CI-generated).

For public discovery, also check GitHub's [`dsh-plugin` topic](https://github.com/topics/dsh-plugin). `CATALOG.md` includes topic repositories that are not already present in the hub catalog.

## Entry standard

Every entry must be:

1. **A real repository** under the ecosystem (dsh-external org or a member project) — no dead links, no placeholders.
2. **A one-line description** — what it does, not marketing. Keep it factual and terse.
3. **A link** to the repository.

No fluff: no badges per entry, no screenshots inside entries, no long blurbs.

## Where to add

Open the matching category list in the README (English) and `README.zh-CN.md` (Chinese):

| Category | Description |
|---|---|
| Core & Official | Official bundles shipped with the composition |
| Context & Search | Session search, memory, knowledge retrieval |
| Input & Editing | Message/prompt/file input tooling |
| UI & Experience | Web UI, TUI, panels, skins |
| Browser & Remote | Browser automation, SSH remote control |
| Models & Inference | Vision, fallbacks, adapters, agent bridges |
| Git & Engineering | Git identity, workflows, plugin health |
| Notifications & Channels | Chat bots, voice, notifications |
| Fun & Lifestyle | Pets, games, skins, joke plugins |
| Infrastructure & Development | Registries, managers, catalogs, SDK tooling |

No matching category? Propose a new one in your PR.

Both language versions should be updated in the same PR — same entry, translated description.

## Process

1. Fork the repository.
2. Add your entry to the correct list(s) — alphabetical order is not required, but keep entries grouped.
3. Open a PR with a concise title (`docs: add <repo>`). No need to run tests — markdown only.

## Maintenance notes

- The curated list is maintained by hand; new entries are reviewed for usefulness, not exhaustiveness.
- Removed/archived repositories should be dropped from both language versions.
- The `dsh-external` org has been private since Aug 2026 — links require org access; the catalog sync CI depends on the `HUB_TOKEN` secret having access.
- The full machine-readable index is generated by [hub](https://github.com/dsh-external/hub) — this list never duplicates the whole catalog, only the curated highlights.