私域智能跟进小助手（自建方案）设计文档方案版本：V2.0（自建版，对应原 Coze 方案 V1.0）制定日期：2026-08-20原方案：D:\AICK\AI开发\sy.md（基于 Coze 的 V1.0）本方案定位：去掉 Coze 依赖、自建独立数据库、本地单机自用的等价实现一、背景与目标原方案（V1.0）基于 Coze 搭建"私域智能跟进小助手"，解决私域运营三大痛点：记录断层、频率失控、话术生硬。核心闭环为：输入聊天记录 → 自动总结存档 → 智能分析情绪与阶段 → 结合节日/活动生成跟进策略与话术。本方案（V2.0）在不使用 Coze的前提下，用独立数据库自建复刻该闭环，换取：数据完全自主、Prompt/规则可深度定制、无平台额度限制、提醒触达多通道可控。关键约束（已与用户确认）维度决策部署形态单机本地自用数据库SQLite 单文件后端技术栈Python交互入口本地 Web 界面（浏览器）提醒触达企业微信自建应用 + 邮件 + 系统内待办列表个人微信不接入（无官方 API，有封号风险）二、系统架构单体单进程架构：一个 Python 进程承载 Web 服务、Agent 编排、定时调度、通知分发，数据落 SQLite 单文件。┌─────────────────────────────────────────────────────────┐ │ 浏览器 (本地 Web 界面) │ │ - 工作台：粘贴聊天记录 → 生成跟进建议 │ │ - 客户档案 / 待办列表 / 配置页 │ └──────────────────────┬──────────────────────────────────┘ │ HTTP (127.0.0.1:8765) ┌──────────────────────▼──────────────────────────────────┐ │ FastAPI 单进程 │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Web 路由 │ │ Agent │ │ 定时调度 │ │ 通知服务 │ │ │ │ (页面/API)│ │ 编排核心 │ │(APScheduler)│ │(企微/邮件)│ │ │ └──────────┘ └────┬─────┘ └────┬─────┘ └──────────┘ │ │ │ │ │ │ ┌──────▼────────────▼──────┐ │ │ │ DeepSeek LLM (OpenAI 兼容) │ │ │ └──────────────────────────┘ │ └──────────────────────┬──────────────────────────────────┘ │ ┌──────▼──────┐ │ SQLite 单文件 │ │ (sales.db) │ └─────────────┘组件职责组件职责依赖Web 层（web/）页面渲染 + REST APIagent、scheduler、notify、dbAgent 编排（agent/）聊天记录 → 结构化分析结果 → 持久化db、DeepSeek定时调度（scheduler/）每日扫描到期待办并触发通知db、notify通知分发（notify/）按配置分发到企微/邮件/系统内db（settings）数据层（db/）6 张表的 ORM 与会话管理SQLite三、数据模型（SQLite，6 张表）原 Coze 方案只有一张客户沟通档案表，把历史总结、标签、钩子塞进单表累积追加。自建后拆成多表，解决：无法按次查询、无法回溯单次分析、总结与标签耦合难以独立更新。3.1customers客户主表字段类型说明对应原方案字段idINTEGER PK AUTOINCREMENT主键—nameTEXT UNIQUE NOT NULL客户姓名客户姓名current_summaryTEXT累积历史总结（每次追加）历史沟通总结tagsTEXT(JSON)客户标签数组，如["价格敏感","跨境电商"]客户标签hooksTEXT(JSON)话题钩子数组，如["下周北京出差"]话题钩子stageTEXT销售阶段：认知期/考虑期/决策期/售后复购期销售阶段moodTEXT情绪温度：热情/平稳/遇冷情绪温度last_contact_dateDATE上次沟通时间上次沟通时间next_followup_dateDATE建议跟进时间建议跟进时间next_followup_adviceTEXT下次跟进建议（策略+话术）下次跟进建议created_atTIMESTAMP创建时间—updated_atTIMESTAMP更新时间—3.2chat_records聊天记录与总结（新增，拆出单次记录）字段类型说明idINTEGER PKcustomer_idINTEGER FK → customers.id关联客户raw_chatTEXT原始粘贴的聊天记录summaryTEXTAI 本次总结（核心诉求/共识/未解决问题）
