交互体验 interaction.yml

interaction.yml 控制玩家看到和听到的一切：聊天格式、反馈、私聊、工具显示。

interaction — 交互设置

interaction:
  commandPrefix: "ark"
  streaming: false
  responseDelay: 300
  maxMessageLength: 300
  chatFormat: "{prefix}{name}§r: {message}"
  actionBarFeedback: true
  soundFeedback: true
  onboarding:
    enabled: true
  feedback:
    enabled: true
  dmMode:
    publicChatPrefix: "!"
    autoTimeoutMinutes: 15

字段	类型	默认值	说明
commandPrefix	string	"ark"	命令前缀（/ark）
streaming	bool	false	流式输出（逐字显示）
responseDelay	int	300	回复前延迟（毫秒）
maxMessageLength	int	300	单条回复最大字符数
chatFormat	string	"{prefix}{name}§r: {message}"	聊天格式模板
actionBarFeedback	bool	true	行动条思考动画
soundFeedback	bool	true	音效反馈
onboarding.enabled	bool	true	新玩家欢迎提示
feedback.enabled	bool	true	回复评分按钮
dmMode.publicChatPrefix	string	"!"	私聊模式下公共聊天前缀
dmMode.autoTimeoutMinutes	int	15	私聊模式自动超时（分钟）

toolDisplay — 工具显示

toolDisplay:
  defaults:
    showInChat: true
    showArgs: false
  overrides:
    execute-command:
      displayName: "执行命令"
      showInChat: true
      showArgs: true

控制 AI 调用工具时在聊天中的提示样式。

字段	说明
defaults.showInChat	默认是否显示工具调用提示
defaults.showArgs	默认是否显示参数
overrides.<key>.displayName	自定义工具显示名
overrides.<key>.showInChat	是否显示该工具的提示
overrides.<key>.showArgs	是否显示该工具的参数