房产助理 AI 智能体（定制版）

基于 Hermes Agent 深度定制的开源房产项目——Coco（可可）房产助理。它不是简单的聊天机器人，而是一套专为房产中介打造的"第二大脑"：自动管理客户、智能匹配房源、主动跟进提醒、沉淀经营数据。

仓库地址： liyuheng200408/coco-real-estate（Gitee）

核心功能

▶客户管理：S/A/B/C 四级分类，自动计算跟进周期；客户画像管理（预算、户型、区域、装修偏好）；一键添加、查询、更新客户；客户生日管理

▶智能匹配：多维度加权评分算法——价格 30%、户型 25%、面积 20%、区域 15%、装修 10%，自动推荐最合适房源；新房源入库自动反匹配 S/A 级客户

▶跟进提醒：早报（09:00）/ 午间检查（13:00）/ 逾期检查（每 30 分钟）定时提醒，默认关闭，COCO_ENABLE_CRON=1 开启；S 级客户 2 天内跟进

▶带看管理：预约带看、记录带看结果、客户反馈，带看后自动 1 小时回访提醒

▶成交管理：定金 → 签约 → 贷款 → 过户 → 交房五阶段状态机，自动推进提醒

▶数据报告：客户统计、房源统计、逾期跟进提醒、经营周报/月报、竞品对比、客户意向度评分

▶话术库：自定义话术保存复用，覆盖开场、异议处理、逼定、跟进场景

▶发布助手：一键生成朋友圈、贝壳、安居客、58 同城房源发布文案

▶数据加密：客户手机号、微信号等敏感字段加密存储，密钥自动生成

▶房源去重：一键扫描并清理重复房源（按标题+面积+价格），保留最早录入的一条，有关联带看/成交的自动跳过

▶需求变更追踪：客户改预算/换区域自动留痕，预算大幅下调 30% 以上时主动预警"客户可能在看别处的房子"

▶流失预警：S 级客户超过 5 天无互动自动降级并提醒，客户快"凉"了 Coco 比你先知道

▶营销海报：一键生成朋友圈海报图（标题+价格+面积+可选二维码）和九宫格大图，文案配图一次搞定

▶短视频脚本：30 秒卖房口播脚本（抖音/视频号两种风格），钩子+亮点+价格+行动号召直接照读

▶渠道分析：安居客/贝壳/抖音/转介绍等来源自动统计来客数与成交率，广告费花在哪心里有数
免责声明
本项目默认面向个人学习、技术研究、功能演示场景。若你希望将其用于生产环境（真实客户、真实业务数据），请务必先自行评估风险、完整测试、并做好以下准备，因使用本软件产生的一切后果由使用者自行承担。

一、操作系统要求：本服务仅支持 Ubuntu 系统（推荐 Ubuntu 24.04.4 LTS 或 26.04.1 LTS ）。

二、服务器环境要求：

1、CPU：最低 2 核心，推荐 4 核心及以上

2、内存：最低 2GB，推荐 4GB 及以上（多 Agent 并发建议更高配置）

3、磁盘空间：至少 10GB 可用空间

4、网络：需具备公网出站能力

三、前置准备：

1、购买前请确保您的 Ubuntu 服务器已开通 root 或 sudo 权限，并可正常联网

2、请提前准备好 AI 模型的 API Key，推荐 Kimi、MiniMax、DeepSeek等，配置向导需要填写

3、如需接入消息渠道，请提前准备好对应平台的App ID

Coco 需要部署在 Linux 服务器上（推荐 Ubuntu 系统），您可以选择云服务商的轻量应用服务器或云服务器。以下为推荐的云服务器购买渠道：

京东云 —— 云主机

▶推荐配置： 2 核 CPU、2 GB 内存、40 GB 系统盘、3M 峰值带宽

▶参考价格： 68元/年起，新用户首单特惠

▶地域选择： 建议选择靠近您的区域

▶购买链接： https://www.jdcloud.com/cn/pages/cloudpromotion

阿里云 —— 云服务器ECS经济型实例

▶推荐配置： 2 核 CPU、2 GB 内存、40 GB 系统盘、3M 峰值带宽

▶参考价格： 99元/年起，新用户首单特惠

▶地域选择： 建议选择靠近您的区域

▶购买链接： https://www.aliyun.com/benefit/scene/swas

 腾讯云 —— 轻量应用服务器

▶推荐配置： 2 核 CPU、2 GB 内存、40 GB 系统盘、3M 峰值带宽

▶参考价格： 68元/年起，新用户首单特惠

▶地域选择： 建议选择靠近您的区域

▶购买链接： https://cloud.tencent.com/product/lighthouse

四、远程协助方式：购买后技术人员将通过 向日葵 或 SSH 等远程工具连接您的电脑进行操作。

五、服务有效期：自购买之日起 30 天内有效，请及时联系技术人员完成部署。

一、发货方式：本服务为虚拟服务，无实物发货。购买成功后系统将自动发送订单确认信息。

二、服务流程：

1、下单后 24 小时内，请您主动通过微信（Gini-LYH)或联系电话（+8613006050302）联系技术人员

2、确认部署环境后，在约定时间进行远程安装

3、安装完成后，技术人员将与您共同验证服务运行状态（执行 hermes 启动 CLI 交互测试）

三、服务时间：工作日 9:00 - 18:00（北京时间），非工作日订单顺延至下一个工作日处理。

四、提前准备：为保障部署效率，建议在技术人员联系前完成服务器购买和环境确认，并准备好 API Key 等必要信息。

1、学习用途定位：本项目默认面向个人学习、技术研究、功能演示场景。若你希望将其用于生产环境（真实客户、真实业务数据），请务必先自行评估风险、完整测试、并做好以下准备，因使用本软件产生的一切后果由使用者自行承担。

2、生产环境风险与数据备份：应用于生产环境前，请务必：① 亲自完成全量功能测试（参考仓库 docs/TESTING_FEISHU_FULL.md 的实测清单）；② 定期备份数据（项目提供 backup_db.py 备份工具，请确认自动备份任务真实生效，不要想当然）；③ 妥善保管备份文件。因未备份、误删、重装系统、服务器故障、断电等造成的任何数据丢失，项目方不承担责任。

3、加密密钥保管：客户手机号、微信号等敏感字段使用加密密钥（COCO_ENC_KEY）加密存储。该密钥是解密客户数据的唯一凭证，一旦丢失或泄露，将导致客户数据永久无法解密。请务必独立备份该密钥，因密钥丢失造成的数据不可读，项目方不承担责任。

4、软件按现状提供：本项目按"现状"（AS-IS）提供，不承诺无缺陷、不保证特定功能完全满足你的需求。AI 模型可能产生错误、幻觉或不准确的信息（例如将未执行的操作描述为已执行），使用时请以实际数据为准。使用过程中出现的任何问题或损失，项目方不承担由此产生的直接或间接责任。

5、数据准确性：贷款政策、税费等外部信息具有时效性，Coco 查询到的政策信息仅供参考，请以当地官方机构的最新公告为准。因政策信息滞后或不准确造成的损失，项目方不承担责任。

6、合规使用：请确保你的业务操作符合当地法律法规（如个人信息保护法、房地产中介管理规定等）。本项目不构成任何投资建议或法律建议。因违规使用本软件产生的法律后果，由使用者自行承担。