{"id":49493598,"url":"https://github.com/tmwgsicp/dify-on-qianniu","last_synced_at":"2026-05-01T08:05:26.217Z","repository":{"id":304490748,"uuid":"995491949","full_name":"tmwgsicp/dify-on-qianniu","owner":"tmwgsicp","description":"基于Clicknium和Dify的轻量千牛智能客服机器人，支持扩展到京东、拼多多等其他电商平台","archived":false,"fork":false,"pushed_at":"2025-07-13T12:05:02.000Z","size":442,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-13T13:23:37.319Z","etag":null,"topics":["ai","customer-service-chatbot","dify"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmwgsicp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-03T15:02:07.000Z","updated_at":"2025-07-13T12:05:05.000Z","dependencies_parsed_at":"2025-07-13T13:34:18.293Z","dependency_job_id":null,"html_url":"https://github.com/tmwgsicp/dify-on-qianniu","commit_stats":null,"previous_names":["tmwgsicp/dify-on-qianniu"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/tmwgsicp/dify-on-qianniu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmwgsicp%2Fdify-on-qianniu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmwgsicp%2Fdify-on-qianniu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmwgsicp%2Fdify-on-qianniu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmwgsicp%2Fdify-on-qianniu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmwgsicp","download_url":"https://codeload.github.com/tmwgsicp/dify-on-qianniu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmwgsicp%2Fdify-on-qianniu/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32489169,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","customer-service-chatbot","dify"],"created_at":"2026-05-01T08:05:24.577Z","updated_at":"2026-05-01T08:05:26.212Z","avatar_url":"https://github.com/tmwgsicp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dify-on-Qianniu - 千牛智能客服机器人\n\n[![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Dify](https://img.shields.io/badge/Powered%20by-Dify-orange.svg)](https://dify.ai)\n[![Clicknium](https://img.shields.io/badge/Automation-Clicknium-blue.svg)](https://www.clicknium.com/)\n\n\n\u003e 🎯 **一句话介绍**：通过RPA技术自动监测千牛客服消息，结合AI智能回复，实现7x24小时无人值守客服\n\n## 🎯 项目特点\n\n- **界面自动化**：基于Clicknium，直接操作千牛客户端，无需API接口\n- **高度定制**：后端AI基于Dify，智能客服逻辑支持完全定制化\n- **轻量设计**：约380行Python代码，依赖简单，轻量运行\n- **无限扩展**：支持扩展至众多电商客服平台，开发简单\n\n## 🚀 核心功能\n\n- 🔍 **智能监测**：实时监测千牛客服界面的新消息通知\n- 📸 **内容识别**：自动截取聊天记录，AI提取图像中的文本信息\n- 🤖 **智能回复**：基于Dify生成专业的客服回复内容\n- 🔄 **自动分流**：复杂问题自动转人工，简单问题AI处理\n- ⚡ **自动操作**：自动发送回复、转人工等界面操作\n\n## 🚀 快速开始\n\n### 环境要求\n\n- Python 3.9+\n- Windows 系统\n- Clicknium许可\n- VScode（Clicknium支持）\n- 千牛客户端\n- Dify平台（建议私有化部署）\n\n### 安装步骤\n\n**1. 克隆项目**\n```bash\ngit clone https://github.com/tmwgsicp/dify-on-qianniu.git\ncd dify-on-qianniu\n```\n\n**2. 安装依赖**\n```bash\npip install -r requirements.txt\n```\n\n**3. 配置文件**\n```bash\ncp config.example.json config.json\n```\n\n然后编辑 `config.json` 填入你的 API 配置。\n\n**4. 千牛客户端设置**\n\n⚠️ **重要设置**：在千牛客户端进行以下配置，否则机器人可能无法正常工作：\n\n1. 打开千牛客户端\n2. 进入 **系统设置** → **接待设置**\n3. **勾选**：`关闭客服工作台是否清除正在接待列表已读会话`\n\n\n**5. 界面元素录制**\n\n使用 Clicknium Studio 录制以下关键界面元素：\n\n| 元素名称 | 用途 | 录制建议 |\n|---------|------|---------|\n| `new_message` | 检测新消息 | 录制正在接待内的消息提醒 |\n| `current_user` | 获取客户名称 | 录制客户名称区域 |\n| `chat_window` | 聊天窗口 | 录制完整聊天内容区域 |\n| `reply_text` | 消息回复区域 | 录制消息回复区域 |\n| `button_send` | 发送按钮 | 录制发送按钮 |\n| `button_接待关闭` | 关闭接待中心 | 录制接待中心右上角的关闭按钮 |\n| `button_跳转接待中心` | 从工作台跳转接待中心 | 录制工作台界面右上角的旺旺图标 |\n| `button_transfer` | 转人工按钮 | 录制接待中心的转人工按钮 |\n\n**6. 运行程序**\n```bash\npython qianniu_bot.py\n```\n\n## ⚙️ 配置说明\n\n### Dify AI 配置\n\n需要在 Dify 中创建两个应用：\n\n1. **对话型应用**：用于智能客服回复，智能客服处理逻辑需自行搭建\n2. **工作流应用**：用于图像内容识别，获取千牛客户端内客户对话内容\n\n### 配置文件示例\n\n```json\n{\n    \"dify\": {\n        \"vision_api_url\": \"https://api.dify.ai/v1/workflows/run\",\n        \"chat_api_url\": \"https://api.dify.ai/v1/chat-messages\",\n        \"file_upload_url\": \"https://api.dify.ai/v1/files/upload\",\n        \"api_key\": \"app-your-chat-api-key\",\n        \"vision_api_key\": \"app-your-vision-api-key\"\n    },\n    \"clicknium\": {\n        \"license_key\": \"your-clicknium-license-key\"\n    },\n    \"settings\": {\n        \"check_interval\": 2,\n        \"use_screenshot\": true,\n        \"cleanup_screenshots\": true\n    }\n}\n```\n\n## 🔧 工作原理\n\n```mermaid\ngraph TD\n    A[监测新消息] --\u003e B{有新客户?}\n    B --\u003e|是| C[截取聊天截图]\n    B --\u003e|否| A\n    C --\u003e D[AI提取文本内容]\n    D --\u003e E[生成智能回复]\n    E --\u003e F{需要转人工?}\n    F --\u003e|是| G[转人工处理]\n    F --\u003e|否| H[发送AI回复]\n    G --\u003e A\n    H --\u003e A\n```\n\n## 📁 项目结构\n\n```\ndify-on-qianniu/\n├── qianniu_bot.py         # 主程序文件\n├── config.example.json    # 配置文件模板\n├── requirements.txt       # Python依赖\n├── .locator/              # Clicknium界面定位器\n├── screenshots/           # 聊天截图缓存\n├── .github/               # GitHub配置\n│   └── ISSUE_TEMPLATE/    # Issue模板\n└── README.md              # 项目说明\n```\n\n## 🛠️ 故障排除\n\n### 常见问题\n\n1. **机器人无法检测到新消息**\n   - 检查千牛客户端设置：**系统设置** → **接待设置** → 勾选 `关闭客服工作台是否清除正在接待列表已读会话`\n   - 重新录制消息提示区域的界面元素\n\n2. **界面识别失败**\n   - 重新录制界面元素\n   - 检查千牛客服界面是否有更新\n   - 确认千牛客户端版本兼容性\n\n3. **API 调用失败**\n   - 检查网络连接\n   - 验证 Dify API 密钥是否正确\n   - 确认 Dify 应用配置正确\n\n4. **截图功能异常**\n   - 确认系统显示设置\n   - 检查权限设置\n   - 验证截图保存路径是否正确\n\n5. **程序启动失败**\n   - 检查 Clicknium 许可证\n   - 确认配置文件格式正确\n   - 验证 Python 版本是否为 3.9+\n\n\n## 🚀 扩展开发\n\n### 平台适配\n\n理论上可以适配其他电商客服平台：\n- 京东\n- 拼多多\n- 抖音\n- 其他电商客服\n\n\u003e 💡 **提示**：核心处理逻辑已实现，扩展新平台主要是界面适配工作\n\n## 📄 许可证\n\n本项目采用 MIT 许可证，详见 [LICENSE](LICENSE) 文件。\n\n## ⚠️ 免责声明\n\n- 本项目仅供学习和研究使用\n- 使用时请遵守相关平台的服务条款\n- 建议在测试环境充分验证后再用于生产\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 📞 联系与交流\n\n### 💬 技术交流与学习指导\n\n如果你在部署过程中遇到问题，或者想要学习更多关于AI自动化、AI工作流的技术，欢迎添加我的联系方式进行交流：\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"contact.jpg\" alt=\"联系方式\" width=\"300\"\u003e\n  \u003cp\u003e\u003cem\u003e扫码添加联系方式，获取技术支持和学习指导\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n### 🎯 问题反馈\n\n对于一般性问题和Bug报告，请优先通过 [GitHub Issues](https://github.com/tmwgsicp/dify-on-qianniu/issues) 提交，这样可以帮助更多用户。\n\n## ☕ 支持项目\n\n如果这个项目对你有帮助，欢迎请我喝杯奶茶！你的支持是我持续更新和维护项目的动力。\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"donate.jpg\" alt=\"赞赏码\" width=\"300\"\u003e\n  \u003cp\u003e\u003cem\u003e感谢你的支持与鼓励！\u003c/em\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n### 🙏 其他支持方式\n\n- ⭐ 给项目一个 Star\n- 🐛 提交 Bug 报告和改进建议  \n- 📢 向朋友推荐这个项目\n- 🔧 贡献代码和文档\n\n---\n\n**⭐ 如果这个项目对你有帮助或启发，请给个Star支持一下！** ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmwgsicp%2Fdify-on-qianniu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmwgsicp%2Fdify-on-qianniu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmwgsicp%2Fdify-on-qianniu/lists"}