omdsh-dev / dsh-hub

OMDSH Hub

OMDSH Hub is a community extension catalog and Profile generation manager for DeepSeek Harness. It reuses the Harness Profile, Bundle, Repository Plugin, Agent Preset, layered Skill registry, Cordis lifecycle, and configuration contracts while adding transactional installation, recovery, catalog browsing, and a settings UI.

This release candidate is checked against the newest packages currently published on the npm next channel (queried 2026-08-13): Cordis 4.0.1-rc.4 and the DSH client and Host contracts 0.0.1-rc.5:

• Bundle metadata under package.json#dsh.bundle;
• Client metadata under package.json#dsh.client;
• the settings.section client slot;
• the webServer host service;
• Loader readiness after every enabled Cordis fiber becomes active.

The package intentionally remains marked private: true to prevent npm publication. Making the GitHub repository public does not require removing that guard.

Local validation

Use Node.js 22 or later:

npm ci --ignore-scripts
npm run validate
npm run pack:check

The @deepseek-ai packages require registry read access. Supply a short-lived NPM_TOKEN through the process environment and the local npm configuration described by the package owner; never put a concrete token in this repository. validate checks the exact npm package versions and contract declarations, JavaScript syntax, the vendored Registry, and the complete Node test suite. pack:check inspects the package manifest without publishing it and rejects local npm configuration.

Harness integration

The host entry is dist/index.mjs. It provides the extension manager, Workshop bridge, and agent ecosystem services, registers the loopback-only management API, and installs the official-v2 runtime-ready adapter. official-v2 is OMDSH's adapter API version; it is not a snapshot name.

The prebuilt client entry is dist/client.js. It contributes the Extensions settings section through the standard client manifest and supports Installed, Discover, collections, recipes, updates, and history views.

The npm registry did not provide @deepseek-ai/dsh-repository-plugin when this candidate was checked. Git-source catalog entries therefore remain visible as guided integrations and OMDSH does not claim that they can be installed through an npm-provided Repository Plugin. This repository does not copy a private or Git-snapshot implementation to fill that gap.

The management endpoint is /omdsh/extensions/v1. Mutation requests are restricted to a loopback Host, reject cross-site Fetch Metadata, and require a matching HTTP Origin when an Origin header is present.

Safety model

• Install and update operations are staged in a new physical Profile generation.
• Package-manager lifecycle scripts are disabled by default.
• Registry documents are strictly parsed and remote replacements require a configured Ed25519 signature.
• A candidate generation becomes current only after configuration validation and runtime readiness confirmation.
• Failed candidates are discarded and the previous generation remains recoverable.

Documentation

• Architecture
• Adapters
• Chinese README

License

MIT