DeskcommCRM

社区

开源的 AI 销售操作系统：自托管 CRM，内置 AI 智能体与 WhatsApp。

分类: 其他第 131 / 230
Stars: ★ 4.7k 非常热门
传输方式: stdio（本地进程）
运行环境: Docker · Node.js 22
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前

52FMRS · D

DeskcommCRM 是一个 MIT 许可、自托管的开源 CRM，核心卖点是在 WhatsApp 上运行 AI 智能体并把整个 CRM 通过 MCP 暴露给智能体操作，同时具备多租户 RLS、RBAC、审计与 LGPD 能力。它适合愿意自行运维 VPS 与 Supabase 的团队，不适合寻求托管、有 SLA 或零运维体验的用户。主要风险来自自托管责任、WhatsApp 非官方接入的封号可能、以及 cron 未安装导致自动化失效；文档提供了安装器、健康检查与恢复脚本等应对手段。作为 MCP 服务器，仓库指出其 MCP 能力存在且内部可用，公开 MCP 仍在路线图中，因此具体工具清单未被证据支持。

最强项 · 文档质量 13/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

9/20

维护活跃度

13/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 7/20: 仅凭仓库描述、元数据与 README 做静态评审，未执行任何代码，也未提供 SERVER MANIFEST（标注 [not cached]）。README 声称有 CI 徽章、48/49 个 Playwright spec、RLS 隔离不变量测试、三个 Docker 镜像构建门禁，还给出了可核查的命令（gh api 查询 branch protection 要求的状态检查），这些间接说明关键路径有一定测试覆盖。但注意两点：1) README 自述 'MCP 公开' 仍在 Roadmap 的『下一步』，仅内部 MCP server 已交付，而本仓库根目录并未展示 MCP 服务器入口、工具清单或初始化握手证据；2) README 明确写出 e2e 并不覆盖 P0 的 vps-fresh-onboarding 安装旅程，且 migrations 0001-0009/0013 是 SELECT 1; 桩，真实 schema 只存在于 baseline.sql —— 说明迁移链本身不能从零自举。按静态校准规则，无实际执行证据时 reliability 上限 12，而 MCP 关键路径（init + 工具列表握手、声明的工具与真实行为是否一致）在源码中完全无证据，错误处理与依赖可控性只能靠 README 自述，因此大幅扣分，给 7。
安全与权限 9/20: 未发现恶意代码、凭证窃取、隐蔽外传、无确认的破坏性默认操作或伪造维护者身份等红线问题，因此不触发 0-4 的降级。仓库具备多项正面信号：multi-tenant + 每张 tenant-aware 表都开 RLS 并用独立不变量测试证明跨组织零行可见（含对照组防止空表假阳性）；RBAC 服务端强制；audit log 为 append-only；LGPD 默认匿名化而非删除；Sentry 遥测为 opt-in、且明确对 CPF/电话/邮箱做 scrub，SENTRY_DSN=off 可关闭；安全漏洞走私有 advisory 渠道而非公开 issue；MIT 许可，README 明确 self-host 者自己是数据控制者。扣分项：根目录没有可审计的 MCP 服务器源码，所有『工具』的参数校验、作用域限制、危险操作确认与网络出口边界都无从核实；安装脚本被描述为一条 curl | bash 的远端管道（虽提供先读后跑的替代路径），属于典型高信任安装路径；README 本身按证据规则不可信，其安全声明无法由源码交叉验证。故按 10 分基准略降，给 9。
维护活跃度 13/20: 有明确许可 (MIT)、持续更新的 CHANGELOG、多语言 README、VISION/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 等治理文档，且声明设置了分支保护与必需状态检查（verify/build-and-size/invariants/e2e/imagens-ok），并给出可复现的 gh api 查询方法而非只贴徽章——这是较少见的可核查证据。869 star、76 open issue、未归档，说明项目活跃。扣分项：只有静态仓库快照，无提交时间序列、无 release/tag 列表、无 issue 响应时延证据；README 承认 bugs 无 SLA、支持为社区 as-is；roadmap 中 MCP 公开能力仍是计划项，说明对外部 agent 生态的接口尚未成型；文档自述文档总数从 157 到分支保护条目存在小规模内部不一致（README 自己都提醒『数它，别信它』）。综合给 13。
文档质量 13/20: 文档是该项目最强的维度之一：分层清晰（README → docs/SETUP.md 全集成教程 → docs/ATUALIZANDO.md 更新手册 → runbooks → PRD/specs → CLAUDE.md 约定），覆盖安装、更新与回滚、备份、密码/MFA 重置、healthcheck、白标/多客户部署、HostGator 生产 runbook，并给出了公开路径 /api/v1/health 与 /api/v1/webhooks/in/<token> 等可验证接口。自我披露限制做得相当诚实：明确说明免费 Supabase 无自动备份、e2e 不覆盖 fresh-onboarding、迁移桩不可用、更新失败会自动回滚并写入 .env、非交互模式关掉遥测。扣分项：与本次评审强相关的 MCP 部分文档严重不足——根目录无 MCP server 说明，工具参数、认证方式、调用限额、成本控制与故障排查均无 MCP 专门章节，Roadmap 只给出『MCP 公开』一句话；成本方面只有『每组织 AI 支出上限』的笼统描述，无价格示例。给 13。
安装易用性 10/20: 安装路径描述得非常完整：VPS 上 git clone + bash hostgator-setup-kit/install.sh，声称幂等、可重跑、自动生成密钥、应用 baseline、创建首个 admin、自动 HTTPS、并可自动创建 Supabase 项目；同时提供非交互模式（--yes + .env.hostgator.example）、检测宿主已有反向代理（Hostinger/Coolify/Dokploy/CapRover）、更新的图形界面与终端两条路径，以及 backup/restore/healthcheck/reset-password/reset-mfa 等运维脚本。对『只想用』与『要改代码』两类读者做了明确分流。但按静态校准，无执行证据时 setup 上限 15，而这里的问题更实际：要到一个可用的 MCP 连接，README 没有任何主流 MCP 客户端（Claude Desktop / Cursor / VS Code 等）的配置示例，本仓库也未展示 MCP endpoint 或启动命令；安装前提偏重（自有 VPS/4GB、域名 A 记录、Supabase 账号、AI 供应商 API key、WhatsApp 号码）；一键安装脚本是从远端 URL 直接管道到 bash，需要先读脚本才能安心执行。综合给 10。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

