dsh-runninghub-api
English | 中文
A DeepSeek Harness (DSH) plugin that integrates RunningHub cloud ComfyUI workflows: a settings card for your API key and workflow library, eight runninghub_* tools for agents, a sha256 media upload cache, a local concurrency gate with FIFO queueing and timeouts, background tasks with completion notifications, and a durable task ledger with automatic restart recovery.
Install
dsh plugin --profile web add dsh-runninghub-api
or install/update from the in-app plugin market (dshmarket). Then open Settings → Plugins → RunningHub to add your API key and workflows.
Settings (runninghub namespace)
| Field | Default | Purpose |
|---|
apiKey | — | Literal key (role('secret')); prefer apiKeyEnv |
apiKeyEnv | RUNNINGHUB_API_KEY | Credential reference resolved per request |
baseUrl | https://www.runninghub.cn | OpenAPI base |
pollIntervalMs | 5000 | Status poll interval (min 1000) |
runTimeoutMs | 3600000 | Run-phase timeout (0 = unlimited) |
queueTimeoutMs | 0 | Queue-phase timeout (0 = unlimited) |
maxConcurrentTasks | 3 | Local concurrency gate |
uploadUseLegacy | false | Legacy multipart upload endpoint |
workflows | [] | Saved workflow definitions |
Tools
runninghub_list_workflows, runninghub_fetch_workflow, runninghub_run_workflow (two-phase: reports missing required params/media as needs_input instead of submitting), runninghub_get_task, runninghub_list_tasks, runninghub_cancel_task, runninghub_upload_file (sha256-deduplicated), runninghub_refresh_workflow.
Remote (ctx.remote.runninghub)
fetchWorkflow (workflow JSON fetch + parse), validateWorkflow (free dry-run payload assembly), runTest (real paid submit for the settings card), testConnection. The browser half self-mounts this namespace via ctx.remote.$mount() at startup.
Development
pnpm install # canonical (npm registry)
pnpm build # Typert artifacts + host lib + client bundle
pnpm test # vitest
pnpm typecheck
Offline against a local deepseek-harness checkout (no registry access):
node scripts/link-local-dsh.mjs [/path/to/deepseek-harness]
pnpm build
Note: when link-installed into a live dsh profile (dsh plugin add <this dir>), the
@deepseek-ai/* entries in node_modules must be symlinks into the local DSH
checkout — real npm copies would duplicate the cordis singleton. Re-run
node scripts/link-local-dsh.mjs after every pnpm install, before restarting dsh.
Local install into the web profile (link install; rebuilds are picked up on restart):
dsh plugin --profile web add /path/to/dsh-runninghub-api
tests/ covers the gateway against a mocked fetch (endpoints A–F, status codes 0/804/805/813, secret masking, no-key fast-fail), workflow prompt mapping, payload validation/override reconciliation, and the media cache.
License
MIT
