简介
本教程介绍如何使用 车万女仆档案（迁移）管理器（Maid File Manager），把车万女仆（Touhou Little Maid）的女仆导出为 .maid 文件并在不同游戏版本、不同加载器之间转移，同时用新增的「备份管理」把消失、或随崩溃存档一起失去的女仆救回来。
源码：https://github.com/zgxhzhr/MaidFileManager
问题反馈：`https://github.com/zgxhzhr/MaidFileManager/issues` ，或通过作者 B 站（逐光星火-执火人）联系
CurseForge：`https://www.curseforge.com/minecraft/mc-mods/maid-file-manager`
适用版本：Forge 1.20 / 1.20.1，NeoForge 1.21 / 1.21.1（1.4.3 起依赖范围放宽为 1.21～1.22，不含，1.21 原版也可加载），Fabric 1.20 / 1.20.1 / 1.21 / 1.21.1。四个游戏版本 × 三大加载器导出的 .maid 文件互通。本教程基于 1.6.0 编写。
主要功能：
把女仆导出为 .maid 文件，随时再导入回来；
跨版本转移：1.20 ↔ 1.20.1 ↔ 1.21 ↔ 1.21.1 导出的文件互相兼容，导入时自动完成数据迁移；
三大加载器支持：Forge、NeoForge、Fabric 全平台覆盖；
（导出的.maid互通！！）女仆档案管理：游戏内查看与编辑女仆档案（照片、职业、生日、个人资料、偏好、背景故事），导入前可只读预览 .maid 文件里的档案；
备份管理：浏览车万女仆自动产出的备份并导出为 .maid，可跨存档检索；女仆在存档中消失、甚至世界已崩溃打不开时，也能把女仆救回来；
药水效果跨版本迁移：导出时同时保存原版 NBT 与跨版本标准化双份数据，导入按目标版本自动恢复；
导出默认保留原女仆在世界，只是生成备份文件；若取消保留，导出前会弹出「危险操作确认」窗，防止误操作导致背包物品丢失；
饰品默认携带、可关闭：同版本导入完整保留附魔、耐久与数据组件，跨版本导入经版本转换同样保留属性，仅在数据无法解析或来源版本不明时才还原为同类型全新饰品；
饰品导入设置（OP 管控）：服务端可统一规定导入时是否丢弃饰品属性、哪些饰品禁止携带；整合包作者还可用 bauble_import.json 预设白 / 黑名单；
导入后可一键删除源文件，仅删除服务端确认生成成功的那批；
联机服务器支持 OP 统一导出全员女仆（需玩家本人同意，只写文件、永不移除女仆）；
附属数据迁移接口（SPI）：附属模组可自行接入，把不在女仆实体 NBT 上的数据随 .maid 一起迁移。
准备工作
新旧两个版本都需安装：本模组 + 车万女仆模组本体（Loader 与游戏版本要对号入座）。Fabric 玩家请安装社区非官方移植版 TLM。
认识四个文件夹（都在游戏根目录的 maid_file/ 下，与 mods 平级）：
maid_file/maid_exports/：导出结果，按玩家名分子文件夹：maid_file/maid_exports/<玩家名>/
maid_file/maid_imports/：导入来源，把要导入的 .maid 文件放这里
maid_file/photos/：女仆档案头像的候选图片，放入后在档案界面挑选（等比缩放，最长边不超过 512 像素，原图不超过 10MB）
maid_file/maid_photos/：档案头像图片库，模组按女仆 UUID 自动维护，请勿手动改动
旧版本（1.6.0以下）散落在游戏根目录的 maid_exports/、maid_imports/ 与 config/maid_file_manager/photos/ 会在首次启动时自动搬运并入 maid_file/ 下，无需手动处理。
打开界面：游戏内按 U 键（可在「选项 → 控制设置 → 女仆档案管理」中修改）。界面分为「导出」「导入」两个 Tab，列表下方有「档案」按钮，标题栏有「备份」按钮。
女仆档案功能
车万女仆本体没有集中查看、编辑女仆「个人资料」的地方，本模组补上了这一块。
查看与编辑
在列表里点击一只女仆选中，再点下方的「档案」按钮，即可打开该女仆的档案；
档案分两块：基础信息（女仆 ID、姓名、阵营、血量、攻击、好感度、职业、生日、渡劫标记）与个人档案（个人资料、偏好与技能、背景故事）；
「姓名」栏：女仆设有命名牌（自定义名称）时显示自定义名称，否则回退显示模型名；
「渡劫」标记：读取车万女仆的雷击标记，被雷劈过的女仆会显示，导入预览状态下也可查看；
头像照片
在档案界面点「选择照片」，会列出 maid_file/photos/ 下的候选图片供挑选，也可用「打开图片文件夹」按钮直接打开该目录；
图片超出限制会自动等比缩放（最长边 512 像素），原图不超过 10MB；
选好的头像保存为 maid_file/maid_photos/<女仆UUID>.png，由模组按女仆 UUID 自动维护，不要手动改动其中文件；
导出时头像会一并打包进 .maid 文件，导入后仍然保留。
导入前的只读预览
在「导入」Tab 的列表里点某条 .maid 文件选中，再点「档案」按钮，可以只读预览这个文件里的女仆档案——导入之前就能确认是不是你要的那只；
预览模式不能编辑；好感度等读数取自文件内数据，基础生命与攻击显示为占位符；
背景故事等多行内容较长时，可用滚轮上下滚动查看全文；
预览同样显示「渡劫」标记（读文件内的雷击标记）。
导出步骤
按 U 打开面板，停留在「导出」Tab；
站到女仆附近再点「刷新」——列表只显示你周围 128 格内属于你的已驯服女仆；
点击列表项勾选要带走的女仆（支持多选，也可点「全选」）；
点「导出选中女仆」，底部会提示保存路径，例如：成功导出 2 个女仆！文件已保存到 maid_file/maid_exports/<你的玩家名>/…；
也可以直接点「打开导出文件夹」跳转到输出目录。
「保留原女仆在世界」默认开启：导出只是备份，女仆仍留在原世界。如果这次是搬家、不想在旧世界留副本，把这个开关关掉再导出——此时会先弹出「危险操作确认」窗，明确提示选中女仆背包内的物品会全部丢失（导出不保留背包），确认后才真正导出；导出前请先把女仆身上的物品取回。
确认窗里可以勾选「不再提示」，勾选后当前存档（或当前服务器）以后不再弹窗；该选择只对当前存档 / 服务器生效，不影响其他存档。想恢复提示时，到设置界面打开「当前存档：导出并移除女仆时不再二次确认」开关即可，详见下文「联机开关」。
转移 .maid 文件
打开旧版本游戏目录下的 maid_file/maid_exports/<你的玩家名>/；
复制要带走的 .maid 文件；
粘贴到新版本游戏目录下的 maid_file/maid_imports/ 文件夹（没有就手动新建一个）。
注：.maid 文件是自包含的：直接复制、重命名都不影响导入。文件名「中文名_时间戳_短UUID.maid」只是默认生成规则，重名会自动追加 _1、_2。
导入步骤
进入新版本存档，按 U 打开界面，切到「导入」Tab，点「刷新」；
列表会显示 maid_file/maid_imports/ 下的所有 .maid 文件，点击勾选（可多选 / 全选）；
可选：勾选「导入成功后删除源文件」开关（默认关闭，开启后仅删除服务端确认生成成功的那批，失败文件原样保留）；
点「导入选中文件」；
女仆会出现在你身边的安全位置（不会卡在地下）。
实体 UUID 与旧世界那只不同，但并非随机：由「源女仆 UUID + 导入玩家 UUID」确定性派生——同一玩家对同一文件多次导入结果恒定，不同玩家分享同一文件也互不冲突。
注意：1.6.0 起，导入界面不再提供「保留饰品」开关，饰品是否随行统一由「设置 → 服务端设置 → 导入时允许携带饰品」控制，防止非 OP 玩家绕过服务端管控，详见下文「联机开关」。
导入成功提示：女仆已成功导入到你的身边！
注意：如果源女仆仍活在当前世界（比如你保留原女仆导出后，又把同一个文件导回同一个存档），导入会被前置拦截并提示「这位女仆仍存在于当前世界，再导入会产生重复个体」。这是防重复保护，处理办法见文末 FAQ。
备份管理
1.6.0 新增。车万女仆会自动为每只女仆生成备份文件，但它们散落在存档目录里、文件名是一串 UUID，真要找的时候基本无从下手。备份管理把这件事变成了可视化操作：
入口有两个：进入世界后按 U 唤出界面、点标题栏的「备份」按钮；或在游戏主菜单点「备份管理」——后者不需要进入任何世界；
列表按「存档 → 玩家 → 女仆 → 备份文件」四层展开，同一女仆的多个备份按时间倒序排列；
权限：OP（权限等级 2）可见并导出全部玩家的备份；非 OP 也能查看并导出自己名下的备份；
专业服务器由服务端代读并回传，服务端只读——不写入、不删除任何数据；
导出的 .maid 文件一律落在客户端的 maid_file/maid_exports/<玩家名>/。
两个典型用途：女仆在存档里意外消失后，用它在备份里把女仆救回来；存档崩溃打不开时，从游戏主菜单就能读到该存档的备份，把女仆导进新世界（救回的女仆不含背包）。
详细流程见配套教程《如何管理车万女仆自动备份文件，如何拯救在服务器/单人存档中完全消失的女仆，如何拯救崩溃世界女仆？（均不含背包）》。
数据保留情况
主人驯服关系：保留
名字 / 模型：保留
女仆档案：保留（照片、职业、生日、个人资料、偏好、背景故事；照片随 .maid 一并打包）
血量：按好感等级恢复为车万女仆本体的标准血量（满好感 80，渡过雷劫的女仆 100），其他模组直接抬高的基础血量不随女仆迁移，保证联机导入公平；饰品 / 词条等附属提供的血量加成会在女仆入世界后自动恢复，满血女仆导入后不会掉血
攻击力：同样恢复为本体按好感等级计算的标准攻击力；饰品 / 词条加成入世界后自动恢复
AI 对话数据：保留（AI 人设、聊天历史、摘要、token 用量跨版本完整迁移）
饰品：可选保留（默认开启，规则见下）
药水效果：可选保留（默认开启，规则见下）
进度（成就）：可选保留（默认开启，规则见下）
无敌状态（替身地藏赋予）：默认不保留（1.6.0 起默认值由开启改为关闭），可由服务端开关开启
背包与手上物品：不保留（导出前请先取回女仆身上的物品；取消「保留原女仆」导出时会弹窗二次确认）
原 UUID / 着火、坠落等运行时状态：不保留（导入时按「源女仆 + 导入玩家」派生 UUID，避免跨存档冲突）
饰品规则
仅恢复 touhou_little_maid（车万女仆本体）与 touhou_little_maid_spell（万法皆通 / 法术附属）两个命名空间的饰品；
同版本导入（如 1.21.1 导出、1.21.1 导入）：完整保留饰品的附魔、耐久、数据组件等全部状态；
跨版本导入（含 1.21.1 → 1.20.1 反向）：经版本转换——1.20 → 1.21 走官方数据升级，1.21 → 1.20 走数据组件格式手动降级——同样保留附魔、耐久、无法破坏与基础数值；仅在数据无法解析或来源版本不明时才还原为同类型全新饰品，绝不带坏物品进世界；
新世界缺少该饰品时自动安全跳过，不会导致崩溃；
服务端可用「导入时允许携带饰品」开关统一管控（默认开启，禁止时饰品被丢弃）；另有「设置 → 饰品导入设置」中的「导入时丢弃饰品属性」与「禁用携带的饰品」清单（默认保留属性、默认空清单）；
整合包作者可在 config/maid_file_manager/bauble_import.json 中预设白 / 黑名单，文件存在即生效并托管，游戏内（含 OP）不可更改；文件解析失败时拒绝导入全部饰品并输出错误日志；
导入后被丢弃或还原为全新物品的饰品会逐件反馈原因，列表放不下的说明仍会完整送达聊天栏。
药水效果规则
导出时同时保存两份数据：原版 NBT（active_effects，供同版本 / 同加载器直接恢复）与跨版本标准化数据（normalized，供跨版本迁移时按目标版本重建）；
1.20 与 1.21 的效果列表键名不同（ActiveEffects / active_effects），读取端双键名都能识别，跨版本不再出现药水效果丢失或异常；
万法皆通结构女仆的 11 种固定常驻效果（minecraft:regeneration/strength/resistance/speed、irons_spellbooks:vigor/blight/true_invisibility/abyssal_shroud、goety:save_effects/leeching、youkaishomecoming:native_god_bless）按「效果 ID 命中白名单 AND Duration=-1」双条件判定；
禁药水服务器下，这 11 种常驻效果会被写入持久化标签保留（不显示和作用于女仆身上，但数据不丢），再次导出可恢复到允许药水的世界；
联机时服务器可用「导入时允许药水效果」开关统一管控（默认开启，禁止时非万法皆通白名单的药水效果被丢弃，白名单内的常驻效果仍按上述规则中转保留）。
进度规则
可配置是否还原女仆成就进度（自定义成就、击杀统计等）；
联机时服务器可用「导入时允许携带进度」开关统一管控（默认开启，禁止时进度数据不写入）。
联机开关
服务端开关（OP / 联机宿主可改，客户端进服自动同步）：
允许客户端导入女仆：关闭时所有玩家的导入都会被拒绝。
导入时允许携带饰品：关闭时导入的饰品会被丢弃。
导入时允许携带进度：关闭时导入的进度数据不写入。
导入时允许药水效果：关闭时非白名单药水被丢弃，万法皆通常驻效果经持久化标签中转保留。
导入时允许携带无敌状态（替身地藏）：默认关闭（1.6.0 起由默认开启改为默认关闭），开启后源女仆的无敌状态才随导入迁移。
另有「饰品导入设置」两项（同样属于服务端配置、仅 OP 可改，非 OP 进入只读）：「导入时丢弃饰品属性」（默认关闭，即保留属性）与「禁用携带的饰品」清单（默认空，命中即丢弃）。
玩家本人的客户端开关：
允许服务端统一导出你的女仆：默认关闭，玩家同意后 OP 才能在统一导出中导出该玩家的女仆
当前存档：导出并移除女仆时不再二次确认：默认关闭（即每次都弹窗确认）。这是导出确认窗里「不再提示」对应的设置项，按存档 / 服务器分别记录，在这里可以随时把某个存档的确认弹窗重新打开
普通玩家：导出文件保存在自己电脑的 maid_file/maid_exports/；导入时把 .maid 文件放进自己客户端的 maid_file/maid_imports/，由游戏读取后发给服务器校验执行（文件无需上传给服务器管理员）。
服务端统一导出
在「导出」Tab 点「统一导出」进入统一导出模式（按钮变为「返回单独导出」，随时可切回）；
列表按玩家分组显示：▼ 玩家名（N 只女仆），点击可展开 / 收起；未同意导出的玩家会标注 [未同意导出]，选中其女仆提交时会被服务端拒绝；
勾选要导出的女仆（每位玩家的女仆以该玩家为中心 128 格内搜索，远离出生点的玩家也能被找到）；
点「通过服务端导出选中女仆（存到服务端）」→ 确认界面点「确认导出」；
服务端异步处理，结果查看聊天栏 / 服务器日志；文件保存在服务端的 maid_file/maid_exports/<玩家名>/。
注意：
统一导出只写文件、永不移除女仆，不会动其他玩家世界里的任何女仆（该模式下「保留原女仆」开关自动隐藏，也不会弹出移除确认窗）；
命令方式：OP 可执行 /maidfile exportall，一键导出所有已同意玩家周围 256 格内的女仆，同样输出到服务端 maid_file/maid_exports/<玩家名>/。
关于统一导出范围的设计说明
很多玩家以为这个功能可以一次性打包整个服务器的所有女仆，但实际上它受设计约束：
若允许玩家直接查看他人女仆列表，可能带越权与导出纠纷；
部分女仆可能身处未加载区块，或被封进魂符、相片、胶卷等容器内，统一汇总在技术上无法覆盖这些场景。
因此实际方案是：每位玩家能导出的范围仅限其半径 128 格以内、由自己驯服的女仆；服务端统一导出本质上就是把每位玩家各自能看到的这份列表汇总后交给联机宿主——只有玩家在线、且女仆在其加载范围内，才能被纳入统一导出。换整合包或灾备备份时，请提前通知玩家集中到主城或各自把女仆带到身边。
FAQ
按 U 没反应？
检查按键绑定（控制设置 →「女仆档案管理」），默认键位 U 可能被其他模组占用。
女仆档案在哪里看？照片放哪？
按 U 打开面板，点击列表里的女仆选中，再点「档案」按钮。头像候选图片放在 maid_file/photos/，在档案界面点「选择照片」挑选；原图不超过 10MB，超出会自动等比缩放到最长边 512 像素。选好的头像存在 maid_file/maid_photos/，由模组按女仆 UUID 自动维护，请勿手动改动。
导入界面的「保留饰品」开关去哪了？
1.6.0 起已移除。饰品是否随行统一由「设置 → 服务端设置 → 导入时允许携带饰品」控制，防止非 OP 玩家绕过服务端管控。
女仆消失了 / 存档崩溃了，能救回来吗？
能。女仆在存档里意外消失时，按 U → 点标题栏「备份」按钮，在自己的自动备份里挑时间点导出为 .maid 再导入；世界已崩溃打不开时，直接从游戏主菜单点「备份管理」——不需要进入世界就能读到本机所有存档的备份。救回的女仆不含背包。详见配套教程《如何用车万女仆档案管理器管理自动备份与拯救女仆》。
导出列表是空的？
列表只显示你周围 128 格内属于你的已驯服女仆，走近女仆后点「刷新」。
导出时弹出的确认窗是什么？能关掉吗？
当你取消勾选「保留原女仆在世界」时，导出会真正移除选中的女仆，而女仆背包内的物品无法随 .maid 迁移，所以会弹窗二次确认，防止误操作。确认窗里勾选「不再提示」后，当前存档 / 服务器以后不再弹窗；想重新开启，到设置界面把「当前存档：导出并移除女仆时不再二次确认」关掉即可。该选择按存档分别记录，在 A 存档关闭弹窗不影响 B 存档。OP 的统一导出只写文件、不移除女仆，不会弹这个窗。
导入提示「女仆仍存在于当前世界」怎么办？
这是重复导入保护：源女仆还活在这个世界里（在身边，或被收在魂符 / 相片等容器中，存活登记仍在），再导入会产生同 UUID 的重复个体。两种正确用法：① 搬家到新存档：旧世界导出时取消「保留原女仆在世界」，实体会被移除且存活登记一并清除，新存档即可正常导入；② 就是想在本存档再要一份：请先解散 / 移除原来的女仆（或等其死亡）后再导入。
1.20 导出的文件能在 1.21 导入吗？反过来呢？
都能。1.20 / 1.20.1 / 1.21 / 1.21.1 四个版本的 .maid 文件互相兼容，导入时自动迁移数据。
低版本管理器导出的 .maid 文件，高版本能导入吗？
可以。高版本管理器向下兼容低版本（含 1.3.x、1.4.x、1.5.x）导出的 .maid 文件，导入时会自动完成数据迁移。
但高版本导出的文件可能包含低版本管理器不认识的新字段，用低版本管理器导入会失败，建议两端版本保持一致或都用高版本。特别地，1.6.0 起新增的 profile（女仆档案快照）字段，在旧版本中会被忽略。
Fabric 版本能用吗？
可以。本模组已完整支持 Fabric 1.20 / 1.20.1 / 1.21 / 1.21.1，请安装社区非官方移植的 TLM Fabric 版。
导入被拒绝？
两种常见提示：①「服务器不允许导入」——服务器的「允许客户端导入女仆」处于关闭状态，请联系管理员开启；②「女仆仍存在于当前世界」——见上文重复导入保护的处理办法。
饰品丢了？
四种可能：① 服务器禁止携带饰品；② 饰品不属于车万本体 / 万法皆通（法术附属）命名空间；③ 当前世界没有注册该饰品（自动安全跳过）；④ 饰品被服务端「导入时丢弃饰品属性」或「禁用携带的饰品」清单拦下，或被整合包 bauble_import.json 白 / 黑名单拦下。只有数据完全无法解析、或来源版本不明时，饰品才会被还原为无附魔的全新同类型物品。同版本与跨版本导入都会尽量保留附魔与耐久，导入后聊天栏会逐件反馈处理结果与被处理的原因。
药水效果丢了？
先检查服务器是否开启「导入时允许药水效果」。若服务器禁药水但女仆是万法皆通结构女仆，其 11 种固定常驻效果会写入持久化标签保留（不在女仆身上显示），再次导出到允许药水的世界时可恢复；其他普通药水效果在禁药水服务器下会被丢弃。另外 1.4.3 修复了 1.21 系药水效果导入后整体丢失的问题，请确认两端都更新到 1.4.3 或更高。
女仆的无敌状态（替身地藏）没了？
1.6.0 起该状态默认不随导入迁移。需要保留时，请联系服务器管理员打开「导入时允许携带无敌状态（替身地藏）」开关（单机 / 局域网主机则自己在设置中打开）。
导入后女仆会出现在哪里？
你身边的安全位置，自动避免卡在方块里 / 地下。
跨版本导入后模型不对？
请确保本端或联机主端有对应模型，否则会变成博丽灵梦。导入后重新选择模型即可。
导入后源文件会被删吗？
默认不会。只有你主动勾选「导入成功后删除源文件」开关，且仅删除服务端确认生成成功的那批文件，失败文件原样保留。
导入不进去？
先确认这个女仆是不是你的：只有属于你的已驯服女仆才能被导出和导入。如果确认是你的女仆，再排查：
正版玩家：检查是否用了离线账号登录。正版 UUID 和离线登录时临时分配的 UUID 对不上，女仆不会认你。
离线账号玩家：检查你的游戏名是否和导出时一致。离线登录下 UUID 由游戏名决定，更换游戏名会导致 UUID 变动。
导入后血量 / 攻击力变低了？
血量与攻击力的基础值会无条件回归车万女仆按好感等级计算的标准值（满好感 80、渡劫 100），其他模组靠全局倍率抬高的数值不会迁移，这是联机防刷的公平性设计。饰品、词条等合法加成会在女仆入世界后自动附加，满血导入也不会掉血；若入世界后数值仍明显异常，检查对应附属模组是否已安装。
界面文案以游戏内显示为准