希望通过 WhatsApp 销售并愿意自行维护 VPS 的中小企业
需要多租户隔离与数据主权的团队
有技术能力按文档完成 Supabase、WAHA 与 AI 提供商配置的运营者
需要审计、RBAC、LGPD 能力的服务型业务（诊所、房产、电商、信息服务）

不适合谁

希望开箱即用、无需自建服务器与 Supabase 项目的非技术用户
需要官方 SLA 或厂商托管支持的场景（项目为社区自助、as-is）
不愿配置第三方服务（Supabase、AI 提供商、WAHA、Upstash、Resend 等）的团队
需要自动更新的用户（更新需手动点击或运行脚本）

所需权限

VPS 的 root 或等效权限（Docker、cron、80/443 端口）
Supabase 项目的数据库连接与认证凭据（4 项凭据 + Session pooler 连接串）
AI 提供商（OpenRouter、Anthropic 或 OpenAI）的 API 密钥
WhatsApp 号码的扫码连接或 Meta Cloud API 官方通道凭据
可选：Upstash Redis、Sentry DSN、Resend、Nuvemshop 集成凭据

风险与副作用

自托管意味着你是实例的数据控制者，需自行承担 LGPD 合规、备份与维护责任
若未安装并运行 cron（event-log-drain），自动化规则会被创建但永不执行
WhatsApp 通过非官方引擎（WAHA）连接存在账号被封的风险，项目依赖节流、抖动等缓解措施
Supabase 免费计划不会自动备份，需自行调度 backup.sh
更新只应用于已发布的版本标签；如需回退旧版本必须显式使用 --force
可选 Sentry 遥测会发送错误报告，但已对 CPF、电话、邮箱等做脱敏，且可用 SENTRY_DSN=off 关闭

安装接入

准备工作

运行环境：Docker · Node.js 22

SUPABASE_ACCESS_TOKEN 可选密钥可选：安装脚本用它来自动创建 Supabase 项目，来自 supabase.com 账户。

SENTRY_DSN 可选密钥可选遥测；安装脚本会询问，未设置时保持关闭，设为 'off' 可禁用。

