============================================================
 授权门控补丁  使用说明（请在动手前先读完）
============================================================

这个补丁解决什么问题？
------------------------------------------------------------
你的软件有一个"授权开关"没被打开。

没打开的时候会怎么样？简单说：

  * 就算你没有激活卡密，软件的真实微信通道照样挂着、收发消息；
  * AI 也会自动回复，用的还是你电脑本地存的那把大模型钥匙。

也就是说，没激活也能一直用，而且用掉的费用不会记到云端账上。
这属于授权漏洞，所以需要补上。

需要说明的是：这不是你操作错了，是老版本安装包在特定情况下
（比如软件已经装过、或者直接复制整个文件夹过来）漏写了这一行。
正常的在线升级也不会覆盖它，所以只能靠这个补丁手工补一次。

------------------------------------------------------------
这个补丁具体做什么？
------------------------------------------------------------
只做一件事：在你的 server\.env 文件末尾，补上一行

    LICENSE_ENFORCED=1

然后备份一份原文件。除此之外，什么都不改。
你原来的 PORT、LLM_ 开头的、WXAUTO_ 开头的、COMMERCIAL 等等，
一个字都不会动。

------------------------------------------------------------
★ 重要：补完之后，没激活的机器会不能用
------------------------------------------------------------
补丁要重启软件后才生效。生效之后：

  * 如果这台电脑【还没有激活卡密】：
    真实的微信通道和 AI 自动回复会被停用，软件进入体验模式。
    这是预期行为，不是故障，也不是补丁把软件弄坏了。

  * 如果这台电脑【已经激活过】：
    一切照常，只是补齐了授权校验。

所以建议你这样安排：

    先激活卡密，再打这个补丁；
    或者打完补丁后马上就去激活。

补丁运行时会自己判断你这台机器有没有激活过，
如果没激活，它会在屏幕上用大字提醒你，注意看。

------------------------------------------------------------
怎么用？（三步）
------------------------------------------------------------
第一步：
    把 setup-hotfix-license-gate.zip 解压出来，
    里面有两个文件：fix-license-gate.bat 和本说明。

第二步：
    把 fix-license-gate.bat 复制到软件的安装目录里。
    也就是和 start.bat 放在同一个文件夹。
    （如果不确定是哪个目录，就看桌面上启动软件的快捷方式，
      右键 -> 打开文件所在位置。）

第三步：
    双击 fix-license-gate.bat。
    它会先做一遍检查，把情况打印出来给你看，然后问你要不要修。
    输入大写字母 Y 再按回车，它才会动手；
    输入任何别的东西，它就什么都不改直接退出。

修完之后，按屏幕上最后几行的提示做：

    1. 关掉软件主程序窗口
    2. 运行 stop-bg.bat
    3. 运行 start.bat
    4. 打开管理面板，看右上角的授权徽章

（不重启是不会生效的，这一点务必记得。）

------------------------------------------------------------
出问题了怎么办？
------------------------------------------------------------
放心，改之前它会自动备份。

备份文件就在 server 文件夹里，名字长得像这样：

    .env.bak-20260918-204928

如果补完发现不对劲，想要退回原样：

    1. 先关掉软件
    2. 进 server 文件夹，把 .env 删掉或者改名
    3. 把那个 .env.bak-... 文件改回成 .env
    4. 重新运行 start.bat

就恢复成补丁之前的样子了。

另外，重复运行本补丁是安全的：
第二次运行时它会发现已经补过了，直接告诉你"已存在，未做任何修改"，
不会重复写，也不会再多出一个备份文件。

------------------------------------------------------------
补丁还会在屏幕上提醒你两件事
------------------------------------------------------------
1) 如果发现你的 server\.env 里写着真实的大模型钥匙
   （LLM_API_KEY=... 后面有内容），它会警告你。

   正常情况下客户机是不需要在本地存这把钥匙的，
   应该激活卡密之后走云端代理调用。
   本地存着钥匙，等于在用别人的账户额度、也不走云端计费。

   本补丁【不会】自动帮你删掉或清空这一行，
   需要你自己把它改成   LLM_API_KEY=
   然后激活卡密，让云端代理来调用。

2) 如果发现你的 server\.env 里写着 LICENSE_DEV=1，
   它也会警告你。

   这是"开发者免激活"开关，它会盖过授权门控，
   也就是说这种情况下补丁白补、门控仍然不生效。
   如果你不是开发人员，请把这一行删掉，或改成 LICENSE_DEV=0。

------------------------------------------------------------
一句话总结
------------------------------------------------------------
解压 -> 放到软件安装目录（和 start.bat 一起）-> 双击 -> 看提示按 Y
-> 关软件 -> stop-bg.bat -> start.bat -> 看右上角授权徽章。
没激活的机器请先激活再打补丁。

============================================================
