源雀SCRM【开源免费版】工具技术手册

如有包括但不限于以下需求，可随时通过源雀官方企微联系我们：

1. 获取源雀SCRM完整体验系统
2. 源雀SCRM商务合作
3. 源雀SCRM产品交流
4. 更多咨询或服务...

注:开源版为简单的企微营销小工具，商业版是一套完整的企微SCRM私域营销系统

开源版下载地址:

1. gitee: https://gitee.com/iyque/iYqueCode
2. gitcode: https://gitcode.com/iyque/iYque

1. 架构

采用springboot+jpa+h2架构，项目内置h2数据库，开箱即可使用；

2. yml配置文件

注:相关重点参数已标注,其他参数如h2远程访问,等通用类型参数可查看相关组件官方文档

server:
  port: 8085
ai:
  model: deepseek-chat #接入的具体模型，deepseek目前支持deepseek-chat与deepseek-reasoner
  limitToken: 10000  #限制每日token使用上限(输入token+输出token)
  deepseek:
    apiKey:  #对应deepseek的apiKey
iyque:
  userName: iyque #系统默认访问账号
  pwd: 123456 #系统默认访问密码
  demo: false #为false当前系统参数可修改,true系统参数不可修改
  fileViewUrl: http://iyque.cn/file/fileView/ #文件统一访问前缀，后端api指向 FileController.readFile
  uploadDir: ./upload #文件存储目录
  complaintUrl: http://iyque.cn/openmobile/customerComplaint #投诉反馈移动端访问页面
spring:
  h2:
    console:
      path: /h2  #嵌入式数据库h2访问前缀,如当前服务端访问地址为http://127.0.0.1:8085/h2
      enabled: true
      settings:
        web-allow-others: true
  datasource:
    url: jdbc:h2:file:./data/mydb; #数据库文件存储地址
    username: sa #数据库访问账号
    password: 123456 #数据库访问密码
  jpa:
    database-platform: org.hibernate.dialect.H2Dialect
    hibernate:
      ddl-auto: update
      naming:
        physical-strategy: org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
    generate-ddl: true
    show-sql: true
    properties:
      hibernate:
        format_sql: true
  jackson:
    time-zone: Asia/Shanghai
    serialization:
      fail-on-empty-beans: false
  servlet:
    multipart:
      max-file-size: 20MB
      max-request-size: 20MB

3. deepseek配置

（如果应用服务启动前没有配置相关参数，那么后续配置的，需要重启）

ai:
  model: deepseek-chat #接入的具体模型，deepseek目前支持deepseek-chat与deepseek-reasoner
  limitToken: 10000  #限制每日token使用上限(输入token+输出token)
  deepseek:
    apiKey:  #对应deepseek的apiKey

3.1 model参数

(https://api-docs.deepseek.com/zh-cn/quick_start/pricing)

3.2 limitToken

注:限制每日token使用上限(输入token+输出token),避免过度使用造成资源浪费

3.3 apiKey

(https://platform.deepseek.com/api_keys)

4.AI客服与知识库配置

4.1 milvus向量数据库相关配置

milvus向量数据库安装: https://milvus.io/docs/zh/install_standalone-docker.md

iyque:
  vector:
    host: 127.0.0.1  #Milvus访问地址
    port: 19530 #Milvus端口,api通信端口,非web访问端口。如非特殊情况默认就是19530
    collectionName: iyque_vectors #向量集合名称前缀，可自定义或使用默认

4.2 向量计算模型

向量模型使用的是openAi的text-embedding-3-small模型。因为网络问题,正常无法直接使用该模型,所以通过百搭API中转平台实现的

iyque:
  vector:
    dimension: 1536 #向量维度,默认为1536维度
    apiUrl: https://api.pandarobot.chat/ #api中转平台地址，使用百搭API，默认即可
    apiKey: sk-4nLONNwyyxRg5S9wA6D278F017Ec420cBeA #百搭平台的apiKey 
    vectorModel: text-embedding-3-small #向量模型,目前暂时只支持text-embedding-3-small,使用默认即可
    score: 0.5f #向量查询相似度,可自行调整0-1范围的大小，以前结合自己的业务更好的实现向量匹配

apiKey获取

5.图片访问配置

iyque:
 fileViewUrl: http://iyque.cn/file/fileView/  #http://iyque.cn替换为当前api服务实际的访问地址【/file/fileView/】保持不变
 uploadDir: /app/upload  #如图片存放于服务器绝对路径【/app/upload】下

6.redis配置

redis安装教程:https://blog.csdn.net/weixin_44906977/article/details/118994047

注：当前redis配置遵循spring-boot-starter-data-redis默认配置,需要其他参数可自行拓展

spring:
  redis:
    host: 127.0.0.1 #访问地址
    port: 6379 #端口
    database: 1 #指定库

7. 应用打包

IDEA环境下打包,如下:

8. 运行

nohup java -jar xxx.jar > iyque.log 2>&1 &

注:xxx.jar替换为实际的包名,如上图中打包名称为:iyque-code-1.0-SNAPSHOT.jar,则实命令为nohup java -jar iyque-code-1.0-SNAPSHOT.jar > iyque.log 2>&1 &

9. nginx后端api转发

注:完整的nginx配置文件 (/configFile/nginx.conf)

location ^~/iyque/ {
   proxy_pass http://127.0.0.1:8085/; #该地址为后端api的访问地址
}