引客云·可信增长决策智能体部署方案
引客云·可信增长决策智能体
让获客、成交、退款、分账和 AI 决策都有证据。
引客云,是可信增长基础设施上的行业智能体。
它面向电商商家、服务商、达人渠道和平台方,把“短链获客、授权线索、订单回传、退款校正、分账结算、审计留痕、智能建议”连成一条可信结果链。客户不再只看报表,而是能清楚回答:谁带来了有效增长、谁应该获得分账、哪里存在风险、下一步该怎么做。
一句话价值
引客云把增长业务从“各看各的表、各算各的账”,升级为“同一条证据链上的可信经营决策”。
它解决什么问题
增长业务最容易失控的地方,不是没有流量,而是后面的链路断了:
经营问题 引客云的解决方式
线索来源说不清 用短链、来源码、活动、素材和授权记录追踪每条线索
成交贡献算不清 用订单回传、退款校正和净支付口径还原真实结果
达人和服务商分账扯皮 用 CPA / CPS / 混合分账和证据链减少争议
商家不回传、飞单、造假 用回传完整度、异常模式和审计记录识别风险
AI 建议不敢信 每条建议都有归因、解释、审批和结果验收
监管或客户审计压力大 留存授权、操作、决策、结算和导出证据
核心优势
真实结果闭环
引客云不是只记录线索,而是把获客、跟进、成交、退款和分账串起来,直接面向净支付、退款率、结算准确率和争议处理。可信结算能力
系统支持 CPA、CPS、混合分账、佣金冻结、退款冲回、付款复核和结算证据链,让商家、达人、服务商在同一套规则下对账。智能生意参谋
系统可以给出高价值客户识别、退款风险预警、素材放量建议、渠道预算建议、付款复核建议和可信增长闭环报告,帮助团队更快找到该跟进、该止损、该放量的动作。行业智能大脑
系统会持续沉淀业务结果、人工反馈、审计日志和监控异常,让线索评分、风险预警、结算治理和策略建议越用越懂业务。可解释、可审计、可治理
引客云不做黑盒决策。低风险内部动作可以自动化,高影响动作必须经过权限、审批、审计和结果验收。
适合谁使用
电商商家:需要提升获客转化、复购和渠道 ROI。
代运营服务商:需要同时管理多个商家、渠道、达人和服务团队。
达人和渠道团队:需要透明查看贡献、佣金和结算状态。
区域平台和产业带平台:需要管理多商家生态、平台抽佣和监管就绪材料。
私有化客户:需要数据不出域、独立部署、专属模型网关和安全运维能力。
核心能力
- 自动获客入口
渠道短链
落地页表单
授权留资
手机号规则校验
来源码、渠道、活动、素材追踪
访问、提交、转化链路记录
频控、退订、黑名单和线索合规治理 - 线索与客户运营
线索去重
授权校验
高意向评分
跟进任务
客户价值雷达
高价值客户识别
复购、流失和售后风险提示 - 订单、退款与可信结算
订单回传
退款回传
净支付口径
CPA / CPS / 混合分账
结算单状态流转
付款批次
付款失败、冲正和异常复核
商家、达人、服务商之间的分账证据链 - 智能生意参谋
增长决策建议
高价值客户雷达
退款风险预警
素材放量建议
渠道预算建议
结算冻结建议
付款复核建议
可信增长闭环报告 - 行业智能大脑
模型治理
训练样本
策略实验
决策网关
自我进化中枢
日志学习闭环
未知风险哨兵
运维学习闭环
受治理自我决策 - 可解释决策
引客云不做黑盒决策。
每条智能建议都可以看到:
为什么推荐这个动作
核心归因因子
权重分布
新手结论
专家模式
隐私脱敏说明
人工采纳、拒绝、修改和补充业务背景
7. 安全、运维与监管就绪
审计日志
决策执行日志
监管就绪总览
数据保留策略
隐私影响评估
算法备案辅助材料
自动化权限降级
回滚守卫
治理 SLA
容量扩容提醒
监控、日志与全链路追踪
系统默认遵循一个原则:低风险内部动作可以在审计留痕下自动化,高影响动作必须审批或禁止自动执行。
系统架构
当前仓库包含:
前端工作台:原生 HTML / CSS / JavaScript
Gateway:Python / FastAPI
高并发采集服务:Go
PostgreSQL:交易、线索、审计和结算数据
Redis:缓存、限流和短期幂等
SonarQube:代码质量分析
Trivy:安全扫描服务
Docker Compose:本地和单机部署
Kubernetes:生产部署建议和扩展方向
核心目录:
.
├── index.html
├── landing.html
├── js/
├── styles.css
├── services/
│ ├── gateway/
│ ├── collector-go/
│ ├── lead-service/
│ ├── campaign-service/
│ └── settlement-service/
├── infra/
├── scripts/
├── docs/
└── docker-compose.yml
部署方式
- Docker Compose 一键启动
推荐 Linux 服务器:
Ubuntu 22.04 LTS 或 Debian 12
Docker 24+
Docker Compose v2+
2 核 CPU / 4 GB 内存起步
生产环境建议 4 核 CPU / 8 GB 内存以上
克隆代码:
gitclone https://gitee.com/xiaoqian9900/huokesys.gitcdhuokesys准备环境变量:
cp.env.example .env创建持久化卷:
dockervolume create pgdatadockervolume create sonarqube_datadockervolume create sonarqube_extensionsdockervolume create sonarqube_logsdockervolume create trivy_cache启动:
dockercompose up-d--build查看状态:
dockercomposeps健康检查:
curlhttp://localhost:8081/health访问地址:
前端工作台:http://服务器IP:5173/
Gateway:http://服务器IP:8081/
SonarQube:http://服务器IP:9000/
Trivy Server:http://服务器IP:4954/
查看日志:
dockercompose logs-fgatewaydockercompose logs-fpostgresdockercompose logs-fredis停止服务:
dockercompose down生产环境谨慎执行:
dockercompose down-v该命令会删除容器卷数据。
- 环境变量
社区版默认使用本地规则模型,开箱即用,不需要大模型密钥。
基础配置:
STORAGE_MODE=postgresPOSTGRES_DSN=postgresql://huoke:huoke@postgres:5432/huokeREDIS_URL=redis://redis:6379/0RATE_LIMIT_ENABLED=trueRATE_LIMIT_PER_MINUTE=120SIGNATURE_AUTH_ENABLED=trueSIGNATURE_SECRET=replace-with-a-strong-random-secretSIGNATURE_MAX_SKEW_SECONDS=300启用外部大模型:
AI_PROVIDER=deepseekAI_MODEL=deepseek-v4-proAI_EXTERNAL_ENABLED=trueAI_BASE_URL=https://api.deepseek.comAI_API_KEY=你的服务端密钥AI_TIMEOUT_SECONDS=15AI_PLAN_TIMEOUT_SECONDS=120AI_REASONING_MODE=deep可选 AI_PROVIDER:
Provider 适用场景 默认地址
deepseek 深度推理、获客方案、素材作战包、归因解释 https://api.deepseek.com
qwen 通义千问/阿里云百炼,国内文本生成和策略建议 https://dashscope.aliyuncs.com/compatible-mode/v1
zhipu 智谱 GLM,文本生成和业务解释 https://open.bigmodel.cn/api/paas/v4
kimi Kimi / Moonshot,长上下文素材和文档任务 https://api.moonshot.cn/v1
volcengine_ark 火山方舟/豆包,国内模型网关接入 https://ark.cn-beijing.volces.com/api/v3
openai OpenAI 官方接口 https://api.openai.com/v1
openai_compatible 私有化模型网关或其他兼容接口 自行配置
如果使用自有模型网关,将 AI_PROVIDER 改为 openai_compatible,并把 AI_BASE_URL 改为对应模型网关地址。
敏感数据不得进入模型请求:
手机号明文
手机号哈希
原始 IP
原始 User-Agent
私聊原文
3. Kubernetes 部署建议
生产或平台版建议拆分:
gateway:Deployment + Service + HPA
collector-go:Deployment + Service + HPA
lead-service:Deployment + Service
campaign-service:Deployment + Service
settlement-service:Deployment + Service
postgres:生产建议使用云数据库或独立 PostgreSQL 集群
redis:生产建议使用云 Redis 或独立 Redis 集群
frontend:Nginx 静态资源容器或对象存储 + CDN
构建镜像:
dockerbuild-tregistry.example.com/huokesys/gateway:latest-fservices/gateway/Dockerfile.dockerbuild-tregistry.example.com/huokesys/collector-go:latest services/collector-godockerbuild-tregistry.example.com/huokesys/lead-service:latest services/lead-servicedockerbuild-tregistry.example.com/huokesys/campaign-service:latest services/campaign-servicedockerbuild-tregistry.example.com/huokesys/settlement-service:latest services/settlement-service推送镜像:
dockerpush registry.example.com/huokesys/gateway:latestdockerpush registry.example.com/huokesys/collector-go:latestdockerpush registry.example.com/huokesys/lead-service:latestdockerpush registry.example.com/huokesys/campaign-service:latestdockerpush registry.example.com/huokesys/settlement-service:latest创建命名空间:
kubectl create namespace huokesys
创建 Secret:
kubectl-nhuokesys create secret generic huokesys-secret\--from-literal=POSTGRES_DSN='postgresql://user:password@postgres.example.com:5432/huoke'\--from-literal=REDIS_URL='redis://redis.example.com:6379/0'\--from-literal=SIGNATURE_SECRET='replace-with-a-strong-random-secret'Gateway 示例:
apiVersion: apps/v1 kind: Deployment metadata: name: gateway namespace: huokesys spec: replicas:2selector: matchLabels: app: gateway template: metadata: labels: app: gateway spec: containers: - name: gateway image: registry.example.com/huokesys/gateway:latest ports: - containerPort:8080env: - name: STORAGE_MODE value: postgres - name: POSTGRES_DSN valueFrom: secretKeyRef: name: huokesys-secret key: POSTGRES_DSN - name: REDIS_URL valueFrom: secretKeyRef: name: huokesys-secret key: REDIS_URL - name: SIGNATURE_AUTH_ENABLED value:"true"- name: SIGNATURE_SECRET valueFrom: secretKeyRef: name: huokesys-secret key: SIGNATURE_SECRET readinessProbe: httpGet: path: /health port:8080initialDelaySeconds:10periodSeconds:10livenessProbe: httpGet: path: /health port:8080initialDelaySeconds:30periodSeconds:20--- apiVersion: v1 kind: Service metadata: name: gateway namespace: huokesys spec: selector: app: gateway ports: - port:8080targetPort:8080HPA 示例: apiVersion: autoscaling/v2 kind: HorizontalPodAutoscaler metadata: name: gateway-hpa namespace: huokesys spec: scaleTargetRef: apiVersion: apps/v1 kind: Deployment name: gateway minReplicas:2maxReplicas:10metrics: - type: Resource resource: name: cpu target: type: Utilization averageUtilization:60生产 Kubernetes 建议:
PostgreSQL 使用云数据库或独立高可用集群
Redis 使用云 Redis 或 Sentinel / Cluster
日志与业务分开部署
日志组件使用独立节点池和独立数据盘
指标接入 Prometheus / Grafana
日志接入 Loki / OpenSearch / ELK
链路追踪接入 OpenTelemetry / Tempo / Jaeger
冷日志、证据和备份进入对象存储
Secret 使用云 KMS 或密钥管理系统
镜像开启漏洞扫描
Pod 设置资源限制
版本与商业模式
引客云适合做基础设施型产品,而不是一次性工具。
版本边界:
社区版:自部署,跑通核心闭环。
标准版:官方 SaaS,适合单商家和小团队。
专业版:增强智能生意参谋、模型治理和结算能力。
服务商版:多商家、多渠道、多团队协作。
平台版:区域平台、产业带平台、连锁总部、多商家生态。
私有化企业版:强监管、数据不出域、客户自有环境部署。
商业模式:
月费与年费
私有化部署
多商家服务商工作台
平台版专属实例
成交 CPS / 有效线索 CPA
结算技术服务费
行业模板
商业插件
企业 SLA
白标 OEM
咨询实施和定制开发
达人侧:
普通达人免费。
认证达人低价月费和年费。
达人团队、机构达人按能力和权益收费。
商业化方案按订阅、用量、结算技术服务费、智能体能力和私有化平台版分层推进。
社区版与开源计划
当前仓库优先在 Gitee 维护和迭代。
社区版目标:
跑通自动获客入口。
跑通授权留资。
跑通订单回传。
跑通退款回传。
跑通可信结算。
跑通审计日志。
跑通智能生意参谋。
跑通自我进化中枢。
跑通 Docker Compose 部署。
等社区版本核心闭环稳定、文档和部署体验完善后,再推送到公开代码平台做正式开源发布。
安全边界
引客云强调“合规就绪”和“监管就绪能力”,不承诺替代法律意见。
系统默认关注:
授权留资
退订与黑名单
数据脱敏
导出审批
审计日志
决策日志
模型治理
算法备案材料
数据保留策略
隐私影响评估
敏感数据不进入智能特征和案例导出:
手机号明文
手机号哈希
原始 IP
原始 User-Agent
私聊原文
研发与验证
常用检查:
nodescripts/dev/visible_text_check.mjs python-mpytest services/gateway/tests-q后端局部测试示例:
cdservices/gateway python-mpytest tests/test_ops_capacity.py-qpython-mpytest tests/test_ai_advice.py-qpython-mpytest tests/test_billing_plans.py-qpython-mruff check app tests大模型功能验证:
python scripts/dev/llm_smoke_check.py该脚本会验证模型调用、Provider 列表、获客方案、批量获客链接和线索建议,不会打印密钥。
最终目标
引客云要成为企业可信增长的决策智能体:
能获客。
能结算。
能审计。
能监控。
能解释。
能学习。
能进化。
能在治理边界内辅助企业做更好的经营决策。
