melgarafael/DeskcommCRM

TL;DR

DeskcommCRM 是一个开源的 AI Sales OS，专为通过 WhatsApp 销售的企业设计。它不仅是 CRM，更内置了具备 RAG、技能执行和自动跟进能力的 AI Agent，支持多租户隔离与数据主权，是 Kommo、Octadesk 等 SaaS 产品的自托管替代方案。

它解决什么问题

传统 CRM（如 Kommo、Intercom）通常将 AI 作为附加功能或外部集成，导致数据割裂且订阅成本高。DeskcommCRM 解决的核心痛点是：让 AI Agent 直接作为 CRM 的“员工”运营销售漏斗。它针对巴西及拉美市场 WhatsApp 为核心沟通渠道的特性，解决了多账号管理、反封号策略（Throttle/Jitter）以及销售流程自动化的问题，同时满足 LGPD（巴西通用数据保护法）对数据本地化和隐私的严格要求。

核心做法

架构基于 Next.js 16 + Supabase (Postgres/RLS)。 - AI Agent Engine：Agent 不是简单的聊天机器人，而是拥有“Skills”和“Memory”的操作实体。它们通过 MCP (Model Context Protocol) 接口直接操作 CRM 数据（移动 Lead、更新状态），并具备情感分析和 IA→Human Handoff 机制。 - Multi-Tenant & RLS：利用 Supabase Row Level Security (RLS) 实现租户级数据隔离，CI 中包含专门的 RLS 隔离测试。 - WhatsApp Integration：支持 WAHA (Web API) 通过 QR 码连接多账号，以及 Meta Cloud API。内置反封号逻辑（速率限制、随机抖动）。 - Automation：基于 event_log 表的异步工作流，支持 Webhook 入站和“当/则”规则引擎。

作者

Owner melgarafael (Afonso Rafael Melgar)。 README 未明确提及作者的详细职业背景，但项目显示出极高的工程成熟度（完整的 CI/CD、Invariants 测试、详细的 Runbooks）。作者与 HostGator Brazil 有官方合作，提供一键部署方案，暗示其具备较强的商业落地能力和对拉美市场的深耕。

社区反应

Stars: ~1,300+ (GitHub)，Forks: 500+。在自托管 AI CRM 细分领域属于高关注度项目。
Issues: ~90 Open Issues。考虑到其功能密度和自托管特性，这一数量级表明社区活跃且处于快速迭代期。
生态：主要语言 TypeScript，依赖 Supabase 和 Docker。社区反馈集中在安装配置、WhatsApp API 稳定性及 AI Prompt 调优上。

怎么上手

最小复现步骤 (Self-Hosted): 1. 环境准备: 一台 Linux VPS (推荐 4GB RAM, Docker 已安装)。 2. 依赖: Supabase 账号 (获取 DB URL/Keys), AI Provider Key (OpenRouter/OpenAI/Anthropic)。 3. 安装: bash ssh root@YOUR_VPS_IP git clone https://github.com/melgarafael/DeskcommCRM.git && cd DeskcommCRM bash hostgator-setup-kit/install.sh 4. 配置: 安装脚本会交互式引导输入域名、DB 凭证和 AI Key，并自动处理 HTTPS (Caddy)。 5. 访问: 浏览器打开域名，扫描 WhatsApp QR 码完成 Onboarding。

*注：也可使用 curl ... | bash 脚本获取硬件建议或直接在本地 Docker Compose 开发环境运行。

争议与局限

自托管运维负担：虽然提供了一键脚本，但用户仍需自行维护 VPS、Supabase 备份和 WhatsApp API 的 Token 续期。WAHA (基于 Web) 相比官方 Cloud API 更容易触发 Meta 的风控，尽管有反封号机制。
AI Provider Lock-in (部分)：虽然支持多提供商，但 RAG 和 Agent 逻辑深度绑定 Vercel AI SDK。切换底层模型可能涉及 Prompt 适配。
市场地域性：原生针对 WhatsApp (WAHA) 和 LGPD，对以 Email/Slack 为主的欧美市场适配成本较高。
成熟度：尽管代码质量高，但作为“Sales OS”，在复杂 B2B 销售流程（如多阶段审批、ERP 深度集成）方面可能不如 Salesforce/HubSpot 完善。