﻿FM LLM ——《足球经理27》大模型对话插件    版本 0.30.17

一、这是什么
在游戏里用中文（或英文）和球员、经纪人、董事会、职员、对方俱乐部自由聊天。回答由你选的大模型生成（ChatGPT 套餐，或各家 API）。
对方的心情、合同要求、和你的关系这些，都实时从游戏里读出来。
  - 球员资料页"操作"下面多一个"私下谈谈"按钮。在球员资料页按 F8 或点右下角"AI 对话"，效果一样，都是和这名球员聊。
  - 游戏主动找你谈话时（球员来办公室、经纪人约见），聊天栏会自动接上；你打的字会对应到游戏原生选项，替你点。
    不想让它自动接上：偏好 → "AI 插件"标签 → 关掉"游戏找你谈话时自动接上聊天栏"，马上生效。关掉后这类谈话只按游戏原来的方式进行，
    聊天栏只在你自己打开时才出现（球员页的"私下谈谈"、F8、右下角"AI 对话"）。
  - 聊天栏开着时，游戏画面会整体缩小到约 76%，给聊天栏让出位置，不再遮住右边和底部的按钮；关掉聊天栏或把它拖成浮动窗口就恢复全宽。
    嫌字太小可以在"偏好 → AI 插件"页关掉"聊天栏开着时缩小游戏画面让出位置"（关掉后聊天栏盖在游戏上）。
    屏幕较窄时聊天栏会跟着收窄（1440×900 也能让位）；宽度不到约 1430 像素时缩小后字太小，就不缩小，聊天栏照旧盖在游戏上（那一页写着本机的情况）。
  - 合同谈判页：和经纪人聊定的条款会自动填进谈判表，提交时游戏会接受这份谈好的合同。
    表上没有的条款（每年加薪、进球达标奖金、欧冠夺冠奖金、俱乐部续约选项等）也会自动用"增加奖金 / 增加条款"加上。
  - 承诺页（谈合同前的出场时间、合同开始日期等承诺）：在聊天里和经纪人谈，他会守住自己的要求，但能被说服。
    他明确接受某一版后，聊天栏会提示"已登记"：先点"建议约定"，游戏里的经纪人会同意这一版，再点"确定承诺"进入条款谈判。
    谈妥后又把表改低、或者加了没谈过的承诺，就由游戏自己判断。
  - 职员资料页（助教、门将教练、球探、队医……）也有"私下谈谈"，按 F8 也一样：他按自己的个性、能力和岗位跟你聊，
    记得以前聊过什么。本队职员谈完，对你们关系的影响会写回游戏。别队的职员也能聊，只是会保持距离，关系不改。
  - 转会报价表（球员页 操作 → 开价）：聊天栏"说给"那一排多一个"对方俱乐部"，由卖方俱乐部的人跟你讨价还价。
    他按身价、合同、是不是主力来要价，不会一压就降。谈妥后插件把费用、附加金额、附加条款填进报价表并登记，
    聊天栏提示"已登记，提交后对方会接受"；"开价"由你自己点，对方在游戏下一次处理时（一般是点"继续"之后）接受。
    谈妥后又改了表、表上有没谈过的条款、或者球员在答复前已经去了别的俱乐部，就由游戏自己判断。
    带分期付款的报价（一项分期，首付可以是 0）也一样会登记，条件是对方亲口把首付、每6或12个月、分几期、分期合计在一句话里说全；
    他只说"成交"、数字有一个对不上，就只填表、不登记，聊天栏会告诉你缺什么。
    买人的报价登记只在游戏开着时有效：答复前存档退出再读档，这份报价就交给游戏判断。
    不想要"一定被接受"，在"AI 插件"页关掉"谈妥的转会报价一定被接受"：照样聊、照样填表，接不接受由游戏判断。
  - 卖人：在消息或转会活动里打开待回应的买方报价，按 F8 或点"AI 对话"。买方给出具体条件后，回复"接受这份还价"。
    插件填入能修改的金额，保留原报价的分期和其它条款。核对后点"协商报价"，等游戏里的买方回复。
    试验功能"卖人还价登记"（默认关）：在服务的 config.json 的 features 里加 "sell_hook": true，并把游戏目录
    BepInEx\config\fmllm.core.cfg 里 [Hooks] 的 SellHook 改成 true，两边都开才生效。开着时买方只答应游戏可能接受的
    价：金额小（约 5000 英镑以下）时最多到原报价的 2 倍，正常价位（约 5000 英镑以上）最多高约 20%。只改了首付的
    还价会登记（买方原报价本身带附加条款或分期的不登记），对方第二天按这个价重新报价，你再点接受；价格以外的
    规则仍由游戏判断。默认关的原因：正常价位那道约 20% 的上限还没有游戏内的实测样本（只测过不超过 2 倍那道）。
  - 租入、租出：在租借报价表里和对方俱乐部谈。明确谈妥后可以填写租期、出场与未出场月费，以及借入方承担的工资比例。
    买断等额外条件请在游戏里核对和填写。报价由你提交，正式答复由游戏处理。
  - 聊完一段，模型判断这次谈话对士气、关系的影响并写回游戏（每次有上限，可以关）。
    资料页上的数值要等下一次点"继续"才刷新。
  - 记得以前谈过什么、许过什么承诺，承诺到期会自动核对。
