适用源码：9da0beb8e8fdad85f50d7039408c3d98494e91c7。本文记录源码行为，默认配置不等于实服配置。
设计状态：按现状编写，具体业务批准记录未逐项核定；开发状态：下述能力有实现证据，限制单列；验证状态：完成定向源码核对，未执行自动测试或实服验收。

先辨认配置来源

仓库 resources 是默认值，服务器插件数据目录才是运行配置。费用、禁用项、图纸与配方开放不因 Wiki 描述自动生效。发布应记录 Git 提交、配置差异和客户端资源版本，不公开整份生产配置。

当前迁移行为

ConfigMigrator 先加载校验默认与已有文件，检查配置版本，再备份变更文件、写临时文件并替换；尽量保留已有值和显式空映射。版本过新或 YAML 解析错误不能当空配置覆盖。
迁移涉及文件分批，不能宣称文件系统与数据库组成同一事务。失败保留原文件与备份，核对报告后处理，不手动调高版本号跳过。

不覆盖运行资产

同步保护清单覆盖数据库伴随文件、玩家运行数据、日志、备份及部分运行配置。正式资源 ZIP 为精确例外。脚本和具体保护规则在 Git 维护，不在本页复制所有路径，也不发布任何密钥内容。

装备和订单版本

历史 EquipmentSpec 按 id+version 查找，不能缺历史版本时改用最新版。已有订单保存工艺、规则与模板，更新配置不重新随机。配方目录和物品目录的首次安装/补齐策略不同，不假定换 JAR 会覆盖已有配置。

生效和验收

当前没有通用 /facility reload。配置多形成启动快照，计划重启后确认实际加载；CE 资源重载不是业务配置热更新。修改前验证 YAML、引用、非负金额、经济精度及合法组合，在隔离环境核对历史数据与新数据，不将静态检查当实服验收。
保留配置、数据和产物的匹配恢复点；发现代码与文档差异先核对消费者，不擅自用 Wiki 创造规则。

来源

folia_plugin/src/main/java/com/flrv/infrastructure/config/ConfigMigrator.java#migrate、EquipmentConfigLoader.java（同 config）；folia_plugin/src/main/resources/config.yml；scripts/plugin-sync-protect.txt；docs/部署与资源维护.md、docs/装备配置与数据规范.md。
相关：运行环境、装备实现。