dsh-runninghub-api
DeepSeek Harness 插件：运行 RunningHub 云端 ComfyUI 工作流——设置卡片、媒体上传缓存、并发控制、后台任务。· DSH 插件：在对话中运行 RunningHub 云端 ComfyUI 工作流。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lucyTrump/dsh-runninghub-api#00a9a2875d83a1bde50f21ca76d30b1c42f63587Runninghub Api 以 dsh-runninghub-api 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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.
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.
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 |
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.
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.
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.