AIGC网盘 n8n 自定义节点

这是一个为 n8n 平台开发的自定义节点包，提供与 AIGC 网盘的完整集成能力。通过这些节点，你可以在 n8n 工作流中轻松管理文件上传、下载、查询和删除等操作。

✨ 功能特性

• 🔍 文件列表查询 - 支持关键词搜索、分类筛选、排序和分页
• 📤 文件上传 - 支持本地文件上传和从URL直接上传
• 📥 文件下载 - 将网盘文件下载到工作流中进行处理
• 📊 文件信息 - 获取文件的详细元数据信息
• 🗑️ 文件删除 - 支持单个文件删除和批量删除操作
• 🔐 安全认证 - 通过 API Token 进行安全的身份验证
• 🌐 中文支持 - 完整的中文界面和错误提示

📦 安装

通过 n8n 社区节点安装（推荐）

1. 在 n8n 界面中，转到 设置 > 社区节点
2. 选择 安装
3. 输入包名：@aigchub/n8n-nodes-aigc-network-disk
4. 点击 安装

通过 npm 安装

如果你是自托管 n8n 实例：

# 安装包
npm install @aigchub/n8n-nodes-aigc-network-disk

# 重启 n8n
n8n start

🔧 配置

1. 获取 API Token

访问 AIGC 网盘 并：

1. 登录你的账户
2. 进入个人设置或 API 设置页面
3. 生成新的 API Token
4. 复制生成的 Token（格式：aigc-hub-xxxxxxxxxx）

2. 在 n8n 中配置凭证

1. 在 n8n 工作流编辑器中添加任意 AIGC 网盘节点
2. 点击 凭证 下拉菜单
3. 选择 创建新凭证
4. 填写配置信息：
   • API Token: 粘贴你的 Token
   • Base URL: https://aigc-network-disk.aigchub.vip（默认值）
5. 点击 保存 并测试连接

🚀 快速开始

基础文件操作工作流

[触发器] → [AIGC网盘-获取文件列表] → [AIGC网盘-下载文件] → [处理文件]

自动化备份工作流

[定时触发] → [HTTP请求获取数据] → [AIGC网盘-上传文件] → [通知]

📋 可用节点

🔍 AIGC网盘-获取文件列表

检索网盘中的文件，支持多种筛选和排序选项。

参数：

• 搜索关键词（可选）
• 文件分类筛选
• 排序字段和方向
• 分页设置

📤 AIGC网盘-上传文件

将工作流中的文件上传到网盘。

参数：

• 二进制数据字段名
• 文件描述（可选）
• 分类设置
• 标签（可选）

🌐 AIGC网盘-通过URL上传

从外部URL直接下载并上传文件到网盘。

参数：

• 文件URL
• 自定义文件名（可选）
• 文件描述
• 分类和标签

📥 AIGC网盘-下载文件

将网盘文件下载到工作流中进行处理。

参数：

• 文件ID
• 输出属性名

📊 AIGC网盘-获取文件信息

获取指定文件的详细元数据。

参数：

• 文件ID

🗑️ AIGC网盘-删除文件

删除单个文件（需要确认）。

参数：

• 文件ID
• 删除确认

🗑️ AIGC网盘-批量删除文件

批量删除多个文件（需要确认）。

参数：

• 文件ID列表（逗号分隔）
• 删除确认

💡 使用示例

示例 1：自动化文件同步

{
  "nodes": [
    {
      "name": "定时触发",
      "type": "n8n-nodes-base.cron",
      "parameters": {
        "triggerTimes": {
          "item": [
            {
              "hour": 2,
              "minute": 0
            }
          ]
        }
      }
    },
    {
      "name": "获取文件列表",
      "type": "@aigchub/n8n-nodes-aigc-network-disk.aigcNetworkDiskListFiles",
      "parameters": {
        "categoryId": 1,
        "size": 50
      }
    }
  ]
}

示例 2：批量文件处理

{
  "nodes": [
    {
      "name": "获取图片文件",
      "type": "@aigchub/n8n-nodes-aigc-network-disk.aigcNetworkDiskListFiles",
      "parameters": {
        "categoryId": 1,
        "query": ".jpg"
      }
    },
    {
      "name": "下载并处理",
      "type": "@aigchub/n8n-nodes-aigc-network-disk.aigcNetworkDiskDownloadFile",
      "parameters": {
        "fileId": "={{$json.id}}"
      }
    }
  ]
}

🔒 安全注意事项

• 🔐 请妥善保管你的 API Token，不要在公开场所分享
• 🛡️ 建议定期更换 API Token
• ⚠️ 删除操作不可逆，请谨慎使用删除功能
• 📝 在生产环境中使用前，建议先在测试环境充分验证

🐛 故障排除

常见问题

Q: 提示 "API Token无效或已过期"
A: 请检查：

• Token 格式是否正确（应以 aigc-hub- 开头）
• Token 是否已过期
• 网络连接是否正常

Q: 文件上传失败
A: 请检查：

• 文件大小是否超过限制
• 网络连接是否稳定
• 账户存储空间是否充足

Q: 无法找到文件
A: 请确认：

• 文件ID是否正确
• 文件是否已被删除
• 是否有访问权限

获取帮助

如果遇到问题：

1. 查看 n8n 的执行日志
2. 检查错误信息中的详细描述
3. 确认 API 凭证配置正确
4. 访问 API 文档 了解更多信息

🤝 贡献

欢迎贡献代码！请：

1. Fork 这个仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目基于 MIT 许可证开源 - 查看 LICENSE.md 文件了解详情。

🔗 相关链接

• 🌐 AIGC 网盘官网
• 📚 API 文档
• 🔧 n8n 官方文档
• 📦 npm 包页面

---

由 AIGC Hub 维护 💫