这是一个为n8n工作流自动化平台开发的社区节点，用于集成胜算云 LLM API路由服务。该项目允许用户在n8n工作流中使用生算云的大语言模型服务。
项目结构分析
1. 基本信息
项目名称: n8n-nodes-shengsuanyun
GitHub仓库: https://github.com/shengsuan/n8n-nodes-shengsuanyun
2. 技术实现点
主节点 (LmChatShengSuanYun.node.ts):
实现了
INodeType接口，作为n8n的AI语言模型节点支持动态加载可用模型列表
提供丰富的配置选项：
- 模型选择（通过API动态获取）
- 温度控制 (0-2)
- Top-P采样 (0-1)
- 频率惩罚 (-2到2)
- 存在惩罚 (-2到2)
- 最大令牌数 (最高32768)
- 响应格式 (文本/JSON)
- 超时设置
- 重试次数
聊天模型 (ShengSuanYunChatModel.ts):
- 完整实现了LangChain兼容的聊天模型接口
- 支持同步和流式响应
- 支持工具调用(Function Calling)
- 支持批量处理
- 实现了完整的消息格式转换
- 错误处理和重试机制
凭据管理 (shengSyanYunApi.credentials.ts):
- API密钥认证
- 可配置的基础URL (默认: https://router.shengsuanyun.com/api/v1)
- 内置凭据测试功能
4. 功能特性
核心功能:
- 与胜算云LLM API路由服务集成
- 支持多种大语言模型
- 流式和非流式响应
- 工具调用支持
- 批量处理能力
配置灵活性:
- 动态模型列表加载
- 丰富的生成参数控制
- 自定义API端点
- 响应格式选择
开发者友好:
- 完整的TypeScript类型定义
- 详细的接口文档
- 错误处理机制
- 调试信息支持
API集成方式：
- 使用OpenAI兼容的API格式
- 支持Bearer Token认证
- 自定义HTTP头部标识
- 完整的错误处理
前提条件
在开始之前，您需要：
- 已安装并运行n8n平台
- 拥有胜算云(ShengSuanYun)的API密钥
第一步：安装n8n（如果还没有安装）
方法1：使用npm安装（推荐）
npm install n8n -g
方法2：使用Docker安装
docker run -it --rm --name n8n -p 5678:5678 n8nio/n8n
第二步：安装N8N-Nodes-Shengsuanyun
方法1：通过n8n界面安装
- 启动n8n：
n8n start - 打开浏览器访问：
http://localhost:5678 - 登录n8n后，点击右上角的"设置"图标
- 选择"社区节点"
- 点击"安装社区节点"
- 输入包名：
n8n-nodes-shengsuanyun - 等待安装完成并重启n8n
方法2：通过命令行安装
# 停止n8n服务
# 然后运行：
npm i n8n-nodes-shengsuanyun
# 重新启动n8n
n8n start
第三步：获取胜算云API密钥
- 访问胜算云官网：https://www.shengsuanyun.com
- 注册账户并登录
- 进入控制台或API管理页面
- 创建或获取您的API密钥
- 复制下API密钥，稍后配置时需要用到
第四步：配置凭据
新建一个n8n工作流，点击加号，输入shengsuan搜索出节点
打开节点，点击"新建凭据"
填写配置信息：
- API Key: 输入您的胜算云API密钥
- Base URL: 保持默认值
https://router.shengsuanyun.com/api/v1（通常不需要修改）
若下方出现模型列表则表示连接成功，选择你的想用的模型工作
高级配置选项
温度设置：
- 0.1-0.3：更准确、一致的回答
- 0.7-0.9：更有创造性的回答
- 1.0-2.0：非常有创造性但可能不太准确
其他有用选项：
- 频率惩罚: 减少重复内容（-2到2）
- 存在惩罚: 鼓励谈论新话题（-2到2）
- Top P: 控制词汇多样性（0-1）
常见问题解决
问题1：节点安装失败
- 确保n8n版本是最新的
- 检查网络连接
- 尝试重启n8n服务
问题2：API连接失败
- 检查API密钥是否正确
- 确认胜算云账户有足够余额
- 检查网络环境设置
问题3：模型列表为空
- 检查API密钥
- 确认胜算云服务状态正常
- 尝试刷新节点配置