dsh-runninghub-api

dsh plugin --profile web add dsh-runninghub-api

dsh-runninghub-api

[English](README.md) | 中文

DeepSeek Harness（DSH）插件：集成 RunningHub 云端 ComfyUI 工作流。插件自带的配置表单管理 API Key 与工作流库；9 个 runninghub_* 工具供 Agent 调用；sha256 媒体上传缓存；本地并发闸门 + FIFO 排队 + 超时；后台任务 + 完成通知；任务台账 + 重启自动恢复。

安装

dsh plugin --profile web add dsh-runninghub-api

或从应用内插件市场（dshmarket）安装/更新。然后打开侧边栏 插件（Plugins） 页面，点开 dsh-runninghub-api 卡片，配置表单在描述下方（DSH ≥ 0.1.6-alpha.2：插件配置已从「设置 → 插件」迁到 Plugins 页面）。

设置（runninghub 命名空间）

字段 · 默认值 · 用途

apiKey · — · 字面量密钥（role('secret')），优先用 apiKeyEnv

apiKeyEnv · RUNNINGHUB_API_KEY · 每次请求解析的凭据引用

baseUrl · https://www.runninghub.cn · OpenAPI 地址

pollIntervalMs · 5000 · 状态轮询间隔（最小 1000）

runTimeoutMs · 3600000 · 运行阶段超时（0 = 不限）

queueTimeoutMs · 0 · 排队阶段超时（0 = 不限）

maxConcurrentTasks · 3 · 本地并发闸门

uploadUseLegacy · false · 旧版 multipart 上传接口

workflows · [] · 已保存的工作流定义

工具

runninghub_list_workflows、runninghub_fetch_workflow、runninghub_run_workflow（两阶段：缺少必填参数/媒体、或参数值不在节点声明的枚举里，都返回 needs_input 而不提交）、runninghub_get_task、runninghub_list_tasks、runninghub_cancel_task、runninghub_upload_file（按 sha256 去重）、runninghub_refresh_workflow、runninghub_note_workflow（记录该工作流的使用注意事项）。

Remote（ctx.remote.runninghub）

fetchWorkflow（拉取工作流 JSON + 解析）、validateWorkflow（免费干跑组装负载）、describeWorkflow（LLM 生成目录描述、重点参数与使用注意事项 —— 摘要里带节点 registry 的枚举/上下限约束和该工作流最近的失败原因）、runTest（配置表单用的真实付费提交）、testConnection。浏览器半在启动时通过 ctx.remote.$mount() 自挂载该命名空间。

开发

pnpm install        # 标准途径（npm registry）
pnpm build          # Typert 产物 + host lib + 客户端 bundle
pnpm test           # vitest
pnpm typecheck

离线开发（registry 不可达时，从本地 deepseek-harness checkout 链接依赖）：

node scripts/link-local-dsh.mjs [/path/to/deepseek-harness]
pnpm build

注意：用 dsh plugin add <本目录> 做 link 调试时，node_modules 里的 @deepseek-ai/* 必须是指向本地 DSH checkout 的软链（真实 npm 副本会造成 cordis 双实例）。所以每次 pnpm install 之后、重启 dsh 之前，重跑一次 node scripts/link-local-dsh.mjs。

一条命令重建并装进本机 web profile（link 安装；会核对 profile 真的指向这次构建，再告诉你要不要重启）：

npm run update:dsh                # 指定 profile：npm run update:dsh -- <profile 目录>

然后重启 DSH —— dsh-hmr 只监听 profile manifest 与 patch 文件，不监听插件内容。

首次把插件装进某个 profile：

dsh plugin --profile web add /path/to/dsh-runninghub-api

tests/ 覆盖：网关对 mocked fetch 的端点 A–F、状态码 0/804/805/813、密钥脱敏、无密钥快速失败；工作流 prompt 映射；负载校验/覆盖合并；媒体缓存。

许可证

[MIT](LICENSE)