基础配置

本文档介绍插件的基础配置选项，配置文件位于 config/config.yaml。

basic 基础设置

basic:
  # 命令前缀
  commandPrefix: "#ai"
  
  # 调试模式
  debug: false
  
  # 显示思考消息
  showThinkingMessage: false
  
  # 调试信息仅输出到控制台
  debugToConsoleOnly: true
  
  # 引用回复
  quoteReply: false
  
  # 自动撤回
  autoRecall:
    enabled: false
    delay: 60          # 撤回延迟（秒）
    recallError: true  # 撤回错误消息

参数说明

参数	类型	默认值	说明
commandPrefix	string	#ai	管理命令前缀
debug	boolean	false	开启调试模式
showThinkingMessage	boolean	false	显示 AI 思考过程
debugToConsoleOnly	boolean	true	调试信息仅输出控制台
quoteReply	boolean	false	回复时引用原消息

admin 管理员配置

admin:
  # 主人QQ列表
  masterQQ: []
  
  # 插件作者QQ（拥有更高权限）
  pluginAuthorQQ: []
  
  # 登录时私聊通知主人
  loginNotifyPrivate: true
  
  # 敏感命令仅主人可用
  sensitiveCommandMasterOnly: true

llm 模型配置

llm:
  # 默认模型
  defaultModel: gpt-4o
  
  # 默认预设ID
  defaultChatPresetId: ""
  
  # 嵌入模型
  embeddingModel: text-embedding-3-small
  dimensions: 1536
  
  # 场景模型配置
  models:
    chat: ""        # 对话模型
    image: ""       # 图像理解模型
    roleplay: ""    # 角色扮演模型
    tool: ""        # 工具调用模型
    dispatch: ""    # 工具分发模型
    search: ""      # 搜索模型
    draw: ""        # 绘图模型
  
  # 回退配置
  fallback:
    enabled: true
    models: []
    maxRetries: 3
    retryDelay: 500
    notifyOnFallback: false
  
  # 模型参数
  temperature: 0.7
  maxTokens: 4000
  topP: 1
  frequencyPenalty: 0
  presencePenalty: 0

web 服务配置

web:
  # 监听端口
  port: 3000
  
  # 共享端口（TRSS）
  sharePort: false
  
  # 挂载路径
  mountPath: /chatai
  
  # JWT 密钥（自动生成）
  jwtSecret: ""
  
  # 公网URL（用于生成链接）
  publicUrl: ""

redis 配置

redis:
  enabled: true
  host: 127.0.0.1
  port: 6379
  password: ""
  db: 0

images 图片配置

images:
  storagePath: ./data/images
  maxSize: 10485760  # 10MB
  allowedFormats:
    - jpg
    - jpeg
    - png
    - gif
    - webp

update 更新配置

update:
  autoCheck: true       # 自动检查更新
  checkOnStart: true    # 启动时检查
  autoUpdate: true      # 自动更新
  autoRestart: true     # 更新后自动重启
  notifyMaster: true    # 通知主人

streaming 流式输出

streaming:
  enabled: true
  chunkSize: 1024

output 输出配置

output:
  # 长文本处理
  longText:
    enabled: true
    threshold: 500      # 字符阈值
    mode: forward       # forward | image
    forwardTitle: AI 回复
  
  # 分句输出
  sentenceOutput:
    enabled: false
    allSentences: false
    minDelay: 300
    maxDelay: 1500
    randomDelay: true

render 渲染配置

render:
  mathFormula: true    # 渲染数学公式
  theme: light         # light | dark
  width: 800           # 渲染宽度

loadBalancing 负载均衡

loadBalancing:
  strategy: priority   # priority | round-robin | random | weight

thinking 思考配置

thinking:
  enabled: false
  defaultLevel: low       # low | medium | high
  enableReasoning: false
  showThinkingContent: true
  useForwardMsg: true

完整示例

basic:
  commandPrefix: "#ai"
  debug: false
  showThinkingMessage: false
  quoteReply: false
  autoRecall:
    enabled: false
    delay: 60

admin:
  masterQQ: ["123456789"]
  loginNotifyPrivate: true
  sensitiveCommandMasterOnly: true

llm:
  defaultModel: gpt-4o
  temperature: 0.7
  maxTokens: 4000
  fallback:
    enabled: true
    maxRetries: 3

web:
  port: 3000
  sharePort: false

streaming:
  enabled: true

update:
  autoCheck: true
  autoUpdate: false

下一步

• 渠道配置 - 配置 API 渠道
• 模型配置 - 模型参数调优
• 触发配置 - 触发方式设置