每个功能都能在 偏好 → "AI 插件" 里单独开关。
插件的文字和对方回复的语言看同一页的"插件语言"：默认跟随游戏（游戏是中文就用中文，是韩语就用韩语；游戏是英文等其它语言时，Windows 是中文就用中文、是韩语就用韩语，否则用英文）。

二、需要什么
  1. Steam 版《足球经理27》，游戏语言是 简体中文、英文或韩语（插件要认谈判表等界面上的字，换别的语言很多功能会失灵）。
  2. Windows 10 / 11。
  3. Python 3.11 或更新版本。安装程序会检查，没有的话会告诉你怎么装。
  4. 一个大模型来源：ChatGPT 套餐，或者免费的智谱 GLM（见第四节）。

三、安装
  1. 先退出游戏。
  2. 把这个压缩包整个解压，在解压出的文件夹里双击"安装 Install.bat"（.bat 要和旁边的 files 文件夹在一起，
     别单独拖到桌面）。它会：
       - 自动找到游戏目录（找不到会让你粘贴路径）；
       - 游戏里还没有 BepInEx 的话，装上 BepInEx 6（开源的插件加载器）；
       - 把插件放进  游戏目录\BepInEx\plugins\FmLlm\
       - 把对话服务放到  C:\Users\你的用户名\FM-LLM\service\
       - 检查 Python。
     Windows 弹"是否运行"的安全提示时，选"运行"。
  3. 第一次启动游戏会比平时慢 1–3 分钟，期间别关游戏：BepInEx 要生成一次文件（它要的 Unity 基础库已经带在安装包里，不用联网下载）。之后就正常了。
     游戏刚更新过的话，第一次启动可能弹 Denuvo 激活窗口，这和插件无关，按提示激活就行。

四、选一个大模型（A、B、C 任选，可以都弄）
  A. 用 ChatGPT 套餐（Plus / Pro 等，效果最好，不需要 API Key）
     进游戏 → 偏好 → "AI 插件"，在"ChatGPT 套餐"那一行点 "Continue with ChatGPT"。
     浏览器会打开 OpenAI 的页面，在上面确认，保留"使用 ChatGPT 套餐"那一项。
     这是 OpenAI 官方给本机应用的登录方式。用量算在你的 ChatGPT 套餐里，
     可以在 chatgpt.com/settings/usage 查看，也能给 FM LLM 设每周上限。
  B. 免费：智谱 GLM（没有 ChatGPT 套餐就用这个，三步）
     1. 打开 https://bigmodel.cn ，用手机号注册登录（不用实名）。
     2. 右上角头像 → "API Keys" → "添加新的 API Key"，复制它。
     3. 双击压缩包里的"设置API密钥 Set API key.bat"，选 1，粘贴，回车。重启游戏就能用，不用再改设置。
     用的是智谱的免费模型 GLM-4-Flash：回答快（约 1 秒一句），但比 ChatGPT 平淡一些。
     智谱还有个更聪明的免费模型 GLM-4.7-Flash，可以在"AI 插件"页的备用模型里打开；
     不过它高峰时段经常排队、要等很久，默认没用它。
  C. 用其他 API Key（DeepSeek、Kimi、OpenAI、Claude、OpenRouter 等，一般要付费）
     双击"设置API密钥 Set API key.bat"，菜单里直接选：1 智谱、2 DeepSeek、3 Gemini、4 Kimi、5 OpenAI、6 OpenRouter
     （变量名自动对好，菜单里每一项都写着去哪申请 Key）；7 是其他（Claude 等），要自己输入变量名，
     变量名看 C:\Users\你的用户名\FM-LLM\service\config.json 里每一项的 "key_env"。
     注意：序号那一步只输入数字，Key 是下一步才粘贴。重启游戏后，在"AI 插件"页把"主模型"切到它：
     Gemini 选"Google Gemini 3.8 Flash（按量）"。Gemini 在国内直连不上，要能访问 Google 的网络环境
     （系统代理或 TUN 模式都行）。
     注意：智谱、Kimi、MiniMax、阿里百炼、火山方舟、腾讯、百度、讯飞等的"Coding Plan / Token Plan"编程套餐，
     大多在条款里写明只能在编程工具里用，不许接别的程序。用了有被停套餐或封 Key 的风险，选中时设置页会显示提醒。
  D. 用自己的中转站或任何第三方 API 站点（直接在游戏里填，不用改 config.json、不用跑 bat）
     进游戏 → 偏好 → "AI 插件"，在"模型"下面的"第三方站点（自己的 API）"里填：
       接口类型：多数中转站选"OpenAI 兼容"；官方 Claude 或只给 Claude 格式的站点选"Claude 官方格式"；
                 站点文档写的是 /responses 的选"OpenAI Responses"。
       站点地址：例如 https://api.example.com/v1（OpenAI 兼容的地址通常以 /v1 结尾，只写主机名会自动补；
                 Claude 官方格式不带 /v1）。地址里不能带用户名密码或 ? 参数。
       模型名：照站点后台列出的模型名抄。
       密钥：直接 Ctrl+V 粘贴，框里只显示圆点。LM Studio、Ollama 这类本地服务不要密钥，随便填一串英文字母（比如 local）。
     点"保存并试一下"：会让对话服务真的调用一次这个站点；试通了才把"主模型"切到它，失败只保存、不切换，并告诉你原因
     （密钥不对 / 地址不对 / 模型名不对 / 连不上）。点"删掉这个站点"会删掉这一项配置和保存的密钥。
     密钥只保存在你电脑的 Windows 用户环境变量 FMLLM_CUSTOM_KEY 里，不写进 config.json，也不会出现在聊天、日志或反馈里。
     只有这一个第三方站点位置，再填一次会覆盖它。卸载工具和其它密钥一样不会删这个环境变量：想删就先点"删掉这个站点"。
     用的是别人的站点，你的聊天内容会发给它：用之前看清它的条款。
  默认设置是：先用 ChatGPT 套餐，没登录就自动用智谱免费模型。两个都弄了就用 ChatGPT。

