# awesome-deepseek-harness-plugins

> Bring the DSH 1024Store curated catalog into the DeepSeek Harness settings page, supporting browsing, searching, one-click install/uninstall, and anonymous install statistics.

## Metadata

- Author: [@imsai-sh](https://github.com/imsai-sh)
- Repo: <https://github.com/imsai-sh/awesome-deepseek-harness-plugins.git>
- GitHub: [imsai-sh/awesome-deepseek-harness-plugins](https://github.com/imsai-sh/awesome-deepseek-harness-plugins)
- Stars: 132
- Language: TypeScript
- License: [MIT](https://spdx.org/licenses/MIT.html)
- Homepage: <https://deepseek1024.com/>
- Topics: `awesome-list`, `catalog`, `deepseek`, `deepseek-harness`, `deepseek-harness-plugins`, `deepseek1024`, `dsh`, `dsh-1024store`, `dsh-bundle`, `dsh-plugin`, `dsh-plugin-market`, `dsh-plugin-verify`, `dsh-plugins`, `dsh-skill`, `marketplace`, `plugin-directory`, `plugin-hub`, `plugin-store`, `plugins`, `registry`
- Forks: 66
- Open Issues: 15
- Last push: 2026-08-20T20:23:23.000Z
- Added: 2026-08-17T00:00:00.000Z

## Install

```bash
dsh plugin --profile web add github:imsai-sh/awesome-deepseek-harness-plugins/packages/dsh-1024store
```

## Wiki

## One-Line Pitch

Brings the DSH 1024Store official curated catalog into DeepSeek Harness's settings page, letting you browse, search, and one-click install/uninstall community plugins without leaving the host application, plus a thin wrapper around the official `dsh` command to report anonymous installation results.

## Core Features

- Dynamically loads and validates the 1024Store public catalog within the settings page, supporting search, category filtering, and installed status detection
- Provides three entry points: left navigation bar in settings, Settings → Plugins tab, and a floating entry at the bottom of the sidebar with a total count badge
- Install/uninstall via same-origin POST, one operation at a time, with real-time progress feedback
- Installer only accepts GitHub repository URLs validated by the catalog, automatically deriving `github:owner/repository` parameters, and does not execute display commands from the catalog
- Checks its own version on startup and prompts for updates; renders the catalog immediately using the last result, then silently re-validates; newly added plugins appear without manual refresh
- Includes the `dsh1024` CLI command as a thin wrapper around the official `dsh plugin`, automatically reusing the official CLI on PATH, and reports anonymous install/uninstall results

## Technical Implementation

- **Language**: TypeScript (CLI uses compiled ESM JavaScript, client uses React module loader format)
- **Key Dependencies**: `@deepseek-ai/cordis ^4.0.1` (peerDependency, injected by host), `@deepseek-ai/dsh` (CLI passthrough target, resolved via npx or PATH at runtime), Node built-in `node:fs/promises`, `node:child_process`, `node:crypto` and other standard libraries
- **Architecture Pattern**: Cordis host plugin; injects `dsh1024` into the host bundle via `package.json#dsh.bundle.patch`, with `apply(ctx, config)` mounting local HTTP routes after the `webServer` service is ready; client-side registers React components via `window.__ModuleLoader__.load` and injects three entry points through `slots`
- **Entry Files**: Server entry `packages/dsh1024/src/index.ts`; client entry `packages/dsh1024/client/client.js`; CLI entry `packages/dsh1024/bin/dsh1024.js`

## Use Cases

Ideal for regular users who want to browse and install community plugins directly within DeepSeek Harness, rather than manually copying GitHub paths to the command line. If you want to track plugin versions you've installed or perform batch management, the CLI wrapper also lets you reuse official commands in scripts while getting a local receipt.

## Prerequisites & Compatibility

| Dependency | Minimum Version | Notes |
|---|---|---|
| Node.js | >=22 | Declared in `packages/dsh1024/package.json#engines.node` |
| DSH (Host) | Not Declared | Only declares optional peer `@deepseek-ai/cordis ^4.0.1`, no host version range specified |
| Platform | Cross-Platform | Full support for macOS / Linux / Windows; `taskkill` compatibility handling on win32 for CLI passthrough and file locks |
| Native Modules | None | No dependencies on `node-pty`, `node:sqlite`, or other native modules |

## Installation

```bash
dsh plugin --profile web add github:imsai-sh/awesome-deepseek-harness-plugins/packages/dsh-1024store
```

> Note: The actual subdirectory in this repository is named `packages/dsh1024`, and the npm published package name is `dsh1024`. If you prefer to install directly via npm name, use `dsh plugin --profile web add dsh1024` as recommended in the repository README.

## Configuration

`apply(ctx, config)` supports the following three optional overrides on the host side:

| Config | Type | Description | Default |
|---|---|---|---|
| `profile` | string | DSH profile name that owns this plugin change | Value of `--profile` CLI argument, or `web` if not specified |
| `registryUrl` | HTTPS URL | Catalog API address | `https://deepseek1024.com/api/v1/registry` |
| `updateUrl` | HTTPS URL | Self-update check API address (with GitHub fallback) | `https://registry.npmjs.org/dsh1024/latest` |

The CLI and shared layer also read the following environment variables:

| Environment Variable | Purpose | Default |
|---|---|---|
| `DSH_HOME` | DSH data directory | `~/.dsh` |
| `DO_NOT_TRACK` | Set to `1` / `true` to disable telemetry | Not set |
| `DSH1024_TELEMETRY` (legacy alias `DSH_1024STORE_TELEMETRY`) | Set to `0` to disable telemetry | Not set |
| `DSH1024_DSH_PACKAGE` | Pin official CLI package name | `@deepseek-ai/dsh` |
| `DSH1024_DSH_VERSION` | DSH version reported when no version specified | Not set |
| `DSH1024_TELEMETRY_URL` | Full event reporting endpoint | `https://deepseek1024.com/api/v1/install-events` |
| `DSH1024_TELEMETRY_TIMEOUT_MS` | Upload timeout, range 100–30000 | `2500` |

## FAQ

**Q: Which profile does this plugin install to?**

A: Defaults to the profile specified by `--profile` argument, or `web` if not specified. The `profile` config option can override this. Host-side changes require restarting DeepSeek Harness to take effect.

**Q: Does it report my IP, commands, or paths?**

A: No. Reported fields include only event UUID, client UUID, plugin ID, profile, operation result, start/end time, duration, OS/architecture, CLI version, and error code; no IP, commands, file paths, prompts, or API keys. Events are reported fire-and-forget style, failures are silent, and do not affect the install exit code.

**Q: Are the plugins in the catalog reviewed?**

A: Yes. The JSON from `/api/v1/registry` undergoes strict schema validation before consumption (types, GitHub URL format, category IDs, count matching plugins length, etc.), throwing errors on failure with old cache as fallback. The installer only accepts validated repository URLs and derives `github:owner/repo` parameters solely from the URL itself, without executing display commands from the catalog.

**Q: How do I completely disable telemetry?**

A: Run `npx dsh1024 telemetry disable` once; identity file and pending queue will be cleared together; or set `DO_NOT_TRACK=1` / `DSH1024_TELEMETRY=0` in the current process (legacy name `DSH_1024STORE_TELEMETRY` remains compatible). When needed, use `telemetry reset` to rotate identity and clear queue, `telemetry status` to check current status.

**Q: What's the relationship with the old `@dsh-1024store/cli` and `dsh-1024store` packages?**

A: The new `dsh1024` package replaces these two deprecated packages. Commands have been renamed but behavior remains unchanged; old local configs (identity, receipt, pending under `$DSH_HOME/.dsh-1024store/`) continue to be reused, no migration needed.

**Q: Can it work offline?**

A: When the catalog API fetch fails, the plugin falls back to the last successful result (`source: 'cache'`), ensuring the panel doesn't go blank; plugin install/uninstall operations depend on the official `dsh` command's network, so changes will fail offline.

## Learning Curve

Beginner — as long as you can run `dsh plugin --profile web add dsh1024`, you're good to go; the UI is accessible from three fixed entry points; advanced usage (environment variable tuning, CLI wrapper, telemetry commands) can be looked up in the README as needed.

## Known Issues & Limitations

- The repository subdirectory is actually named `packages/dsh1024`, while the npm published package name is `dsh1024`; the landing page lists `packages/dsh-1024store` path which doesn't match `dsh plugin --profile web add dsh1024` in the README, please confirm the correct path before installing from GitHub path form.
- Preflight scripts will forcefully require client bundle, cordis patch, catalog URL, and three UI entries to all be present; any modification will cause `npm test` to fail.
- Catalog cache uses last-good fallback: returns `source: 'cache'` when API is unreachable, but only valid within 5-minute TTL; returns 500 when TTL exceeded and network is unavailable.
- On install/uninstall failure, if the official CLI exit code is 0 but the profile was actually not changed, the CLI wrapper will return `PROFILE_NOT_UPDATED` error code and prompt "installed but could not verify".
- Concurrent installs under the same DSH HOME are serialized by a mutex lock, waiting up to 30 seconds maximum; only one plugin operation allowed at a time, duplicate requests return 409.
- `dsh1024` itself cannot be uninstalled via the in-store panel; the API will directly return `plugin cannot be uninstalled here`.

---

This document is auto-generated by [deepseek-plugin.org](https://deepseek-plugin.org). HTML page: [awesome-deepseek-harness-plugins](https://deepseek-plugin.org/plugins/imsai-sh/awesome-deepseek-harness-plugins/packages/dsh-1024store)
Wiki generated by AI (model: `MiniMax-M2.7`)