dsh-n8n-plugin：在 DeepSeek Harness 中运维 n8n 工作流

它是做什么的？

它是 DeepSeek Harness（DSH）的 n8n 工作流运维插件（DSH plugin），把 n8n 实例注册与工作流操作直接搬进 DSH。它解决的是每次对话都要重复粘贴 n8n 地址和 API Key 的麻烦：实例只需在设置页登记一次，之后按别名调用即可。插件提供统一的实例注册表、15 个 Agent 工具和设置页界面，让配置与调用共享同一份数据，避免两边不一致。

核心功能

• 多实例注册表：在设置页按别名（如 prod、staging、local）登记基础地址与 API Key，每次工具调用只选别名，同一句指令可作用于任意环境。
• 15 个按别名寻址的 Agent 工具：覆盖实例列表、工作流增删改查、发布与取消发布、执行记录查看、等待执行结束、Webhook 触发、标签与凭据列表，以及原始 API 请求。
• 离线工作流校验：在发送前检查节点 id 与名称唯一、连接目标存在、Webhook 节点配有响应节点、执行顺序设置合理，全程不接触实例。
• 密钥本地保管：API Key 只存放在本机配置文件中并限制为 0600 权限，所有响应只显示末四位，设置页也不会回显完整密钥。
• 兼容 n8n 接口演进：发布优先走新版发布接口，仅在遇到 404 时回退到旧版激活接口，其余版本差异可用原始 API 调用兜底。
• 职责分离：Agent 只能列出实例，不能创建或修改实例，避免 API Key 通过对话被写入。

怎么使用这个插件？

在 DSH 中启用后，先打开设置页的 n8n 实例区域添加实例：填写以字母或数字开头、最长 64 字符的别名，再填基础地址（可带子路径，末尾的 /api/v1 会被自动规范化）和 API Key。之后在对话里直接让 Agent 按别名操作，例如列出某实例的工作流、读取完整工作流文档、创建或更新工作流并顺带发布、查看某次执行的逐节点结果，或通过 Webhook 触发一次运行并等待完成。发布前可先让 Agent 做离线校验，确认无误再推送；需要调整行为时，回到设置页修改实例或开关 announceToAgent，让提示中带上工作流指南文件的绝对路径供 Agent 按需读取。

报错怎么排查？

发布工作流时若遇到 404，说明实例不支持新版发布接口，插件会自动回退到旧版激活接口，无需手动处理。若某个工具调用提示找不到目标实例，先到设置页确认别名拼写与默认实例设置是否正确。若校验报出节点名称重复或连接目标不存在，按提示修正工作流 JSON 中的节点 id、名称与连接关系后重新校验。