Skip to content

Latest commit

 

History

History
159 lines (104 loc) · 7.89 KB

CONTRIBUTING-ZH.md

File metadata and controls

159 lines (104 loc) · 7.89 KB

贡献给 Flowise

English | 中文

我们欢迎任何形式的贡献。

⭐ 点赞

点赞并分享Github 仓库

🙋 问题和回答

问题和回答部分搜索任何问题,如果找不到,可以毫不犹豫地创建一个。这可能会帮助到其他有类似问题的人。

🙌 分享 Chatflow

是的!分享你如何使用 Flowise 是一种贡献方式。将你的 Chatflow 导出为 JSON,附上截图并在展示和分享部分分享。

💡 想法

欢迎各种想法,如新功能、应用集成和区块链网络。在想法部分提交。

🐞 报告错误

发现问题了吗?报告它

👨‍💻 贡献代码

不确定要贡献什么?一些想法:

  • packages/components 创建新组件
  • 更新现有组件,如扩展功能、修复错误
  • 添加新的 Chatflow 想法

开发人员

Flowise 在一个单一的单体存储库中有 3 个不同的模块。

  • server:用于提供 API 逻辑的 Node 后端
  • ui:React 前端
  • components:Langchain/LlamaIndex 组件

先决条件

  • 安装 PNPM
    npm i -g pnpm

逐步指南

  1. Fork 官方的Flowise Github 仓库

  2. 克隆你 fork 的存储库。

  3. 创建一个新的分支,参考指南。命名约定:

    • 对于功能分支:feature/<你的新功能>
    • 对于 bug 修复分支:bugfix/<你的新bug修复>
  4. 切换到新创建的分支。

  5. 进入存储库文件夹

    cd Flowise
  6. 安装所有模块的依赖项:

    pnpm install
  7. 构建所有代码:

    pnpm build
  8. http://localhost:3000上启动应用程序

    pnpm start
  9. 开发时:

    • packages/ui中创建.env文件并指定VITE_PORT(参考.env.example
    • packages/server中创建.env文件并指定PORT(参考.env.example
    • 运行
    pnpm dev

    packages/uipackages/server进行的任何更改都将反映在http://localhost:8080

    对于packages/components中进行的更改,再次运行pnpm build以应用更改。

  10. 做完所有的更改后,运行以下命令来确保在生产环境中一切正常:

    pnpm build

    pnpm start
  11. 提交代码并从指向 Flowise 主分支 的分叉分支上提交 Pull Request。

🌱 环境变量

Flowise 支持不同的环境变量来配置您的实例。您可以在 packages/server 文件夹中的 .env 文件中指定以下变量。阅读更多信息

变量名 描述 类型 默认值
PORT Flowise 运行的 HTTP 端口 数字 3000
FLOWISE_USERNAME 登录用户名 字符串
FLOWISE_PASSWORD 登录密码 字符串
FLOWISE_FILE_SIZE_LIMIT 上传文件大小限制 字符串 50mb
DEBUG 打印组件的日志 布尔值
BLOB_STORAGE_PATH 存储位置 字符串 your-home-dir/.flowise/storage
LOG_PATH 存储日志文件的位置 字符串 your-path/Flowise/logs
LOG_LEVEL 日志的不同级别 枚举字符串: error, info, verbose, debug info
APIKEY_PATH 存储 API 密钥的位置 字符串 your-path/Flowise/packages/server
TOOL_FUNCTION_BUILTIN_DEP 用于工具函数的 NodeJS 内置模块 字符串
TOOL_FUNCTION_EXTERNAL_DEP 用于工具函数的外部模块 字符串
DATABASE_TYPE 存储 flowise 数据的数据库类型 枚举字符串: sqlite, mysql, postgres sqlite
DATABASE_PATH 数据库保存的位置(当 DATABASE_TYPE 是 sqlite 时) 字符串 your-home-dir/.flowise
DATABASE_HOST 主机 URL 或 IP 地址(当 DATABASE_TYPE 不是 sqlite 时) 字符串
DATABASE_PORT 数据库端口(当 DATABASE_TYPE 不是 sqlite 时) 字符串
DATABASE_USERNAME 数据库用户名(当 DATABASE_TYPE 不是 sqlite 时) 字符串
DATABASE_PASSWORD 数据库密码(当 DATABASE_TYPE 不是 sqlite 时) 字符串
DATABASE_NAME 数据库名称(当 DATABASE_TYPE 不是 sqlite 时) 字符串
SECRETKEY_PATH 保存加密密钥(用于加密/解密凭据)的位置 字符串 your-path/Flowise/packages/server
FLOWISE_SECRETKEY_OVERWRITE 加密密钥用于替代存储在 SECRETKEY_PATH 中的密钥 字符串
DISABLE_FLOWISE_TELEMETRY 关闭遥测 字符串

您也可以在使用 npx 时指定环境变量。例如:

npx flowise start --PORT=3000 --DEBUG=true

📖 贡献文档

Flowise 文档

🏷️ Pull Request 流程

当您打开一个 Pull Request 时,FlowiseAI 团队的成员将自动收到通知/指派。您也可以在 Discord 上联系我们。