五、开始玩
  1. 进游戏 → 偏好 → "AI 插件"，在"服务状态"那一行点"启动"。
     会开一个黑色窗口，那就是对话服务，玩的时候别关它；关掉它就是停止。
  2. 打开一名球员的资料页，点"操作"下面的"私下谈谈"（或按 F8），就可以打字聊了。
  3. 不想要哪个功能（比如把士气写回游戏），在"AI 插件"页点它的开关。
  建议：先另存一个存档再试。插件会改士气、关系这些数值（每次有上限，可以关）。

六、常见问题
  - 聊天栏说连不上对话服务：去"AI 插件"页点"启动"。黑色窗口里有报错就照着处理（比如没装 Python、没登录）。
  - 明明装了 Python，点"启动"还说找不到：0.25.5 起插件会自己去注册表和常见安装目录里找，一般不会再遇到。
    还是不行的话，把 Steam 完全退出（右下角托盘图标右键→退出）再打开游戏：游戏沿用 Steam 启动时的环境，
    Steam 开着的时候装的 Python 要重开 Steam 才看得到。另外要确认装的是 3.11 或更新的版本。
  - 聊天栏标题显示的是球员的外文名（比如 Pedri）：装了改动球员页的皮肤时，插件在页面上找不到中文名，就用游戏数据里的名字，功能不受影响。
  - "AI 插件"页显示"插件自检：有 N 项停用"：游戏更新后插件找不到对应的游戏代码，相关功能会自动停用，不会让游戏出错。等插件更新就好。
  - 日志：游戏目录\BepInEx\LogOutput.log；聊天记录在 C:\Users\你的用户名\FM-LLM\service\logs\
  - 隐私：聊天内容会发给你选的模型服务商。ChatGPT 登录信息存在 C:\Users\你的用户名\.fm-llm\，只在你自己电脑上。
    插件会连下载站 fm.juyiba.com：进游戏时查一次新版本（只带插件版本号）。关掉"进游戏时提醒新版本"后，只要"匿名使用统计"
    或"自动更新"还开着，也会查一次，只为"重要更新"的提示；三个都关就不连。
  - 匿名使用统计（"AI 插件"页的"匿名使用统计"开关，以前叫"统计在线人数"）。开着时插件会发两样东西：
    1）游戏开着时每 5 分钟报一声"在运行"，用来统计在线人数；
    2）0.29.4 起，每天发一份匿名计数，让作者看出大家实际碰到了哪些问题、碰到多少次。里面只有次数和固定的选项：
       - 出错：模型调用失败几次，按原因分（密钥不对、超时、连不上、服务器出错、限流、没设密钥、内容被拒）和用的是哪个预设模型
         （你自己起名的模型只记成"custom"）；插件报错几次；消息区自动修复几次；认错人后重建几次；自检哪几项没通过；
       - 功能：和谁说了几句（球员、经纪人、一起、职员、董事会、对方俱乐部、球队训话）；自动填合同成没成；
         合同、承诺、转会、转会兴趣这几处放行了几次；说服的结果；提交了几次反馈；
       - 体验：模型回复、读档后等资料就绪各用了多久（只记"3 秒内""3–6 秒"这样的区间）；屏幕宽度区间；让位开没开；
         游戏语言和插件语言；
       - 更新：从哪个版本更新到哪个版本，成没成，没成的话是哪一类原因。
       不发：聊天内容、球员和俱乐部名字、存档、密钥和环境变量的值、文件路径、Windows 用户名、电脑名、账号。
       在线心跳：服务器只留 IP 加盐后的指纹和国家代码，不留 IP。每日汇总：服务器不存 IP、指纹和国家，只按日期和版本把计数
       加在一起存（单份汇总不留）；为了防刷，当天在内存里用一个每天换一次的哈希数一数同一网络发了几份，不写进硬盘。
       还没发出去的计数存在 C:\Users\你的用户名\FM-LLM\metrics.json，可以打开看。
    怎么关：偏好 → "AI 插件" → 关掉"匿名使用统计"。马上生效：什么都不再发，还没发出去的计数也一起删掉。
    提示：装好 0.29.4（或以后的版本）后第一次打开聊天栏，顶上会有一条横条说明这件事，可以直接点"关掉统计"或"知道了"。
    每台电脑只出现一次；开关本来就关着的不会出现。横条出现之前不发每日汇总（在线心跳和以前一样照发）；横条出现以前那几天的
    计数永远不发，横条出现当天的计数要到第二天才发。

