概览
dsh-n8n-plugin
源码级技术说明DeepSeek Harness Web GUI 的 n8n 工作流运维插件：设置页可管理多个 n8n 实例（每个实例一个别名 + 实例地址 + API Key，存储于 ~/.dsh/dsh-n8n-plugin.json），并提供 21 个 Agent 工具（n8n_instances、n8n_workflows、n8n_workflow_get/create/update/delete/publish/validate/clone/tags、n8n_executions、n8n_execution_get/cancel、n8n_wait_execution、n8n_webhook_call、n8n_tags、n8n_tag_create/update/delete、n8n_credentials、n8n_api）。收起技术说明
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- n8n 公开 API 仍没有跨版本稳定的「手动执行工作流」端点；`n8n_webhook_call` 通过 Webhook 触发器补上了这条路径——要求工作流里有 Webhook 节点且已发布（或用 `mode:"test"` 配合编辑器监听测试事件）。不含 Webhook 触发器的工作流，请在 n8n 界面执行，再用 `n8n_executions` / `n8n_execution_get` 查看结果。 - 不同 n8n 版本的公开 API 端点与字段有差异（例如 `publish/unpublish` 与 `activate/deactivate` 并存、更新可能需要 `versionId`）。插件对发布/取消发布做了 404 回退；其他差异可用 `n8n_api` 直达接口。 - 标签增改删、工作流标签读写与执行取消依赖实例暴露对应公开 API 端点（`/tags`、`/workflows/{id}/tags`、`/executions/{id}/stop`）。较旧的 n8n 会返回 404；请升级实例，或改用 `n8n_api` 调用它实际提供的端点。 - n8n 的标签名上限为 24 个字符，且 API 会把超长名称报成误导性的 `409 Tag already exists`；`n8n_tag_create` / `n8n_tag_update` 在发送前就拒绝超长名称。 - 实例地址使用自签名证书时会被 DSH 主机的 TLS 校验拒绝（提示证书错误）；请为实例配置受信任证书，或使用内网 HTTP。 - 一个 profile 只挂载一份本插件（重复行会由内置的 single-instance 守卫去重）。