推荐使用自托管安装器（面向使用而非开发）：在带有 Docker 的 VPS 上执行 git clone https://github.com/melgarafael/DeskcommCRM.git，进入目录后运行 bash hostgator-setup-kit/install.sh。脚本会询问域名、Supabase 凭据、AI 提供商密钥和管理员密码，验证每个输入，生成技术密钥，创建 Postgres 扩展并应用 supabase/baseline.sql，创建首个管理员，启动整栈并启用 HTTPS，同时安装自动化 cron 和更新代理。非交互模式：复制 .env.hostgator.example 为 .env，填好后运行 bash hostgator-setup-kit/install.sh --yes。若 VPS 自带反向代理（Hostinger、Coolify、Dokploy、CapRover 等），安装器会自行检测并在其后面发布服务。安装完成后访问 https://<你的域名> 登录，并在引导中用 WhatsApp 扫描二维码。开发者本地环境需要 Node 22、pnpm、Supabase 项目、Docker（可选 WAHA）并手工应用 baseline.sql，详见 docs/SETUP.md。

验证是否装好

README 记录了 MCP 功能（内部 MCP 服务器，公共 MCP 已列入路线图），但未列出任何工具或客户端配置，因此没有可引用的验证步骤；可确认服务器运行后访问 /api/v1/health。

常见排障

应用不可用或出现异常时运行 bash hostgator-setup-kit/healthcheck.sh 并查看输出
自动化无反应时检查 install.sh/update.sh 是否安装了每分钟的 event-log-drain cron
基线应用报 type public.vector does not exist 时先手动创建 vector、citext、pg_trgm 扩展
更新后数据库出现 already exists / multiple primary keys 属预期噪音，关注脚本输出的警告
需要回退时运行 bash hostgator-setup-kit/restore.sh 恢复备份
界面提示“自动更新不可用”说明更新代理不在运行，可改用终端 update.sh
旧安装首次更新需运行 update.sh 两次以安装更新代理
报告问题时可附上 /api/v1/health 结果；安全问题请走私有漏洞报告而非公开 issue

试试这样问

连接成功后，可以直接对 AI 助手这样说：

通过 MCP 列出我 CRM 漏斗中的所有商机

使用场景

在自托管 CRM 中让 AI 智能体在 WhatsApp 上接待、筛选并推进销售线索

为通过聊天销售的企业提供多租户客服与销售管理（每个租户独立的 RAG 知识库）

用 Webhooks 接收来自落地页、表单或 Zapier/n8n 的线索并自动进入漏斗

用 QUANDO/SE/ENTÃO 规则自动打标签、移动线索、分配坐席或发送 WhatsApp 消息

满足 LGPD 要求的数据导出、匿名化与审计记录管理

作为 Kommo、Octadesk、Intercom 的开源自托管替代方案，数据留在自有服务器

详细介绍

DeskcommCRM 是一个开源、自托管的 AI 销售操作系统（CRM），面向通过聊天销售的企业，定位为 Kommo、Octadesk 与 Intercom 的开源替代方案。它把 AI 智能体与 CRM 结合：智能体可按租户进行 RAG 检索、在服务过程中执行 skills、移动销售漏斗中的线索，并在合适时机转接给人工，相关交接有审计记录。WhatsApp 支持两条路径：通过 WAHA 扫码接入（多号码，带节流、抖动和发送时间窗口等防封措施），或使用 Meta 官方 Cloud API 通道（含已审批并同步的模板）。项目为多租户设计，所有涉及租户的表都启用 RLS，并将隔离测试作为 CI 门禁；包含 LGPD 能力（导出、匿名化、经审计的同意）、追加式审计日志、服务端 RBAC、按 pipeline 可配置的行业词汇、Webhooks（可接收线索的公开来源）以及 QUANDO/SE/ENTÃO 形式的自动化规则。仓库中描述了内部 MCP server 以及把 CRM 能力通过 MCP 暴露给外部智能体的计划。技术栈包括 Next.js 16、TypeScript、Supabase（Postgres + Auth + Storage + Realtime）、Tailwind + shadcn/ui、WAHA、Vercel AI SDK（OpenRouter、Anthropic、OpenAI 等）、Upstash Redis 限流与可选的 Sentry 遥测。安装以 hostgator-setup-kit 提供，可通过一条命令部署 app、WhatsApp 与数据库，支持从界面或脚本更新并自动备份。