﻿FM27 -> EA FC 27 「亲自上场」 0.3.1-1.3.1
================================================

这是什么
--------
在《足球经理27》里，到比赛日的阵容界面点「亲自上场」，本工具会把这场比赛的两队阵容（球员、能力）转成 EA SPORTS FC 27 能读的阵容文件，
自动启动 FC 27、直接开球；你在 FC 里亲手踢，踢完后退出 FC，会弹出一个确认窗口，选“接受”之后，FM 里这场比赛就按你在 FC 踢出的比分、进球人、助攻记录结果
（积分榜、新闻、球员的进球数都会跟着走），FM 自己不再模拟这场。

需要先有
--------
 1. 《足球经理27》（Steam 版）。
 2. EA SPORTS FC 27（Steam 版），并且至少正常启动过一次，保存过阵容文件。阵容请更新到官方最新（本工具以安装那一刻的阵容为底稿）。
 3. 「FC 27 Live Editor」：安装包已附带 Live Editor（经作者授权，版权归原作者，详见 files\le\来源与授权.txt；仅限离线使用，请勿用于在线模式），已装过的继续用你自己的，不覆盖、不重复装。
 本工具会往 Live Editor 的数据文件夹（一般 C:\FC 27 Live Editor）里放几个界面流程覆盖文件、在 le_config.json 里打开日志开关（首次还没运行过 Live Editor 时会在首次启动后自动补设；都有备份，卸载时还原）。
 系统：Windows 10/11 64 位。不需要管理员权限，不需要另装 Python。

安装
----
 1. 把压缩包整个解压（不要在压缩软件窗口里直接运行）。
 2. 退出 FM27、FC 27 和 Live Editor 启动器。
 3. 双击「一键安装.bat」。它会自动找到游戏；如果你已装过 Live Editor 就继续用你自己的，没装过会自动安装附带的 Live Editor。游戏文件夹找不到的会弹出选择文件夹的窗口让你指一下。
    想先看看它会做什么：在命令行运行  powershell -ExecutionPolicy Bypass -File files\install.ps1 -DryRun   （只显示，不改动）。
 4. 安装做的事：
    - 程序复制到 %LOCALAPPDATA%\FMFC（含自带的 Python，不动你系统里的 Python；未装过 Live Editor 时一并把附带的 Live Editor 装到 %LOCALAPPDATA%\FMFC\le）；
    - FM27 游戏文件夹：如果还没有 BepInEx 就装上 BepInEx（开源插件加载器），再放 BepInEx\plugins\FmFc\FmFc.dll。已经有 BepInEx（比如你装过别的 FM 插件）就不动它；
    - Live Editor 数据文件夹（一般 C:\FC 27 Live Editor）：mods\legacy\data\ui\nav 里放 4 个界面流程文件（只做这几件事：跳过几屏欢迎画面（EA 片头照常播）、在主菜单自动进入开球模式、赛前界面自动开始比赛；登录和账号验证流程原样不动；同名文件会先备份），
      le_config.json 里把 log_load_legacy_file 打开（先备份；如果还没运行过 Live Editor、le_config.json 尚未生成，会记下待办并在首次启动后自动补设）；
    - 把你 FC 27 设置文件夹里最新的官方 Squads 阵容文件复制一份当「底稿」；
    - 注册一个「当前用户登录时启动」的计划任务「FMFC-亲自上场-监听」，常驻后台等 FM 里的按钮，并立刻启动它。

