[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-danielcardeenas--sulla":3,"tool-danielcardeenas--sulla":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":81,"owner_twitter":79,"owner_website":82,"owner_url":83,"languages":84,"stars":93,"forks":94,"last_commit_at":95,"license":96,"difficulty_score":23,"env_os":97,"env_gpu":97,"env_ram":97,"env_deps":98,"category_tags":102,"github_topics":103,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":110,"updated_at":111,"faqs":112,"releases":143},1138,"danielcardeenas\u002Fsulla","sulla","👩🏻‍🔬 Javascript Whatsapp api library for chatbots","sulla是一款基于JavaScript的WhatsApp自动化工具，通过封装高阶API让开发者能轻松实现消息自动回复和数据交互。它利用puppeteer库操控无头浏览器模拟网页版WhatsApp操作，无需复杂配置即可完成聊天机器人开发。该工具特别适合需要快速搭建WhatsApp自动化场景的开发者，比如客服系统或信息推送应用。sulla的亮点在于通过Session记忆功能避免重复扫码，支持多实例并发运行。不过需要注意的是，当前项目维护较为有限，建议关注其生态中更活跃的衍生项目如venom或wppconnect作为替代方案。","\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\">\n    \u003Cimg width=\"250px\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdanielcardeenas_sulla_readme_5a5663772fac.jpg\" alt=\"Sulla logo\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n# Sulla\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fsulla.svg?color=%2378e08f)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fsulla)\n![npm type definitions](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Ftypes\u002Fsulla)\n![GitHub last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fdanielcardeenas\u002Fsulla)\n[![GitHub license](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fdanielcardeenas\u002Fsulla)](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002FLICENSE)\n[![codebeat badge](https:\u002F\u002Fcodebeat.co\u002Fbadges\u002F7e510d47-8689-49da-abd8-a9a29d106a2b)](https:\u002F\u002Fcodebeat.co\u002Fprojects\u002Fgithub-com-danielcardeenas-sulla-master)\n\n> Sulla is a javascript library which provides a high-level API control to\n> Whatsapp so it can be configured to automatize responses or any data that goes\n> through Whatsapp effortlessly.\n>\n> It is built using [puppeteer](https:\u002F\u002Fgithub.com\u002FGoogleChrome\u002Fpuppeteer)\n\n\n## Sulla state\n\nAs of version `2.3.5` it seems that sulla has reached a very rich and stable functionality and architecture.\nAs much as I would love to, I cannot dedicate a lot of time to this project so please consider checking out forked versions of sulla where other developers can dedicate more time and support to it.\n\nRecommended actively supported sulla-based projects:\n> [**venom**](https:\u002F\u002Fgithub.com\u002Forkestral\u002Fvenom)\n> \n> [![last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Forkestral\u002Fvenom)](https:\u002F\u002Fgithub.com\u002Forkestral\u002Fvenom\u002F)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fvenom.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fvenom)\n[![Average time to resolve an issue](https:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Forkestral\u002Fvenom.svg)](https:\u002F\u002Fisitmaintained.com\u002Fproject\u002Forkestral\u002Fvenom 'Average time to resolve an issue')\n\n> [**wppconnect**](https:\u002F\u002Fgithub.com\u002Fwppconnect-team\u002Fwppconnect\u002F)\n> \n> [![last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fwppconnect-team\u002Fwppconnect)](https:\u002F\u002Fgithub.com\u002Fwppconnect-team\u002Fwppconnect\u002F)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@wppconnect-team\u002Fwppconnect.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@wppconnect-team\u002Fwppconnect)\n[![Average time to resolve an issue](https:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Fwppconnect-team\u002Fwppconnect.svg)](https:\u002F\u002Fisitmaintained.com\u002Fproject\u002Fwppconnect-team\u002Fwppconnect 'Average time to resolve an issue')\n\n> [**open-wa\u002Fwa-automate**](https:\u002F\u002Fgithub.com\u002Fopen-wa\u002Fwa-automate-nodejs)\n>\n> [![last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fopen-wa\u002Fwa-automate-nodejs)](https:\u002F\u002Fgithub.com\u002Fopen-wa\u002Fwa-automate-nodejs)\n[![Downloads](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@open-wa\u002Fwa-automate.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@open-wa\u002Fwa-automate)\n[![Average time to resolve an issue](http:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Fopen-wa\u002Fwa-automate-nodejs.svg)](http:\u002F\u002Fisitmaintained.com\u002Fproject\u002Fopen-wa\u002Fwa-automate-nodejs \"Average time to resolve an issue\")\n\n## Installation\n\n```bash\n> npm i sulla --save\n```\n\n## Getting started\n\n```javascript\n\u002F\u002F Supports ES6\n\u002F\u002F import { create, Whatsapp } from 'sulla';\nconst sulla = require('sulla');\n\nsulla.create().then((client) => start(client));\n\nfunction start(client) {\n  client.onMessage((message) => {\n    if (message.body === 'Hi') {\n      client.sendText(message.from, '👋 Hello from sulla!');\n    }\n  });\n}\n```\n\n\u003Cimg align=\"left\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdanielcardeenas_sulla_readme_98cd1e28f984.gif\" width=\"370px\">\n\n##### After executing `create()` function, **sulla** will create an instance of whatsapp web. If you are not logged in, it will print a QR code in the terminal. Scan it with your phone and you are ready to go!\n\n##### Sulla will remember the session so there is no need to authenticate everytime.\n\n##### Multiples sessions can be created at the same time by pasing a session name to `create()` function:\n\n```javascript\n\u002F\u002F Init sales whatsapp bot\nsulla.create('sales').then((salesClient) => {...});\n\n\u002F\u002F Init support whatsapp bot\nsulla.create('support').then((supportClient) => {...});\n```\n\n\u003Cbr>\n\n## Optional create parameters\n\nSulla `create()` method third parameter can have the following optional\nparameters:\n\n```javascript\ncreate('sessionName', qrCallback, {\n  headless: true, \u002F\u002F Headless chrome\n  devtools: false, \u002F\u002F Open devtools by default\n  useChrome: true, \u002F\u002F If false will use Chromium instance\n  debug: false, \u002F\u002F Opens a debug session\n  logQR: true \u002F\u002F Logs QR automatically in terminal\n  browserArgs: [''] \u002F\u002F Parameters to be added into the chrome browser instance\n  refreshQR: 15000, \u002F\u002F Will refresh QR every 15 seconds, 0 will load QR once. Default is 30 seconds\n});\n```\n\n##### The type definition con be found in here: [CreateConfig.ts](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002Fsrc\u002Fconfig\u002Fcreate-config.ts)\n\n## Exporting QR code\n\nBy default QR code will appear on the terminal. If you need to pass the QR\nsomewhere else heres how:\n\n```javascript\nconst fs = require('fs');\n\n\u002F\u002F Second create() parameter is the QR callback\nsulla.create('session-marketing', (base64Qr, asciiQR) => {\n  \u002F\u002F To log the QR in the terminal\n  console.log(asciiQR);\n\n  \u002F\u002F To write it somewhere else in a file\n  exportQR(base64Qr, 'marketing-qr.png');\n});\n\n\u002F\u002F Writes QR in specified path\nfunction exportQR(qrCode, path) {\n  qrCode = qrCode.replace('data:image\u002Fpng;base64,', '');\n  const imageBuffer = Buffer.from(qrCode, 'base64');\n\n  \u002F\u002F Creates 'marketing-qr.png' file\n  fs.writeFileSync(path, imageBuffer);\n}\n```\n\n## Downloading files\n\nPuppeteer takes care of the file downloading. The decryption is being done as\nfast as possible (outruns native methods). Supports big files!\n\n```javascript\nimport fs = require('fs');\nimport mime = require('mime-types');\n\nclient.onMessage(async (message) => {\n  if (message.isMedia) {\n    const buffer = await client.downloadFile(message);\n    \u002F\u002F At this point you can do whatever you want with the buffer\n    \u002F\u002F Most likely you want to write it into a file\n    const fileName = `some-file-name.${mime.extension(message.mimetype)}`;\n    fs.writeFile(fileName, buffer, function (err) {\n      ...\n    });\n  }\n});\n```\n\n## Basic functions (usage)\n\nNot every available function is listed, for further look, every function\navailable can be found in [here](\u002Fsrc\u002Fapi\u002Flayers) and\n[here](\u002Fsrc\u002Flib\u002Fwapi\u002Ffunctions)\n\n### Chatting\n\n##### Here, `chatId` could be `\u003CphoneNumber>@c.us` or `\u003CphoneNumber>-\u003CgroupId>@c.us`\n\n```javascript\n\u002F\u002F Send basic text\nawait client.sendText(chatId, '👋 Hello from sulla!');\n\n\u002F\u002F Send image\nawait client.sendImage(\n  chatId,\n  'path\u002Fto\u002Fimg.jpg',\n  'image-name.jpg',\n  'Caption text'\n);\n\n\u002F\u002F Send @tagged message\nawait client.sendMentioned(chatId, 'Hello @5218113130740 and @5218243160777!', [\n  '5218113130740',\n  '5218243160777',\n]);\n\n\u002F\u002F Reply to a message\nawait client.reply(chatId, 'This is a reply!', message.id.toString());\n\n\u002F\u002F Send file (sulla will take care of mime types, just need the path)\nawait client.sendFile(chatId, 'path\u002Fto\u002Ffile.pdf', 'cv.pdf', 'Curriculum');\n\n\u002F\u002F Send gif\nawait client.sendVideoAsGif(\n  chatId,\n  'path\u002Fto\u002Fvideo.mp4',\n  'video.gif',\n  'Gif image file'\n);\n\n\u002F\u002F Send contact\n\u002F\u002F contactId: 52155334634@c.us\nawait client.sendContact(chatId, contactId);\n\n\u002F\u002F Forwards messages\nawait client.forwardMessages(chatId, [message.id.toString()], true);\n\n\u002F\u002F Send sticker\nawait client.sendImageAsSticker(chatId, 'path\u002Fto\u002Fimage.jpg');\n\n\u002F\u002F Send location\nawait client.sendLocation(\n  chatId,\n  25.6801987,\n  -100.4060626,\n  'Some address, Washington DC',\n  'Subtitle'\n);\n\n\u002F\u002F Send seen ✔️✔️\nawait client.sendSeen(chatId);\n\n\u002F\u002F Start typing...\nawait client.startTyping(chatId);\n\n\u002F\u002F Stop typing\nawait client.stopTyping(chatId);\n\n\u002F\u002F Set chat state (0: Typing, 1: Recording, 2: Paused)\nawait client.setChatState(chatId, 0 | 1 | 2);\n```\n\n### Retrieving data\n\n```javascript\n\u002F\u002F Retrieve contacts\nconst contacts = await client.getAllContacts();\n\n\u002F\u002F Retrieve all messages in chat\nconst allMessages = await client.loadAndGetAllMessagesInChat(chatId);\n\n\u002F\u002F Retrieve contact status\nconst status = await client.getStatus(contactId);\n\n\u002F\u002F Retrieve user profile\nconst user = await client.getNumberProfile(contactId);\n\n\u002F\u002F Retrieve all unread message\nconst messages = await client.getAllUnreadMessages();\n\n\u002F\u002F Retrieve all chats\nconst chats = await client.getAllChats();\n\n\u002F\u002F Retrieve all groups\nconst chats = await client.getAllGroups();\n\n\u002F\u002F Retrieve profile fic (as url)\nconst url = await client.getProfilePicFromServer(chatId);\n\n\u002F\u002F Retrieve chat\u002Fconversation\nconst chat = await client.getChat(chatId);\n```\n\n### Group functions\n\n```javascript\n\u002F\u002F groupId or chatId: leaveGroup 52123123-323235@g.us\n\n\u002F\u002F Leave group\nawait client.leaveGroup(groupId);\n\n\u002F\u002F Get group members\nawait client.getGroupMembers(groupId);\n\n\u002F\u002F Get group members ids\nawait client.getGroupMembersIds(groupId);\n\n\u002F\u002F Generate group invite url link\nawait client.getGroupInviteLink(groupId);\n\n\u002F\u002F Create group (title, participants to add)\nawait client.createGroup('Group name', ['123123@c.us', '45456456@c.us']);\n\n\u002F\u002F Remove participant\nawait client.removeParticipant(groupId, '123123@c.us');\n\n\u002F\u002F Add participant\nawait client.addParticipant(groupId, '123123@c.us');\n\n\u002F\u002F Promote participant (Give admin privileges)\nawait client.promoteParticipant(groupId, '123123@c.us');\n\n\u002F\u002F Demote particiapnt (Revoke admin privileges)\nawait client.demoteParticipant(groupId, '123123@c.us');\n\n\u002F\u002F Get group admins\nawait client.getGroupAdmins(groupId);\n```\n\n### Profile functions\n\n```javascript\n\u002F\u002F Set client status\nawait client.setProfileStatus('On vacations! ✈️');\n\n\u002F\u002F Set client profile name\nawait client.setProfileName('Sulla bot');\n```\n\n### Device functions\n\n```javascript\n\u002F\u002F Get device info\nawait client.getHostDevice();\n\n\u002F\u002F Get connection state\nawait client.getConnectionState();\n\n\u002F\u002F Get battery level\nawait client.getBatteryLevel();\n\n\u002F\u002F Is connected\nawait client.isConnected();\n\n\u002F\u002F Get whatsapp web version\nawait client.getWAVersion();\n```\n\n### Events\n\n```javascript\n\u002F\u002F Listen to messages\nclient.onMessage(message => {\n  ...\n})\n\n\u002F\u002F Listen to state changes\nclient.onStateChange(state => {\n  ...\n});\n\n\u002F\u002F Listen to ack's\nclient.onAck(ack => {\n  ...\n});\n\n\u002F\u002F Listen to live location\n\u002F\u002F chatId: 'phone@c.us'\nclient.onLiveLocation(chatId, (liveLocation) => {\n  ...\n});\n\n\u002F\u002F chatId looks like this: '5518156745634-1516512045@g.us'\n\u002F\u002F Event interface is in here: https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002Fsrc\u002Fapi\u002Fmodel\u002Fparticipant-event.ts\nclient.onParticipantsChanged(chatId, (event) => {\n  ...\n});\n\n\u002F\u002F Listen when client has been added to a group\nclient.onAddedToGroup(chatEvent => {\n  ...\n});\n\n```\n\n### Other\n\n```javascript\n\u002F\u002F Delete chat\nawait client.deleteChat(chatId);\n\n\u002F\u002F Clear chat messages\nawait client.clearChat(chatId);\n\n\u002F\u002F Delete message (last parameter: delete only locally)\nawait client.deleteMessage(chatId, message.id.toString(), false);\n\n\u002F\u002F Retrieve a number profile \u002F check if contact is a valid whatsapp number\nconst profile = await client.getNumberProfile('0000000@c.us');\n```\n\n## Misc\n\nThere are some tricks for a better usage of sulla.\n\n#### Keep session alive:\n\n```javascript\n\u002F\u002F In case of being logged out of whatsapp web\n\u002F\u002F Force it to keep the current session\n\u002F\u002F State change\nclient.onStateChange((state) => {\n  console.log(state);\n  const conflits = [\n    sulla.SocketState.CONFLICT,\n    sulla.SocketState.UNPAIRED,\n    sulla.SocketState.UNLAUNCHED,\n  ];\n  if (conflits.includes(state)) {\n    client.useHere();\n  }\n});\n```\n\n#### Send message to new contacts (non-added)\n\nAlso see [Whatsapp links](https:\u002F\u002Ffaq.whatsapp.com\u002Fen\u002F26000030\u002F) Be careful\nsince this can pretty much could cause a ban from Whatsapp, always keep your\ncontacts updated!\n\n```javascript\nawait client.sendMessageToId('5212234234@c.us', 'Hello from sulla! 👋');\n```\n\n#### Multiple sessions\n\nIf you need to run multiple sessions at once just pass a session name to\n`create()` method.\n\n```javascript\nasync () => {\n  const marketingClient = await sulla.create('marketing');\n  const salesClient = await sulla.create('sales');\n  const supportClient = await sulla.create('support');\n};\n```\n\n#### Closing (saving) sessions\n\nClose the session properly to ensure the session is saved for the next time you\nlog in (So it wont ask for QR scan again). So instead of CTRL+C,\n\n```javascript\n\u002F\u002F Catch ctrl+C\nprocess.on('SIGINT', function() {\n  client.close();\n});\n\n\u002F\u002F Try-catch close\ntry {\n   ...\n} catch (error) {\n   client.close();\n}\n```\n\n### Debugging\n\n## Development\n\nBuilding sulla is really simple altough it contians 3 main projects inside\n\n1. Wapi project\n\n```bash\n> npm run build:wapi\n```\n\n2. Middleeware\n\n```bash\n> npm run build:build:middleware\n> npm run build:jsQR\n```\n\n3. Sulla\n\n```bash\n> npm run build:sulla\n```\n\nTo build the entire project just run\n\n```bash\n> npm run build\n```\n\n\n## Maintainers\n\nMaintainers are needed, I cannot keep with all the updates by myself. If you are\ninterested please open a Pull Request.\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to\ndiscuss what you would like to change.\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\">\n    \u003Cimg width=\"250px\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdanielcardeenas_sulla_readme_5a5663772fac.jpg\" alt=\"Sulla logo\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n# Sulla\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fsulla.svg?color=%2378e08f)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fsulla)\n![npm type definitions](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Ftypes\u002Fsulla)\n![GitHub last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fdanielcardeenas\u002Fsulla)\n[![GitHub license](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fdanielcardeenas\u002Fsulla)](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002FLICENSE)\n[![codebeat badge](https:\u002F\u002Fcodebeat.co\u002Fbadges\u002F7e510d47-8689-49da-abd8-a9a29d106a2b)](https:\u002F\u002Fcodebeat.co\u002Fprojects\u002Fgithub-com-danielcardeenas-sulla-master)\n\n> Sulla 是一个 JavaScript 库，提供对 WhatsApp 的高级 API 控制，可以轻松配置以自动化回复或处理通过 WhatsApp 传输的任何数据。\n>\n> 它基于 [Puppeteer](https:\u002F\u002Fgithub.com\u002FGoogleChrome\u002Fpuppeteer) 构建。\n\n\n## Sulla 当前状态\n\n截至 `2.3.5` 版本，Sulla 已经具备非常丰富且稳定的功能和架构。\n尽管我非常希望继续维护这个项目，但我目前无法投入大量时间。因此，建议您查看 Sulla 的分支版本，这些版本由其他开发者维护，能够获得更好的支持。\n\n推荐的活跃维护的基于 Sulla 的项目：\n> [**venom**](https:\u002F\u002Fgithub.com\u002Forkestral\u002Fvenom)\n> \n> [![最近一次提交](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Forkestral\u002Fvenom)](https:\u002F\u002Fgithub.com\u002Forkestral\u002Fvenom\u002F)\n[![下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fvenom.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fvenom)\n[![解决一个问题的平均时间](https:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Forkestral\u002Fvenom.svg)](https:\u002F\u002Fisitmaintained.com\u002Fproject\u002Forkestral\u002Fvenom '解决一个问题的平均时间')\n\n> [**wppconnect**](https:\u002F\u002Fgithub.com\u002Fwppconnect-team\u002Fwppconnect\u002F)\n> \n> [![最近一次提交](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fwppconnect-team\u002Fwppconnect)](https:\u002F\u002Fgithub.com\u002Fwppconnect-team\u002Fwppconnect\u002F)\n[![下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@wppconnect-team\u002Fwppconnect.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@wppconnect-team\u002Fwppconnect)\n[![解决一个问题的平均时间](https:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Fwppconnect-team\u002Fwppconnect.svg)](https:\u002F\u002Fisitmaintained.com\u002Fproject\u002Fwppconnect-team\u002Fwppconnect '解决一个问题的平均时间')\n\n> [**open-wa\u002Fwa-automate**](https:\u002F\u002Fgithub.com\u002Fopen-wa\u002Fwa-automate-nodejs)\n>\n> [![最近一次提交](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Fopen-wa\u002Fwa-automate-nodejs)](https:\u002F\u002Fgithub.com\u002Fopen-wa\u002Fwa-automate-nodejs)\n[![下载量](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@open-wa\u002Fwa-automate.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@open-wa\u002Fwa-automate)\n[![解决一个问题的平均时间](http:\u002F\u002Fisitmaintained.com\u002Fbadge\u002Fresolution\u002Fopen-wa\u002Fwa-automate-nodejs.svg)](http:\u002F\u002Fisitmaintained.com\u002Fproject\u002Fopen-wa\u002Fwa-automate-nodejs \"解决一个问题的平均时间\")\n\n## 安装\n\n```bash\n> npm i sulla --save\n```\n\n## 快速入门\n\n```javascript\n\u002F\u002F 支持 ES6\n\u002F\u002F import { create, Whatsapp } from 'sulla';\nconst sulla = require('sulla');\n\nsulla.create().then((client) => start(client));\n\nfunction start(client) {\n  client.onMessage((message) => {\n    if (message.body === 'Hi') {\n      client.sendText(message.from, '👋 Hello from sulla!');\n    }\n  });\n}\n```\n\n\u003Cimg align=\"left\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdanielcardeenas_sulla_readme_98cd1e28f984.gif\" width=\"370px\">\n\n##### 执行 `create()` 函数后，**Sulla** 将创建一个 WhatsApp Web 实例。如果您尚未登录，终端会显示一个二维码。使用手机扫描该二维码即可开始使用！\n\n##### Sulla 会记住会话，因此无需每次都重新验证。\n\n##### 您可以通过向 `create()` 函数传递会话名称来同时创建多个会话：\n\n```javascript\n\u002F\u002F 初始化销售 WhatsApp 机器人\nsulla.create('sales').then((salesClient) => {...});\n\n\u002F\u002F 初始化客服 WhatsApp 机器人\nsulla.create('support').then((supportClient) => {...});\n```\n\n\u003Cbr>\n\n## 可选的 create 参数\n\nSulla 的 `create()` 方法第三个参数可以包含以下可选配置：\n\n```javascript\ncreate('sessionName', qrCallback, {\n  headless: true, \u002F\u002F 无头模式\n  devtools: false, \u002F\u002F 默认不打开开发者工具\n  useChrome: true, \u002F\u002F 如果为 false，则使用 Chromium 实例\n  debug: false, \u002F\u002F 是否开启调试模式\n  logQR: true \u002F\u002F 自动在终端中记录二维码\n  browserArgs: [''] \u002F\u002F 要添加到 Chrome 浏览器实例中的参数\n  refreshQR: 15000, \u002F\u002F 每 15 秒刷新一次二维码，0 表示只加载一次，默认为 30 秒\n});\n```\n\n##### 类型定义可以在以下文件中找到：[CreateConfig.ts](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002Fsrc\u002Fconfig\u002Fcreate-config.ts)\n\n## 导出二维码\n\n默认情况下，二维码会显示在终端中。如果您需要将二维码传递到其他地方，可以这样做：\n\n```javascript\nconst fs = require('fs');\n\n\u002F\u002F create() 的第二个参数是二维码回调函数\nsulla.create('session-marketing', (base64Qr, asciiQR) => {\n  \u002F\u002F 在终端中记录二维码\n  console.log(asciiQR);\n\n  \u002F\u002F 将其写入文件\n  exportQR(base64Qr, 'marketing-qr.png');\n});\n\n\u002F\u002F 将二维码写入指定路径\nfunction exportQR(qrCode, path) {\n  qrCode = qrCode.replace('data:image\u002Fpng;base64,', '');\n  const imageBuffer = Buffer.from(qrCode, 'base64');\n\n  \u002F\u002F 创建 'marketing-qr.png' 文件\n  fs.writeFileSync(path, imageBuffer);\n}\n```\n\n## 下载文件\n\nPuppeteer 负责处理文件下载。解密过程尽可能快速（比原生方法更快）。支持大文件！\n\n```javascript\nimport fs = require('fs');\nimport mime = require('mime-types');\n\nclient.onMessage(async (message) => {\n  if (message.isMedia) {\n    const buffer = await client.downloadFile(message);\n    \u002F\u002F 此时您可以对缓冲区执行任何操作\n    \u002F\u002F 最常见的是将其写入文件\n    const fileName = `some-file-name.${mime.extension(message.mimetype)}`;\n    fs.writeFile(fileName, buffer, function (err) {\n      ...\n    });\n  }\n});\n```\n\n## 基本功能（用法）\n\n并非所有可用功能都列在此处，如需更多信息，请参阅 [这里](\u002Fsrc\u002Fapi\u002Flayers) 和 [这里](\u002Fsrc\u002Flib\u002Fwapi\u002Ffunctions) 中的所有可用函数。\n\n### 聊天\n\n##### 在这里，`chatId` 可以是 `\u003CphoneNumber>@c.us` 或 `\u003CphoneNumber>-\u003CgroupId>@c.us`\n\n```javascript\n\u002F\u002F 发送基础文本\nawait client.sendText(chatId, '👋 Sulla 发来的问候！');\n\n\u002F\u002F 发送图片\nawait client.sendImage(\n  chatId,\n  'path\u002Fto\u002Fimg.jpg',\n  'image-name.jpg',\n  '图片说明文字'\n);\n\n\u002F\u002F 发送带 @ 标记的消息\nawait client.sendMentioned(chatId, '你好 @5218113130740 和 @5218243160777！', [\n  '5218113130740',\n  '5218243160777',\n]);\n\n\u002F\u002F 回复消息\nawait client.reply(chatId, '这是一条回复！', message.id.toString());\n\n\u002F\u002F 发送文件（Sulla 会自动处理 MIME 类型，只需提供文件路径）\nawait client.sendFile(chatId, 'path\u002Fto\u002Ffile.pdf', 'cv.pdf', '简历');\n\n\u002F\u002F 发送 GIF 动图\nawait client.sendVideoAsGif(\n  chatId,\n  'path\u002Fto\u002Fvideo.mp4',\n  'video.gif',\n  'GIF 图片文件'\n);\n\n\u002F\u002F 发送联系人\n\u002F\u002F contactId: 52155334634@c.us\nawait client.sendContact(chatId, contactId);\n\n\u002F\u002F 转发消息\nawait client.forwardMessages(chatId, [message.id.toString()], true);\n\n\u002F\u002F 发送贴纸\nawait client.sendImageAsSticker(chatId, 'path\u002Fto\u002Fimage.jpg');\n\n\u002F\u002F 发送位置信息\nawait client.sendLocation(\n  chatId,\n  25.6801987,\n  -100.4060626,\n  '华盛顿特区某地址',\n  '副标题'\n);\n\n\u002F\u002F 标记消息已读 ✔️✔️\nawait client.sendSeen(chatId);\n\n\u002F\u002F 开始输入...\nawait client.startTyping(chatId);\n\n\u002F\u002F 停止输入\nawait client.stopTyping(chatId);\n\n\u002F\u002F 设置聊天状态（0：正在输入，1：录制中，2：暂停）\nawait client.setChatState(chatId, 0 | 1 | 2);\n```\n\n### 数据获取\n\n```javascript\n\u002F\u002F 获取联系人列表\nconst contacts = await client.getAllContacts();\n\n\u002F\u002F 获取聊天中的所有消息\nconst allMessages = await client.loadAndGetAllMessagesInChat(chatId);\n\n\u002F\u002F 获取联系人状态\nconst status = await client.getStatus(contactId);\n\n\u002F\u002F 获取用户个人资料\nconst user = await client.getNumberProfile(contactId);\n\n\u002F\u002F 获取所有未读消息\nconst messages = await client.getAllUnreadMessages();\n\n\u002F\u002F 获取所有聊天\nconst chats = await client.getAllChats();\n\n\u002F\u002F 获取所有群组\nconst groups = await client.getAllGroups();\n\n\u002F\u002F 获取个人资料图片（作为 URL）\nconst url = await client.getProfilePicFromServer(chatId);\n\n\u002F\u002F 获取聊天\u002F对话详情\nconst chat = await client.getChat(chatId);\n```\n\n### 群组功能\n\n```javascript\n\u002F\u002F groupId 或 chatId：leaveGroup 52123123-323235@g.us\n\n\u002F\u002F 退出群组\nawait client.leaveGroup(groupId);\n\n\u002F\u002F 获取群组成员\nawait client.getGroupMembers(groupId);\n\n\u002F\u002F 获取群组成员 ID\nawait client.getGroupMembersIds(groupId);\n\n\u002F\u002F 生成群组邀请链接\nawait client.getGroupInviteLink(groupId);\n\n\u002F\u002F 创建群组（名称、要添加的参与者）\nawait client.createGroup('群组名称', ['123123@c.us', '45456456@c.us']);\n\n\u002F\u002F 移除成员\nawait client.removeParticipant(groupId, '123123@c.us');\n\n\u002F\u002F 添加成员\nawait client.addParticipant(groupId, '123123@c.us');\n\n\u002F\u002F 提升成员权限（授予管理员权限）\nawait client.promoteParticipant(groupId, '123123@c.us');\n\n\u002F\u002F 降低成员权限（撤销管理员权限）\nawait client.demoteParticipant(groupId, '123123@c.us');\n\n\u002F\u002F 获取群组管理员\nawait client.getGroupAdmins(groupId);\n```\n\n### 个人资料功能\n\n```javascript\n\u002F\u002F 设置客户端状态\nawait client.setProfileStatus('度假中！✈️');\n\n\u002F\u002F 设置客户端昵称\nawait client.setProfileName('Sulla 机器人');\n```\n\n### 设备功能\n\n```javascript\n\u002F\u002F 获取设备信息\nawait client.getHostDevice();\n\n\u002F\u002F 获取连接状态\nawait client.getConnectionState();\n\n\u002F\u002F 获取电池电量\nawait client.getBatteryLevel();\n\n\u002F\u002F 检查是否已连接\nawait client.isConnected();\n\n\u002F\u002F 获取 WhatsApp Web 版本\nawait client.getWAVersion();\n```\n\n### 事件监听\n\n```javascript\n\u002F\u002F 监听消息\nclient.onMessage(message => {\n  ...\n})\n\n\u002F\u002F 监听状态变化\nclient.onStateChange(state => {\n  ...\n});\n\n\u002F\u002F 监听消息确认\nclient.onAck(ack => {\n  ...\n});\n\n\u002F\u002F 监听实时位置\n\u002F\u002F chatId：'phone@c.us'\nclient.onLiveLocation(chatId, (liveLocation) => {\n  ...\n});\n\n\u002F\u002F chatId 的格式为：'5518156745634-1516512045@g.us'\n\u002F\u002F 事件接口请参见：https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fblob\u002Fmaster\u002Fsrc\u002Fapi\u002Fmodel\u002Fparticipant-event.ts\nclient.onParticipantsChanged(chatId, (event) => {\n  ...\n});\n\n\u002F\u002F 监听客户端被加入群组的事件\nclient.onAddedToGroup(chatEvent => {\n  ...\n});\n```\n\n### 其他功能\n\n```javascript\n\u002F\u002F 删除聊天\nawait client.deleteChat(chatId);\n\n\u002F\u002F 清空聊天记录\nawait client.clearChat(chatId);\n\n\u002F\u002F 删除单条消息（最后一个参数表示仅在本地删除）\nawait client.deleteMessage(chatId, message.id.toString(), false);\n\n\u002F\u002F 获取号码个人资料 \u002F 检查联系人是否为有效的 WhatsApp 号码\nconst profile = await client.getNumberProfile('0000000@c.us');\n```\n\n## 杂项\n\n有一些技巧可以帮助更好地使用 Sulla。\n\n#### 保持会话活跃：\n\n```javascript\n\u002F\u002F 如果从 WhatsApp Web 登出\n\u002F\u002F 强制保持当前会话\n\u002F\u002F 状态变化\nclient.onStateChange((state) => {\n  console.log(state);\n  const conflits = [\n    sulla.SocketState.CONFLICT,\n    sulla.SocketState.UNPAIRED,\n    sulla.SocketState.UNLAUNCHED,\n  ];\n  if (conflits.includes(state)) {\n    client.useHere();\n  }\n});\n```\n\n#### 向新联系人发送消息（未添加）\n\n另请参阅 [WhatsApp 链接](https:\u002F\u002Ffaq.whatsapp.com\u002Fen\u002F26000030\u002F)。请注意，这可能会导致 WhatsApp 封禁账号，因此务必保持联系人列表的更新！\n\n```javascript\nawait client.sendMessageToId('5212234234@c.us', 'Sulla 发来的问候！👋');\n```\n\n#### 多个会话\n\n如果需要同时运行多个会话，只需在 `create()` 方法中传入会话名称即可。\n\n```javascript\nasync () => {\n  const marketingClient = await sulla.create('marketing');\n  const salesClient = await sulla.create('sales');\n  const supportClient = await sulla.create('support');\n};\n```\n\n#### 正确关闭（保存）会话\n\n正确关闭会话以确保下次登录时会话能够被保存（这样就不需要再次扫描二维码）。因此，不要直接按 CTRL+C，\n\n```javascript\n\u002F\u002F 捕获 CTRL+C\nprocess.on('SIGINT', function() {\n  client.close();\n});\n\n\u002F\u002F 使用 try-catch 关闭\ntry {\n   ...\n} catch (error) {\n   client.close();\n}\n```\n\n### 调试\n\n## 开发\n\n构建 Sulla 非常简单，尽管它内部包含三个主要项目：\n\n1. Wapi 项目\n\n```bash\n> npm run build:wapi\n```\n\n2. 中间件\n\n```bash\n> npm run build:build:middleware\n> npm run build:jsQR\n```\n\n3. Sulla\n\n```bash\n> npm run build:sulla\n```\n\n要构建整个项目，只需运行：\n\n```bash\n> npm run build\n```\n\n\n## 维护者\n\n我们需要更多的维护者，我一个人无法跟上所有的更新。如果您感兴趣，请提交一个 Pull Request。\n\n## 贡献\n\n欢迎提交 Pull Request。对于重大更改，请先打开一个议题讨论您想要进行的修改。","# Sulla 快速上手指南\n\n## 环境准备\n- **系统要求**：Node.js v12 或更高版本\n- **前置依赖**：已安装 Node.js 和 npm（无需额外安装 Chrome，puppeteer 会自动处理）\n\n## 安装步骤\n使用 npm 安装 Sulla（推荐使用淘宝镜像加速）：\n```bash\nnpm install sulla --save -registry=https:\u002F\u002Fregistry.npmmirror.com\n```\n\n## 基本使用\n以下是最简示例，实现自动回复 \"Hi\" 消息：\n\n```javascript\nconst sulla = require('sulla');\n\nsulla.create().then((client) => {\n  client.onMessage((message) => {\n    if (message.body === 'Hi') {\n      client.sendText(message.from, '👋 Hello from sulla!');\n    }\n  });\n});\n```\n\n执行脚本后：\n1. 终端将显示 WhatsApp 登录二维码\n2. 用手机扫描二维码完成登录\n3. 会话自动保存，无需重复登录\n4. 当收到 \"Hi\" 消息时，自动回复 \"👋 Hello from sulla!\"","一家月销50万的电商公司，客服团队每天需手动处理200+条WhatsApp咨询，主要涉及订单查询、退货政策等重复性问题，导致响应延迟和员工疲劳。\n\n### 没有 sulla 时\n- 人工回复耗时：客服人员平均30秒\u002F条输入回复，每日耗时超10小时，高峰期甚至需加班\n- 会话管理混乱：每次重启服务需重新扫描QR码，新员工入职需2小时配置，且易因登录失败中断服务\n- 高峰期响应崩溃：促销活动时消息量激增200%，平均响应时间从5分钟延长至30分钟，客户流失率上升15%\n- 无对话记录追溯：消息回复后无存档，客户重复提问时需重新解释，客服重复工作量增加40%\n- 人工错误频发：约8%的回复包含错误链接或过期政策，引发客户投诉\n\n### 使用 sulla 后\n- 自动化常见问题：对\"订单状态\"\"退货流程\"等关键词自动发送预设回复，响应时间压缩至1秒内\n- 会话持久化免登录：sulla自动保存登录状态，新员工接入仅需10分钟配置，无需反复扫描QR码\n- 高并发稳定处理：支持同时管理5个会话，促销期间响应时间稳定在2分钟内，客户满意度提升25%\n- 对话自动存档：所有消息实时存入数据库，客服可快速调取历史记录，减少重复解释\n- 100%回复精准：预设内容确保政策信息准确无误，错误率归零，投诉量下降30%\n\nsulla将客服团队从机械重复劳动中解放，让自动化处理成为电商高效服务的核心引擎。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fdanielcardeenas_sulla_6a359395.png","danielcardeenas","Daniel Cardenas","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fdanielcardeenas_98873b8b.jpg","Doing beautiful UI and real time data - cloud native web applications",null,"Monterrey, MX","danielcardeenas@gmail.com","leind.dev","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas",[85,89],{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",63.1,{"name":90,"color":91,"percentage":92},"TypeScript","#3178c6",36.9,1301,274,"2026-04-03T01:52:06","MIT","未说明",{"notes":99,"python":97,"dependencies":100},"需要 Node.js 环境，首次运行需扫描终端显示的 QR 码登录 WhatsApp，Sulla 会自动保存会话无需重复认证",[101],"puppeteer",[54,53,26,13],[104,105,106,107,108,109],"whatsapp","bot","framework","whatsapp-bot","whatsapp-api","chatbot","2026-03-27T02:49:30.150509","2026-04-06T08:40:45.362784",[113,118,123,128,133,138],{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},5137,"第一次扫描二维码后无法认证","使用 puppeteer-extra-stealth 或更改 useragent 字符串。在 `controllers\u002Fbrowser.ts` 第 9 行（src）或 `controllers\u002Fbrowser.js` 第 55 行（dist）修改 useragent 为其他值（如 'Mozilla\u002F5.0 (Windows NT 10.0; Win64; x64) AppleWebKit\u002F537.36 (KHTML, like Gecko) Chrome\u002F91.0.4472.124 Safari\u002F537.36'），然后重新构建项目。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F40",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},5138,"QR 码加载无限期","删除 session 文件夹。添加代码：`const fse = require('fs-extra'); fse.remove('.\u002Fsession').then(() => { sulla.create().then(client => start(client)); });`，确保在初始化前执行此操作。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F82",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},5139,"发送视频文件失败","发送视频需要使用 Chrome 实例。在配置中设置 `useChrome: true`，因为 Chromium 不支持视频发送。确保代码中包含 `useChrome: true` 参数。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F243",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},5140,"如何发送消息到未保存的联系人","使用 `number@c.us` 格式发送消息。例如：`client.sendText('555555555555@c.us', 'Hello');`，直接指定号码无需保存联系人。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F114",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},5141,"ReferenceError: WAPI is not defined 错误","安装新版本的 sulla。使用 `client.reply(message.from, '回复内容', message.id.toString());` 替代旧的 WAPI 方法，确保代码基于最新版本编写。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F212",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},5142,"Sulla 不检测已认证会话，启动后挂起","在代码中正确处理会话关闭。参考 README 的 'Closing and Saving Sessions' 部分，添加 `client.on('disconnected', () => { \u002F* 保存会话 *\u002F });` 确保会话正常保存和恢复。","https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fissues\u002F201",[144,148,153,158,162,167],{"id":145,"version":146,"summary_zh":79,"released_at":147},114369,"2.4.0","2021-02-17T19:44:46",{"id":149,"version":150,"summary_zh":151,"released_at":152},114370,"2.3.10","#### [v2.3.10](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcompare\u002F2.3.5...v2.3.10)\r\n\r\n> 10 April 2020\r\n\r\n- feat: Added args property to initialization options for customizing arguments passed to browser instance [`#240`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fpull\u002F240)\r\n- Restyle Add license scan report and status [`#247`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fpull\u002F247)\r\n- feat: Added args property to initialization options for customizing arguments passed to browser instance [`#240`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fpull\u002F240)\r\n- docs support [`2623605`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F2623605a56824221d6b41c22eb356f96a7b63818)\r\n- Restyled by jq [`5dbd783`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F5dbd783b794d528b10756fd22cff832429d90638)\r\n- Restyled by clang-format [`a584006`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fa58400668d86ed4baf63a2209833f39e139da5f8)\r\n- Bump nodemon from 2.0.2 to 2.0.3 [`d806028`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fd806028f884718e3828c929341503a7bd8408835)\r\n- Selfcheck for updates [`ee95f72`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fee95f7263d0509ca774f976fb3b533c83d36bd6e)\r\n- Restyled by whitespace [`7c722d1`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F7c722d1cea5c91ebb76abd591910f94045dc97a0)\r\n- Fix spinner mistake [`f8c35cd`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Ff8c35cdca4ca2731eea4a950bd49fd0b6c9b7842)\r\n- Add retrievers, deprecate some unneeded functions [`d41bb44`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fd41bb44c251934f36d5dd15fe47b8d729c5b5a17)\r\n- Better logging, extract QR as ascii [`4db4419`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F4db4419f10d49e232cc7d27837e61c0bf8af327f)\r\n- Fix video sending, fix optional parameters on create [`3c85195`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F3c851954b320079e1ce40079d9ae9d5580d25001)\r\n- Fix spinner mistake [`5643071`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F5643071b146b44c161a194edf5be67a0ed6fc058)\r\n- Bump husky from 4.2.4 to 4.2.5 [`757afb0`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F757afb0dc0d72907bb19b3b4842b5604a558cfef)\r\n- Add browserArgs to readme.md [`ca5f4bf`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fca5f4bf7131d5204df35a61919748d760b19116a)\r\n- Add cmd user interaction [`7eba90c`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F7eba90cd86e7ea89807bd0947fd27cfd5d9692c8)\r\n- Add updates.md [`a611cd9`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fa611cd9c39f1188f4ac6bedce5299b08f0c1e035)\r\n- Fix spinner mistake [`c23e7b4`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fc23e7b4c1a758c66dc8f3adbeb3a9dd555bc3a0b)\r\n- Update README.md [`5c798d7`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F5c798d7e8fe10a309f033b5613d9942b1184be62)\r\n- Bump @types\u002Fnode from 13.11.0 to 13.11.1 [`24b25ee`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F24b25eec8c5da6ed0397946d9749c9d4bb59b9c4)\r\n- fix codebeatignore docs folder [`58a4f62`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F58a4f62a46a11894ada1ab2e0ad3ae92ecef2caa)\r\n- Wrong options reference my bad! [`dd67081`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fdd67081d6e31a65a52a651b13963e532e77a48bd)\r\n- Bump version [`b35cc77`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Fb35cc77efcd8083231072d947bb9a8a7212f732e)\r\n- add docs to codebeatignore [`95ee67e`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002F95ee67e488ec005bb9694ad323f0b2f68a69bf2b)\r\n- added missing SocketState to exports [`fc4e3e9`](https:\u002F\u002Fgithub.com\u002Fdanielcardeenas\u002Fsulla\u002Fcommit\u002Ffc4e3e95f51f99981c7ba4b8b25bed1a56f8bb61)","2020-04-10T20:34:05",{"id":154,"version":155,"summary_zh":156,"released_at":157},114371,"2.3.5","Lower bundle size","2020-04-07T16:51:34",{"id":159,"version":160,"summary_zh":79,"released_at":161},114372,"2.1.0","2020-04-04T09:41:03",{"id":163,"version":164,"summary_zh":165,"released_at":166},114373,"1.1.3","+ Optimizations\r\n+ Better QR detection","2020-01-24T18:25:35",{"id":168,"version":169,"summary_zh":170,"released_at":171},114374,"v1.1.1","- First stable version","2019-06-10T22:55:40"]