配置概览

ArkPilot 按模块拆分为 6 个配置文件，各自独立热重载。

配置文件

文件	职责	热重载
config.yml	核心运行：默认助手、执行引擎、限流、日志	✅ /ark reload
session.yml	会话与记忆：历史管理、压缩策略、记忆系统	✅ /ark reload
interaction.yml	交互体验：聊天格式、反馈、私聊、工具显示	✅ /ark reload
tools.yml	工具与扩展：外部脚本、扩展包、蓝图系统	✅ /ark reload
models.yml	模型与提供商：API Key、默认模型、自定义端点	✅ /ark reload
storage.yml	数据存储后端：文件 / MySQL / PostgreSQL	⚠️ 需重启

此外，每个助手有独立配置，参见助手配置。

配置优先级

助手配置（assistants/{id}/config.yml）     → 最高
全局模型配置（models.yml defaults）         → 模型默认值
全局核心配置（config.yml / session.yml 等） → 行为默认值
代码硬编码默认值                             → 兜底

配置项	覆盖来源
模型（model.primary / temperature）	助手 → models.yml defaults
会话 token（session.maxContextTokens）	助手 → session.yml
记忆开关（memory.enabled）	助手 → session.yml
命令白名单（executeCommand.whitelist）	助手 → session.yml
API Key	providers → api-keys → 环境变量
存储后端	storage.yml（全局唯一）

数据目录结构

plugins/ArkPilot/
├── config.yml                    # 核心运行配置
├── session.yml                   # 会话与记忆配置
├── interaction.yml               # 交互体验配置
├── tools.yml                     # 工具与扩展配置
├── models.yml                    # 模型与提供商配置
├── storage.yml                   # 存储后端配置
├── SERVER.md                     # 全局服务器知识（需编辑）
│
├── tools/                        # 脚本工具目录
│   └── give-item/
│       ├── manifest.yml
│       └── main.js
│
├── expansions/                   # 扩展包目录（JAR）
│   └── economy-tools-1.0.jar
│
├── assistants/                   # 助手定义
│   ├── player-helper/
│   │   ├── config.yml
│   │   ├── SOUL.md
│   │   ├── IDENTITY.md
│   │   └── PLAYER.md
│   └── builder/
│       ├── config.yml
│       ├── SOUL.md
│       └── IDENTITY.md
│
├── skills/                       # 全局技能文档
│   ├── server-wiki/SKILL.md
│   └── building-basics/SKILL.md
│
├── data/                         # 运行时数据（仅 file 存储）
│   ├── sessions/{assistantId}/{playerUUID}.jsonl
│   └── memory/{assistantId}/{playerUUID}/
│       ├── preferences.md
│       ├── events.md
│       └── todos.md
│
└── logs/usage/                   # Token 用量日志