dsh-runninghub-api
DeepSeek Harness 插件：运行 RunningHub 云端 ComfyUI 工作流——插件页面上的配置表单、媒体上传缓存、并发控制、后台任务。· DSH 插件：在对话中运行 RunningHub 云端 ComfyUI 工作流。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-runninghub-api@0.1.6Runninghub Api 以 dsh-runninghub-api 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness (DSH) plugin that integrates RunningHub cloud ComfyUI workflows: a configuration form for your API key and workflow library, nine 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 the sidebar's Plugins page and open the dsh-runninghub-api card: the configuration form sits below the description (on DSH ≥ 0.1.6-alpha.2, plugin configuration moved out of Settings → Plugins onto the Plugins page).
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 — and values outside a node's declared enum choices — as needs_input instead of submitting), runninghub_get_task, runninghub_list_tasks, runninghub_cancel_task, runninghub_upload_file (sha256-deduplicated), runninghub_refresh_workflow, runninghub_note_workflow (append a per-workflow usage gotcha).
ctx.remote.runninghub)fetchWorkflow (workflow JSON fetch + parse), validateWorkflow (free dry-run payload assembly), describeWorkflow (LLM catalog description, attention params, and usage notes — fed the node registry's enum/bounds constraints and this workflow's recent failures), runTest (real paid submit for the configuration form), 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.
One command rebuilds and installs into the local web profile (a link install — it verifies the profile really resolves to this build, then says what to do):
npm run update:dsh # or: npm run update:dsh -- <profile dir>
Then restart DSH — dsh-hmr watches the profile manifest and patch files, not plugin contents. First-time install into a profile:
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.