核心配置 config.yml

config.yml 管理插件的核心运行参数。修改后使用 /ark reload 热重载。

defaults — 默认设置

yaml

defaults:
  assistant: "player-helper"

字段	类型	默认值	说明
`assistant`	string	`"player-helper"`	玩家未指定助手时使用的默认助手 ID

execution — 执行引擎

yaml

execution:
  threadPoolSize: 10
  maxConcurrent: 10
  queueSize: 50
  timeoutSeconds: 1200

字段	类型	默认值	说明
`threadPoolSize`	int	`10`	IO 线程池大小
`maxConcurrent`	int	`10`	全服最大并发 AI 请求数
`queueSize`	int	`50`	等待队列容量
`timeoutSeconds`	int	`1200`	单次请求空闲超时（秒）

调优建议

小服（< 20 人）：threadPoolSize: 5, maxConcurrent: 5
中服（20-100 人）：threadPoolSize: 10, maxConcurrent: 10
大服（100+ 人）：threadPoolSize: 20, maxConcurrent: 20

rateLimit — 限流

yaml

rateLimit:
  globalRequestsPerMinute: 60
  defaultCooldownSeconds: 3
  defaultMaxDailyUses: 200

字段	类型	默认值	说明
`globalRequestsPerMinute`	int	`60`	全服每分钟最大请求数
`defaultCooldownSeconds`	int	`3`	单玩家默认冷却（秒）
`defaultMaxDailyUses`	int	`200`	单玩家每日默认限额（0 = 无限）

这些值可被助手配置中的 permissions.cooldownSeconds 和 permissions.maxDailyUses 覆盖。

billing — 费用追踪

yaml

billing:
  enabled: false
  logUsage: true
  dailyBudget: 0
  perPlayerDailyBudget: 0

字段	类型	默认值	说明
`enabled`	bool	`false`	启用费用追踪
`logUsage`	bool	`true`	记录 token 用量日志
`dailyBudget`	float	`0`	全服每日预算（0 = 不限）
`perPlayerDailyBudget`	float	`0`	单玩家每日预算（0 = 不限）

logging — 日志

yaml

logging:
  level: INFO
  logPrompts: false
  logToolCalls: true
  logStackTrace: true
  payloadPreviewLength: 800

字段	类型	默认值	说明
`level`	string	`INFO`	日志级别（DEBUG / INFO / WARN / ERROR）
`logPrompts`	bool	`false`	记录完整系统提示（调试用）
`logToolCalls`	bool	`true`	记录工具调用日志
`logStackTrace`	bool	`true`	错误时输出完整堆栈
`payloadPreviewLength`	int	`800`	大文本日志预览长度