七、以后怎么更新
  0.29.4 起不用退游戏、不用关对话服务窗口，点一下就行：
  - 进游戏后有新版本时，右下角"AI 对话"按钮上方会弹出一条提示，点"现在更新"。
    也可以打开聊天栏，点标题下面"有新版 x"旁边的"现在更新"；或者 偏好 → "AI 插件" → "插件版本"那一行点"更新"。
  - 更新在后台进行，不弹窗口：下载、核对签名和文件，再替换插件和对话服务；设置和聊天记忆都保留。
    进度显示在聊天栏标题下面，结束后聊天栏里会说结果；没成功会写明原因，记录在 C:\Users\你的用户名\FM-LLM\update-last.log。
  - 对话服务开着的话，它会在自己的窗口里自动重启成新版，对话服务那部分的修复马上生效。
    插件本身（游戏里的部分）要下次启动游戏才换成新版。
  - 标着"重要更新"（红色）的版本修的是比较严重的问题，建议尽快更新；即使关掉了"进游戏时提醒新版本"，它也会提示（"匿名使用统计"和"自动更新"也都关着的话就不查了）。
  - "AI 插件"页的"自动更新"（0.29.5 起默认打开，不想要可以关掉）：有新版时自动在后台下载，等你不在谈话中时装好，装完在聊天栏说一声。
    从 0.29.4 升上来时，之前关掉的自动更新会被打开一次；之后自己关掉会保留。
  - 更新时报"certificate verify failed（证书验证失败）"：先核对电脑的系统日期和时间，再把杀毒软件的 HTTPS 扫描关掉；
    更新程序会先自动改用自带的根证书重试；证书校验仍失败时，会改为不验证证书下载，但发布签名和安装包 SHA-256 必须通过才安装。
    还不行就到 https://fm.juyiba.com/ 手动下载整包，重新运行"安装 Install.bat"。
  从 0.29.3 或更早的版本升上来的那一次，还是老办法：先关掉对话服务的黑色窗口，再在"AI 插件"页点"更新"，
  会弹出一个窗口，显示"更新完成"后重启游戏。
  更新程序只安装作者签过名的版本，别人改过的包它会拒绝。
  下载页：https://fm.juyiba.com/ （也可以下载新包，重新运行一次"安装 Install.bat"，效果一样）。

八、卸载
  退出游戏，双击"卸载 Uninstall.bat"。它会删掉插件，然后分别问你：
    - BepInEx 要不要一起删（只有它是这个安装程序装的、而且没有别的插件时才会问；删掉后游戏目录完全恢复原样，游戏本体文件从来没改过）；
    - ChatGPT 登录要不要退出；
    - 对话服务和长期记忆（C:\Users\你的用户名\FM-LLM）要不要删。

附：BepInEx 是开源项目（LGPL-2.1 许可），源码见 https://github.com/BepInEx/BepInEx ，本包里是它的原版 6.0.0-be.793。

作者：Dale Dai（a1014689894@gmail.com · QQ 1014689894 · 微信 1014689894（同号））。想和作者交流可以加。