怎么用
------
 1. 启动 FM27，读档，推进到有你的比赛的那一天，进到那场比赛的阵容/选人界面。
 2. 点界面上的「亲自上场」按钮。（第一次用，先打开 http://127.0.0.1:18767/ 看一下插件的状态页。）
    点按钮后先弹出「本场比赛设置」窗口：选难度、半场时长，勾选受伤/越位/出牌/手球，点「开始」才会启动 FC；点「取消」这场就不踢，由 FM 自己模拟。勾上「记住为默认」下次就用这次的选择当初始值。
 3. 稍等约 30–60 秒，FC 27 自动打开并开球。你来踢。
 4. 终场哨响、看到结算后，退出 FC（不要在比赛中途退）。FC 全屏时弹窗看不见，所以确认窗口等你退出 FC 之后才会弹出（置顶，任务栏里也能看到）。
 5. 在弹出的窗口里选：
    - 「接受，写回 FM」：把比分和进球人写回 FM，回 FM 点跳过比赛，这场就按你在 FC 里的结果结算，FM 不再模拟；
    - 「重新踢（重新打开 FC）」：不满意就再来一次，FC 会重新自动开球（球队不变）；
    - 「放弃，让 FM 自己模拟」：什么都不写回，这场由 FM 自己模拟。
    没有踢完（中途退出了）时窗口只有「重新打开 FC 再踢」和「放弃」两个选项。
    直接关掉这个窗口不算选择：有结果时会再问你（最多 3 次，之后当作放弃，不会替你写回）。
 6. 在 FC 里可以连踢好几场（踢完回菜单再开球，球队保持不变）：以最后一场完整踢完的为准。换了别的球队踢的那几场不算数，也不会写回。
    想保留旧做法（终场哨一响就自动写回，不弹窗）：在 %LOCALAPPDATA%\FMFC\config\options.json 里写  {"confirm_result": false}（文件不存在或写坏了就按默认的“弹窗确认”）。
 两个要点：FC 27 开机载入的是你上次手动载入的阵容文件，本工具改写的就是这个文件（见下面「注意」）；比赛过程中不要把 FC 切到后台（会暂停）。

限制（请先知道）
----------------
 - 只支持「离线 Kick Off（友谊赛）」，不是生涯模式/线上模式。
 - FC 27 里没有的俱乐部，会用一支「替身球队」顶上（队名改成 FM 里的名字，队徽尽量换成 FM 的队徽，缩写可能不对）。
 - 球衣用的是 FC 里那支球队自己的球衣（不会换成 FM 里的）。
 - 球员能力是按公式从 FM 换算的，不会和 FC 官方数值完全一样。
 - 不传递：体能/疲劳、伤病（FC 里的伤病、体能不会带回 FM）。
 - 打平后的加时/点球：FM 这边遇到加时或点球大战的比赛不会改写（以插件页面提示为准）。
 - 对 FM27 / FC 27 的游戏更新很敏感：游戏大更新后可能要等本工具更新。

注意
----
 - 本工具会改写这一个文件（FC 的阵容文件）：<FC 设置文件夹>\Squads…（安装时会显示具体文件名）（安装后会显示在安装窗口里，路径也记在 %LOCALAPPDATA%\FMFC\config\paths.json）。
   如果第一次踢发现球队/球员不对：在 FC 里手动载入一次这个阵容文件，再退出游戏重试。
 - 每次开球前它还会改写你 FC 个人设置文件里「上次比赛的两支球队」，并先做备份（%LOCALAPPDATA%\FMFC\data\settings-backups）。
 - FC 27 在运行时它不会动任何文件；FC 没退出时 FM 里再点「亲自上场」会被拒绝。
 - 确认窗口没点之前，这一轮还算“进行中”：FM 里再点「亲自上场」会被拒绝，自动更新也会等。

更新
----
 - 本工具会自己检查更新：后台监听程序启动时、之后每 12 小时，向 https://fm.juyiba.com/fmfc/ 看有没有新版（更新清单带签名，只装签名对得上的版本）。
   有新版就先在后台下载并校验；等 FM27、FC 27、Live Editor 启动器都没在运行、也没有比赛流程在进行时自动安装，装好后弹窗告诉你「已更新到 x.y.z」。
   你的设置（paths.json）、阵容底稿、Live Editor 里的备份都保持不变。
 - 下载页（最新版本、更新说明、常见问题）：https://fmfc.juyiba.com/
 - 想手动更新：双击 %LOCALAPPDATA%\FMFC\检查更新.bat（或安装包里的「检查更新.bat」）。更新前请先退出 FM27、FC 27 和 Live Editor 启动器。
 - 不想自动安装：把 %LOCALAPPDATA%\FMFC\config\update.json 里的 auto_update 改成 false，这样只会提示有新版，不会自己装。
 - 更新日志：%LOCALAPPDATA%\FMFC\updates\last-update.log；更新前的程序文件备份在 %LOCALAPPDATA%\FMFC\backup\app-before-update（更新失败会自动还原）。
 - 在线更新只替换程序文件、FmFc.dll 和 Live Editor 的界面流程文件（如果使用的是安装包附带的 Live Editor 且新版有更新也会一并替换；你自己装的 Live Editor 永不改动）；自带的 Python 运行环境不会被替换。
 - 更新后如果新版的监听程序连续 3 次启动都没能稳定运行（不到 1 分钟就退出），会自动还原成更新前的版本，并且不再自动安装这个有问题的版本。

