dsh-runninghub-plugin

第一次使用

1. 在插件面板添加 API Key。地域可以选国内、海外，或让插件自动探测。
2. 把 RunningHub 工作流链接发给 AI，例如：「帮我配置这个工作流：……」。
3. AI 会读取工作流，与你确认提示词、参考素材和可调参数，然后保存配置。
4. 配置完成后，可以说：「用这个工作流画一只在竹林里的熊猫」。

工作流里的节点角色由插件推断，保存前需要确认。参考素材可以使用本地文件路径，也可以使用已上传到 RunningHub 的文件名。

任务提交后会返回任务 ID。宿主提供后台作业服务时，可以查看进度并收到完成通知；调用 task.wait 可以取回结果，图片以附件显示在聊天中。

配置面板

面板中可以管理 Key、编辑工作流节点、上传提示词文档，以及查看或取消任务。工作流列表默认折叠，点击名称展开。

节点的角色、默认值、必填项、数值范围和候选值均可编辑。插件推断的常见数值范围用于提示；手动设置的范围会参与运行前校验。

插件配置和数据

以下字段可以放在插件的 config 中：

字段	默认值	说明
dataDir	/runninghub	工作流、文档、任务和 Key 的存储目录
outputDir	空	默认结果目录；单次调用的 saveDir 优先
httpTimeoutMs	60000	HTTP 请求超时，单位毫秒；提交请求至少等待 60 秒
pollIntervalMs	3000	起始轮询间隔；退避在此基础上逐步变慢，最多 15 秒。配得比 15 秒大时以配置值为准（不会被压回去）
maxWaitMs	1800000	单次等待和后台任务跟踪的上限，单位毫秒
maxTasks	10	按完成时间保留最近 N 条已结束记录；0 不限制。运行中的任务永不删；待恢复（超时 / 无可用 Key）和提交结果待核对的记录另有独立上限（max(20, 2N)），留得比普通记录久但同样有界。可在面板修改，保存后重启仍生效
registerSkill	true	注册工作流配置引导
exposeClientPanel	true	启用配置面板通道
baseUrls	{}	覆盖国内、海外接口地址，通常只在测试或代理场景使用

没有设置 DSH_HOME 时，数据目录默认是用户主目录下的 .dsh/runninghub。

secrets.json          API Key 和 Key 池状态
state.json            非机密状态
workflows/*.json      工作流配置
prompts/*.md          提示词文档
prompts/*.meta.json   文档信息
tasks/*.json          任务记录，包括结果路径（默认保留最近完成的 10 条；活任务与待恢复/待核对记录另行保留，见 maxTasks）
outputs//     默认结果目录

API Key 明文存放在本机的 secrets.json 中，工具回执、面板和日志会脱敏。写入时会尝试设置仅当前用户可读写的权限；Windows 上的实际访问权限由文件系统 ACL 决定。

建议将数据目录放在仓库之外。分享数据目录前，要移除 secrets.json 及其副本；旧版状态文件也可能含 Key。写入成功后会清理旧的机密备份和临时文件，损坏文件副本会保留供恢复。

工作流和文档覆盖前保留最近五份备份，机密文件不生成常规备份。重启插件后会继续查询未结束的任务。