一、Dify简介

1. 为什么要使用Dify？

• 零代码门槛：通过直观界面和预设模板，非技术人员也能快速创建智能助手1。
• 模型生态丰富：支持数百个开源模型（如GPT-3.5、通义千问等），满足多样化需求1。
• 私有化部署：支持本地化部署，保障数据安全，适合企业级应用1。

2. Dify能做什么？

• 智能客服：通过知识库+大模型构建自动回复系统，降低人工成本1。
• 工作流编排：串联多个工具（如邮件、文件处理），实现复杂任务自动化1。
• 企业级知识库：整合网页、网页数据，构建结构化知识库并生成问答系统1。
• 多端接入：支持微信公众号、企业微信、飞书等平台，扩展应用场景1。

二、dify-on-wechat简介

dify-on-wechat是开源项目，用于将Dify应用接入微信生态（个人微信/企业微信），实现扫码登录、消息交互功能。核心特点：

• 零代码配置：通过修改config.json文件即可完成Dify API与微信通道的对接1。
• 多场景支持：兼容聊天助手、客服系统、文件传输等微信功能1。
• 企业认证要求：接入企业微信客服需完成企业认证，否则会报错1。

三、部署流程

1. 前期准备

• 硬件环境：推荐2核CPU+4GB内存的服务器（云服务器或本地主机）1。
• 域名与证书：若需HTTPS，需准备域名及SSL证书1。
• Dify环境：通过Docker Compose私有化部署Dify平台1。

2. 如何部署？

步骤1：创建Dify应用

1. 登录Dify控制台，创建基础编排聊天助手应用1。
2. 配置模型（如gpt-3.5-turbo）和提示词，添加知识库（可选）1。
3. 发布应用并获取API密钥和服务器地址1。

步骤2：配置dify-on-wechat

克隆项目代码

git clone https://github.com/hanfangyuan4396/dify-on-wechat.git
  cd dify-on-wechat

创建config.json文件，填写以下参数：

{
  "dify_api_base": "https://api.dify.ai/v1",  // Dify服务器地址
  "dify_api_key": "app-xxx",                // 上一步获取的API密钥
  "dify_app_type": "chatbot",              // 应用类型
  "channel_type": "wx",                    // 微信通道
  "single_chat_prefix": [""]               // 私聊触发前缀（可选）
}

安装依赖并启动项目

pip3 install -r requirements.txt
nohup python3 app.py & tail -f nohup.out  # 后台运行

或使用Docker部署：

docker compose up -d

四、常见问题

五、应用安排搭建

1. 智能助理搭建

1. 创建知识库：导入FAQ网页或网页数据，设置自动分段与清洗。

2. 配置工作流：添加知识库检索节点和LLM节点，实现上下文感知回复。

3. 发布应用：生成API接口并接入微信，设置触发前缀（如/助手）。

2. 客服系统搭建

1. 创建客服应用：选择工作流编排类型，配置多轮对话逻辑。
2. 接入企业微信：

• 在企业微信后台创建客服账号，配置回调URL。
• 将Dify API密钥与客服账号绑定，设置消息接收权限。

3. 测试与优化：

通过模拟对话验证响应速度与准确性，调整提示词提升效果