卸载
----
 退出 FM27、FC 27、Live Editor 启动器，双击「卸载.bat」。它会：停掉并删除计划任务、把被本工具改写的阵容文件还原成底稿、把 Live Editor 里放的文件删除/还原（有备份的还原）、
 le_config.json 还原、删除 FmFc.dll；如果 C:\FC 27 Live Editor 是本工具为附带的 Live Editor 新建的且里面只剩 Live Editor 自己生成的文件，会问你要不要一起删（默认保留）；
 如果 BepInEx 是本工具装的，会问你要不要一起删（游戏里还有别的插件时一律保留）；最后删除 %LOCALAPPDATA%\FMFC（含附带安装的 Live Editor）。
 不会动你的 FM 存档和 FC 存档。（%USERPROFILE%\.fmfc 里是插件导出的比赛数据，可以自己删。）

日志在哪
--------
 %LOCALAPPDATA%\FMFC\fc27\runs\watch\watch_日期.log      常驻监听的日志（每天一个，保留 30 天）
 %LOCALAPPDATA%\FMFC\fc27\runs\<时间>\                      每场比赛一个文件夹：run.json（每一步和耗时）、fm2fc.log、fcboot.log、fcwatch.log
 FM27 游戏文件夹\BepInEx\LogOutput.log                           插件加载日志
 Live Editor 程序文件夹\Logs\                                    Live Editor 日志

反馈问题（发给作者）
--------------------
 遇到问题、有建议：双击 %LOCALAPPDATA%\FMFC\反馈问题.bat（安装包里也有一份「反馈问题.bat」，安装失败时也能用），
 或者在 FM「偏好选择 → 亲自上场」页、FM 插件网页（http://127.0.0.1:18767/）点「反馈」；也可以在网页上反馈：https://fmfc.juyiba.com/feedback/ 。比赛流程出错时也会问你要不要把这次的问题发给作者。
 会弹出一个窗口：写几句话说明问题，联系方式可以不留（不留作者没法回复你），可以选择附上日志和截图。
 - 日志：本工具的版本、设置、最近两场比赛的记录、后台监听日志、FM 插件日志里和本工具有关的行。发送前自动去掉 Windows 用户名、用户文件夹路径、
   邮箱、密钥和令牌、SteamID；点「查看将发送的日志」可以先看一遍。
 - 截图：点开窗口之前拍下的整个屏幕，点「查看截图」可以先看；不想发就取消勾选。
 内容只发给作者本人，不公开。发送成功会给一个反馈编号，发出去的内容在 %LOCALAPPDATA%\FMFC\fc27\feedback\<编号>\ 留一份；
 没发出去（比如没网）时你写的话不会丢，保存在同一个文件夹的 unsent.txt。
 不想在比赛出错后看到「发给作者」的提示：在 %LOCALAPPDATA%\FMFC\config\options.json 里写  {"feedback_offer": false}。
 命令行：反馈问题.bat --preview 只生成日志并用记事本打开，不发送。

出问题时
--------
 - 按钮点了没反应：看 watch 日志最后几行；确认计划任务在运行（任务计划程序里的「FMFC-亲自上场-监听」）；确认 FC 没在运行。
 - 想手动重启监听：注销再登录，或者在 %LOCALAPPDATA%\FMFC\tools 里运行  powershell -ExecutionPolicy Bypass -File watch_service.ps1 start
 - 想看状态：同一个脚本加参数 status。
