01
系统总览
企微AI-SCRM智能客户增长引擎以「1 个核心 + 4 大增长引擎」的架构，把私域运营从获客到复购的每一个环节都变成可检测、可优化、可自动执行的闭环。
1.1 1+4 架构定义
整个系统由 1 个核心系统 + 4 个增长矩阵引擎 构成，五个插件既可独立运行，又通过统一事件总线、桥接服务和计费网关深度协同：
① AI-SCRM 管理大师
私域运营核心：客户全生命周期管理、企微集成、社群运营、营销自动化、AI 接待与跟进。承载成交与复购。
② SMOGEO 推广大师
AI 搜索曝光优化引擎：检测品牌在 DeepSeek / 腾讯元宝 / 豆包 / Kimi / 百度文心 / 通义千问 / 智谱 7 大平台的曝光，AI 蒸馏智能布词，生成优化建议与内容。
③ SMOPUB 发布大师
内容分发底座：统一管理多平台账号、登录态、发布任务与平台适配器，被 SMOGEO / SMOAI 共同调用。
④ SMOAI 线索大师
智能获客引擎：RPA 采集评论 / 私信 / 表单 / 扫码线索，AI 意向识别、评分、归因并自动同步 SCRM。
⑤ AI 智慧中台
AI Agent 运行时底座：基于 LangGraph 的 Agent 注册、执行、计费、结算，为四端提供统一 AI 能力。
1.2 核心价值
闭环
检测→发布→获客→成交→归因
自动
SOP / Agent / 规则引擎全自动
归因
每一条成交都可追溯来源
私有
源码交付、自主可控、可定制
- 减少漏单：SMOAI 将各平台评论、私信、表单、扫码线索统一采集，AI 识别意向并自动同步 SCRM，避免线索沉睡。
- 自动运营：SCRM 的 SOP、规则引擎、AI Agent 把跟进、群发、社群维护、流失挽回变成自动化流程。
- 搜索曝光可经营：SMOGEO 让品牌在 AI 搜索中被"看见"，用内容矩阵和信源建设持续提升曝光与转化。
- 每一分钱可追溯：SMOPUB 分发 + SMOAI 归因 + ai_plat 统一计费，形成"内容→线索→成交→ROI"的完整数据链路。
1.3 系统架构
1.4 增长闭环
五个系统围绕一条完整的增长链路协同工作，每一次循环都让品牌在 AI 搜索中的曝光、内容的触达、线索的转化持续提升：
02
AI-SCRM 管理大师（scrm_v2）
面向企微服务商和成长型企业的私有化 AI-SCRM 源码系统，把获客、跟进、社群运营、成交和复购放进一套可定制、可自主掌控的系统。当前 v3.8.2：PHP 后端 1,364 文件（控制器 288 / 服务 580 / 模型 206）、Vue 页面 357、队列任务 69、定时任务 15、另有教培 / 医美 / 家装 / 律所四大行业版插件、对外标准能力 23 项（MCP / OpenAPI）。
2.1 工作台与数据驾驶舱
员工侧工作台汇总待办、今日待跟进、逾期客户，支持批量打标签、分配、改阶段；管理层通过多维度数据驾驶舱掌握全局经营状况。
工作台
待办任务、今日待跟进、逾期客户、批量操作（打标签/分配/改阶段）。
全局数据驾驶舱
经营数据总览、报表导出、数据钻取、指标定义与快照。
客户分析看板
客户维度分析，洞察客户结构与转化漏斗。
营销效果看板
营销活动效果分析，评估各渠道 ROI。
AI 效能监控
AI 使用量、效能与成本监控。
增长经营看板
增长 OS 经营总览与智能经营建议。
客服负载监控
员工/客服负载监控，合理分配人力。
2.2 客户全生命周期管理
以客户 360° 画像为中心，覆盖从建档、打标、分组、跟进到流失预警的完整生命周期。
| 功能 | 说明 |
|---|---|
| 客户列表 / 详情 | 客户全量管理，360° 画像（概览/阶段/跟进/时间线），支持自定义视图与批量操作。 |
| 客户健康度 | 健康度评分与预警，识别高流失风险客户。 |
| 客户阶段管理 | 新增→意向→报价→成交→流失 阶段流转，全程阶段日志。 |
| 客户标签体系 | 分组/标签管理，支持企微标签同步、规则推荐、自动打标。 |
| 自动标签 | 按消费金额/次数/访问页面/参与活动等条件自动打标。 |
| 客户分组 | 动态分组规则，自动归组。 |
| 画像字段 | 自定义画像字段，灵活扩展客户档案。 |
| 身份合并 / 去重 | 多身份客户合并（企微/非企微/会员绑定），智能去重。 |
| 非企微客户 | 手动录入非企微客户，纳入统一管理。 |
| 批量添加客户 | 批量添加任务、记录、失败原因、补货与到期管理。 |
| 行为追踪 | 浏览、点击等行为事件采集与浏览轨迹。 |
| 时间线 / 协作 | 全生命周期时间线，客户共享协作。 |
| 会话存档 | 企微会话存档消息查询与同步。 |
2.3 线索与跟进
| 功能 | 说明 |
|---|---|
| 线索管理 | 线索列表/详情、线索池（公海）、批量导入、客户创建后自动关联线索。 |
| 跟进记录 | 客户跟进记录管理，跟进方式字典配置。 |
| 跟进 SLA | 跟进时效 SLA 规则，超时/到期自动提醒，逾期预警。 |
2.4 销售管理
| 功能 | 说明 |
|---|---|
| 商机管理 | 商机看板（Kanban）+ CRUD，阶段：发现→资格确认→方案报价→谈判审核→赢单/输单。 |
| 合同管理 | 合同 CRUD，状态：草稿/待审批/已审批/执行中/已完成/已终止；付款方式：一次性/分期/预付+尾款。 |
| 产品管理 | 产品 + 产品分类管理。 |
| 发票管理 | 发票开具与管理。 |
| 回款管理 | 回款/付款计划管理。 |
| 销售目标 | 销售目标设定与达成追踪。 |
| 客户分享 | 客户对外分享。 |
2.5 企业微信集成
深度企微集成，支持自建应用与服务商 Suite 双模式接入，覆盖员工、标签、侧边栏、转移、微信客服等全能力。
| 功能 | 说明 |
|---|---|
| 企业微信接入 | 自建/服务商 Suite 双模式授权绑定，扫码接入引导。 |
| 企微回调 / 事件中心 | 事件回调处理与事件日志查询。 |
| 员工 / 标签同步 | 员工、部门、标签自动同步。 |
| 企微侧边栏 | 聊天侧边栏工作台：客户信息、跟进、商机/合同/回款、快捷回复、AI 助手、SOP 任务、素材、话术。 |
| 侧边栏策略 / 话术 | 分阶段/行业/动作类型的策略管理，话术脚本与反馈统计。 |
| 企微转移 | 客户/群转移，交接留痕。 |
| 微信客服（wxkf） | 微信客服全链路接待：实时回调 + 每分钟兜底轮询双通道、AI 自动接待、欢迎语 20 秒送达（随机 A/B + 昵称变量）、区域分流转人工（城市 → 省份 → 全国兜底）、接待人员管理。 |
| 接入诊断 / 监测 | 接入能力诊断、系统可观测性、用量统计、灰度发布。 |
| 能力覆盖 / 降级 | 站点能力覆盖与降级，保障接入稳定性。 |
| 订阅管理 | 企业订阅与套餐管理。 |
2.6 社群运营
| 功能 | 说明 |
|---|---|
| 客户群管理 | 客户群列表、成员管理。 |
| 群标签 | 群标签 + 自动打群标签规则。 |
| 群欢迎语 | 入群欢迎语 + 规则 + 日志。 |
| 群 SOP | 入群触发/定时触发/事件触发（群沉默/群消息），可视化任务节点编辑器。 |
| 群营销活动 | 群活动 Campaign 与统计。 |
| 群裂变 | 群裂变活动 + 日志。 |
| 群接龙 | 群接龙 + 参与人管理。 |
| 群数据 / 健康度 | 群数据分析、社群健康度看板（聚合计算）。 |
| 群活码 | 群活码 + 群组 + 扫码记录，自动拉群。 |
2.7 消息与群发
| 功能 | 说明 |
|---|---|
| 1V1 群发 | 员工 1V1 群发（立即/定时/批量）。 |
| 客户群群发 | 客户群群发任务与日志。 |
| 全员群发 | MassMessage 全员群发。 |
| 消息模板 / 历史 | 消息模板管理、消息记录与历史。 |
| 快捷回复 | 快捷回复 + 分类。 |
| 朋友圈 | 朋友圈发布/评论/日志。 |
| 关键词回复 | 关键词自动回复 + 欢迎语 + 日志。 |
2.8 营销自动化
以可视化 SOP 设计器为核心，叠加规则引擎、流失预警、渠道活码、裂变等能力，实现"零人工干预"的自动化运营。
| 功能 | 说明 |
|---|---|
| 统一 SOP | 可视化 SOP 设计器（节点+连线+条件），定时/事件触发，含漏斗分析。 |
| 智能 SOP | SmartSop + 事件 + 目标客户，AI 驱动的智能触达。 |
| 自动化规则 | 规则引擎：条件 + 动作（打标签/发消息/改阶段等），含规则测试器。 |
| 流失预警 | 客户流失预警 + 干预，AI 流失预警分析。 |
| 培育 SOP | 增长培育 SOP，长期客户培育。 |
| 欢迎语 / A/B 测试 | 客户欢迎语 + 规则，欢迎语 A/B 实验（变体/分配/事件）。 |
| 渠道活码 | 单人/多人/群活码 + 渠道分类 + 扫码日志 + 渠道统计/趋势/对比 + ROI 分析。 |
| 素材 / 海报 / 口令 | 素材管理（基础/网页/小程序/复合）、海报生成、口令短链。 |
| 裂变 / 邀请 | 好友裂变 + 推广管理、奖品管理、邀请关系追踪。 |
| 员工任务 | 员工任务分配/自动处理/提醒。 |
2.9 风控体系
| 功能 | 说明 |
|---|---|
| 敏感词管理 | 敏感词库 + 命中日志 + 新增审批流。 |
| 敏感行为 | 敏感行为规则 + 日志。 |
| 风控管理 | 风控规则配置。 |
2.10 AI 能力中心
内置完整的 AI 运营能力矩阵，从智能体、编排、接待、知识库到决策引擎，覆盖 AI 驱动的私域运营全场景。
| 功能 | 说明 |
|---|---|
| 智能体市场 | 浏览/购买/运行/配置 AI 智能体，支持行业模板。 |
| Agent 管理 | Agent 定义 CRUD、规则、事件、日志、结果、回调、复核、分发器、映射。 |
| 多 Agent 编排 | 编排器画布 + 日志 + AI 判定日志，多智能体协同。 |
| 任务包战役 | Mission 战役 + 模板 + 步骤日志。 |
| 客户旅程 | 客户旅程阶段/实体/转换 + 仪表盘。 |
| 主动触达 | 主动触达规则 + 统计 + 黑名单 + 日志。 |
| 智能接待 | AI 接待中心：接待入口/会话中心/知识库/分流规则/回复质检/数据统计/工作台。 |
| 会话中心 | AI 会话管理 + 转人工 + 接管。 |
| 知识库 RAG | AI 知识库 + 分类 + 向量同步 + 混合检索。 |
| AI 智能标签 | 聊天/行为/购买分析自动打标。 |
| AI 智能回复 | 回复建议/模板/生成，AI 客户记忆（长期记忆）。 |
| AI 智能分析 | 客户分析/意图分析。 |
| 决策引擎 | 决策列表/统计/权重配置/反馈，NBA 决策与结果回填。 |
| 评分系统 | 客户评分规则 + 日志 + 趋势 + 分群 + 行业模板（6 大行业）。 |
| AI 中台配置 | 多平台 AI 接入配置、节流、开关、席位、沙箱调试。 |
| 能力中心 / 能力外溢 | capability_manifest 暴露 23 项标准能力（客户 / 运营 / AI / 跨产品联动），OpenAPI + MCP 双协议开放，能力可被外部智能体调用。 |
| AI 智能体机器人 | 企微聊天窗口内直接 @ 对话：自然语言查客户画像、写跟进话术、建任务、查流失预警；基于 AstrBot 桥接，AI 能力由 AI 中台统一提供、多模型路由。 |
2.11 增长与人事
| 功能 | 说明 |
|---|---|
| AI 推广助手 | 增长推广总览、推广内容库（公众号/小红书/知乎/朋友圈/社群/短视频/欢迎语/跟进话术）。 |
| 引流资料库 | 引流资料 + 脚本分类/行业。 |
| 增长战役 / 线索 | 增长 Campaign、增长线索 + 同步。 |
| 增长目标 | 目标 + 进度追踪。 |
| 员工管理 | 员工 CRUD、角色（管理员/经理/员工/销售/客服）、部门树、组织架构图。 |
| 员工统计 | 员工绩效统计。 |
| 审批管理 | 审批流（节点/记录）。 |
2.12 报表与设置
| 功能 | 说明 |
|---|---|
| 数据分析 | 客户/员工/标签/消息/趋势统计、业绩统计、评分趋势分析。 |
| 数据报表 | 自定义数据报表 + 记录，统计快照与导出。 |
| 系统设置 | 增长启动中心、企微接入引导、企微/微信客服/基础/销售/跟进配置。 |
| 自定义字段 | 自定义字段 + 分组。 |
| 智能表格同步 | Smartsheet 同步配置/字段映射/同步日志/告警。 |
| 工具集 | 队列管理、监控、性能优化、过滤器、容错、调试日志、日志管理、导入。 |
| 计费中心 | 订阅与权益、账户余额、充值、服务消费流水、交易流水、服务市场。 |
03
SMOGEO 推广大师（smo_geo）
AI 搜索曝光优化引擎，检测品牌在 DeepSeek / 腾讯元宝 / 豆包 / Kimi / 百度文心 / 通义千问 / 智谱 七大平台的曝光情况，自动生成优化建议，并与 SMOAI、SMOPUB、SCRM 联动形成增长闭环。
3.1 项目与关键词库
| 功能 | 说明 |
|---|---|
| 项目管理 | 品牌/产品级项目 CRUD，覆盖品牌名、行业、官网、目标人群，是关键词、检测、评分的业务容器。 |
| 配置选择题化 | 12 大行业预设一键套用，品牌画像 / 竞品 / 客户 / 卖点支持 AI 代填；检测任务向导三步完成配置（v1.12）。 |
| 项目仪表盘 | 检测趋势、AI 平台对比、关键词覆盖度、评分变化等核心指标聚合。 |
| 关键词库 | 11 种关键词类型（品牌词/行业词/竞品词/痛点词/购买意向词/品牌防御/竞品防御/AI长尾词/行业词/实施词/旅程词），支持批量导入与分组。 |
3.2 AI 搜索曝光检测
| 功能 | 说明 |
|---|---|
| 问题模板管理 | 定义向 AI 平台提问的 prompt 结构，按业务场景定制。 |
| 检测任务 | 指定项目、关键词、问题模板与目标 AI 平台，异步执行，失败可重试。 |
| 检测结果 | 品牌是否被提及、情感倾向、竞品提及、推荐品牌、引用来源、风险等级。 |
| 效度趋势 | 追踪检测结果真实性/有效性变化，评估 AI 检索可信度；统计口径自动排除无效回答样本（双质量标志过滤），指标真实可信（v1.12）。 |
3.3 排名追踪与竞品
| 功能 | 说明 |
|---|---|
| 排名矩阵 | 关键词在各 AI 平台的排名矩阵，品牌提及/未提及、排名位置、情感倾向一览。 |
| 排名趋势 / 快照 | 排名随时间变化趋势，定期快照用于历史对比。 |
| 分组聚合 | 按关键词分组聚合排名数据。 |
| 竞品库 | 竞品 CRUD，AI 竞品分析、竞品动态提醒、竞品压制策略生成。 |
3.4 评分报告体系
| 功能 | 说明 |
|---|---|
| GEO 综合评分 | 品牌曝光度、内容权威度、竞品压制度、转化潜力四维评分（0-100 分）。 |
| 报告生成 / 对比 / 导出 | 自动生成评分报告，多报告横向对比，Excel 导出。 |
| 报表分享 | 检测报告生成免登录只读链接，可直接发给客户查看；分享链接统一管理（v1.12）。 |
| PSOS 报告 | 提示空间占有率（Prompt Space Occupancy Share）分析。 |
| 可见性评分（16 柱） | 选择力 / 吸收力 / 稳定性三维度健康评分卡，覆盖品牌提及率、首位推荐率、Top3 推荐率、场景推荐率、引用率、多平台覆盖率、内容准确度、情感正向率、竞品拦截率、关键词覆盖率、长尾词捕获率、排名波动、情感稳定性、持续提及率、跨平台一致度、时效新鲜度。 |
3.5 内容优化与知识图谱
| 功能 | 说明 |
|---|---|
| 内容优化建议 | 基于检测结果自动生成优化建议，含 EEAT 评分、信源冲突检测、证据密度评分。 |
| 建议推送 | 优化建议一键推送至 SMOAI 创作、SMOPUB 发布。 |
| 知识图谱 | 知识实体（品牌/产品/人物/技术/事件）+ 关系管理，图谱可视化，AI 自动抽取。 |
3.6 SEO 信源与归因
| 功能 | 说明 |
|---|---|
| llms.txt | 生成符合 LLM 爬虫规范的 llms.txt，帮助 AI 搜索引擎索引品牌内容。 |
| FAQ Schema | 生成 FAQ 结构化数据（JSON-LD）与可嵌入 HTML，增强富摘要展示。 |
| Sitemap | 项目级 sitemap.xml 生成，信源完整度评分。 |
| 归因分析 | 项目归因、归因时间线、多模型归因（线性/时间衰减/首次触达/末次触达）、模型对比。 |
3.7 增长工具与商机
| 功能 | 说明 |
|---|---|
| UTM 链接 | UTM 追踪链接管理 + 点击/转化统计。 |
| A/B 测试 | 内容对比实验，多版本对照、统计显著性检验。 |
| 合规检测 | 违禁词、敏感词、广告法违规检测，修复标记。 |
| 媒体库 | 权威媒体资源管理，渠道权威性评估。 |
| 商机管理 | 关键词缺口/竞品压制缺口/内容空白/高意向客户商机，推送至 SMOAI / SCRM。 |
3.8 智能增长 Agent
SMOGEO 的核心自动化引擎，按策略自动执行"检测→评分→建议→发布"完整闭环，并支持灰度发布与紧急回滚。
| 功能 | 说明 |
|---|---|
| 运行策略 | 运行频率、关键词策略、内容策略、发布策略配置，cron 定时或手动触发。 |
| 每日自动运行 | 计划任务自动执行完整闭环，含运行记录与摘要。 |
| 紧急停止 | Kill Switch 一键停止所有 Agent 运行。 |
| 内容草稿箱 | Agent 自动生成内容草稿，多版本管理，人工审核后批准发布。 |
| 优化决策 | 关键词扩展、内容优化、渠道调整决策，可执行/跳过。 |
| 发布链路 | 推送 SMOPUB 发布 + 状态对账 + UTM 归因绑定。 |
| 策略学习 | 记录策略有效性，持续优化。 |
| 发布试验 | 按比例发布试验新策略，门禁清零，紧急回滚，验证后全量发布（v1.11 起由「灰度切流」更名）。 |
| 今日待办聚合 | 优化建议 + 商机 + 草稿统一收件箱，一站式处理（v1.11）。 |
| 复检闭环 | 14 天复检提醒 + 指标对比摘要，追踪优化效果（v1.11）。 |
| AI 蒸馏关键词 | 主词 + 品牌词经 LLM 蒸馏为咨询式长尾问题，按 9 大关注议题（使用方法/选购对比/价格/人群适配/场景/效果/口碑/风险/售后）控制意图分布，覆盖购买决策全链路，蒸馏问句一键入库直达检测（v1.12）。 |
| 告警与审计 | 运行告警（分级）、告警统计与处理、全操作审计日志。 |
| AI 调用计费 | 检测按组合数计费、优化建议按条计费（0.1 元/条）、AI 调用量预约与运行计费。 |
3.9 商业发稿
对接第三方商业发稿平台，把内容分发从自有账号扩展到付费媒体资源，形成「自然曝光 + 商业发稿」双轨覆盖（v1.10 新增）。
| 功能 | 说明 |
|---|---|
| 发稿平台配置 | 代理商识别码 / API Key / Secret / Base URL（测试-正式）/ 加价率 / 回调地址，平台级配置。 |
| 发稿订单 | 按 GEO 项目创建发稿订单，订单号追踪，关联媒体资源。 |
| 子订单管理 | 主订单拆分子订单，逐条执行与状态回传。 |
04
SMOPUB 发布大师（smo_pub）
三谋增长矩阵的内容分发底座，统一管理多平台账号、登录态、发布任务、平台适配器，被 SMOGEO / SMOAI 共同调用，支持 10 大内容平台。
4.1 账号与登录态
| 功能 | 说明 |
|---|---|
| 账号管理 | 发布账号 CRUD，记录平台、昵称、UID、主页 URL、每日限额，支持启用/禁用。 |
| 凭证加密 | 账号凭证（cookie/session）AES-GCM 加密存储。 |
| 扫码登录 | 服务器 Worker 模式扫码登录，轮询登录状态。 |
| 本机登录助手 | 推荐模式：本机客户端（Tauri）引导登录，自动回传 Cookie/Session。 |
| 会话管理 | 会话同步、刷新、续期 TTL、临近过期检测、持久化。 |
4.2 发布任务管理
| 功能 | 说明 |
|---|---|
| 任务创建 | 指定来源应用、平台、账号、内容类型（文章/图文/视频/短视频/问答/笔记）、标题、正文、封面、媒体、标签、摘要、定时发布。 |
| 任务生命周期 | 待执行→调度中→登录中→上传素材→填写表单→提交发布→等待审核→已发布/失败/已取消。 |
| 任务操作 | 列表/详情/取消/重试/删除，幂等键防重复，trace 追踪。 |
| 智能评论 | 发布后自动评论（自问自答），失败重试。 |
| 短链接 | 长链转短链，批量创建，过期管理。 |
| 定时发布 | 按时间窗口配置发布定时策略。 |
4.3 平台适配器架构
| 功能 | 说明 |
|---|---|
| CDP 适配器 | 基于 Chrome DevTools Protocol 的浏览器自动化适配器，控制浏览器完成登录与发布。 |
| RPA 适配器 | 机器人流程自动化适配器，适用于无法通过 CDP 直接控制的场景。 |
| 适配器配置 | 每平台适配器配置模板（登录 URL、发布 URL、选择器路径、表单字段映射），支持密钥项。 |
| 平台管理 | 平台启用/禁用、基础配置编辑。 |
4.4 Worker 与本机助手
| 功能 | 说明 |
|---|---|
| Worker 管理 | 发布 Worker 在线状态、健康度（健康/繁忙/超时/从未上报）、当前负载，远程启停。 |
| Worker 心跳 | 定期心跳，90 秒超时自动标记离线。 |
| 本机助手设备 | 设备注册、令牌、心跳、任务拉取、结果上报、吊销管理。 |
| 回调安全 | Worker 回调 HMAC-SHA256 签名验证，回调日志审计。 |
4.5 调度与容错
| 功能 | 说明 |
|---|---|
| 发布调度器 | 从 pending 队列选取任务，按平台匹配与站点隔离分配空闲 Worker，行锁防并发抢任务。 |
| BullMQ 队列 | 任务推入 BullMQ 消息队列，支持异步分布式执行。 |
| 错误分类 | 10 种标准错误码（登录过期/验证码/限流/内容驳回/网络/超时/选择器失效/上传失败/转码失败/未知）。 |
| 自动重试 | 指数退避重试（0/5/15/45/180 分钟），自动/人工/取消三种策略。 |
| 验证码处理 | 触发验证码时暂停任务，通知人工处理。 |
| 发布日志 | 任务每步骤详细日志，按级别分类，步骤回放排查。 |
4.6 AI 中台集成
| 功能 | 说明 |
|---|---|
| AI 内容润色 | 针对目标平台优化内容表达风格。 |
| AI 标题 / 封面 | 自动生成多个标题候选与封面图。 |
| AI 最佳发布时间 | 根据历史数据推荐最佳发布时间 + 发布热力图。 |
| AI 故障诊断 | 发布失败时 AI 自动诊断原因并给出修复建议。 |
| AI 任务分配 | 根据 Worker 在线情况自动分配任务。 |
| 发布模板 | 引导模板管理，按平台和类型生成模板内容。 |
4.7 内容流水线
将「选题 → 内容生成 → 审核 → 发布」编排为可复用的自动化流水线，一次配置、按触发条件持续产出并分发内容（v1.5 新增）。
| 功能 | 说明 |
|---|---|
| 流水线编排 | 流水线 CRUD + 启停，触发条件配置（trigger_json），绑定选题与发布策略。 |
| 流水线运行 | 运行实例与状态（running / success / partial / failed）+ 统计摘要，失败可定位。 |
| 内容包 | 按选题关键词批量生成内容包（标题 / 正文 / 素材），统一审核后进入发布队列。 |
05
SMOAI 线索大师（smo_ai）
RPA 驱动的多平台智能获客 + 线索全生命周期运营 + 成交归因闭环。核心链路：RPA 采集 → 意向识别 → 评分 → SCRM 同步 → 成交回写归因。
5.1 线索采集与识别
| 功能 | 说明 |
|---|---|
| 线索任务 | 按关键词、多关键词、目标数量创建获客任务，4 种场景：评论区评论/评论区私信/留痕/视频号获客。 |
| RPA 设备网关 | Workerman TCP 长连接 + 跨进程统一网关，设备连接/心跳/绑定/结果上报。 |
| 线索入库去重 | 按 external_id 或 昵称+平台+任务 去重，多字段去重规则与合并策略。 |
| 平台账号 | 小红书/抖音/快手/视频号账号管理，运营号/获客号分类，扫码登录。 |
| 关键词监控 | 监控关键词维护、匹配类型、启停与统计。 |
| 互动采集 | 评论/私信互动采集与批量处理。 |
5.2 意向分析与评分
| 功能 | 说明 |
|---|---|
| AI 意向分析 | 三步流程：关键词快速预判 → LLM 深度分析（低温度）→ 失败回退关键词；垃圾/广告直接拦截。 |
| 平台人设 | 内置抖音老铁/小红书姐妹/快手老铁/微信专业顾问人设，用于话术生成。 |
| 线索评分 | 四维加权：意向 40 + 互动度 30 + 画像完整度 20 + 来源 10，0-100 分映射 A/B/C/D 等级。 |
| 线索雷达 | 统一线索检索（关键词/意向等级/平台/时间范围）、统计、详情、同步入口。 |
| 内置智能体 | lead（线索识别）/score（评分）智能体，支持市场安装与异步队列分发。 |
5.3 SCRM 同步与成交归因
| 功能 | 说明 |
|---|---|
| SCRM 自动同步 | 同系统直接调用 / 跨系统 Webhook（HMAC-SHA256 签名 + 时间戳 + 事件头），事件：contact.created / message.received / wechat.friend_added / comment.captured 等。 |
| 成交回写 | 监听 SCRM 成交事件，自动更新线索成交状态，写归因闭环。 |
| 多模型归因 | 首次触达/末次触达/线性/时间衰减/位置归因五种模型，ROI 报表、评分排行、归因锁、可解释性说明。 |
| AI 归因推荐 | AI 推荐内容/渠道/投放时间，渠道评分与内容评分。 |
| 策略引擎 | 内容分发/渠道选择/预算分配三类策略，条件+动作+调度。 |
| UTM 追踪 | 批量埋点，访客触点回写 lead_id 并标记转化。 |
5.4 内容创作与发布
| 功能 | 说明 |
|---|---|
| 素材库 | 素材 CRUD、分类管理、统计。 |
| AI 文案库 | 文案生成/收藏/模板/热门/批量生成/导入，智能推荐。 |
| 视频生成 | 视频脚本生成、渲染进度、数字人列表、音色列表、视频模板、云服务配置、发布到平台。 |
| 发布任务 | 发布/重发/统计/日志，监听 SMOPUB 发布结果回写状态。 |
| 内容中心 / 效果 | 批量生成、内容类型/语气选项，内容效果统计（覆盖 10 平台）。 |
5.5 AI 能力与运营风控
| 功能 | 说明 |
|---|---|
| AI 渠道管理 | 统一网关：chat/chatStream/embedding/drawing/digitalHuman/chatWithTools，9 个渠道适配器（智谱/DeepSeek/文心/通义/通义Plus/Moonshot/自定义/腾讯/OpenAI）。 |
| 知识库 RAG | 知识库/文档/分块/解析/检索，RAG 对话与会话管理。 |
| AI 中台接入 | 注册到 AI 中台，预置 12 个 Agent（免费 6 个 + 付费 6 个）。 |
| 工作流 | 工作流 CRUD、执行、实例管理。 |
| 设备管理 | 设备 CRUD/统计/监控/告警/Token 签发。 |
| 风控与黑名单 | 风险事件上报与处理、黑名单管理。 |
| 发布链路追踪 | 发布统一收敛至 SMOPUB，任务带 pub_status / pub_task_ids / trace_id 全链路追踪（v1.8 起，原加微/私信/养号等 RPA 遗留模块下线）。 |
| 接管 / 自动回复 | 接管规则、关键词回复、欢迎语、RAG 配置。 |
| 定时 / 自动化任务 | 定时任务与自动化任务 CRUD、启停、执行、日志。 |
| 矩阵运营 | 矩阵账号、互动处理、批量处理。 |
| 限流风控 | ShadowBan 限流状态监控与重置。 |
06
AI 智慧中台（ai_plat）
基于 LangGraph 的 AI Agent 运行时中台（后端基础设施），提供统一的 Agent 注册、执行、计费能力。用户交互通过 Admin 后台，业务接入通过 API/SDK。
6.1 LangGraph 运行时引擎
| 功能 | 说明 |
|---|---|
| 图执行引擎 | 按 nodes/edges/entry_point 执行有向图，支持条件求值、工具分发、状态管理，最大迭代 50 次；单 Agent 与工作流两种执行器。 |
| LLM 多模型路由 | 15 家供应商（Azure/OpenAI/通义/MiniMax/讯飞星火/DeepSeek/Moonshot/豆包/混元/Ollama/硅基流动/智谱/文心等），动态加载、fallback 链。 |
| 工具系统 | 企微工具、SCRM 工具、企微陪聊工具、平台工具、回调客户端。 |
| 知识库 RAG | embedding、文本切分、文档解析、检索、向量存储。 |
| 记忆系统 | 短期记忆 + 长期记忆 + 时间线。 |
| 语音能力 | TTS 合成、ASR 识别、流式处理。 |
| 流式输出 | SSE 管理器与流式路由。 |
| 引擎认证 | HMAC 签名验签 + 配额检查中间件。 |
6.2 Agent 注册与执行
| 功能 | 说明 |
|---|---|
| Agent 注册中心 | 注册/更新/发现/版本控制，支持完整图定义或组装式定义，工具自动提取，缓存 1h。 |
| Agent 定义管理 | 创建/更新/删除/发布/下线/复制/模板创建/定义验证/预置模板。 |
| 智能体设计器 | 前端可视化设计 Agent 图。 |
| 智能体市场 | 发布/列表/详情/安装/评论/分类/上下架/安装记录，Agent 购买与退款。 |
| 执行服务 | 同步/异步/流式三种执行模式，执行开始/结束记录，失败回写。 |
| 引擎客户端 | runAgent / runAgentStream / 健康检查，30s 超时。 |
| 流式与事件 | SSE 会话、事件流推送、工具回调。 |
6.3 计费与结算
| 功能 | 说明 |
|---|---|
| Agent 计费网关 | 六步流程：估算→付款方解析（主账户/会员子账户）→余额检查→月度配额检查→真实执行→按实际用量结算（多退少补，失败回滚）。 |
| 定价体系 | 阶梯价、分销价、LLM 单价实时算费。 |
| 配额管理 | 应用配额设置/用量/检查/批量设置/分发/回收。 |
| 套餐 / 服务目录 | 服务包/服务项，按 code 与 invoke_code 查询。 |
| 余额账户 | 会员余额与交易。 |
| 代收代付 / 结算 | 转售订单、结算单生成/处理/自动结算。 |
| 退款 / 提现 | 退款工单申请/审核/发起退款，提现账户/申请/审核/打款。 |
| 支付管理 | 支付渠道管理、证书上传、订单、收银台、模拟支付。 |
| CDK 卡密 | 批次创建/验证/使用/作废/导出。 |
| 对账 / 用量 | 计费对账、用量记录与实时 KPI。 |
6.4 租户授权与统一能力
| 功能 | 说明 |
|---|---|
| 应用租户管理 | 租户注册/编辑/禁用/启用/站点充值/手动补录/Webhook 漏单补录与告警。 |
| API 密钥 | AppKey 生成/编辑/重生成。 |
| 站点绑定 / 授权 | 站点绑定、站点权益、租户服务包。 |
| Webhook 接入 | 市场 auth-change 推送、验签、日志/模拟/健康总览。 |
| 企业微信能力 | 客户画像、回复建议、会话记录、消息发送、JS-SDK 配置、情绪预警。 |
| 知识库管理 | 知识库/文档上传/处理/检索/增强提示。 |
| A/B 测试 | 实验 CRUD/启停/分组/埋点/分流/效果报表。 |
| 语音能力 | ASR/TTS/流式语音/语言/音色/格式。 |
| 机器学习 / 调优 | 自动调优、流量切分、统计显著性检验。 |
| 监控告警 | 告警推送（微信 Webhook）。 |
| 分销体系 | 渠道商关系、分销价格表、配额分发、续费规则、套餐阶梯。 |
| RPA 授权 | 授权配置、设备注册/激活/心跳/审核/冻结解冻/支付。 |
6.5 OpenAPI / MCP / SDK
| 功能 | 说明 |
|---|---|
| OpenAPI v1 | 探活 ping；Agent 市场/安装/购买/运行；知识库自管；服务目录/收银台；计费（套餐/购买/余额/权益/CDK 兑换/服务消费/记录/订单状态）；CDK 接收/批次；会员（购买套餐/使用 CDK/余额/记录）。 |
| API 认证 | HMAC-SHA256 签名、300s 时间戳容差、AppKey/AppSecret 校验。 |
| RPA 设备 API | 设备注册/配置/支付/授权码/激活/验证/心跳。 |
| 中间件 | 数据采集、HMAC 鉴权、跨域。 |
| MCP 服务 | 站点级 McpAccess，以 MCP 标准协议对外暴露 23 项 SCRM 能力，可被 AstrBot / Claude / GPT 等任意 MCP 客户端调用。 |
07
1+4 协同闭环
五个系统不是孤立的功能堆叠，而是通过事件总线、桥接服务和统一计费网关深度咬合，形成"检测→发布→获客→成交→归因"的完整增长飞轮。
7.1 跨应用协同
| 协同链路 | 说明 |
|---|---|
| SMOGEO → SMOPUB | GeoPublisherBridge 创建发布任务，优化建议/商机/草稿一键推送发布。 |
| SMOGEO → SMOAI | GeoSmoaiBridge 创建 AI 创作任务，商机推送至 SMOAI 内容创作。 |
| SMOGEO → SCRM | GeoScrmBridge 推送商机、绑定 UTM、记录访问。 |
| SMOPUB → SMOAI | 发布结果事件回写 SMOAI 发布任务状态。 |
| SMOAI → SCRM | ScrmSyncService 同步客户（同系统直调 / 跨系统 Webhook），成交事件回写归因。 |
| 四端 → ai_plat | Agent 注册与执行走统一计费网关，站点初始化自动激活 AI 中台租户。 |
| SCRM 事件总线 | CrossProductEventBus 跨产品事件（营销引擎等）广播。 |
7.2 统一计费体系
ai_plat 的 AgentBillingGateway 明确服务 scrm_v2 / smo_geo / smo_pub / smo_ai 四端，统一计费与配额；各应用同时保留独立的计费中心（余额、充值、服务市场、交易流水、服务消费流水），支持本地计费与远程计费双模式，充值成功通过事件监听自动入账。
7.3 典型应用场景
场景一 · 品牌 AI 搜索占位
SMOGEO 检测曝光 → 生成内容建议 → SMOPUB 分发至 10 大平台 → 再检测验证 → 持续提升首位推荐率。
场景二 · 内容获客自动转化
SMOPUB 发布 → SMOAI 采集评论/私信 → AI 识别意向 → 自动同步 SCRM → 销售跟进成交。
场景三 · 私域自动运营
SCRM 渠道活码获客 → 欢迎语 → 群 SOP / 客户 SOP 自动跟进 → 流失预警 → 复购营销。
场景四 · 投放 ROI 归因
UTM 埋点 → 触点采集 → 成交回写 → 多模型归因 → ROI 报表 → 优化投放策略。
场景五 · AI 智能体机器人
企微里 @ 机器人查客户、写话术、建任务；MCP 能力外溢，SCRM 能力可被 AstrBot 等外部智能体调用，一套能力随处可调。
08
技术架构与安全
基于 Niucloud 多应用框架构建，前后端分离，事件驱动解耦，面向私有化部署与二次开发。
8.1 技术底座
| 层次 | 技术 |
|---|---|
| 后端框架 | ThinkPHP（Niucloud 多应用框架），PHP 8 |
| 前端 | Vue 3 + Vite + Element Plus（Admin），uni-app（移动端） |
| AI 运行时 | Python FastAPI + LangGraph（ai_plat 引擎） |
| 队列 | BullMQ 消息队列 + 框架队列任务 |
| 设备通信 | Workerman TCP 长连接（RPA 网关） |
| 数据库 | MySQL 8（InnoDB，utf8mb4） |
| 缓存 | Redis |
| 自动化 | CDP（Chrome DevTools Protocol）/ RPA 适配器 / Tauri 本机助手 |
8.2 安全与合规
- 凭证安全：账号凭证 AES-GCM 加密存储，access_token 缓存且不明文记录。
- 接口安全：OpenAPI / Webhook 均采用 HMAC-SHA256 签名 + 时间戳容差校验。
- 输入安全：参数统一过滤，Validate 验证器校验，搜索关键词特殊字符处理。
- 数据安全：敏感数据加密存储，软删除不物理删除，会员操作校验归属。
- 合规检测：SMOGEO 内置违禁词/敏感词/广告法违规检测。
- 风控体系：SCRM 敏感词/敏感行为/风控规则，SMOAI 限流风控与黑名单。
8.3 可扩展性
- 事件驱动解耦：模块间通过事件钩子交互，新增能力通过 Listener 挂载，不修改核心。
- 适配器扩展：SMOPUB 平台适配器、SMOAI 渠道适配器、ai_plat LLM 供应商均可动态扩展。
- Agent 生态：智能体市场支持第三方 Agent 安装，预置模板覆盖各行业。
- 私有化交付：源码交付，可自主定制、自主掌控，支持灰度发布与能力降级。
- 能力外溢（MCP / OpenAPI）：23 项标准能力以标准协议对外暴露，可被 AstrBot 等外部智能体调用，SCRM 能力无处不在。