工具与扩展 tools.yml

tools.yml 管理工具系统的运行时配置：外部脚本、扩展包、子助手调用、蓝图系统。

externalTools — 外部脚本工具

externalTools:
  enabled: true
  timeout: 5000

字段	类型	默认值	说明
enabled	bool	true	启用 tools/ 目录下的脚本工具加载
timeout	int	5000	脚本工具执行超时（毫秒）

expansions — 扩展包

expansions:
  enabled: true

字段	类型	默认值	说明
enabled	bool	true	启用 expansions/ 目录下的 JAR 扩展包加载

callAgent — 子助手调用

callAgent:
  timeoutSeconds: 1200

字段	类型	默认值	说明
timeoutSeconds	int	1200	助手 A 调用助手 B 的超时（秒）

blueprint — 蓝图系统

blueprint:
  enabled: true
  apiBaseUrl: "https://arkpilot-blueprint.pages.dev"
  maxBlocks: 50000
  maxBlocksPerTick: 50
  generation:
    model: ""

字段	类型	默认值	说明
enabled	bool	true	是否启用蓝图系统
apiBaseUrl	string	—	蓝图 API 地址（上传/下载蓝图和网页预览）
maxBlocks	int	50000	单蓝图最大方块数
maxBlocksPerTick	int	50	每 tick 放置方块数
generation.model	string	""	蓝图生成模型（留空用助手主模型）

参数调优

参数	建议	说明
maxBlocks	10000-50000	根据服务器性能调整
maxBlocksPerTick	20-100	20 = 流畅但慢，100 = 快但可能卡顿

详见蓝图系统。